python-gvm 27.4.0__py3-none-any.whl → 27.6.0__py3-none-any.whl

gvm/__version__.py

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

gvm/protocols/gmp/_gmpnext.py

@@ -16,6 +16,7 @@ from .requests.next import (
     AgentInstallerInstructions,
     Agents,
     AliveTest,
+    AuditReport,
     Credentials,
     CredentialStoreCredentialType,
     CredentialStores,
@@ -30,12 +31,14 @@ from .requests.next import (
     ReportPorts,
     ReportTlsCertificates,
     ReportVulnerabilities,
+    ScanReports,
     Targets,
     Tasks,
     WebApplicationTargets,
 )
 from .requests.v224 import AliveTest as AliveTestV224
 from .requests.v224 import HostsOrdering
+from .requests.v226 import ReportFormatType
 
 
 class GMPNext(GMPv227[T]):
@@ -306,6 +309,29 @@ class GMPNext(GMPv227[T]):
         """Trigger agents synchronization from all agent controllers."""
         return self._send_request_and_transform_response(Agents.sync_agents())
 
+    def get_agent_support_bundle(
+        self,
+        agent_id: EntityID,
+        days: int = 0,
+    ) -> T:
+        """Request a support bundle for an agent.
+
+        Args:
+            agent_id: ID of the agent to get the support bundle for.
+            days: Number of days of logs to include. If None, zero is sent so the
+                Agent Controller uses its configured default.
+
+        Raises:
+            RequiredArgument: If agent_id is missing.
+            ValueError: If days is negative.
+        """
+        return self._send_request_and_transform_response(
+            Agents.get_agent_support_bundle(
+                agent_id,
+                days=days,
+            )
+        )
+
     def create_credential_store_credential(
         self,
         name: str,
@@ -1066,6 +1092,36 @@ class GMPNext(GMPv227[T]):
             )
         )
 
+    def get_audit_report_hosts(
+        self,
+        report_id: EntityID,
+        *,
+        filter_string: str | None = None,
+        filter_id: str | None = None,
+        ignore_pagination: bool | None = None,
+        details: bool | None = True,
+    ) -> T:
+        """Request hosts of a single audit report.
+
+        Args:
+            report_id: UUID of an existing report.
+            filter_string: Filter term to use to filter results in the report
+            filter_id: UUID of filter to use to filter results in the report
+            ignore_pagination: Whether to ignore the filter terms "first" and
+                "rows".
+            details: Request additional report host information details.
+                Defaults to True.
+        """
+        return self._send_request_and_transform_response(
+            ReportHosts.get_audit_report_hosts(
+                report_id=report_id,
+                filter_string=filter_string,
+                filter_id=filter_id,
+                ignore_pagination=ignore_pagination,
+                details=details,
+            )
+        )
+
     def get_report_operating_systems(
         self,
         report_id: EntityID,
@@ -1619,3 +1675,86 @@ class GMPNext(GMPv227[T]):
                 tasks=tasks,
             )
         )
+
+    def get_scan_report(
+        self,
+        scan_report_id: EntityID,
+        *,
+        filter_string: str | None = None,
+        filter_id: str | None = None,
+    ) -> T:
+        """ "Request a structured summary of a single scan report.
+
+        Args:
+            scan_report_id: UUID of an existing scan report.
+            filter_string: Filter term to apply to the report results.
+            filter_id: UUID of a saved filter to apply to the report results.
+
+        Returns:
+            A request for the get_scan_report GMP command.
+
+        Raises:
+            RequiredArgument: If scan_report_id is not provided.
+        """
+        return self._send_request_and_transform_response(
+            ScanReports.get_scan_report(
+                scan_report_id=scan_report_id,
+                filter_string=filter_string,
+                filter_id=filter_id,
+            )
+        )
+
+    def get_audit_report(  # type: ignore[override]
+        self,
+        audit_report_id: EntityID,
+        *,
+        filter_string: str | None = None,
+        filter_id: str | None = None,
+    ) -> T:
+        """Request a structured summary of a single audit report.
+
+        Args:
+            audit_report_id: UUID of an existing audit report.
+            filter_string: Filter term to apply to the report results.
+            filter_id: UUID of a saved filter to apply to the report results.
+
+        Returns:
+            A request for the get_audit_report GMP command.
+
+        Raises:
+            RequiredArgument: If audit_report_id is not provided.
+        """
+        return self._send_request_and_transform_response(
+            AuditReport.get_audit_report(
+                audit_report_id=audit_report_id,
+                filter_string=filter_string,
+                filter_id=filter_id,
+            )
+        )
+
+    def get_audit_report_legacy(
+        self,
+        report_id: EntityID,
+        *,
+        filter_string: str | None = None,
+        filter_id: str | None = None,
+        delta_report_id: EntityID | None = None,
+        report_format_id: str | ReportFormatType | None = None,
+        ignore_pagination: bool | None = None,
+        details: bool | None = True,
+    ) -> T:
+        """Request an audit report using the legacy command.
+
+        Deprecated:
+            Use ``get_audit_report`` instead. This method will be removed
+            in the next major release.
+        """
+        return super().get_audit_report(
+            report_id,
+            filter_string=filter_string,
+            filter_id=filter_id,
+            delta_report_id=delta_report_id,
+            report_format_id=report_format_id,
+            ignore_pagination=ignore_pagination,
+            details=details,
+        )

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

@@ -8,6 +8,7 @@ from gvm.protocols.gmp.requests.next._agent_installer_instructions import (
     AgentInstallerInstructions,
 )
 from gvm.protocols.gmp.requests.next._agents import Agents
+from gvm.protocols.gmp.requests.next._audit_report import AuditReport
 from gvm.protocols.gmp.requests.next._credential_stores import CredentialStores
 from gvm.protocols.gmp.requests.next._credentials import (
     Credentials,
@@ -44,6 +45,7 @@ from gvm.protocols.gmp.requests.next._report_tls_certificates import (
 from gvm.protocols.gmp.requests.next._report_vulnerabilities import (
     ReportVulnerabilities,
 )
+from gvm.protocols.gmp.requests.next._scan_report import ScanReports
 from gvm.protocols.gmp.requests.next._targets import AliveTest, Targets
 from gvm.protocols.gmp.requests.next._tasks import Tasks
 from gvm.protocols.gmp.requests.next._web_application_targets import (
@@ -130,6 +132,7 @@ __all__ = (
     "AlertMethod",
     "Alerts",
     "AliveTest",
+    "AuditReport",
     "AuditReports",
     "Audits",
     "Authentication",
@@ -184,6 +187,7 @@ __all__ = (
     "Results",
     "Roles",
     "ScanConfigs",
+    "ScanReports",
     "ScannerType",
     "Scanners",
     "Schedules",

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

@@ -431,3 +431,36 @@ class Agents:
     def sync_agents(cls) -> Request:
         """Trigger agents synchronization from all agent controllers."""
         return XmlCommand("sync_agents")
+
+    @classmethod
+    def get_agent_support_bundle(
+        cls,
+        agent_id: EntityID,
+        *,
+        days: int = 0,
+    ) -> Request:
+        """Request a support bundle for an agent.
+
+        Args:
+            agent_id: ID of the agent to get the support bundle for.
+            days: Number of days of logs to include. If None, zero is sent so the
+                Agent Controller uses its configured default.
+
+        Raises:
+            RequiredArgument: If agent_id is missing.
+            ValueError: If days is negative.
+        """
+        if not agent_id:
+            raise RequiredArgument(
+                function=cls.get_agent_support_bundle.__name__,
+                argument="agent_id",
+            )
+
+        if days < 0:
+            raise ValueError("days must be greater than or equal to zero")
+
+        cmd = XmlCommand("get_agent_support_bundle")
+        cmd.set_attribute("agent_uuid", str(agent_id))
+        cmd.set_attribute("days", str(days))
+
+        return cmd

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

@@ -0,0 +1,39 @@
+from gvm.errors import RequiredArgument
+from gvm.protocols.core import Request
+from gvm.protocols.gmp.requests import EntityID
+from gvm.xml import XmlCommand
+
+
+class AuditReport:
+    @classmethod
+    def get_audit_report(
+        cls,
+        audit_report_id: EntityID,
+        *,
+        filter_string: str | None = None,
+        filter_id: str | None = None,
+    ) -> Request:
+        """Request a structured summary of a single audit report.
+
+        Args:
+            audit_report_id: UUID of an existing audit report.
+            filter_string: Filter term to apply to the report results.
+            filter_id: UUID of a saved filter to apply to the report results.
+
+        Returns:
+            A request for the get_audit_report GMP command.
+
+        Raises:
+            RequiredArgument: If audit_report_id is not provided.
+        """
+        if not audit_report_id:
+            raise RequiredArgument(
+                function=cls.get_audit_report.__name__,
+                argument="audit_report_id",
+            )
+
+        cmd = XmlCommand("get_audit_report")
+        cmd.set_attribute("audit_report_id", str(audit_report_id))
+        cmd.add_filter(filter_string, filter_id)
+
+        return cmd

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

@@ -44,3 +44,42 @@ class ReportHosts:
         cmd.set_attribute("details", to_bool(details))
 
         return cmd
+
+    @classmethod
+    def get_audit_report_hosts(
+        cls,
+        report_id: EntityID,
+        *,
+        filter_string: str | None = None,
+        filter_id: str | None = None,
+        ignore_pagination: bool | None = None,
+        details: bool | None = True,
+    ) -> Request:
+        """Request hosts of a single audit report.
+
+        Args:
+            report_id: UUID of an existing report.
+            filter_string: Filter term to use to filter results in the report
+            filter_id: UUID of filter to use to filter results in the report
+            ignore_pagination: Whether to ignore the filter terms "first" and
+                "rows".
+            details: Request additional report host information details.
+                Defaults to True.
+        """
+        cmd = XmlCommand("get_audit_report_hosts")
+
+        if not report_id:
+            raise RequiredArgument(
+                function=cls.get_report_hosts.__name__, argument="report_id"
+            )
+
+        cmd.set_attribute("report_id", str(report_id))
+
+        cmd.add_filter(filter_string, filter_id)
+
+        if ignore_pagination is not None:
+            cmd.set_attribute("ignore_pagination", to_bool(ignore_pagination))
+
+        cmd.set_attribute("details", to_bool(details))
+
+        return cmd

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

@@ -0,0 +1,39 @@
+from gvm.errors import RequiredArgument
+from gvm.protocols.core import Request
+from gvm.protocols.gmp.requests import EntityID
+from gvm.xml import XmlCommand
+
+
+class ScanReports:
+    @classmethod
+    def get_scan_report(
+        cls,
+        scan_report_id: EntityID,
+        *,
+        filter_string: str | None = None,
+        filter_id: str | None = None,
+    ) -> Request:
+        """Request a structured summary of a single scan report.
+
+        Args:
+            scan_report_id: UUID of an existing scan report.
+            filter_string: Filter term to apply to the report results.
+            filter_id: UUID of a saved filter to apply to the report results.
+
+        Returns:
+            A request for the get_scan_report GMP command.
+
+        Raises:
+            RequiredArgument: If scan_report_id is not provided.
+        """
+        if not scan_report_id:
+            raise RequiredArgument(
+                function=cls.get_scan_report.__name__,
+                argument="scan_report_id",
+            )
+
+        cmd = XmlCommand("get_scan_report")
+        cmd.set_attribute("scan_report_id", str(scan_report_id))
+        cmd.add_filter(filter_string, filter_id)
+
+        return cmd

{python_gvm-27.4.0.dist-info → python_gvm-27.6.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-gvm
-Version: 27.4.0
+Version: 27.6.0
 Summary: Library to communicate with remote servers over GMP or OSP
 Project-URL: Homepage, https://github.com/greenbone/python-gvm/
 Project-URL: Repository, https://github.com/greenbone/python-gvm/
@@ -25,7 +25,7 @@ Requires-Dist: lxml>=4.5.0
 Requires-Dist: paramiko>=2.7.1
 Description-Content-Type: text/markdown
 
-![Greenbone Logo](https://www.greenbone.net/wp-content/uploads/gb_new-logo_horizontal_rgb_small.png)
+![Greenbone Logo](https://www.greenbone.net/wp-content/uploads/greenbone-logo-2025.png)
 
 # Greenbone Vulnerability Management Python Library <!-- omit in toc -->
 

{python_gvm-27.4.0.dist-info → python_gvm-27.6.0.dist-info}/RECORD

@@ -1,5 +1,5 @@
 gvm/__init__.py,sha256=Eu3a8hRdlixDFn34Q-BwPXVN65KHpgFk_i0CYUdbfF8,412
-gvm/__version__.py,sha256=VZj5wzvpAt0792r36uKsG9me961dIWp4WNe2d3IHyF4,103
+gvm/__version__.py,sha256=zkjBBcTOU9y-yAfS_zLUFOIEAx1x2CfkLUnZBfV1ByQ,103
 gvm/_enum.py,sha256=n--ztwQQW2MU4M9E_4qJrw-32IGc4Laj6auZ8glMw_0,1168
 gvm/errors.py,sha256=FnZoe3ROKlAm8LMJ25uKRaG9cp-SG8hYIVtDMwwp0l0,5263
 gvm/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -27,14 +27,15 @@ gvm/protocols/gmp/_gmp224.py,sha256=NO-ufzkGW1RNzMHrIjlFm7r8QzSH0uRZK5xc9mWLRVI,
 gvm/protocols/gmp/_gmp225.py,sha256=3lz_AHTIQdBEr4DIYJ5o9D0Eke-Df3jUb0IZytITRdo,2227
 gvm/protocols/gmp/_gmp226.py,sha256=YqQ7CJIbUtM7s8wQPYX5BgePdhX-tUjCemanW0_DZtE,14543
 gvm/protocols/gmp/_gmp227.py,sha256=-q4Aci1I4FRtLle21qTwtkchE2ixWn1-Kug58X4dU5I,5713
-gvm/protocols/gmp/_gmpnext.py,sha256=wIbgFQoFa9SxftUVTPK8BUziw_1qSGaF3M51HeWgd5o,57945
+gvm/protocols/gmp/_gmpnext.py,sha256=0_-sE2uyu6ctUQPneyMPoaMZ5jPgZJxChbZVQN4dpTw,62532
 gvm/protocols/gmp/requests/__init__.py,sha256=XH1zSifyz9Rx4FqY2lJ1mwurnUepHk7REZ-fSMC_Wx0,200
 gvm/protocols/gmp/requests/_entity_id.py,sha256=V96VhTg7_CF2AduaAHRYrGgTaOVA8_mG1lFiCl8-CMA,136
 gvm/protocols/gmp/requests/_version.py,sha256=GdHQnEVzJ6PbxoU4pxP36Oze1XvK5llWqB9bkC16Pf8,393
-gvm/protocols/gmp/requests/next/__init__.py,sha256=KXolfKC-eX2DyPvSEYgLT6FSXtrkUyx5v_zAs7gFMBs,4645
+gvm/protocols/gmp/requests/next/__init__.py,sha256=o_LZf7Rd4kY5OMwIo39S4btQfi8Z9rN39L09QXnVfG0,4822
 gvm/protocols/gmp/requests/next/_agent_groups.py,sha256=Dqa77vY2U82lG6wkLZfGMIUOHfZW9yCXkFvT3M8bFfo,6275
 gvm/protocols/gmp/requests/next/_agent_installer_instructions.py,sha256=wh4LBJVEE3t_Og9uf5Ek_y8MxjtnTcBa2IT4u4JVXg0,1798
-gvm/protocols/gmp/requests/next/_agents.py,sha256=6LIr3xG1YHsQeQucg01nmjm3JguvObluIkn0t_KNnAU,14591
+gvm/protocols/gmp/requests/next/_agents.py,sha256=j4UNQmfeH8ToFfA8T4JiPKb4ZGpQy71DL--sbaVXttM,15589
+gvm/protocols/gmp/requests/next/_audit_report.py,sha256=ssCzIQXSRFFjLAYGtlJoMDZSPAF9q_JLJs1IBsxHZ2c,1209
 gvm/protocols/gmp/requests/next/_credential_stores.py,sha256=wgixeHhls_Nvd7lYPE3mra_2vtWFZscm8HCwy4UgUNg,5691
 gvm/protocols/gmp/requests/next/_credentials.py,sha256=9iI2F4rp6TtQdM-OXS9IKN09SZRRLxYeBMcZs-Heo1Q,6107
 gvm/protocols/gmp/requests/next/_integration_configs.py,sha256=j9RospMEU9ErjUzRNHv9tvv0_yRSwMfJdOKNUmJC4rk,3715
@@ -43,11 +44,12 @@ gvm/protocols/gmp/requests/next/_report_applications.py,sha256=EVqMMb1u-uQatywFu
 gvm/protocols/gmp/requests/next/_report_closed_cves.py,sha256=2j2ZFScgQughuGmbW5eaagdgPlOnYr38JnQ3ruEpLUQ,1244
 gvm/protocols/gmp/requests/next/_report_cves.py,sha256=VZa25Tkiabg19tNkxVsxz1_oDz2ERGyL5LCQwuHtY_Y,1471
 gvm/protocols/gmp/requests/next/_report_errors.py,sha256=tB3zvDSaV0e3HjteK__oOFQwce5Tjbv5KQgM4eBEbJk,1483
-gvm/protocols/gmp/requests/next/_report_hosts.py,sha256=uAt9MvfLZoIqZ0VWKpWSOrsQW2cxsKZkSYo7C_0JIU0,1477
+gvm/protocols/gmp/requests/next/_report_hosts.py,sha256=qYyPwr4QBuC8CYt_COaZYDNIFyT74rPX9Ik6DjG-Owg,2764
 gvm/protocols/gmp/requests/next/_report_operating_systems.py,sha256=qN6-94OYKXGQQZ4q7RuRLtoaBduT500ocYb_-mIW5E0,1566
 gvm/protocols/gmp/requests/next/_report_ports.py,sha256=xTzdBFKqYHv1ulH1BduWEE-wO3SzuMu0yU7pnB5jx5E,1477
 gvm/protocols/gmp/requests/next/_report_tls_certificates.py,sha256=-h1d3OVn873DLEHHvjeLVpOpvErJo5C3u5tyxIrXUI8,1559
 gvm/protocols/gmp/requests/next/_report_vulnerabilities.py,sha256=8TOQm-CyaHtTOL1dXDUrFYEzuohdeSs_TeonCeVJJzg,1543
+gvm/protocols/gmp/requests/next/_scan_report.py,sha256=V31NDmrHusVgGCN3OJ7rVUvb8T5l4PUTBd9VQoJDzSE,1196
 gvm/protocols/gmp/requests/next/_targets.py,sha256=EIiYyPNrzflxjr3pmY0ZT25KSHn-ISERD3IfrzVauZI,12707
 gvm/protocols/gmp/requests/next/_tasks.py,sha256=4faG2a3wey9-fj-el4TiAwBUbu4H8M7EZ9WyO3SJ0QM,27016
 gvm/protocols/gmp/requests/next/_web_application_targets.py,sha256=03EYFVXKmVf0ZS_CTaXGsD-ALclSu9Hc2hm6p0LLV8o,6563
@@ -113,7 +115,7 @@ gvm/protocols/http/openvasd/_notus.py,sha256=FwX5fFsx-FWXf4Rl_5seequkQ6XVS8jZ0NW
 gvm/protocols/http/openvasd/_openvasd1.py,sha256=YhV-OJULO4XJJQTsvAyH1ZVc5r1mRmGk2VMotvOoIxg,3896
 gvm/protocols/http/openvasd/_scans.py,sha256=U8aYmHudMQFtVzl9khjNsRRewY0sf8G376zTYZN6HQQ,16667
 gvm/protocols/http/openvasd/_vts.py,sha256=_T4j4SdXe0DthBA7pCehx4FXKYbQyhzpq72YNO4fKt4,2136
-python_gvm-27.4.0.dist-info/METADATA,sha256=41bGzS_8lKwjTXcrkTeUvtEIIsIn3Gfkq6h50AaZbkI,5709
-python_gvm-27.4.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-python_gvm-27.4.0.dist-info/licenses/LICENSE,sha256=WJ7YI-moTFb-uVrFjnzzhGJrnL9P2iqQe8NuED3hutI,35141
-python_gvm-27.4.0.dist-info/RECORD,,
+python_gvm-27.6.0.dist-info/METADATA,sha256=s0Ez3Ltf4WZGKtH7SyYGaP9_cbXibtM9a_F2xLTWiXY,5696
+python_gvm-27.6.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+python_gvm-27.6.0.dist-info/licenses/LICENSE,sha256=WJ7YI-moTFb-uVrFjnzzhGJrnL9P2iqQe8NuED3hutI,35141
+python_gvm-27.6.0.dist-info/RECORD,,

{python_gvm-27.4.0.dist-info → python_gvm-27.6.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.30.1
+Generator: hatchling 1.31.0
 Root-Is-Purelib: true
 Tag: py3-none-any