Dump sys.path if OMNIPKG_DEBUG=1

(REWRITTEN) Queries PyPI to find a compatible Python version for a package. Handles both UPGRADE and DOWNGRADE scenarios by analyzing

Find the path to a specific Python version managed by omnipkg, or fall back to system PATH. Returns None if not found.

Gets all packages from a bubble.

Generate a context-aware cache key.

Hash the RECORD file contents (which itself contains SHA-256 of every installed file) to produce a byte-level cache key. Two

Retrieve port from log file.

Robustly checks if a file is a binary executable, excluding C extensions. Uses multiple detection strategies with intelligent fallbac

Write a registry.json and stub interpreter binaries; return the venv root.

Prints the final performance summary comparing Runner failure time to omnipkg execution time.

Reference self-healer: given a plan and a target dir, returns a dict describing what actions were/would be taken. Contract r

Save cache to local file — no-op unless data changed (dirty flag).

Scan *.dist-info dirs for active (non-bubbled) packages.

Scan .omnipkg_versions/ for bubbled package versions. Each top-level subdirectory is named <pkg>-<version> and represents ONE bubble. Dep

Ask the interpreter where its site-packages is.

(UPGRADED - THE REPAIR BOT v7) Now uses resolved paths consistently for hash generation to prevent ghost/rebuild loops.

Test-installs a package to a temporary directory to get pip's actual compatibility error messages, then parses them to find the lates

Write <venv>/.omnipkg/build_manifest.json with the outcome of every C/Rust compilation step. CI can read this file directly instead of g

Converts an IDLE worker into a specific package worker.

Attach to the watcher's shared flag. Returns a no-op guard if the watcher isn't running. Caches the result but re-validates o

Argparse skeleton for omnipkg — parsing structure only, no display help strings. Top-level help text (8pkg --help / omnipkg --help) is served fro

* daemon_connect — platform-transparent daemon connection. * * Reads daemon_connection.txt from the platform temp dir. * Unix: "unix:///path/t

Set send+recv timeouts on a connected daemon socket. */

Get current Python version in X.Y format

Get current urllib3 version using importlib.metadata

Checks if the current Python context matches the requirement. If not, it automatically finds, adopts (or downloads), and swaps to it. Ar

── minimal JSON value extractor ─────────────────────────────────────── */ * Finds the value of "key" in a flat JSON object string. * Handles: "key"

List all available Python interpreters with their versions. FIXED: Prioritize actual interpreters over symlinks, show hotswapped path

Load a CUDA tensor from IPC metadata. Returns PyTorch tensor pointing to shared GPU memory.

Normalize a user-supplied language code to its canonical form. Handles: - Wrong case: "zh_cn" -> "zh_CN" - Hyphen vs

(CORRECTED) Forces a targeted KB rebuild, now correctly determining and passing the Python context to prevent accidental ghost exorci

Receives a JSON dictionary over a socket with timeout protection.

Immediately adds a newly created bubble to the internal version map to prevent race conditions during validation.

Forcefully removes a managed Python interpreter directory, purges its knowledge base from Redis, and updates the registry. S

run() capturing stderr; prints coloured; returns result tuple.

Run all registered hooks of a given type. Args: hook_type: Which hooks to run context: Context to pass to hooks Returns

Run code in a subprocess. Returns (success, elapsed_ms).

Run subprocess with improved real-time output streaming.

Share a PyTorch CUDA tensor via CUDA IPC handle. Returns serializable metadata that can be sent over socket.

Spawn an interactive sub-shell with the swapped Python context. Handles all shim setup, PATH manipulation, .bat writing (Windows), rcfile

Context manager to temporarily set the install strategy and restore it on exit.

A context manager to temporarily set the install strategy and restore it on exit.

(SMARTER VALIDATION) Validates a bubble's integrity. It now intelligently checks for a 'bin' directory ONLY if the bubble's manifest

Enhanced deactivation with COMPLETE profiling visibility.

Build the uv_ffi PyO3 extension via maturin and install the .so into the active environment. Only runs in a dev checkout (submodule present);

(CORRECTED) ENHANCED: Catches orphaned cloaks with more aggressive pattern matching, correct path references, and ownership checking.

Compute a stable SHA256 of the lock's *portable* content. Two machines with identical packages + env_kind produce the same hash.

Creates a robust, dynamic manifest file and registers the bubble in Redis. Schema 2.0: Includes Global Cache metadata.

Enhanced Version: Fixes flask-login and similar packages with missing submodules. Key improvements: 1. Better detection of p

Connects to the daemon to handle this package spec.

Canonical lock file: <venv_root>/.omnipkg/omnipkg.lock

Classify the current environment and collect identity metadata. Returns a dict of fields to merge into [meta].

Uses tomli_w if available, otherwise a minimal hand-rolled writer.

Scan system-wide for omnipkg.lock files across: - All conda envs (via conda env list --json) - Common virtualenv locations (~/.venvs,

If we decide to use a package from the main environment, we must ensure the main site-packages directory is actually in sys.path.

Execute Python code inside a persistent isolated worker process. The daemon keeps one worker process alive per (spec, python, tag) t

Surgically removes a non-existent package entry from both KB and filesystem. If it's the last version of the package, it removes all

Pull pythonX.Y or cpython-X.Y out of a command string or exe path. Handles macOS framework paths like Python.app/Contents/MacOS/Python by

Extract Python version from an interpreter path. Examples: - /path/to/.omnipkg/interpreters/cpython-3.10-managed/bin/python3

Get or create a file lock for a specific package's cloak operations. Delegates to fs_lock_queue to ensure the SAME FileLock instance

Reads omnipkg's DIRECT production dependencies from pyproject.toml, filtered for the target Python version. Args: target_python_

Built-in default registry for common package ecosystems.

(ENHANCED CACHING) Gets the latest compatible version of a package. Returns None if package doesn't exist. Raises NoCompatibl

Generates comprehensive package name variants to handle ALL Python packaging naming conventions including dots, hyphens, underscores.

Read RECORD from dist-info to find ALL top-level site-packages items owned by this package — e.g. numpy/, numpy.libs/, numpy-1.26.4.dist-info

Enhanced detection that ALWAYS checks for cloaked versions first. CRITICAL FIX: Strictly checks self.site_packages_root to avoid conf

Enhanced CLI execution with unified healing analysis and performance stats.

Compile the C dispatcher and overwrite the pip-generated 8pkg/omnipkg wrapper scripts with the fast binary. Supports gcc (Linux/macOS) an

Installs essential packages for a new interpreter using a robust hybrid strategy. It installs dependencies first using the new interp

Show the lock file picker. Returns chosen Path or None if user aborted. If allow_manage=True, user can enter 'm' to manage/delete lock files.

Checks if a directory contains a valid, runnable Python interpreter structure. This is the core of the integrity check.

Check if a path points to the main site-packages directory.

Trigger on depth-1 events inside site-packages (dist-info, .data, .pth, packages). Ignore: - __pycache__ and nested writes

Load cache from local file.