| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758 |
- """pm: the hermes package system.
- Everything hermes depends on — tool binaries, the python venv, node_modules
- dirs, plugins — is a package in one dependency tree. Package definitions
- (pm/packages.py) say what a package IS. The lockfile (pm/lock.json,
- machine-written) says exactly which versions and hashes. The installed-state
- file (facts.json, per install) says what is actually on this machine.
- ensure(name) makes the installed state match the lockfile and returns a
- Runner with the composed environment. env_for(*names) composes already-installed
- packages' env without installing anything.
- The facade resolves lazily (PEP 562): ``pm.environments`` runs at process boot,
- before any dependency is importable, and must not drag the downloader/ensure
- machinery in with it.
- """
- from __future__ import annotations
- import sys
- _EXPORTS = {
- "pm.install": (
- "activate", "check", "drift", "enabled_extras", "env_for", "is_installed",
- "installed_package", "lazy_installs_allowed", "store_first_path", "uv_launcher",
- ),
- "pm.client": (
- "ensure", "sync_venv", "build_environment", "lock_project", "stage_manager_runtime",
- "ensure_environment", "ensure_project_environment", "ensure_python_tool", "venv_is_current", "check_project_lock",
- "export_requirements", "build_requirements_environment", "prune_cache", "stage_tools",
- "prepare_tools",
- ),
- "pm.operations": ("environment_python", "python_tool"),
- "pm.extras": ("available", "ensure_import", "install_hint"),
- "pm.lock": ("Facts", "Lockfile"),
- "pm.package": ("InstallError", "Package", "Runner", "compose_env"),
- "pm.registry": ("all_packages", "get_package", "register", "walk"),
- "pm.store": ("Store", "current_target"),
- }
- _HOME = {name: module for module, names in _EXPORTS.items() for name in names}
- __all__ = list(_HOME)
- def __getattr__(name: str):
- module = _HOME.get(name)
- if module is None:
- raise AttributeError(f"module 'pm' has no attribute {name!r}")
- # Not importlib.import_module: tests patch that globally and the facade must keep resolving.
- __import__(module)
- value = getattr(sys.modules[module], name)
- globals()[name] = value
- return value
- def __dir__():
- return sorted(set(globals()) | set(_HOME))
|