pyfig 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Reggie Bowser
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,77 @@
-# Temporary Holding Version
+# pyfig
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+`pyfig` finds and configures a compatible Python interpreter and Python package manager from Bun or Node.js. It validates versions with npm's `semver`, checks the usual `python3`/`python` and `pip3`/`pip` names, and uses uv when a compatible local tool is unavailable.
+
+## Install
+
+```sh
+bun add pyfig
+```
+
+## Library
+
+```ts
+import { ensureEnvironment } from 'pyfig';
+
+const environment = await ensureEnvironment({
+  pythonRange: '>=3.11.0 <4.0.0',
+  pipRange: '>=23.0.0',
+});
+
+console.log(environment.python);
+console.log(environment.packageManager);
+```
+
+Defaults are Python `>=3.10.0 <4.0.0`, pip `>=20.3.0`, managed Python `3.12`, and uv `0.13.6`. Pass any npm-compatible SemVer range.
+
+If pip is unsuitable, `packageManager.kind` is `uv`; its `prefixArgs` is `['pip']`. If Python is unsuitable, pyfig installs the configured managed Python with uv and returns that interpreter.
+
+## CLI
+
+```sh
+bunx pyfig
+bunx pyfig --check
+bunx pyfig --python-range '>=3.12.0 <3.14.0' --pip-range '>=24.0.0'
+bunx pyfig --json
+```
+
+`--check` prohibits installation and exits nonzero when no compatible environment exists.
+
+## Configuration
+
+Precedence is API/CLI option, environment variable, then default.
+
+| API option | Environment variable | Default |
+| --- | --- | --- |
+| `python` | `PYFIG_PYTHON` | auto-detect |
+| `pip` | `PYFIG_PIP` | auto-detect |
+| `pythonRange` | `PYFIG_PYTHON_RANGE` | `>=3.10.0 <4.0.0` |
+| `pipRange` | `PYFIG_PIP_RANGE` | `>=20.3.0` |
+| `managedPython` | `PYFIG_MANAGED_PYTHON` | `3.12` |
+| `uvVersion` | `PYFIG_UV_VERSION` | `0.13.6` |
+| `cacheDir` | `PYFIG_HOME` | OS cache directory |
+| `autoInstall` | `PYFIG_AUTO_INSTALL` | `true` |
+
+Set `PYFIG_UV` to select an existing uv executable.
+
+## Installation safety
+
+pyfig uses the official, version-pinned Astral installer: PowerShell on Windows and POSIX `sh` elsewhere. The installer chooses the supported platform and architecture. `UV_UNMANAGED_INSTALL` keeps uv inside pyfig's cache, and `UV_NO_MODIFY_PATH=1` prevents shell-profile changes.
+
+uv and managed Python installation use `proper-lockfile` with a check-lock-check sequence:
+
+1. Check for a usable tool.
+2. Acquire a cross-process filesystem lock.
+3. Check again after acquiring the lock.
+4. Install only when the tool is still absent.
+
+## Development
+
+```sh
+bun install --ignore-scripts
+bun run verify
+bun run build
+bun pm pack --dry-run
+```
+
+MIT licensed.

package/SECURITY.md

@@ -0,0 +1,7 @@
+# Security
+
+pyfig can download and execute Astral's official uv installer and can use uv to download Python distributions. Automatic installation is enabled by default; set `autoInstall: false`, pass `--check`, or set `PYFIG_AUTO_INSTALL=0` when downloads are not allowed.
+
+The uv installer URL is pinned to the configured uv version and fetched over HTTPS. uv is installed into pyfig's cache without modifying shell profiles or `PATH`. Cross-process locks prevent concurrent installation into the same managed directories.
+
+Executable paths and version ranges are configuration, not untrusted request data. Do not let an untrusted user choose `python`, `pip`, `PYFIG_UV`, `cacheDir`, or related environment variables in a privileged process.

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { ensureEnvironment } from './provision.js';
+const program = new Command()
+    .name('pyfig')
+    .description('Find compatible Python and pip executables, using uv as a locked fallback.')
+    .version('0.1.0')
+    .option('--python <path>', 'Python executable to check first')
+    .option('--pip <path>', 'pip executable to check first')
+    .option('--python-range <range>', 'accepted Python SemVer range')
+    .option('--pip-range <range>', 'accepted pip SemVer range')
+    .option('--managed-python <request>', 'Python version request passed to uv')
+    .option('--uv-version <version>', 'pinned uv installer version')
+    .option('--home <path>', 'cache and managed-tool directory')
+    .option('--check', 'check only; do not install Python or uv', false)
+    .option('--json', 'print machine-readable JSON', false)
+    .action(async (cli) => {
+    const environment = await ensureEnvironment({
+        python: cli.python,
+        pip: cli.pip,
+        pythonRange: cli.pythonRange,
+        pipRange: cli.pipRange,
+        managedPython: cli.managedPython,
+        uvVersion: cli.uvVersion,
+        cacheDir: cli.home,
+        autoInstall: cli.check ? false : undefined,
+    });
+    if (cli.json) {
+        console.log(JSON.stringify(environment, null, 2));
+        return;
+    }
+    console.log(`Python ${environment.python.version}: ${environment.python.executable}`);
+    const manager = environment.packageManager;
+    const suffix = manager.kind === 'uv' ? ' (pip fallback)' : '';
+    console.log(`${manager.kind} ${manager.version}: ${manager.executable}${suffix}`);
+});
+program.parseAsync().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`pyfig: ${message}`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAcnD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE;KAC1B,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,4EAA4E,CAAC;KACzF,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,iBAAiB,EAAE,kCAAkC,CAAC;KAC7D,MAAM,CAAC,cAAc,EAAE,+BAA+B,CAAC;KACvD,MAAM,CAAC,wBAAwB,EAAE,8BAA8B,CAAC;KAChE,MAAM,CAAC,qBAAqB,EAAE,2BAA2B,CAAC;KAC1D,MAAM,CAAC,4BAA4B,EAAE,qCAAqC,CAAC;KAC3E,MAAM,CAAC,wBAAwB,EAAE,6BAA6B,CAAC;KAC/D,MAAM,CAAC,eAAe,EAAE,kCAAkC,CAAC;KAC3D,MAAM,CAAC,SAAS,EAAE,yCAAyC,EAAE,KAAK,CAAC;KACnE,MAAM,CAAC,QAAQ,EAAE,6BAA6B,EAAE,KAAK,CAAC;KACtD,MAAM,CAAC,KAAK,EAAE,GAAe,EAAE,EAAE;IAChC,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC;QAC1C,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,aAAa,EAAE,GAAG,CAAC,aAAa;QAChC,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,QAAQ,EAAE,GAAG,CAAC,IAAI;QAClB,WAAW,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;KAC3C,CAAC,CAAC;IAEH,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAClD,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,UAAU,WAAW,CAAC,MAAM,CAAC,OAAO,KAAK,WAAW,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACtF,MAAM,OAAO,GAAG,WAAW,CAAC,cAAc,CAAC;IAC3C,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,UAAU,GAAG,MAAM,EAAE,CAAC,CAAC;AACpF,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC5C,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,KAAK,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,32 @@
+export declare const DEFAULT_PYTHON_RANGE = ">=3.10.0 <4.0.0";
+export declare const DEFAULT_PIP_RANGE = ">=20.3.0";
+export declare const DEFAULT_MANAGED_PYTHON = "3.12";
+export declare const DEFAULT_UV_VERSION = "0.13.6";
+export interface PyfigOptions {
+    python?: string;
+    pip?: string;
+    pythonRange?: string;
+    pipRange?: string;
+    managedPython?: string;
+    uvVersion?: string;
+    autoInstall?: boolean;
+    cacheDir?: string;
+    probeTimeoutMs?: number;
+    installTimeoutMs?: number;
+    env?: NodeJS.ProcessEnv;
+}
+export interface ResolvedPyfigOptions {
+    python: string;
+    pip: string;
+    pythonRange: string;
+    pipRange: string;
+    managedPython: string;
+    uvVersion: string;
+    autoInstall: boolean;
+    cacheDir: string;
+    probeTimeoutMs: number;
+    installTimeoutMs: number;
+    env: NodeJS.ProcessEnv;
+}
+export declare function resolveOptions(options?: PyfigOptions): ResolvedPyfigOptions;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AACtD,eAAO,MAAM,iBAAiB,aAAa,CAAC;AAC5C,eAAO,MAAM,sBAAsB,SAAS,CAAC;AAC7C,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAE3C,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;CACxB;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE,YAAiB,GAAG,oBAAoB,CAyB/E"}

package/dist/config.js

@@ -0,0 +1,46 @@
+import path from 'node:path';
+import envPaths from 'env-paths';
+import semver from 'semver';
+export const DEFAULT_PYTHON_RANGE = '>=3.10.0 <4.0.0';
+export const DEFAULT_PIP_RANGE = '>=20.3.0';
+export const DEFAULT_MANAGED_PYTHON = '3.12';
+export const DEFAULT_UV_VERSION = '0.13.6';
+export function resolveOptions(options = {}) {
+    const env = options.env ?? process.env;
+    const pythonRange = options.pythonRange ?? env['PYFIG_PYTHON_RANGE'] ?? DEFAULT_PYTHON_RANGE;
+    const pipRange = options.pipRange ?? env['PYFIG_PIP_RANGE'] ?? DEFAULT_PIP_RANGE;
+    assertRange('Python', pythonRange);
+    assertRange('pip', pipRange);
+    const configuredHome = options.cacheDir ?? env['PYFIG_HOME'];
+    const cacheDir = configuredHome
+        ? path.resolve(configuredHome)
+        : envPaths('pyfig', { suffix: '' }).cache;
+    return {
+        python: options.python ?? env['PYFIG_PYTHON'] ?? '',
+        pip: options.pip ?? env['PYFIG_PIP'] ?? '',
+        pythonRange,
+        pipRange,
+        managedPython: options.managedPython ?? env['PYFIG_MANAGED_PYTHON'] ?? DEFAULT_MANAGED_PYTHON,
+        uvVersion: options.uvVersion ?? env['PYFIG_UV_VERSION'] ?? DEFAULT_UV_VERSION,
+        autoInstall: options.autoInstall ?? parseBoolean(env['PYFIG_AUTO_INSTALL'], true),
+        cacheDir,
+        probeTimeoutMs: options.probeTimeoutMs ?? 10_000,
+        installTimeoutMs: options.installTimeoutMs ?? 10 * 60_000,
+        env,
+    };
+}
+function assertRange(tool, range) {
+    if (!semver.validRange(range)) {
+        throw new TypeError(`Invalid ${tool} SemVer range: ${range}`);
+    }
+}
+function parseBoolean(value, fallback) {
+    if (value === undefined)
+        return fallback;
+    if (/^(1|true|yes|on)$/iu.test(value))
+        return true;
+    if (/^(0|false|no|off)$/iu.test(value))
+        return false;
+    throw new TypeError(`Invalid boolean value: ${value}`);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,QAAQ,MAAM,WAAW,CAAC;AACjC,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AACtD,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAC5C,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAC7C,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AA8B3C,MAAM,UAAU,cAAc,CAAC,OAAO,GAAiB,EAAE;IACvD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,GAAG,CAAC,oBAAoB,CAAC,IAAI,oBAAoB,CAAC;IAC7F,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,GAAG,CAAC,iBAAiB,CAAC,IAAI,iBAAiB,CAAC;IACjF,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACnC,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAE7B,MAAM,cAAc,GAAG,OAAO,CAAC,QAAQ,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,cAAc;QAC7B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC;QAC9B,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC;IAE5C,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE;QACnD,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE;QAC1C,WAAW;QACX,QAAQ;QACR,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,GAAG,CAAC,sBAAsB,CAAC,IAAI,sBAAsB;QAC7F,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,GAAG,CAAC,kBAAkB,CAAC,IAAI,kBAAkB;QAC7E,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,YAAY,CAAC,GAAG,CAAC,oBAAoB,CAAC,EAAE,IAAI,CAAC;QACjF,QAAQ;QACR,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,MAAM;QAChD,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,EAAE,GAAG,MAAM;QACzD,GAAG;KACJ,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,KAAa;IAC9C,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,SAAS,CAAC,WAAW,IAAI,kBAAkB,KAAK,EAAE,CAAC,CAAC;IAChE,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,KAAyB,EAAE,QAAiB;IAChE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACzC,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnD,IAAI,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,MAAM,IAAI,SAAS,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAC;AACzD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { DEFAULT_MANAGED_PYTHON, DEFAULT_PIP_RANGE, DEFAULT_PYTHON_RANGE, DEFAULT_UV_VERSION, resolveOptions, } from './config.js';
+export type { PyfigOptions, ResolvedPyfigOptions } from './config.js';
+export { findPip, findPython, findUv, probePython, probeUv } from './probes.js';
+export type { PackageManagerInfo, PythonInfo, UvInfo } from './probes.js';
+export { ensureEnvironment, ensurePip, ensurePython } from './provision.js';
+export type { PythonEnvironment } from './provision.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAChF,YAAY,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC5E,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { DEFAULT_MANAGED_PYTHON, DEFAULT_PIP_RANGE, DEFAULT_PYTHON_RANGE, DEFAULT_UV_VERSION, resolveOptions, } from './config.js';
+export { findPip, findPython, findUv, probePython, probeUv } from './probes.js';
+export { ensureEnvironment, ensurePip, ensurePython } from './provision.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEhF,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/probes.d.ts

@@ -0,0 +1,27 @@
+import type { ResolvedPyfigOptions } from './config.js';
+import { type CommandSpec } from './process.js';
+export interface PythonInfo {
+    executable: string;
+    version: string;
+    major: number;
+    minor: number;
+    patch: number;
+    prefix: string;
+}
+export interface PackageManagerInfo {
+    kind: 'pip' | 'uv';
+    executable: string;
+    prefixArgs: string[];
+    version: string;
+    pythonExecutable: string;
+}
+export interface UvInfo {
+    executable: string;
+    version: string;
+}
+export declare function findPython(options: ResolvedPyfigOptions): Promise<PythonInfo | null>;
+export declare function probePython(candidate: CommandSpec, options: ResolvedPyfigOptions): Promise<PythonInfo | null>;
+export declare function findPip(python: PythonInfo, options: ResolvedPyfigOptions): Promise<PackageManagerInfo | null>;
+export declare function findUv(options: ResolvedPyfigOptions): Promise<UvInfo | null>;
+export declare function probeUv(executable: string, options: ResolvedPyfigOptions): UvInfo | null;
+//# sourceMappingURL=probes.d.ts.map

package/dist/probes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probes.d.ts","sourceRoot":"","sources":["../src/probes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAA0B,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAExE,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,MAAM;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAOD,wBAAsB,UAAU,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAuB1F;AAED,wBAAsB,WAAW,CAC/B,SAAS,EAAE,WAAW,EACtB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAe5B;AAED,wBAAsB,OAAO,CAC3B,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CA+BpC;AAED,wBAAsB,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAIlF;AAED,wBAAgB,OAAO,CACrB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,oBAAoB,GAC5B,MAAM,GAAG,IAAI,CAQf"}

package/dist/probes.js

@@ -0,0 +1,88 @@
+import semver from 'semver';
+import { resolveExecutable, run } from './process.js';
+const PYTHON_PROBE = [
+    'import json,sys',
+    'print(json.dumps({"executable":sys.executable,"version":".".join(map(str,sys.version_info[:3])),"major":sys.version_info.major,"minor":sys.version_info.minor,"patch":sys.version_info.micro,"prefix":sys.prefix}))',
+].join(';');
+export async function findPython(options) {
+    const candidates = [];
+    if (options.python)
+        candidates.push({ executable: options.python, args: [] });
+    if (process.platform === 'win32') {
+        candidates.push({ executable: 'python', args: [] }, { executable: 'python3', args: [] }, { executable: 'py', args: ['-3'] });
+    }
+    else {
+        candidates.push(...['python3.15', 'python3.14', 'python3.13', 'python3.12', 'python3.11', 'python3.10']
+            .map((executable) => ({ executable, args: [] })), { executable: 'python3', args: [] }, { executable: 'python', args: [] });
+    }
+    for (const candidate of candidates) {
+        const info = await probePython(candidate, options);
+        if (info && semver.satisfies(info.version, options.pythonRange))
+            return info;
+    }
+    return null;
+}
+export async function probePython(candidate, options) {
+    const executable = await resolveExecutable(candidate.executable, options.env);
+    if (!executable)
+        return null;
+    try {
+        const { stdout } = run(executable, [...candidate.args, '-c', PYTHON_PROBE], options.env, options.probeTimeoutMs);
+        const info = JSON.parse(stdout.trim());
+        return semver.valid(info.version) ? info : null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function findPip(python, options) {
+    const candidates = [
+        { executable: python.executable, args: ['-m', 'pip'] },
+    ];
+    if (options.pip)
+        candidates.push({ executable: options.pip, args: [] });
+    candidates.push({ executable: 'pip3', args: [] }, { executable: 'pip', args: [] });
+    for (const candidate of candidates) {
+        const executable = await resolveExecutable(candidate.executable, options.env);
+        if (!executable)
+            continue;
+        try {
+            const { stdout } = run(executable, [...candidate.args, '--version'], options.env, options.probeTimeoutMs);
+            const version = normalizeVersion(stdout.match(/^pip\s+(\S+)/iu)?.[1]);
+            if (!version || !semver.satisfies(version, options.pipRange))
+                continue;
+            return {
+                kind: 'pip',
+                executable,
+                prefixArgs: candidate.args,
+                version,
+                pythonExecutable: python.executable,
+            };
+        }
+        catch {
+            // Try the next conventional pip spelling.
+        }
+    }
+    return null;
+}
+export async function findUv(options) {
+    const configured = options.env['PYFIG_UV'] ?? 'uv';
+    const executable = await resolveExecutable(configured, options.env);
+    return executable ? probeUv(executable, options) : null;
+}
+export function probeUv(executable, options) {
+    try {
+        const { stdout } = run(executable, ['--version'], options.env, options.probeTimeoutMs);
+        const version = normalizeVersion(stdout.match(/^uv\s+(\S+)/iu)?.[1]);
+        return version ? { executable, version } : null;
+    }
+    catch {
+        return null;
+    }
+}
+function normalizeVersion(value) {
+    if (!value)
+        return null;
+    return semver.valid(value) ?? semver.coerce(value)?.version ?? null;
+}
+//# sourceMappingURL=probes.js.map

package/dist/probes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probes.js","sourceRoot":"","sources":["../src/probes.ts"],"names":[],"mappings":"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"}

package/dist/process.d.ts

@@ -0,0 +1,11 @@
+export interface CommandSpec {
+    executable: string;
+    args: string[];
+}
+export interface RunResult {
+    stdout: string;
+    stderr: string;
+}
+export declare function resolveExecutable(value: string, env: NodeJS.ProcessEnv): Promise<string | null>;
+export declare function run(executable: string, args: string[], env: NodeJS.ProcessEnv, timeoutMs: number): RunResult;
+//# sourceMappingURL=process.d.ts.map

package/dist/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../src/process.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOxB;AAED,wBAAgB,GAAG,CACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,SAAS,EAAE,MAAM,GAChB,SAAS,CAaX"}

package/dist/process.js

@@ -0,0 +1,28 @@
+import { spawnSync } from 'node:child_process';
+import path from 'node:path';
+import which from 'which';
+export async function resolveExecutable(value, env) {
+    if (!value)
+        return null;
+    if (path.isAbsolute(value)) {
+        return await which(value, { nothrow: true, path: env['PATH'], pathExt: env['PATHEXT'] });
+    }
+    if (!/^[A-Za-z0-9_.-]+$/u.test(value))
+        return null;
+    return await which(value, { nothrow: true, path: env['PATH'], pathExt: env['PATHEXT'] });
+}
+export function run(executable, args, env, timeoutMs) {
+    const result = spawnSync(executable, args, {
+        encoding: 'utf8',
+        env,
+        timeout: timeoutMs,
+        maxBuffer: 4 * 1024 * 1024,
+        windowsHide: true,
+    });
+    if (result.status !== 0 || result.error) {
+        const detail = result.stderr?.trim() || result.error?.message || `exit ${result.status}`;
+        throw new Error(`${path.basename(executable)} ${args.slice(0, 3).join(' ')} failed: ${detail}`);
+    }
+    return { stdout: result.stdout, stderr: result.stderr };
+}
+//# sourceMappingURL=process.js.map

package/dist/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../src/process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,KAAK,MAAM,OAAO,CAAC;AAY1B,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAa,EACb,GAAsB;IAEtB,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,MAAM,KAAK,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAC3F,CAAC;IACD,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnD,OAAO,MAAM,KAAK,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,GAAG,CACjB,UAAkB,EAClB,IAAc,EACd,GAAsB,EACtB,SAAiB;IAEjB,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE;QACzC,QAAQ,EAAE,MAAM;QAChB,GAAG;QACH,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;QAC1B,WAAW,EAAE,IAAI;KAClB,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;QACzF,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,MAAM,EAAE,CAAC,CAAC;IAClG,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;AAC1D,CAAC"}

package/dist/provision.d.ts

@@ -0,0 +1,10 @@
+import { type PyfigOptions } from './config.js';
+import { type PackageManagerInfo, type PythonInfo } from './probes.js';
+export interface PythonEnvironment {
+    python: PythonInfo;
+    packageManager: PackageManagerInfo;
+}
+export declare function ensurePython(options?: PyfigOptions): Promise<PythonInfo>;
+export declare function ensurePip(options?: PyfigOptions, python?: PythonInfo): Promise<PackageManagerInfo>;
+export declare function ensureEnvironment(options?: PyfigOptions): Promise<PythonEnvironment>;
+//# sourceMappingURL=provision.d.ts.map

package/dist/provision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provision.d.ts","sourceRoot":"","sources":["../src/provision.ts"],"names":[],"mappings":"AAKA,OAAO,EAAkB,KAAK,YAAY,EAA6B,MAAM,aAAa,CAAC;AAC3F,OAAO,EAML,KAAK,kBAAkB,EACvB,KAAK,UAAU,EAEhB,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,UAAU,CAAC;IACnB,cAAc,EAAE,kBAAkB,CAAC;CACpC;AAQD,wBAAsB,YAAY,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAElF;AAED,wBAAsB,SAAS,CAC7B,OAAO,GAAE,YAAiB,EAC1B,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,kBAAkB,CAAC,CAI7B;AAED,wBAAsB,iBAAiB,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAK9F"}

package/dist/provision.js

@@ -0,0 +1,156 @@
+import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import lockfile from 'proper-lockfile';
+import semver from 'semver';
+import { resolveOptions } from './config.js';
+import { findPip, findPython, findUv, probePython, probeUv, } from './probes.js';
+import { resolveExecutable, run } from './process.js';
+const LOCK_OPTIONS = {
+    realpath: true,
+    stale: 10 * 60_000,
+    retries: { retries: 40, factor: 1.2, minTimeout: 100, maxTimeout: 1000 },
+};
+export async function ensurePython(options = {}) {
+    return ensurePythonResolved(resolveOptions(options));
+}
+export async function ensurePip(options = {}, python) {
+    const resolved = resolveOptions(options);
+    const selectedPython = python ?? await ensurePythonResolved(resolved);
+    return ensurePipResolved(selectedPython, resolved);
+}
+export async function ensureEnvironment(options = {}) {
+    const resolved = resolveOptions(options);
+    const python = await ensurePythonResolved(resolved);
+    const packageManager = await ensurePipResolved(python, resolved);
+    return { python, packageManager };
+}
+async function ensurePythonResolved(options) {
+    const existing = await findPython(options);
+    if (existing)
+        return existing;
+    if (!options.autoInstall) {
+        throw new Error(`No Python interpreter satisfies ${options.pythonRange}; automatic installation is disabled.`);
+    }
+    const lockTarget = path.join(options.cacheDir, 'locks', 'python');
+    await mkdir(lockTarget, { recursive: true });
+    const release = await lockfile.lock(lockTarget, LOCK_OPTIONS);
+    try {
+        const rechecked = await findPython(options);
+        if (rechecked)
+            return rechecked;
+        const uv = await ensureUv(options);
+        const uvEnv = uvEnvironment(options);
+        run(uv.executable, ['python', 'install', options.managedPython], uvEnv, options.installTimeoutMs);
+        const { stdout } = run(uv.executable, ['python', 'find', '--python-preference', 'only-managed', options.managedPython], uvEnv, options.probeTimeoutMs);
+        const installed = await probePython({ executable: stdout.trim(), args: [] }, { ...options, env: uvEnv });
+        if (!installed || !semver.satisfies(installed.version, options.pythonRange)) {
+            throw new Error(`uv installed Python ${options.managedPython}, but it does not satisfy ${options.pythonRange}.`);
+        }
+        return installed;
+    }
+    finally {
+        await release();
+    }
+}
+async function ensurePipResolved(python, options) {
+    const existing = await findPip(python, options);
+    if (existing)
+        return existing;
+    const existingUv = await findAvailableUv(options);
+    if (existingUv)
+        return uvPackageManager(existingUv, python);
+    if (!options.autoInstall) {
+        throw new Error(`No pip executable satisfies ${options.pipRange}; automatic uv installation is disabled.`);
+    }
+    const uv = await ensureUv(options);
+    return uvPackageManager(uv, python);
+}
+async function ensureUv(options) {
+    const existing = await findAvailableUv(options);
+    if (existing)
+        return existing;
+    if (!options.autoInstall)
+        throw new Error('uv is unavailable and automatic installation is disabled.');
+    const installDir = uvInstallDirectory(options);
+    const executable = uvExecutable(options);
+    const lockTarget = path.join(options.cacheDir, 'locks', 'uv');
+    await mkdir(lockTarget, { recursive: true });
+    const release = await lockfile.lock(lockTarget, LOCK_OPTIONS);
+    try {
+        const rechecked = probeUv(executable, options);
+        if (rechecked)
+            return rechecked;
+        await installUv(installDir, options);
+        const result = probeUv(executable, options);
+        if (!result)
+            throw new Error('The uv installer completed, but the installed executable could not run.');
+        return result;
+    }
+    finally {
+        await release();
+    }
+}
+async function findAvailableUv(options) {
+    return await findUv(options) ?? probeUv(uvExecutable(options), options);
+}
+function uvInstallDirectory(options) {
+    return path.join(options.cacheDir, 'tools', 'uv', options.uvVersion);
+}
+function uvExecutable(options) {
+    return path.join(uvInstallDirectory(options), process.platform === 'win32' ? 'uv.exe' : 'uv');
+}
+function uvPackageManager(uv, python) {
+    return {
+        kind: 'uv',
+        executable: uv.executable,
+        prefixArgs: ['pip'],
+        version: uv.version,
+        pythonExecutable: python.executable,
+    };
+}
+async function installUv(installDir, options) {
+    const scriptName = process.platform === 'win32' ? 'install.ps1' : 'install.sh';
+    const installerUrl = `https://astral.sh/uv/${options.uvVersion}/${scriptName}`;
+    const temporary = await mkdtemp(path.join(os.tmpdir(), 'pyfig-uv-'));
+    try {
+        const installer = path.join(temporary, scriptName);
+        await download(installerUrl, installer);
+        await mkdir(installDir, { recursive: true });
+        const env = {
+            ...options.env,
+            UV_UNMANAGED_INSTALL: installDir,
+            UV_NO_MODIFY_PATH: '1',
+        };
+        if (process.platform === 'win32') {
+            const powershell = await resolveExecutable('powershell.exe', env) ??
+                await resolveExecutable('pwsh', env);
+            if (!powershell)
+                throw new Error('The uv Windows installer requires PowerShell or pwsh.');
+            run(powershell, ['-NoLogo', '-NoProfile', '-NonInteractive', '-ExecutionPolicy', 'Bypass', '-File', installer], env, options.installTimeoutMs);
+        }
+        else {
+            const shell = await resolveExecutable('sh', env);
+            if (!shell)
+                throw new Error('The uv installer requires a POSIX sh executable.');
+            run(shell, [installer], env, options.installTimeoutMs);
+        }
+    }
+    finally {
+        await rm(temporary, { recursive: true, force: true });
+    }
+}
+async function download(url, destination) {
+    const response = await fetch(url, { redirect: 'follow' });
+    if (!response.ok)
+        throw new Error(`Could not download ${url}: HTTP ${response.status}`);
+    await writeFile(destination, new Uint8Array(await response.arrayBuffer()));
+}
+function uvEnvironment(options) {
+    return {
+        ...options.env,
+        UV_PYTHON_INSTALL_DIR: path.join(options.cacheDir, 'python'),
+        UV_CACHE_DIR: path.join(options.cacheDir, 'uv-cache'),
+    };
+}
+//# sourceMappingURL=provision.js.map

package/dist/provision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provision.js","sourceRoot":"","sources":["../src/provision.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,63 @@
 {
   "name": "pyfig",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Find compatible Python and pip executables, with a locked uv fallback.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "pyfig": "dist/cli.js"
+  },
+  "files": [
+    "dist/",
+    "LICENSE",
+    "README.md",
+    "SECURITY.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "verify": "bun run typecheck && bun test",
+    "prepack": "bun run verify && bun run build"
+  },
+  "keywords": [
+    "python",
+    "pip",
+    "uv",
+    "bootstrap",
+    "bun",
+    "cli"
+  ],
+  "author": "Reggie Bowser",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20.17.0",
+    "bun": ">=1.2.0"
+  },
+  "dependencies": {
+    "commander": "^14.0.3",
+    "env-paths": "^4.0.0",
+    "proper-lockfile": "^4.1.2",
+    "semver": "^7.8.5",
+    "which": "^6.0.1"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.4.4",
+    "@types/node": "^26.6.6",
+    "@types/proper-lockfile": "^4.1.4",
+    "@types/semver": "^7.8.0",
+    "@types/which": "^3.0.4",
+    "typescript": "^7.0.2"
+  }
+}