Releases: greenbone/python-gvm
Releases · greenbone/python-gvm
python-gvm 1.0.0.beta2
Changes
gvm.protocols.base
- Fix: Don't close the connection after each send/read command sequence
automatically. This fixes sending more then one privileged gmp command after
authentication.
gvm.protocols.gmpv7
- Fixed generating XML for help command
- help method type argument got renamed to help_type
- help method help_type argument will be checked for invalid values
- Fixed wrong order of key and value for condition_data, event_data and
method_data dict parameters of create_alert method. - create_credential requires a credential_type argument now.
- Optional parameters are required to be passed as keyword arguments.
- Fixed get_reports sending the wrong protocol command
- Removed format_id argument from get_reports
- get_report method format_id argument got renamed to
report_format_id - Removed alert_id argument from get_reports
- Added new trigger_alert method for triggering an alert method on a
specific report. - Fixed create_permission method
- Check if scanner_type is one of '1' (OSP Scanner) or '2' (OpenVAS Scanner) in
create_scanner method. - Fixed get_config sending the correct protocol command.
- Added import_config method to import a scan config from xml.
gvm.xml
- Added helper function to validate xml input gvm.xml.validate_xml_string
- pretty_print accepts a xml string as input too
gvm.connections
- Optional arguments for connection class constructors must be passed as
keyword arguments. - Add finish_send method to connections. The method allows to indicate to
the server sending data is finished and no additional data has to be received. - Don't crash if huge content is returned in a xml response. This fixes e.g.
get_reports for bigger report data. - It's possible to wait indefinitely by deactivating the timeouts via passing
None as timeout argument to the connection class constructors now. - Removed unused read_timeout argument from UnixSocketConnection
python-gvm 1.0.0.beta1
This is the first release of python-gvm.
python-gvm was a part of gvm-tools prior version 2.0. It got extracted from gvm-tools and completely overhauled.
Some notable changes are:
- The package name changed from gmp to gvm.
- The type of connection is passed to a more generic Gmp class instead of
having to select the connection when creating the gmp object. - Support for different protocols and versions has been added. Currently
supported protocols are OSP v1 and GMP v7. - Full API documentation is available at https://python-gvm.readthedocs.io/en/latest/.
- Possible arguments to protocol methods are documented.
- Arguments should be passed as keywords
Gmp API changes
- create_report has been renamed to import_report.
- Requesting single entities has been extracted from the list commands e.g.
get_task(task_id) instead of get_tasks(task_id=task_id). - get_info requests a single info entity.
- get_info_list requests a list of info entities.
- filt_id argument is called filter_id at all Gmp methods.
- report_filter argument for get_reports got renamed to filter.
report_filt_id is filter_id now. - create_schedule start_time and end_time arguments got split into
several parameters. - Plural arguments like hosts, users, ... always require a list now.
- create_alert event, condition and method arguments got
revised and split. - boolean parameters expect True and False and not 1, 0, '1' or '0' now.
- get_assets type parameter got renamed to asset_type
- Copying an entity via the copy argument has been removed and extracted to
own clone methods e.g. clone_task.