General Package Utility Functions

Utility functions useful for various package things like getting the signature matching

boa.utils.get_callable_signature(callable: Callable) → Signature

Parameters

callable (Callable) –

Return type

Signature

boa.utils.get_dictionary_matching_signature(signature: Signature, d: dict, match_private: bool = False, exclude_fields: Optional[list[str]] = None, accept_all_kwargs: bool = True) → dict

Parameters

• signature (Signature) –

• d (dict) –

• match_private (bool) –

• exclude_fields (Optional[list[str]]) –

• accept_all_kwargs (bool) –

Return type

dict

boa.utils.get_dictionary_from_callable(callable: Callable, d: dict, **kwargs) → dict

Parameters

• callable (Callable) –

• d (dict) –

Return type

dict

boa.utils.serialize_init_args(class_, *, parents: Optional[list[Type]] = None, match_private: bool = False, **kwargs)

Given an object, return a dictionary of the arguments that are needed by its constructor.

Parameters

• parents (Optional[list[Type]]) –

• match_private (bool) –

boa.utils.extract_init_args(args: dict[str, Any], class_: Type, *, parents: Optional[list[Type]] = None, match_private: bool = False, **kwargs) → dict[str, Any]

Given a dictionary, extract the arguments required for the given class’s constructor.

Parameters

• args (dict[str, Any]) –

• class_ (Type) –

• parents (Optional[list[Type]]) –

• match_private (bool) –

Return type

dict[str, Any]

boa.utils.torch_device()

boa.utils.convert_type(maybe_iterable, conversion: dict, new_dict: Optional[dict] = None)

Parameters

• conversion (dict) –

• new_dict (Optional[dict]) –

boa.utils.deprecation(message, version_to_remove=None)

class boa.utils.StrEnum(value)

Bases: str, Enum

Enum where members are also (and must be) strings

classmethod from_str_or_enum(value: Union[str, StrEnum]) → StrEnum

Parameters

value (Union[str, StrEnum]) –

Return type

StrEnum