Create a new lock object. :param lock_file: path to the file :param timeout: default timeout when acquiring the lock, in sec

Initialize the registry. Args: omnipkg_home: Path to the omnipkg home directory (usually ~/.omnipkg)

Initialize the verification strategy. Args: parent_omnipkg: The main OmnipkgCore instance gatherer: omnipkgM

Add only specific non-conflicting packages from main environment.

Attempt to automatically heal a broken bubble installation.

Return True if outer_spec's bubble bundles inner_name.

Determine if bubble needs access to main site-packages for dependencies.

Build glibc with custom prefix.

Build libpng with custom prefix.

Build OpenSSL with custom prefix.

Build zlib with custom prefix.

Produce a stable canonical string for identity-sensitive path hashing and comparisons across platforms. - resolves when possible - n

### THE DEFINITIVE INSTANCE-AWARE FIX ### Checks if a list of requirements is satisfied by searching for ANY valid, non-neste

Parses the raw dependency JSON, filters out noise, and formats it for humans.

Clean up symlinks created for omnipkg dependencies in the bubble.

Scans for and REMOVES any bubbles from the filesystem that are identical to the currently active version of a package. NOW A

Surgically removes all traces of a single, specific version of a package from the Redis knowledge base.

Windows-specific: Clear cached modules that might cause import conflicts. This helps prevent "ImportError: cannot import name 'text_

Temporarily renames the main environment installation of a package.

(CORRECTED) Gets omnipkg's dependency paths, using a class-level cache to ensure the expensive detection runs only once per session.

Installs a MINIMAL copy of just the Python interpreter (not the entire venv). Uses the system Python as a base but copies only what's

Creates a proper shell script executable that forces the use of the new Python interpreter.

Creates a snapshot before installing a package. Returns the snapshot key for latLiteCacheCliener restoration.

Creates a bubble by downloading ONLY from PyPI, never from local source. This ensures upgrade bubbles contain the actual PyPI version

Connects to the daemon to handle this package spec.

Comprehensive change detection that catches EVERYTHING pip does. Returns dict with: - downgrades: List of {package, old_

Analyze if activating this bubble would cause C++ extension conflicts. Returns True if collision is likely.

Detects the likely shell name for display purposes.

Identifies packages that were upgraded.

Identifies packages that were replaced (uninstalled and a new version installed). This is different from a simple upgrade/downgrade l

Surgically patch the Rust SITE_PACKAGES_CACHE with the accumulated delta. Now logs exactly which files triggered the event and ignore

Ask uv to resolve what would be installed without actually installing. Returns dict of {pkg_name: version} for packages that would ch

Enhanced adoption logic that prioritizes registering the original interpreter when appropriate, falling back to download only when ne

Ensure all registered Python interpreters have .omnipkg_config.json files. This should be called after adopting a new Python or durin

Ensures the current Python 3.11 is properly registered even if already detected.

Remove all ghost instances for a specific package version from the current Python context.

Extract the specific missing module name from error messages.

Downloads a wheel and extracts its content directly into a bubble directory. Does NOT use pip install.

Efficiently registers new package instances by cloning metadata from existing identical instances already in the Knowledge Base.

Filter environment variable paths to remove incompatible Python versions.

Find cloaked versions of a package in the environment.

Disabled: C extensions are copied, not symlinked.

Finds the Python executable for a given version. Checks registry first, then standard managed locations.

Safety net: Restore ANY cloak registered to this loader instance, guaranteeing cleanup even if local tracking lists desynchronize.

Get active versions only from the specified site-packages directory. This prevents cross-interpreter contamination.

(V7.2 - CORRECTED) Discovers all physical package installations and returns them as a dictionary mapping a unique instance ID to the

Helper to get a complete list of interpreters for the config file. Merges the registry data with the current interpreter.

Get version of a package from bubble manifest.

(V3 - ROBUST PATH FIX) A lightweight, READ-ONLY function to get the ground truth of package specs, now using robust logic to find the

Separate install lock (prevents duplicate installations). This is DIFFERENT from worker_locks (which protect worker creation).