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)¶