4.6.2. pde.tools.config module

Handles configuration variables of the package

Config

class handling the package configuration

get_package_versions

tries to load certain python packages and returns their version

parse_version_str

helper function converting a version string into a list of integers

check_package_version

checks whether a package has a sufficient version

packages_from_requirements

read package names from a requirements file

environment

obtain information about the compute environment

class Config(items=None, mode='update')[source]

Bases: UserDict

class handling the package configuration

Parameters
  • items (dict, optional) – Configuration values that should be added or overwritten to initialize the configuration.

  • mode (str) –

    Defines the mode in which the configuration is used. Possible values are

    • insert: any new configuration key can be inserted

    • update: only the values of pre-existing items can be updated

    • locked: no values can be changed

    Note that the items specified by items will always be inserted, independent of the mode.

to_dict()[source]

convert the configuration to a simple dictionary

Returns

A representation of the configuration in a normal dict.

Return type

dict

check_package_version(package_name, min_version)[source]

checks whether a package has a sufficient version

Parameters
  • package_name (str) –

  • min_version (str) –

environment()[source]

obtain information about the compute environment

Returns

information about the python installation and packages

Return type

dict

get_package_versions(packages, *, na_str='not available')[source]

tries to load certain python packages and returns their version

Parameters
  • packages (list) – The names of all packages

  • na_str (str) – Text to return if package is not available

Returns

Dictionary with version for each package name

Return type

dict

packages_from_requirements(requirements_file)[source]

read package names from a requirements file

Parameters

requirements_file (str or Path) – The file from which everything is read

Returns

list of package names

Return type

List[str]

parse_version_str(ver_str)[source]

helper function converting a version string into a list of integers

Parameters

ver_str (str) –

Return type

List[int]