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
pkgutilwithout 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.
attributenames the value exported by each registry module. Exported callables are returned unchanged unlessfactory=Trueis requested explicitly.Class hierarchy
Constructor
- names(*, include_aliases=True, name_contains=None)[source]
Return discovered names without importing registry modules.
- 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.