neutron_lib.utils.helpers module

neutron_lib.utils.helpers.camelize(s)

Camelize a str that uses _ as a camelize token.

Parameters:

s – The str to camelize that contains a _ at each index where a new camelized word starts.

Returns:

The camelized str.

neutron_lib.utils.helpers.compare_elements(a, b)

Compare elements if a and b have same elements.

This method doesn’t consider ordering.

Parameters:
  • a – The first item to compare.

  • b – The second item to compare.

Returns:

True if a and b have the same elements, False otherwise.

neutron_lib.utils.helpers.dict2str(dic)

Build a str representation of a dict.

Parameters:

dic – The dict to build a str representation for.

Returns:

The dict in str representation that is a k=v command list for each item in dic.

neutron_lib.utils.helpers.dict2tuple(d)

Build a tuple from a dict.

Parameters:

d – The dict to coherence into a tuple.

Returns:

The dict d in tuple form.

neutron_lib.utils.helpers.diff_list_of_dict(old_list, new_list)

Given 2 lists of dicts, return a tuple containing the diff.

Parameters:
  • old_list – The old list of dicts to diff.

  • new_list – The new list of dicts to diff.

Returns:

A tuple where the first item is a list of the added dicts in the diff and the second item is the removed dicts.

neutron_lib.utils.helpers.get_random_string(length)

Get a random hex string of the specified length.

Parameters:

length – The length for the hex string.

Returns:

A random hex string of the said length.

neutron_lib.utils.helpers.make_weak_ref(f)

Make a weak reference to a function accounting for bound methods.

Parameters:

f – The callable to make a weak ref for.

Returns:

A weak ref to f.

neutron_lib.utils.helpers.parse_mappings(mapping_list, unique_values=True, unique_keys=True)

Parse a list of mapping strings into a dictionary.

Parameters:
  • mapping_list – A list of strings of the form ‘<key>:<value>’.

  • unique_values – Values must be unique if True.

  • unique_keys – Keys must be unique if True, else implies that keys and values are not unique.

Returns:

A dict mapping keys to values or to list of values.

Raises:

ValueError – Upon malformed data or duplicate keys.

neutron_lib.utils.helpers.resolve_ref(ref)

Handles dereference of weakref.

Parameters:

ref – The weak ref to resolve.

Returns:

The resolved reference.

neutron_lib.utils.helpers.round_val(val)

Round the value.

Parameters:

val – The value to round.

Returns:

The value rounded using the half round up scheme.

neutron_lib.utils.helpers.safe_decode_utf8(s)

Safe decode a str from UTF.

Parameters:

s – The str to decode.

Returns:

The decoded str.

neutron_lib.utils.helpers.safe_sort_key(value)

Return value hash or build one for dictionaries.

Parameters:

value – The value to build a hash for.

Returns:

The value sorted.

neutron_lib.utils.helpers.str2dict(string)

Parse a str representation of a dict into its dict form.

This is the inverse of dict2str()

Parameters:

string – The string to parse.

Returns:

A dict constructed from the str representation in string.

neutron_lib.utils.helpers.timecost(f)