ModuleRegistry

class ase2sprkkr.common.module_registry.ModuleRegistry(package, attribute=None, *, aliases=None, include=None, factory=False)[source]

Lazily discover and load one named value from package modules.

Module names are discovered with pkgutil without importing the modules. Values are imported and materialized only when requested. Subclasses can customize extraction, validation and aliasing without duplicating discovery machinery.

Discovery and cache materialization are synchronized so concurrent first lookups observe the same cached objects. Module imports themselves remain outside the registry lock and rely on Python’s import synchronization.

attribute names the value exported by each registry module. Exported callables are returned unchanged unless factory=True is requested explicitly.

Class hierarchy

Inheritance diagram of ase2sprkkr.common.module_registry.ModuleRegistry


Constructor

__init__(package, attribute=None, *, aliases=None, include=None, factory=False)[source]
static normalize_name(name)[source]
_normalize_aliases(aliases)[source]
_validate_aliases(module_names)[source]
_discover_module_names()[source]
_load_module(name)[source]
value_from_module(name, module)[source]

Extract the registered value from a loaded module.

is_user_defined(module)[source]
prepare_value(name, module, value)[source]

Validate or transform a freshly loaded value.

alias_value(alias, value)[source]

Return the value exposed under alias.

_load_value(name)[source]
names(*, include_aliases=True, name_contains=None)[source]

Return discovered names without importing registry modules.

values(*, include_aliases=False, name_contains=None)[source]

Load and return registered values.

iter_valid_values(*, names=None, include_aliases=False, name_contains=None, condition=None)[source]

Load entries in an enumeration, warning and skipping invalid ones.

A direct lookup and values() remain strict. The optional names restrict which entries are materialized, preserving lazy lookup for filtered enumerations. Each failing entry is warned about at most once.

property modules

Import canonical registry modules without materializing values.