CLI Testing Framework Usage¶
The cli.base module¶
-
class
CLIClient
(username='', password='', tenant_name='', uri='', cli_dir='', insecure=False, prefix='', *args, **kwargs)[source]¶ Class to use OpenStack official python client CLI's with auth
Parameters: - username (string) -- The username to authenticate with
- password (string) -- The password to authenticate with
- tenant_name (string) -- The name of the tenant to use with the client calls
- uri (string) -- The auth uri for the OpenStack Deployment
- cli_dir (string) -- The path where the python client binaries are installed. defaults to /usr/bin
- insecure (boolean) -- if True, --insecure is passed to python client binaries.
- prefix (string) -- prefix to insert before commands
-
ceilometer
(action, flags='', params='', fail_ok=False, endpoint_type='publicURL', merge_stderr=False)[source]¶ Executes ceilometer command for the given action.
Parameters: - action (string) -- the cli command to run using ceilometer
- flags (string) -- any optional cli flags to use
- params (string) -- any optional positional args to use
- fail_ok (boolean) -- if True an exception is not raised when the cli return code is non-zero
- endpoint_type (string) -- the type of endpoint for the service
- merge_stderr (boolean) -- if True the stderr buffer is merged into stdout
-
cinder
(action, flags='', params='', fail_ok=False, endpoint_type='publicURL', merge_stderr=False)[source]¶ Executes cinder command for the given action.
Parameters: - action (string) -- the cli command to run using cinder
- flags (string) -- any optional cli flags to use
- params (string) -- any optional positional args to use
- fail_ok (boolean) -- if True an exception is not raised when the cli return code is non-zero
- endpoint_type (string) -- the type of endpoint for the service
- merge_stderr (boolean) -- if True the stderr buffer is merged into stdout
-
cmd_with_auth
(cmd, action, flags='', params='', fail_ok=False, merge_stderr=False)[source]¶ Executes given command with auth attributes appended.
Parameters: - cmd (string) -- command to be executed
- action (string) -- command on cli to run
- flags (string) -- optional cli flags to use
- params (string) -- optional positional args to use
- fail_ok (boolean) -- if True an exception is not raised when the cli return code is non-zero
- merge_stderr (boolean) -- if True the stderr buffer is merged into stdout
-
glance
(action, flags='', params='', fail_ok=False, endpoint_type='publicURL', merge_stderr=False)[source]¶ Executes glance command for the given action.
Parameters: - action (string) -- the cli command to run using glance
- flags (string) -- any optional cli flags to use
- params (string) -- any optional positional args to use
- fail_ok (boolean) -- if True an exception is not raised when the cli return code is non-zero
- endpoint_type (string) -- the type of endpoint for the service
- merge_stderr (boolean) -- if True the stderr buffer is merged into stdout
-
heat
(action, flags='', params='', fail_ok=False, endpoint_type='publicURL', merge_stderr=False)[source]¶ Executes heat command for the given action.
Parameters: - action (string) -- the cli command to run using heat
- flags (string) -- any optional cli flags to use
- params (string) -- any optional positional args to use
- fail_ok (boolean) -- if True an exception is not raised when the cli return code is non-zero
- endpoint_type (string) -- the type of endpoint for the service
- merge_stderr (boolean) -- if True the stderr buffer is merged into stdout
-
keystone
(action, flags='', params='', fail_ok=False, merge_stderr=False)[source]¶ Executes keystone command for the given action.
Parameters: - action (string) -- the cli command to run using keystone
- flags (string) -- any optional cli flags to use
- params (string) -- any optional positional args to use
- fail_ok (boolean) -- if True an exception is not raised when the cli return code is non-zero
- merge_stderr (boolean) -- if True the stderr buffer is merged into stdout
-
neutron
(action, flags='', params='', fail_ok=False, endpoint_type='publicURL', merge_stderr=False)[source]¶ Executes neutron command for the given action.
Parameters: - action (string) -- the cli command to run using neutron
- flags (string) -- any optional cli flags to use
- params (string) -- any optional positional args to use
- fail_ok (boolean) -- if True an exception is not raised when the cli return code is non-zero
- endpoint_type (string) -- the type of endpoint for the service
- merge_stderr (boolean) -- if True the stderr buffer is merged into stdout
-
nova
(action, flags='', params='', fail_ok=False, endpoint_type='publicURL', merge_stderr=False)[source]¶ Executes nova command for the given action.
Parameters: - action (string) -- the cli command to run using nova
- flags (string) -- any optional cli flags to use
- params (string) -- any optional positional args to use
- fail_ok (boolean) -- if True an exception is not raised when the cli return code is non-zero
- endpoint_type (string) -- the type of endpoint for the service
- merge_stderr (boolean) -- if True the stderr buffer is merged into stdout
-
nova_manage
(action, flags='', params='', fail_ok=False, merge_stderr=False)[source]¶ Executes nova-manage command for the given action.
Parameters: - action (string) -- the cli command to run using nova-manage
- flags (string) -- any optional cli flags to use
- params (string) -- any optional positional args to use
- fail_ok (boolean) -- if True an exception is not raised when the cli return code is non-zero
- merge_stderr (boolean) -- if True the stderr buffer is merged into stdout
-
openstack
(action, flags='', params='', fail_ok=False, merge_stderr=False)[source]¶ Executes openstack command for the given action.
Parameters: - action (string) -- the cli command to run using openstack
- flags (string) -- any optional cli flags to use
- params (string) -- any optional positional args to use
- fail_ok (boolean) -- if True an exception is not raised when the cli return code is non-zero
- merge_stderr (boolean) -- if True the stderr buffer is merged into stdout
-
sahara
(action, flags='', params='', fail_ok=False, endpoint_type='publicURL', merge_stderr=True)[source]¶ Executes sahara command for the given action.
Parameters: - action (string) -- the cli command to run using sahara
- flags (string) -- any optional cli flags to use
- params (string) -- any optional positional args to use
- fail_ok (boolean) -- if True an exception is not raised when the cli return code is non-zero
- endpoint_type (string) -- the type of endpoint for the service
- merge_stderr (boolean) -- if True the stderr buffer is merged into stdout
-
swift
(action, flags='', params='', fail_ok=False, endpoint_type='publicURL', merge_stderr=False)[source]¶ Executes swift command for the given action.
Parameters: - action (string) -- the cli command to run using swift
- flags (string) -- any optional cli flags to use
- params (string) -- any optional positional args to use
- fail_ok (boolean) -- if True an exception is not raised when the cli return code is non-zero
- endpoint_type (string) -- the type of endpoint for the service
- merge_stderr (boolean) -- if True the stderr buffer is merged into stdout
-
class
ClientTestBase
(*args, **kwargs)[source]¶ Base test class for testing the OpenStack client CLI interfaces.
-
execute
(cmd, action, flags='', params='', fail_ok=False, merge_stderr=False, cli_dir='/usr/bin', prefix='')[source]¶ Executes specified command for the given action.
Parameters: - cmd (string) -- command to be executed
- action (string) -- string of the cli command to run
- flags (string) -- any optional cli flags to use
- params (string) -- string of any optional positional args to use
- fail_ok (boolean) -- boolean if True an exception is not raised when the cli return code is non-zero
- merge_stderr (boolean) -- boolean if True the stderr buffer is merged into stdout
- cli_dir (string) -- The path where the cmd can be executed
- prefix (string) -- prefix to insert before command
The cli.output_parser module¶
Collection of utilities for parsing CLI clients output.
-
details
(output_lines, with_label=False)[source]¶ Return dict with details of first item (table) found in output.
-
details_multiple
(output_lines, with_label=False)[source]¶ Return list of dicts with item details from cli output tables.
If with_label is True, key '__label' is added to each items dict. For more about 'label' see OutputParser.tables().