ahvn.utils.deps module¶

Dependency management utilities for AgentHeaven.

This module is deprecated. Please use ahvn.utils.basic.deps_utils instead.

class ahvn.utils.deps.DependencyManager[source]¶

Bases: object

Clean dependency management system.

Return type:: DependencyManager

static __new__(cls)[source]¶

Singleton pattern.

Return type:: DependencyManager

__init__()[source]¶: Initialize the manager.

add(dep_info)[source]¶

Add a dependency.

Return type:: None
Parameters:: dep_info (DependencyInfo)

check(name)[source]¶

Check if a dependency is available.

Return type:: bool
Parameters:: name (str)

require(name, feature='')[source]¶

Require a dependency, raising error if missing.

Return type:

None

Parameters:

name (str)
feature (str)

list(filter_optional=None)[source]¶

List all dependencies.

Return type:: List[str]
Parameters:: filter_optional (bool | None)

missing()[source]¶

Get list of missing dependencies.

Return type:: List[str]

info(name)[source]¶

Get dependency information.

Return type:: Dict[str, Any]
Parameters:: name (str)

clear_cache()[source]¶

Clear dependency cache.

Return type:: None

load(module_name, package=None, error_msg=None)[source]¶

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

Parameters:

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.

Return type:

ModuleType

Returns:

The imported module.

Raises:

OptionalDependencyError – If the module cannot be imported.

exception ahvn.utils.deps.DependencyError[source]¶

Bases: Exception

Dependency-related error.

exception ahvn.utils.deps.OptionalDependencyError[source]¶

Bases: DependencyError, ImportError

Optional dependency not available.

class ahvn.utils.deps.DependencyInfo(name, packages, install, description, optional=True, required_for=None)[source]¶

Bases: object

Information about a dependency.

Parameters:

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__()[source]¶: Initialize default values.

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

Parameters:

name (str)
packages (List[str])
install (str)
description (str)
optional (bool)
required_for (List[str] | None)

Return type:

None

ahvn.utils.deps.get_default_dependencies()[source]¶

Get all default dependency definitions.

Return type:: dict