itwinai.utils

Utilities for itwinai package.

itwinai.utils.load_yaml(path: str) → Dict

Load YAML file as dict.

Parameters:

path (str) – path to YAML file.

Raises:

yaml.YAMLError – for loading/parsing errors.

Returns:

nested dict representation of parsed YAML file.

Return type:

Dict

itwinai.utils.dynamically_import_class(name: str) → Type

Dynamically import class by module path. Adapted from https://stackoverflow.com/a/547867

Parameters:

name (str) – path to the class (e.g., mypackage.mymodule.MyClass)

Returns:

class type.

Return type:

__class__

itwinai.utils.flatten_dict(d: MutableMapping, parent_key: str = '', sep: str = '.') → MutableMapping

Flatten dictionary

Parameters:

• d (MutableMapping) – nested dictionary to flatten

• parent_key (str, optional) – prefix for all keys. Defaults to ‘’.

• sep (str, optional) – separator for nested key concatenation. Defaults to ‘.’.

Returns:

flattened dictionary with new keys.

Return type:

MutableMapping

class itwinai.utils.SignatureInspector(func: Callable)

Bases: object

Provides the functionalities to inspect the signature of a function or a method.

Parameters:

func (Callable) – function to be inspected.

INFTY: int = 9223372036854775807

property has_varargs: bool

Checks if the function has *args parameter.

property has_kwargs: bool

Checks if the function has **kwargs parameter.

property required_params: Tuple[str]

Names of required parameters. Class method’s ‘self’ is skipped.

property min_params_num: int

Minimum number of arguments required.

property max_params_num: int

Max number of supported input arguments. If no limit, SignatureInspector.INFTY is returned.

itwinai.utils.str_to_slice(interval: str) → slice

Transform string interval to Python slice. Example: “1:17:3” -> slice(1,17,3)

Parameters:

interval (str) – interval to parse.

Raises:

ValueError – when interval is invalid.

Returns:

parsed slice.

Return type:

slice

itwinai.utils.clear_key(my_dict: Dict, dict_name: str, key: Hashable, complain: bool = True) → Dict

Remove key from dictionary if present and complain.

Parameters:

• my_dict (Dict) – Dictionary.

• dict_name (str) – name of the dictionary.

• key (Hashable) – Key to remove.