ahvn.utils.basic.deps_utils module

Dependency management and lazy loading utilities.

This module provides a clean, industrial-standard dependency management system and utilities for lazy loading modules.

class ahvn.utils.basic.deps_utils.DependencyManager

基类：object

Clean dependency management system.

返回类型:

DependencyManager

static __new__(cls)

Singleton pattern.

返回类型:

DependencyManager

__init__()

Initialize the manager.

add(dep_info)

Add a dependency.

返回类型:

None

参数:

dep_info (DependencyInfo)

check(name)

Check if a dependency is available.

返回类型:

bool

参数:

name (str)

require(name, feature='')

Require a dependency, raising error if missing.

返回类型:

None

参数:

• name (str)

• feature (str)

list(filter_optional=None)

List all dependencies.

返回类型:

List[str]

参数:

filter_optional (bool | None)

missing()

Get list of missing dependencies.

返回类型:

List[str]

info(name)

Get dependency information.

返回类型:

Dict[str, Any]

参数:

name (str)

clear_cache()

Clear dependency cache.

返回类型:

None

load(module_name, package=None, error_msg=None)

Import an optional dependency, raising a clear error if missing.

参数:

• module_name (str) -- The python module name to import (e.g. "pandas")

• package (Optional[str]) -- The pip package name (e.g. "pandas"). Defaults to module_name.

• error_msg (Optional[str]) -- Custom error message. If None, generates a standard one.

返回类型:

ModuleType

返回:

The imported module.

抛出:

OptionalDependencyError -- If the module cannot be imported.

exception ahvn.utils.basic.deps_utils.DependencyError

基类：Exception

Dependency-related error.

exception ahvn.utils.basic.deps_utils.OptionalDependencyError

基类：DependencyError, ImportError

Optional dependency not available.

ahvn.utils.basic.deps_utils.lazy_getattr(name, export_map, package)

Helper function to implement __getattr__ for lazy loading modules.

参数:

• name (str) -- The attribute name being accessed.

• export_map (Dict[str, str]) -- A dictionary mapping attribute names to relative module paths (e.g., { "MyClass": ".my_module" }).

• package (str) -- The package name (usually __name__ of the calling module).

返回:

The requested attribute from the imported module.

抛出:

AttributeError -- If the name is not in the export_map.

ahvn.utils.basic.deps_utils.collect_exports(package_names, parent_package)

Collects exported names from a list of subpackages to build a master lazy map.

参数:

• package_names (List[str]) -- List of relative package names (e.g., ["klstore", "klengine"]).

• parent_package (str) -- The parent package name (usually __name__).

返回:

".klstore" }).

返回类型:

A dictionary mapping exported names to their relative package path (e.g., { "DatabaseKLStore"

ahvn.utils.basic.deps_utils.lazy_import_submodules(name, submodules, package)

Helper function to lazy load submodules.

参数:

• name (str) -- The attribute name being accessed.

• submodules (List[str]) -- List of submodule names (relative).

• package (str) -- The package name.

返回:

The imported module or None.

class ahvn.utils.basic.deps_utils.DependencyInfo(name, packages, install, description, optional=True, required_for=None)

基类：object

Information about a dependency.

参数:

• name (str)

• packages (List[str])

• install (str)

• description (str)

• optional (bool)

• required_for (List[str] | None)

name: str

packages: List[str]

install: str

description: str

optional: bool = True

required_for: List[str] | None = None

__post_init__()

Initialize default values.

__init__(name, packages, install, description, optional=True, required_for=None)

参数:

• name (str)

• packages (List[str])

• install (str)

• description (str)

• optional (bool)

• required_for (List[str] | None)

返回类型:

None

ahvn.utils.basic.deps_utils.get_default_dependencies()

Get all default dependency definitions.

返回类型:

dict