novaclient.utils module

novaclient.utils.add_arg(func, *args, **kwargs)

Bind CLI arguments to a shell.py do_foo function.

novaclient.utils.arg(*args, **kwargs)

Decorator for CLI args.

Example:

>>> @arg("name", help="Name of the new entity")
... def entity_create(args):
...     pass
novaclient.utils.do_action_on_many(action, resources, success_msg, error_msg)

Helper to run an action on many resources.

novaclient.utils.env(*args, **kwargs)

Returns the first environment variable set.

If all are empty, defaults to ‘’ or keyword arg default.

novaclient.utils.find_resource(manager, name_or_id, wrap_exception=True, **find_args)

Helper for the _find_* methods.

novaclient.utils.flatten_dict(data)

Return a new dict whose sub-dicts have been merged into the original. Each of the parents keys are prepended to the child’s to prevent collisions. Any string elements will be JSON parsed before flattening.

>>> flatten_dict({'service': {'host':'cloud9@compute-068', 'id': 143}})
{'service_host': colud9@compute-068', 'service_id': 143}
novaclient.utils.format_security_groups(groups)
novaclient.utils.format_servers_list_networks(server)
novaclient.utils.get_service_type(f)

Retrieves service type from function.

novaclient.utils.get_url_with_filter(url, filters)
novaclient.utils.is_integer_like(val)

Returns validation of a value as an integer.

novaclient.utils.isunauthenticated(func)

Checks if the function does not require authentication.

Mark such functions with the @unauthenticated decorator.

Returns

bool

novaclient.utils.make_field_formatter(attr, filters=None)

Given an object attribute, return a formatted field name and a formatter suitable for passing to print_list.

Optionally pass a dict mapping attribute names to a function. The function will be passed the value of the attribute and should return the string to display.

novaclient.utils.prepare_query_string(params)

Convert dict params to query string

novaclient.utils.pretty_choice_dict(values)

Returns a formatted dict as ‘key=value’.

novaclient.utils.pretty_choice_list(values)
novaclient.utils.print_dict(d, dict_property='Property', dict_value='Value', wrap=0)
novaclient.utils.print_list(objs, fields, formatters={}, sortby_index=None)
novaclient.utils.record_time(times, enabled, *args)

Record the time of a specific action.

Parameters
  • times – A list of tuples holds time data.

  • enabled – Whether timing is enabled.

  • args – Other data to be stored besides time data, these args will be joined to a string.

novaclient.utils.safe_issubclass(*args)

Like issubclass, but will just return False if not a class.

novaclient.utils.service_type(stype)

Adds ‘service_type’ attribute to decorated function.

Usage:

@service_type('volume')
def mymethod(f):
...
novaclient.utils.unauthenticated(func)

Adds ‘unauthenticated’ attribute to decorated function.

Usage:

>>> @unauthenticated
... def mymethod(f):
...     pass
novaclient.utils.validate_flavor_metadata_keys(keys)