Merge pull request #470 from y0urself/detach-rest

[Refactor python-gvm API] Step 2: Detach ReportFormat, Ticket, Roles

.coveragerc

@@ -1,5 +1,6 @@
 # Configuration for coverage.py
 [run]
+branch = True
 omit =
     tests/*
     */__init__.py

CHANGELOG.md

@@ -13,6 +13,10 @@ and this project adheres to [Calendar Versioning](https://calver.org)html).
 * Introduced new explicit API calls for SecInfo: `get_nvt()`, `get_nvt_list()`, `get_cpe()`, `get_cpe_list()`, `get_cve()`, `get_cve_list()`, `get_cert_bund_advisory()`, `get_cert_bund_advisory_list()`, `get_dnf_cert_advisory()`, `get_dnf_cert_advisory_list()`, `get_oval_definition()`, `get_oval_definition_list()`. [#456](https://github.com/greenbone/python-gvm/pull/456)
 
 ### Changed
+* Changed `filter` to `filter_string` in getter functions. [#470](https://github.com/greenbone/python-gvm/pull/470)
+* Detached the ReportFormats API calls from the GMP class into a new `ReportFormatsMixin`. [#470](https://github.com/greenbone/python-gvm/pull/470)
+* Detached the Roles API calls from the GMP class into a new `RolesMixin`. [#470](https://github.com/greenbone/python-gvm/pull/470)
+* Detached the Tickets API calls from the GMP class into a new `TicketsMixin`. [#470](https://github.com/greenbone/python-gvm/pull/470)
 * Detached the HostsOrdering Type from the GMP types class. [#469](https://github.com/greenbone/python-gvm/pull/469)
 * Detached the TicketStatus Type from the GMP types class. [#469](https://github.com/greenbone/python-gvm/pull/469)
 * Detached the Schedules API calls from the GMP class into a new `SchedulesMixin`. [#469](https://github.com/greenbone/python-gvm/pull/469)

gvm/protocols/gmpv208/__init__.py

@@ -95,8 +95,10 @@
 from gvm.protocols.gmpv208.entities.results import ResultsMixin
 from gvm.protocols.gmpv208.entities.report_formats import (
     ReportFormatType,
+    ReportFormatsMixin,
     get_report_format_id_from_string,
 )
+from gvm.protocols.gmpv208.entities.roles import RolesMixin
 from gvm.protocols.gmpv208.entities.scan_configs import ScanConfigsMixin
 from gvm.protocols.gmpv208.entities.scanners import (
     ScannersMixin,
@@ -121,6 +123,7 @@
 )
 from gvm.protocols.gmpv208.entities.tasks import TasksMixin
 from gvm.protocols.gmpv208.entities.tickets import (
+    TicketsMixin,
     TicketStatus,
     get_ticket_status_from_string,
 )
@@ -150,11 +153,14 @@ class Gmp(
     PermissionsMixin,
     PoliciesMixin,
     PortListMixin,
+    ReportFormatsMixin,
     ReportsMixin,
     ResultsMixin,
+    RolesMixin,
     TagsMixin,
     TargetsMixin,
     TasksMixin,
+    TicketsMixin,
     TLSCertificateMixin,
     ScanConfigsMixin,
     ScannersMixin,

gvm/protocols/gmpv208/entities/audits.py

@@ -132,9 +132,15 @@ def create_audit(
                 )
             cmd.add_element("hosts_ordering", hosts_ordering.value)
 
-        if alert_ids:
-            if is_list_like(alert_ids):
-                # parse all given alert id's
+        if alert_ids is not None:
+            if not is_list_like(alert_ids):
+                raise InvalidArgumentType(
+                    function=self.modify_task.__name__,
+                    argument='alert_ids',
+                    arg_type='list',
+                )
+
+            if not len(alert_ids) == 0:
                 for alert in alert_ids:
                     cmd.add_element("alert", attrs={"id": str(alert)})
 
@@ -204,7 +210,7 @@ def delete_audit(
     def get_audits(
         self,
         *,
-        filter: Optional[str] = None,
+        filter_string: Optional[str] = None,
         filter_id: Optional[str] = None,
         trash: Optional[bool] = None,
         details: Optional[bool] = None,
@@ -213,7 +219,7 @@ def get_audits(
         """Request a list of audits
 
         Arguments:
-            filter: Filter term to use for the query
+            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 audits instead
             details: Whether to include full audit details
@@ -226,7 +232,7 @@ def get_audits(
         cmd = XmlCommand("get_tasks")
         cmd.set_attribute("usage_type", "audit")
 
-        add_filter(cmd, filter, filter_id)
+        add_filter(cmd, filter_string, filter_id)
 
         if trash is not None:
             cmd.set_attribute("trash", to_bool(trash))

gvm/protocols/gmpv208/entities/filter.py

@@ -16,8 +16,6 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# pylint:  disable=redefined-builtin
-
 from enum import Enum
 from typing import Any, Optional
 
@@ -175,15 +173,15 @@ def delete_filter(
     def get_filters(
         self,
         *,
-        filter: Optional[str] = None,
+        filter_string: Optional[str] = None,
         filter_id: Optional[str] = None,
         trash: Optional[bool] = None,
         alerts: Optional[bool] = None,
     ) -> Any:
         """Request a list of filters
 
         Arguments:
-            filter: Filter term to use for the query
+            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 filters instead
             alerts: Whether to include list of alerts that use the filter.
@@ -193,7 +191,7 @@ def get_filters(
         """
         cmd = XmlCommand("get_filters")
 
-        add_filter(cmd, filter, filter_id)
+        add_filter(cmd, filter_string, filter_id)
 
         if trash is not None:
             cmd.set_attribute("trash", to_bool(trash))

gvm/protocols/gmpv208/entities/port_lists.py

@@ -207,7 +207,7 @@ def delete_port_range(self, port_range_id: str) -> Any:
     def get_port_lists(
         self,
         *,
-        filter: Optional[str] = None,
+        filter_string: Optional[str] = None,
         filter_id: Optional[str] = None,
         details: Optional[bool] = None,
         targets: Optional[bool] = None,
@@ -216,7 +216,7 @@ def get_port_lists(
         """Request a list of port lists
 
         Arguments:
-            filter: Filter term to use for the query
+            filter_string: Filter term to use for the query
             filter_id: UUID of an existing filter to use for the query
             details: Whether to include full port list details
             targets: Whether to include targets using this port list
@@ -227,7 +227,7 @@ def get_port_lists(
         """
         cmd = XmlCommand("get_port_lists")
 
-        add_filter(cmd, filter, filter_id)
+        add_filter(cmd, filter_string, filter_id)
 
         if details is not None:
             cmd.set_attribute("details", to_bool(details))