python-gvm 27.0.2__tar.gz → 27.1.0__tar.gz

{python_gvm-27.0.2 → python_gvm-27.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-gvm
-Version: 27.0.2
+Version: 27.1.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/

{python_gvm-27.0.2 → python_gvm-27.1.0}/gvm/__version__.py

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

{python_gvm-27.0.2 → python_gvm-27.1.0}/gvm/protocols/gmp/_gmpnext.py

@@ -19,6 +19,14 @@ from .requests.next import (
     CredentialStores,
     IntegrationConfigs,
     OCIImageTargets,
+    ReportApplications,
+    ReportClosedCVEs,
+    ReportCVEs,
+    ReportErrors,
+    ReportHosts,
+    ReportOperatingSystems,
+    ReportPorts,
+    ReportTlsCertificates,
     Tasks,
 )
 from .requests.v224 import HostsOrdering
@@ -992,3 +1000,237 @@ class GMPNext(GMPv227[T]):
                 oidc_provider_client_secret=oidc_provider_client_secret,
             )
         )
+
+    def get_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 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_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,
+        *,
+        filter_string: str | None = None,
+        filter_id: str | None = None,
+        ignore_pagination: bool | None = None,
+        details: bool | None = True,
+    ) -> T:
+        """Request operating systems of a single 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 operating system information details.
+                Defaults to True.
+        """
+        return self._send_request_and_transform_response(
+            ReportOperatingSystems.get_report_operating_systems(
+                report_id=report_id,
+                filter_string=filter_string,
+                filter_id=filter_id,
+                ignore_pagination=ignore_pagination,
+                details=details,
+            )
+        )
+
+    def get_report_ports(
+        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 ports of a single 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 port information details.
+                Defaults to True.
+        """
+        return self._send_request_and_transform_response(
+            ReportPorts.get_report_ports(
+                report_id=report_id,
+                filter_string=filter_string,
+                filter_id=filter_id,
+                ignore_pagination=ignore_pagination,
+                details=details,
+            )
+        )
+
+    def get_report_tls_certificates(
+        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 TLS certificates of a single 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 TLS certificate information details.
+                Defaults to True.
+        """
+        return self._send_request_and_transform_response(
+            ReportTlsCertificates.get_report_tls_certificates(
+                report_id=report_id,
+                filter_string=filter_string,
+                filter_id=filter_id,
+                ignore_pagination=ignore_pagination,
+                details=details,
+            )
+        )
+
+    def get_report_applications(
+        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 applications of a single 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 application information details.
+                Defaults to True.
+        """
+        return self._send_request_and_transform_response(
+            ReportApplications.get_report_applications(
+                report_id=report_id,
+                filter_string=filter_string,
+                filter_id=filter_id,
+                ignore_pagination=ignore_pagination,
+                details=details,
+            )
+        )
+
+    def get_report_cves(
+        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 CVEs of a single 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 CVE information details.
+                Defaults to True.
+        """
+        return self._send_request_and_transform_response(
+            ReportCVEs.get_report_cves(
+                report_id=report_id,
+                filter_string=filter_string,
+                filter_id=filter_id,
+                ignore_pagination=ignore_pagination,
+                details=details,
+            )
+        )
+
+    def get_report_closed_cves(
+        self,
+        report_id: EntityID,
+        *,
+        ignore_pagination: bool | None = None,
+        details: bool | None = True,
+    ) -> T:
+        """Request closed CVEs of a single report.
+
+        Args:
+            report_id: UUID of an existing report.
+            ignore_pagination: Whether to ignore the filter terms "first" and
+                "rows".
+            details: Request additional report closed CVE information details.
+                Defaults to True.
+        """
+        return self._send_request_and_transform_response(
+            ReportClosedCVEs.get_report_closed_cves(
+                report_id=report_id,
+                ignore_pagination=ignore_pagination,
+                details=details,
+            )
+        )
+
+    def get_report_errors(
+        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 errors of a single 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 error information details.
+                Defaults to True.
+        """
+        return self._send_request_and_transform_response(
+            ReportErrors.get_report_errors(
+                report_id=report_id,
+                filter_string=filter_string,
+                filter_id=filter_id,
+                ignore_pagination=ignore_pagination,
+                details=details,
+            )
+        )

{python_gvm-27.0.2 → python_gvm-27.1.0}/gvm/protocols/gmp/requests/next/__init__.py

@@ -14,6 +14,30 @@ from gvm.protocols.gmp.requests.next._integration_configs import (
     IntegrationConfigs,
 )
 from gvm.protocols.gmp.requests.next._oci_image_targets import OCIImageTargets
+from gvm.protocols.gmp.requests.next._report_applications import (
+    ReportApplications,
+)
+from gvm.protocols.gmp.requests.next._report_closed_cves import (
+    ReportClosedCVEs,
+)
+from gvm.protocols.gmp.requests.next._report_cves import (
+    ReportCVEs,
+)
+from gvm.protocols.gmp.requests.next._report_errors import (
+    ReportErrors,
+)
+from gvm.protocols.gmp.requests.next._report_hosts import (
+    ReportHosts,
+)
+from gvm.protocols.gmp.requests.next._report_operating_systems import (
+    ReportOperatingSystems,
+)
+from gvm.protocols.gmp.requests.next._report_ports import (
+    ReportPorts,
+)
+from gvm.protocols.gmp.requests.next._report_tls_certificates import (
+    ReportTlsCertificates,
+)
 from gvm.protocols.gmp.requests.next._tasks import Tasks
 
 from .._entity_id import EntityID
@@ -132,10 +156,18 @@ __all__ = (
     "Policies",
     "PortLists",
     "PortRangeType",
+    "ReportApplications",
+    "ReportCVEs",
+    "ReportClosedCVEs",
     "ReportConfigParameter",
     "ReportConfigs",
+    "ReportErrors",
     "ReportFormatType",
     "ReportFormats",
+    "ReportHosts",
+    "ReportOperatingSystems",
+    "ReportPorts",
+    "ReportTlsCertificates",
     "Reports",
     "ResourceNames",
     "ResourceType",

python_gvm-27.1.0/gvm/protocols/gmp/requests/next/_report_applications.py

@@ -0,0 +1,47 @@
+from gvm.errors import RequiredArgument
+from gvm.protocols.core import Request
+from gvm.protocols.gmp.requests import EntityID
+from gvm.utils import to_bool
+from gvm.xml import XmlCommand
+
+
+class ReportApplications:
+    @classmethod
+    def get_report_applications(
+        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 applications of a single 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 applications information details.
+                Defaults to True.
+        """
+        cmd = XmlCommand("get_report_applications")
+
+        if not report_id:
+            raise RequiredArgument(
+                function=cls.get_report_applications.__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

python_gvm-27.1.0/gvm/protocols/gmp/requests/next/_report_closed_cves.py

@@ -0,0 +1,41 @@
+from gvm.errors import RequiredArgument
+from gvm.protocols.core import Request
+from gvm.protocols.gmp.requests import EntityID
+from gvm.utils import to_bool
+from gvm.xml import XmlCommand
+
+
+class ReportClosedCVEs:
+    @classmethod
+    def get_report_closed_cves(
+        cls,
+        report_id: EntityID,
+        *,
+        ignore_pagination: bool | None = None,
+        details: bool | None = True,
+    ) -> Request:
+        """Request closed CVEs of a single report.
+
+        Args:
+            report_id: UUID of an existing report.
+            ignore_pagination: Whether to ignore the filter terms "first" and
+                "rows".
+            details: Request additional report closed CVE information details.
+                Defaults to True.
+        """
+        cmd = XmlCommand("get_report_closed_cves")
+
+        if not report_id:
+            raise RequiredArgument(
+                function=cls.get_report_closed_cves.__name__,
+                argument="report_id",
+            )
+
+        cmd.set_attribute("report_id", str(report_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

python_gvm-27.1.0/gvm/protocols/gmp/requests/next/_report_cves.py

@@ -0,0 +1,46 @@
+from gvm.errors import RequiredArgument
+from gvm.protocols.core import Request
+from gvm.protocols.gmp.requests import EntityID
+from gvm.utils import to_bool
+from gvm.xml import XmlCommand
+
+
+class ReportCVEs:
+    @classmethod
+    def get_report_cves(
+        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 CVEs of a single 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 CVE information details.
+                Defaults to True.
+        """
+        cmd = XmlCommand("get_report_cves")
+
+        if not report_id:
+            raise RequiredArgument(
+                function=cls.get_report_cves.__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

python_gvm-27.1.0/gvm/protocols/gmp/requests/next/_report_errors.py

@@ -0,0 +1,46 @@
+from gvm.errors import RequiredArgument
+from gvm.protocols.core import Request
+from gvm.protocols.gmp.requests import EntityID
+from gvm.utils import to_bool
+from gvm.xml import XmlCommand
+
+
+class ReportErrors:
+    @classmethod
+    def get_report_errors(
+        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 errors of a single 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 error information details.
+                Defaults to True.
+        """
+        cmd = XmlCommand("get_report_errors")
+
+        if not report_id:
+            raise RequiredArgument(
+                function=cls.get_report_errors.__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

python_gvm-27.1.0/gvm/protocols/gmp/requests/next/_report_hosts.py

@@ -0,0 +1,46 @@
+from gvm.errors import RequiredArgument
+from gvm.protocols.core import Request
+from gvm.protocols.gmp.requests import EntityID
+from gvm.utils import to_bool
+from gvm.xml import XmlCommand
+
+
+class ReportHosts:
+    @classmethod
+    def get_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 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_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

python_gvm-27.1.0/gvm/protocols/gmp/requests/next/_report_operating_systems.py

@@ -0,0 +1,47 @@
+from gvm.errors import RequiredArgument
+from gvm.protocols.core import Request
+from gvm.protocols.gmp.requests import EntityID
+from gvm.utils import to_bool
+from gvm.xml import XmlCommand
+
+
+class ReportOperatingSystems:
+    @classmethod
+    def get_report_operating_systems(
+        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 operating systems of a single 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 operating systems information details.
+                Defaults to True.
+        """
+        cmd = XmlCommand("get_report_operating_systems")
+
+        if not report_id:
+            raise RequiredArgument(
+                function=cls.get_report_operating_systems.__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

python_gvm-27.1.0/gvm/protocols/gmp/requests/next/_report_ports.py

@@ -0,0 +1,46 @@
+from gvm.errors import RequiredArgument
+from gvm.protocols.core import Request
+from gvm.protocols.gmp.requests import EntityID
+from gvm.utils import to_bool
+from gvm.xml import XmlCommand
+
+
+class ReportPorts:
+    @classmethod
+    def get_report_ports(
+        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 ports of a single 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 port information details.
+                Defaults to True.
+        """
+        cmd = XmlCommand("get_report_ports")
+
+        if not report_id:
+            raise RequiredArgument(
+                function=cls.get_report_ports.__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

python_gvm-27.1.0/gvm/protocols/gmp/requests/next/_report_tls_certificates.py

@@ -0,0 +1,47 @@
+from gvm.errors import RequiredArgument
+from gvm.protocols.core import Request
+from gvm.protocols.gmp.requests import EntityID
+from gvm.utils import to_bool
+from gvm.xml import XmlCommand
+
+
+class ReportTlsCertificates:
+    @classmethod
+    def get_report_tls_certificates(
+        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 TLS certificates of a single 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 TLS certificate information details.
+                Defaults to True.
+        """
+        cmd = XmlCommand("get_report_tls_certificates")
+
+        if not report_id:
+            raise RequiredArgument(
+                function=cls.get_report_tls_certificates.__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