python-gvm 26.3.0__tar.gz → 26.4.0__tar.gz

{python_gvm-26.3.0 → python_gvm-26.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: python-gvm
-Version: 26.3.0
+Version: 26.4.0
 Summary: Library to communicate with remote servers over GMP or OSP
 License: GPL-3.0-or-later
 Author: Greenbone AG

{python_gvm-26.3.0 → python_gvm-26.4.0}/gvm/__version__.py

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

{python_gvm-26.3.0 → python_gvm-26.4.0}/gvm/connections/_debug.py

@@ -28,7 +28,7 @@ class DebugConnection:
 
         socket_connection = UnixSocketConnection(path='/var/run/gvm.sock')
         connection = DebugConnection(socket_connection)
-        gmp = Gmp(connection=connection)
+        gmp = GMP(connection=connection)
     """
 
     def __init__(self, connection: GvmConnection):

{python_gvm-26.3.0 → python_gvm-26.4.0}/gvm/protocols/gmp/__init__.py

@@ -9,14 +9,14 @@ In most circumstances you will want to use the :class:`GMP` class which
 dynamically selects the supported GMP protocol of the remote manager daemon.
 
 If you need to use a specific GMP version, you can use the :class:`GMPv224`,
-:class:`GMPv225`, :class:`GMPv226`, :class:`GMPv227` or :class:`GMPv228` classes.
+:class:`GMPv225`, :class:`GMPv226`, :class:`GMPv227` or :class:`GMPNext` classes.
 
 * :class:`GMP` - Dynamically select supported GMP protocol of the remote manager daemon.
 * :class:`GMPv224` - GMP version 22.4
 * :class:`GMPv225` - GMP version 22.5
 * :class:`GMPv226` - GMP version 22.6
 * :class:`GMPv227` - GMP version 22.7
-* :class:`GMPv228` - GMP version 22.8
+* :class:`GMPNext` - "next" GMP version, containing unstable features
 """
 
 from ._gmp import GMP
@@ -24,7 +24,7 @@ from ._gmp224 import GMPv224
 from ._gmp225 import GMPv225
 from ._gmp226 import GMPv226
 from ._gmp227 import GMPv227
-from ._gmp228 import GMPv228
+from ._gmpnext import GMPNext
 
 Gmp = GMP  # for backwards compatibility
 
@@ -35,5 +35,5 @@ __all__ = (
     "GMPv225",
     "GMPv226",
     "GMPv227",
-    "GMPv228",
+    "GMPNext",
 )

{python_gvm-26.3.0 → python_gvm-26.4.0}/gvm/protocols/gmp/_gmp.py

@@ -16,11 +16,11 @@ from ._gmp224 import GMPv224
 from ._gmp225 import GMPv225
 from ._gmp226 import GMPv226
 from ._gmp227 import GMPv227
-from ._gmp228 import GMPv228
+from ._gmpnext import GMPNext
 from .requests import Version
 
 SUPPORTED_GMP_VERSIONS = Union[
-    GMPv224[T], GMPv225[T], GMPv226[T], GMPv227[T], GMPv228[T]
+    GMPv224[T], GMPv225[T], GMPv226[T], GMPv227[T], GMPNext[T]
 ]
 _SUPPORTED_GMP_VERSION_STRINGS = ["22.4", "22.5", "22.6", "22.7", "22.8"]
 
@@ -42,7 +42,7 @@ class GMP(GvmProtocol[T]):
                 # gvm.protocols.gmp.GMPv225,
                 # gvm.protocols.gmp.GMPv226,
                 # gvm.protocols.gmp.GMPv227,
-                # or gvm.protocols.gmp.GMPv228
+                # or gvm.protocols.gmp.GMPNext
                 # depending on the supported GMP version of the remote manager daemon
                 resp = gmp.get_tasks()
     """
@@ -100,7 +100,7 @@ class GMP(GvmProtocol[T]):
         elif major_version == 22 and minor_version == 7:
             gmp_class = GMPv227
         elif major_version == 22 and minor_version >= 8:
-            gmp_class = GMPv228
+            gmp_class = GMPNext
             if minor_version > 8:
                 warnings.warn(
                     "Remote manager daemon uses a newer GMP version than "

python_gvm-26.3.0/gvm/protocols/gmp/_gmp228.py → python_gvm-26.4.0/gvm/protocols/gmp/_gmpnext.py

@@ -8,18 +8,22 @@ from gvm.protocols.gmp.requests import EntityID
 
 from .._protocol import T
 from ._gmp227 import GMPv227
-from .requests.v228 import AgentInstallers
+from .requests.next import AgentInstallers
 
 
-class GMPv228(GMPv227[T]):
+class GMPNext(GMPv227[T]):
     """
-    A class implementing the Greenbone Management Protocol (GMP) version 22.8
+    A class implementing the "Next" version of Greenbone Management Protocol (GMP)
+    containing features that are not part of the stable release yet.
+
+    These features may change at any time and may not be available in all builds
+    of the gvmd back-end.
 
     Example:
 
         .. code-block:: python
 
-            from gvm.protocols.gmp import GMPv228 as GMP
+            from gvm.protocols.gmp.next import GMP
 
             with GMP(connection) as gmp:
                 resp = gmp.get_tasks()

{python_gvm-26.3.0/gvm/protocols/gmp/requests/v228 → python_gvm-26.4.0/gvm/protocols/gmp/requests/next}/__init__.py

@@ -2,7 +2,7 @@
 #
 #  SPDX-License-Identifier: GPL-3.0-or-later
 
-from gvm.protocols.gmp.requests.v228._agent_installers import AgentInstallers
+from gvm.protocols.gmp.requests.next._agent_installers import AgentInstallers
 
 from .._entity_id import EntityID
 from .._version import Version

{python_gvm-26.3.0 → python_gvm-26.4.0}/gvm/protocols/latest.py

@@ -22,11 +22,14 @@ Exports:
 """
 
 from .gmp import (
-    GMPv227 as Gmp,
+    GMPv227 as GMP,
 )
 from .ospv1 import Osp
 
+Gmp = GMP  # for backwards compatibility
+
 __all__ = [
     "Gmp",
+    "GMP",
     "Osp",
 ]

{python_gvm-26.3.0 → python_gvm-26.4.0}/gvm/protocols/next.py

@@ -5,7 +5,8 @@
 """Latest supported protocols, including unstable ones.
 
 This module exposes the latest supported protocols of GVM including versions
-not yet released as stable.
+not yet released as stable, which may contain features that can change at any time
+and may not be available in all builds of the gvmd back-end.
 
 The provided Gmp class implements the latest Greenbone Management Protocol.
 The provided Osp class implements the latest Open Scanner Protocol.
@@ -14,16 +15,19 @@ For details about the possible supported protocol versions please take a look at
 :py:mod:`gvm.protocols`.
 
 Exports:
-  - :py:class:`gvm.protocols.gmp.GMPv227`
+  - :py:class:`gvm.protocols.gmp.GMPNext`
   - :py:class:`gvm.protocols.ospv1.Osp`
 """
 
 from .gmp import (
-    GMPv227 as Gmp,
+    GMPNext as GMP,
 )
 from .ospv1 import Osp
 
+Gmp = GMP  # for backwards compatibility
+
 __all__ = [
     "Gmp",
+    "GMP",
     "Osp",
 ]

{python_gvm-26.3.0 → python_gvm-26.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "python-gvm"
-version = "26.3.0"
+version = "26.4.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.3.0 → python_gvm-26.4.0}/tests/protocols/gmp/test_context_manager.py

@@ -7,7 +7,7 @@ import unittest
 from unittest.mock import MagicMock, patch
 
 from gvm.errors import GvmError
-from gvm.protocols.gmp import Gmp, GMPv228
+from gvm.protocols.gmp import Gmp, GMPNext
 from gvm.protocols.gmp._gmp224 import GMPv224
 from gvm.protocols.gmp._gmp225 import GMPv225
 from gvm.protocols.gmp._gmp226 import GMPv226
@@ -155,7 +155,7 @@ class GmpContextManagerTestCase(GmpTestCase):
 
         with self.gmp as gmp:
             self.assertEqual(gmp.get_protocol_version(), (22, 8))
-            self.assertIsInstance(gmp, GMPv228)
+            self.assertIsInstance(gmp, GMPNext)
 
         self.connection.read.return_value(
             b'<get_version_response status="200" status_text="OK">'

{python_gvm-26.3.0/tests/protocols/gmpv228 → python_gvm-26.4.0/tests/protocols/gmpnext}/__init__.py

@@ -3,10 +3,10 @@
 # SPDX-License-Identifier: GPL-3.0-or-later
 #
 
-from gvm.protocols.gmp import GMPv228
+from gvm.protocols.gmp import GMPNext
 
 from .. import GmpTestCase as BaseGMPTestCase
 
 
 class GMPTestCase(BaseGMPTestCase):
-    gmp_class = GMPv228
+    gmp_class = GMPNext

{python_gvm-26.3.0/tests/protocols/gmpv228 → python_gvm-26.4.0/tests/protocols/gmpnext}/entities/test_agent_installers.py

@@ -3,7 +3,7 @@
 # SPDX-License-Identifier: GPL-3.0-or-later
 #
 
-from ...gmpv228 import GMPTestCase
+from ...gmpnext import GMPTestCase
 from .agent_installers.test_get_agent_installer import (
     GmpGetAgentInstallerTestMixin,
 )

{python_gvm-26.3.0 → python_gvm-26.4.0}/tests/protocols/test_next.py

@@ -12,7 +12,7 @@ from gvm.protocols.next import Gmp, Osp
 
 class LatestProtocolsTestCase(unittest.TestCase):
     def test_gmp_version(self):
-        self.assertEqual(Gmp.get_protocol_version(), (22, 7))
+        self.assertEqual(Gmp.get_protocol_version(), (22, 8))
 
     def test_osp_version(self):
         self.assertEqual(Osp.get_protocol_version(), (1, 2))