add: add agent installer instruction GMP request

Add support for the get_agent_installer_instruction GMP request.

The request uses a scanner ID and language type to retrieve installer
instructions from gvmd.

Remove the old agent installer request helpers and tests because
installer files are no longer handled by these commands.

Add tests for English and German language types and required arguments.

Author: ozgen

gvm/protocols/gmp/_gmpnext.py

@@ -12,7 +12,8 @@
 from ._gmp227 import GMPv227
 from .requests.next import (
     AgentGroups,
-    AgentInstallers,
+    AgentInstallerInstructionLanguageType,
+    AgentInstallerInstructions,
     Agents,
     Credentials,
     CredentialStoreCredentialType,
@@ -55,52 +56,25 @@ class GMPNext(GMPv227[T]):
     def get_protocol_version() -> tuple[int, int]:
         return (22, 8)
 
-    def get_agent_installers(
+    def get_agent_installer_instruction(
         self,
         *,
-        filter_string: str | None = None,
-        filter_id: EntityID | None = None,
-        trash: bool | None = None,
-        details: bool | None = None,
+        scanner_id: EntityID,
+        language_type: AgentInstallerInstructionLanguageType,
     ) -> T:
-        """Request a list of agent installers
+        """Request an agent installer instruction.
 
         Args:
-            filter_string: Filter term to use for the query
-            filter_id: UUID of an existing filter to use for the query
-            trash: Whether to get the trashcan agent installers instead
-            details: Whether to include extra details like tasks using this
-                scanner
+            scanner_id: UUID of the Agent controller to get the installer instruction for.
+            language_type: Language of the installer instruction.
         """
         return self._send_request_and_transform_response(
-            AgentInstallers.get_agent_installers(
-                filter_string=filter_string,
-                filter_id=filter_id,
-                trash=trash,
-                details=details,
+            AgentInstallerInstructions.get_agent_installer_instruction(
+                scanner_id=scanner_id,
+                language_type=language_type,
             )
         )
 
-    def get_agent_installer(self, agent_installer_id: EntityID) -> T:
-        """Request a single agent installer
-
-        Args:
-            agent_installer_id: UUID of an existing agent installer
-        """
-        return self._send_request_and_transform_response(
-            AgentInstallers.get_agent_installer(agent_installer_id)
-        )
-
-    def get_agent_installer_file(self, agent_installer_id: EntityID) -> T:
-        """Request a single agent installer file
-
-        Args:
-            agent_installer_id: UUID of an existing agent installer
-        """
-        return self._send_request_and_transform_response(
-            AgentInstallers.get_agent_installer_file(agent_installer_id)
-        )
-
     def get_agents(
         self,
         *,

gvm/protocols/gmp/requests/next/__init__.py

@@ -3,7 +3,10 @@
 #  SPDX-License-Identifier: GPL-3.0-or-later
 
 from gvm.protocols.gmp.requests.next._agent_groups import AgentGroups
-from gvm.protocols.gmp.requests.next._agent_installers import AgentInstallers
+from gvm.protocols.gmp.requests.next._agent_installer_instructions import (
+    AgentInstallerInstructionLanguageType,
+    AgentInstallerInstructions,
+)
 from gvm.protocols.gmp.requests.next._agents import Agents
 from gvm.protocols.gmp.requests.next._credential_stores import CredentialStores
 from gvm.protocols.gmp.requests.next._credentials import (
@@ -115,7 +118,8 @@
 
 __all__ = (
     "AgentGroups",
-    "AgentInstallers",
+    "AgentInstallerInstructionLanguageType",
+    "AgentInstallerInstructions",
     "Agents",
     "AggregateStatistic",
     "Aggregates",

gvm/protocols/gmp/requests/next/_agent_installer_instructions.py

@@ -0,0 +1,43 @@
+from enum import Enum
+
+from gvm.errors import RequiredArgument
+from gvm.protocols.core import Request
+from gvm.protocols.gmp.requests._entity_id import EntityID
+from gvm.xml import XmlCommand
+
+
+class AgentInstallerInstructionLanguageType(Enum):
+    EN = "en"
+    DE = "de"
+
+
+class AgentInstallerInstructions:
+    @classmethod
+    def get_agent_installer_instruction(
+        cls,
+        scanner_id: EntityID,
+        language_type: AgentInstallerInstructionLanguageType,
+    ) -> Request:
+        """Request an agent installer instruction.
+
+        Args:
+            scanner_id: UUID of the Agent controller to get the installer instruction for.
+            language_type: Language of the installer instruction.
+        """
+        if not scanner_id:
+            raise RequiredArgument(
+                function=cls.get_agent_installer_instruction.__name__,
+                argument="scanner_id",
+            )
+
+        if not language_type:
+            raise RequiredArgument(
+                function=cls.get_agent_installer_instruction.__name__,
+                argument="language_type",
+            )
+
+        cmd = XmlCommand("get_agent_installer_instruction")
+        cmd.set_attribute("scanner_id", str(scanner_id))
+        cmd.set_attribute("language", language_type.value)
+
+        return cmd

gvm/protocols/gmp/requests/next/_agent_installers.py

@@ -0,0 +1,57 @@
+# SPDX-FileCopyrightText: 2026 Greenbone AG
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+
+from gvm.errors import RequiredArgument
+from gvm.protocols.gmp.requests.next import (
+    AgentInstallerInstructionLanguageType,
+)
+
+
+class GmpGetAgentInstallerInstructionTestMixin:
+    def test_get_agent_installer_instruction(self):
+        self.gmp.get_agent_installer_instruction(
+            scanner_id="scanner1",
+            language_type=AgentInstallerInstructionLanguageType.EN,
+        )
+
+        self.connection.send.has_been_called_with(
+            b'<get_agent_installer_instruction scanner_id="scanner1" language="en"/>'
+        )
+
+    def test_get_agent_installer_instruction_de(self):
+        self.gmp.get_agent_installer_instruction(
+            scanner_id="scanner1",
+            language_type=AgentInstallerInstructionLanguageType.DE,
+        )
+
+        self.connection.send.has_been_called_with(
+            b'<get_agent_installer_instruction scanner_id="scanner1" language="de"/>'
+        )
+
+    def test_get_agent_installer_instruction_without_scanner_id(self):
+        with self.assertRaises(RequiredArgument):
+            self.gmp.get_agent_installer_instruction(
+                scanner_id=None,
+                language_type=AgentInstallerInstructionLanguageType.EN,
+            )
+
+        with self.assertRaises(RequiredArgument):
+            self.gmp.get_agent_installer_instruction(
+                scanner_id="",
+                language_type=AgentInstallerInstructionLanguageType.EN,
+            )
+
+    def test_get_agent_installer_instruction_without_language_type(self):
+        with self.assertRaises(RequiredArgument):
+            self.gmp.get_agent_installer_instruction(
+                scanner_id="scanner1",
+                language_type=None,
+            )
+
+        with self.assertRaises(RequiredArgument):
+            self.gmp.get_agent_installer_instruction(
+                scanner_id="scanner1",
+                language_type="",
+            )

…xt/entities/agent_installers/__init__.py …agent_installer_instructions/__init__.pytests/protocols/gmpnext/entities/agent_installers/__init__.py renamed to tests/protocols/gmpnext/entities/agent_installer_instructions/__init__.py tests/protocols/gmpnext/entities/agent_installers/__init__.py renamed to tests/protocols/gmpnext/entities/agent_installer_instructions/__init__.py

@@ -0,0 +1,15 @@
+# SPDX-FileCopyrightText: 2023-2026 Greenbone AG
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+
+from ...gmpnext import GMPTestCase
+from .agent_installer_instructions.test_get_aget_installer_instruction import (
+    GmpGetAgentInstallerInstructionTestMixin,
+)
+
+
+class GMPGetAgentInstallerInstructionTestCase(
+    GmpGetAgentInstallerInstructionTestMixin, GMPTestCase
+):
+    pass