python-gvm 26.8.0__tar.gz → 26.9.0__tar.gz

{python_gvm-26.8.0 → python_gvm-26.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-gvm
-Version: 26.8.0
+Version: 26.9.0
 Summary: Library to communicate with remote servers over GMP or OSP
 License: GPL-3.0-or-later
 License-File: LICENSE

{python_gvm-26.8.0 → python_gvm-26.9.0}/gvm/__version__.py

@@ -2,4 +2,4 @@
 
 # THIS IS AN AUTOGENERATED FILE. DO NOT TOUCH!
 
-__version__ = "26.8.0"
+__version__ = "26.9.0"

{python_gvm-26.8.0 → python_gvm-26.9.0}/gvm/protocols/gmp/_gmpnext.py

@@ -682,18 +682,29 @@ class GMPNext(GMPv227[T]):
             )
         )
 
-    def create_container_task(
+    def create_import_task(
         self, name: str, *, comment: Optional[str] = None
     ) -> T:
-        """Create a new container task
+        """Create a new import task
 
-        A container task is a "meta" task to import and view reports from other
+        An import task is a "meta" task to import and view reports from other
         systems.
 
         Args:
             name: Name of the task
             comment: Comment for the task
         """
+        return self._send_request_and_transform_response(
+            Tasks.create_import_task(name=name, comment=comment)
+        )
+
+    def create_container_task(
+        self, name: str, *, comment: Optional[str] = None
+    ) -> T:
+        """[DEPRECATED] Use create_import_task instead.
+
+        This method will be removed in a future version.
+        """
         return self._send_request_and_transform_response(
             Tasks.create_container_task(name=name, comment=comment)
         )

{python_gvm-26.8.0 → python_gvm-26.9.0}/gvm/protocols/gmp/requests/next/_tasks.py

@@ -7,7 +7,7 @@ from typing import Mapping, Optional, Sequence
 
 from gvm.errors import InvalidArgument, RequiredArgument
 from gvm.protocols.core import Request
-from gvm.utils import SupportsStr, to_bool, to_comma_list
+from gvm.utils import SupportsStr, deprecated, to_bool, to_comma_list
 from gvm.xml import XmlCommand
 
 from .._entity_id import EntityID
@@ -210,12 +210,12 @@ class Tasks:
         return cmd
 
     @classmethod
-    def create_container_task(
+    def create_import_task(
         cls, name: str, *, comment: Optional[str] = None
     ) -> Request:
-        """Create a new container task
+        """Create a new import task
 
-        A container task is a "meta" task to import and view reports from other
+        An import task is a "meta" task to import and view reports from other
         systems.
 
         Args:
@@ -224,7 +224,7 @@ class Tasks:
         """
         if not name:
             raise RequiredArgument(
-                function=cls.create_container_task.__name__, argument="name"
+                function=cls.create_import_task.__name__, argument="name"
             )
 
         cmd = XmlCommand("create_task")
@@ -236,6 +236,19 @@ class Tasks:
 
         return cmd
 
+    @classmethod
+    @deprecated(
+        "The function is obsolete. Please use create_import_task instead."
+    )
+    def create_container_task(
+        cls, name: str, *, comment: Optional[str] = None
+    ) -> "Request":
+        """[DEPRECATED] Use create_import_task instead.
+
+        This method will be removed in a future version.
+        """
+        return cls.create_import_task(name=name, comment=comment)
+
     @classmethod
     def create_task(
         cls,

{python_gvm-26.8.0 → python_gvm-26.9.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "python-gvm"
-version = "26.8.0"
+version = "26.9.0"
 description = "Library to communicate with remote servers over GMP or OSP"
 license = "GPL-3.0-or-later"
 authors = ["Greenbone AG <info@greenbone.net>"]

{python_gvm-26.8.0 → python_gvm-26.9.0}/tests/protocols/gmpnext/entities/tasks/__init__.py

@@ -9,6 +9,7 @@ from .test_create_container_image_task import (
     GmpCreateContainerImageTaskTestMixin,
 )
 from .test_create_container_task import GmpCreateContainerTaskTestMixin
+from .test_create_import_task import GmpCreateImportTaskTestMixin
 from .test_create_task import GmpCreateTaskTestMixin
 from .test_delete_task import GmpDeleteTaskTestMixin
 from .test_get_task import GmpGetTaskTestMixin
@@ -24,6 +25,7 @@ __all__ = (
     "GmpCreateAgentGroupTaskTestMixin",
     "GmpCreateContainerImageTaskTestMixin",
     "GmpCreateContainerTaskTestMixin",
+    "GmpCreateImportTaskTestMixin",
     "GmpCreateTaskTestMixin",
     "GmpDeleteTaskTestMixin",
     "GmpGetTaskTestMixin",

python_gvm-26.9.0/tests/protocols/gmpnext/entities/tasks/test_create_container_task.py

@@ -0,0 +1,40 @@
+# SPDX-FileCopyrightText: 2018-2025 Greenbone AG
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+
+from gvm.errors import RequiredArgument
+
+
+class GmpCreateContainerTaskTestMixin:
+    def test_create_container_task_emits_deprecation_warning_and_sends_xml(
+        self,
+    ):
+        with self.assertWarns(DeprecationWarning):
+            self.gmp.create_container_task(name="foo")
+
+        self.connection.send.has_been_called_with(
+            b"<create_task>"
+            b"<name>foo</name>"
+            b'<target id="0"/>'
+            b"</create_task>"
+        )
+
+    def test_create_container_task_missing_name(self):
+        with self.assertRaises(RequiredArgument):
+            self.gmp.create_container_task(name=None)
+
+        with self.assertRaises(RequiredArgument):
+            self.gmp.create_container_task(name="")
+
+    def test_create_container_task_with_comment_emits_warning(self):
+        with self.assertWarns(DeprecationWarning):
+            self.gmp.create_container_task(name="foo", comment="bar")
+
+        self.connection.send.has_been_called_with(
+            b"<create_task>"
+            b"<name>foo</name>"
+            b'<target id="0"/>'
+            b"<comment>bar</comment>"
+            b"</create_task>"
+        )

python_gvm-26.8.0/tests/protocols/gmpnext/entities/tasks/test_create_container_task.py → python_gvm-26.9.0/tests/protocols/gmpnext/entities/tasks/test_create_import_task.py

@@ -6,9 +6,9 @@
 from gvm.errors import RequiredArgument
 
 
-class GmpCreateContainerTaskTestMixin:
+class GmpCreateImportTaskTestMixin:
     def test_create_task(self):
-        self.gmp.create_container_task(name="foo")
+        self.gmp.create_import_task(name="foo")
 
         self.connection.send.has_been_called_with(
             b"<create_task>"
@@ -19,13 +19,13 @@ class GmpCreateContainerTaskTestMixin:
 
     def test_create_task_missing_name(self):
         with self.assertRaises(RequiredArgument):
-            self.gmp.create_container_task(name=None)
+            self.gmp.create_import_task(name=None)
 
         with self.assertRaises(RequiredArgument):
-            self.gmp.create_container_task(name="")
+            self.gmp.create_import_task(name="")
 
     def test_create_task_with_comment(self):
-        self.gmp.create_container_task(name="foo", comment="bar")
+        self.gmp.create_import_task(name="foo", comment="bar")
 
         self.connection.send.has_been_called_with(
             b"<create_task>"

{python_gvm-26.8.0 → python_gvm-26.9.0}/tests/protocols/gmpnext/entities/test_tasks.py

@@ -2,13 +2,13 @@
 #
 # SPDX-License-Identifier: GPL-3.0-or-later
 #
-
 from ...gmpnext import GMPTestCase
 from ...gmpnext.entities.tasks import (
     GmpCloneTaskTestMixin,
     GmpCreateAgentGroupTaskTestMixin,
     GmpCreateContainerImageTaskTestMixin,
     GmpCreateContainerTaskTestMixin,
+    GmpCreateImportTaskTestMixin,
     GmpCreateTaskTestMixin,
     GmpDeleteTaskTestMixin,
     GmpGetTasksTestMixin,
@@ -43,6 +43,10 @@ class GMPCreateContainerTaskTestCase(
     pass
 
 
+class GMPCreateImportTaskTestCase(GmpCreateImportTaskTestMixin, GMPTestCase):
+    pass
+
+
 class GMPCreateTaskTestCase(GmpCreateTaskTestMixin, GMPTestCase):
     pass