pyfig 0.7.0 → 0.7.1

package/dist/process.js

@@ -1,91 +1,72 @@
-import { spawn, spawnSync } from 'node:child_process';
+import { spawn } 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,
+const OUTPUT_LIMIT = 1024 * 1024;
+/** Resolve a command name or path to an executable without invoking it. */
+export async function findExecutable(requested, cwd, env) {
+    const candidate = path.isAbsolute(requested) || /[\\/]/u.test(requested)
+        ? path.resolve(cwd, requested)
+        : requested;
+    const resolved = await which(candidate, {
+        nothrow: true,
+        path: environmentValue(env, 'PATH'),
+        pathExt: environmentValue(env, 'PATHEXT'),
     });
-    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 };
+    return resolved ? path.resolve(cwd, resolved) : null;
 }
-/** Run a child without blocking lock heartbeats or other coordination timers. */
-export async function runAsync(executable, args, env, timeoutMs, signal, cwd) {
+/** Capture a bounded child-process response or throw with its stderr. */
+export async function capture(executable, args, cwd, env) {
     return new Promise((resolve, reject) => {
         const child = spawn(executable, args, {
-            env,
             cwd,
+            env,
             stdio: ['ignore', 'pipe', 'pipe'],
             windowsHide: true,
         });
         let stdout = '';
         let stderr = '';
         let settled = false;
-        const finish = (error, result) => {
+        const finish = (error) => {
             if (settled)
                 return;
             settled = true;
-            clearTimeout(timer);
-            signal?.removeEventListener('abort', abort);
             if (error)
                 reject(error);
-            else if (result)
-                resolve(result);
+            else
+                resolve(stdout);
         };
-        const abort = () => {
-            child.kill();
-            const reason = signal?.reason;
-            finish(reason instanceof Error ? reason : new Error(`${path.basename(executable)} was aborted.`));
-        };
-        const timer = setTimeout(() => {
-            child.kill();
-            finish(new Error(`${path.basename(executable)} timed out after ${timeoutMs}ms.`));
-        }, timeoutMs);
         child.stdout.setEncoding('utf8');
         child.stderr.setEncoding('utf8');
         child.stdout.on('data', (chunk) => {
             stdout += chunk;
-            if (stdout.length > 4 * 1024 * 1024) {
+            if (stdout.length > OUTPUT_LIMIT) {
                 child.kill();
-                finish(new Error(`${path.basename(executable)} exceeded the output limit.`));
+                finish(new Error(`${path.basename(executable)} exceeded its stdout limit.`));
             }
         });
         child.stderr.on('data', (chunk) => {
             stderr += chunk;
-            if (stderr.length > 4 * 1024 * 1024) {
+            if (stderr.length > OUTPUT_LIMIT) {
                 child.kill();
-                finish(new Error(`${path.basename(executable)} exceeded the error-output limit.`));
+                finish(new Error(`${path.basename(executable)} exceeded its stderr limit.`));
             }
         });
-        child.once('error', (error) => finish(error));
-        child.once('close', (code, childSignal) => {
-            if (code !== 0) {
-                const detail = stderr.trim() || (childSignal ? `signal ${childSignal}` : `exit ${code}`);
-                finish(new Error(`${path.basename(executable)} ${args.slice(0, 3).join(' ')} failed: ${detail}`));
+        child.once('error', error => finish(error));
+        child.once('close', (code, signal) => {
+            if (code === 0) {
+                finish();
                 return;
             }
-            finish(undefined, { stdout, stderr });
+            const detail = stderr.trim() || (signal ? `signal ${signal}` : `exit ${code}`);
+            finish(new Error(`${path.basename(executable)} ${args.slice(0, 3).join(' ')} failed: ${detail}`));
         });
-        if (signal?.aborted)
-            abort();
-        else
-            signal?.addEventListener('abort', abort, { once: true });
     });
 }
+/** Read environment keys case-insensitively on Windows. */
+export function environmentValue(env, name) {
+    if (env[name] !== undefined || process.platform !== 'win32')
+        return env[name];
+    const key = Object.keys(env).find(candidate => candidate.toLowerCase() === name.toLowerCase());
+    return key ? env[key] : undefined;
+}
 //# sourceMappingURL=process.js.map

package/dist/process.js.map

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

package/dist/pyfig.d.ts

@@ -0,0 +1,31 @@
+import { type ChildProcess, type SpawnOptions } from 'node:child_process';
+export interface PyfigOptions {
+    /** uv executable or PEP 440 constraint. Executables take precedence. */
+    uv?: string;
+    /** Python executable or PEP 440 constraint. Executables take precedence. */
+    python?: string;
+    /** Require CPython headers, a linkable library, and matching runtime architecture. */
+    requireEmbedding?: boolean;
+    /** Reject free-threaded Python builds. */
+    requireGil?: boolean;
+    /** Directory used for uv project and configuration discovery. */
+    cwd?: string;
+    /** Environment used to locate executables and invoke child processes. */
+    env?: Readonly<Record<string, string | undefined>>;
+}
+export declare class PythonContext {
+    #private;
+    /** Absolute path to the resolved uv executable. */
+    readonly uv: string;
+    /** Absolute path to the resolved Python interpreter. */
+    readonly python: string;
+    constructor(uvPath: string, pythonPath: string, cwd?: string, env?: NodeJS.ProcessEnv);
+    /** Spawn `uv run` with the resolved Python pinned before the command separator. */
+    run(...args: string[]): ChildProcess;
+    run(...args: [...command: string[], options: SpawnOptions]): ChildProcess;
+}
+/** Resolve compatible uv and Python executables without owning either environment. */
+export declare function pyfig(options?: PyfigOptions): Promise<PythonContext>;
+/** @internal Build a safe `uv run` argv array from the public variadic input. */
+export declare function buildRunArgs(pythonPath: string, args: readonly string[]): string[];
+//# sourceMappingURL=pyfig.d.ts.map

package/dist/pyfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pyfig.d.ts","sourceRoot":"","sources":["../src/pyfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAuDjF,MAAM,WAAW,YAAY;IAC3B,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0CAA0C;IAC1C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;CACpD;AAED,qBAAa,aAAa;;IAGxB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,YACE,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,GAAG,SAAgB,EACnB,GAAG,GAAE,MAAM,CAAC,UAAwB,EAOrC;IAED,mFAAmF;IACnF,GAAG,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC;IACrC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,YAAY,CAAC,GAAG,YAAY,CAAC;CAW3E;AAED,sFAAsF;AACtF,wBAAsB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,aAAa,CAAC,CAsB9E;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAalF"}

package/dist/pyfig.js

@@ -0,0 +1,275 @@
+import { spawn } from 'node:child_process';
+import path from 'node:path';
+import { filter, valid as validVersion, validRange, } from '@renovatebot/pep440';
+import { capture, findExecutable } from './process.js';
+import { resolveUv } from './uv.js';
+const DEFAULT_UV = '>=0.10,<1';
+const PYTHON_PROBE = String.raw `
+import json
+import os
+import platform
+import struct
+import sys
+import sysconfig
+
+base_prefix = getattr(sys, "base_prefix", sys.prefix)
+include_directory = sysconfig.get_path("include") or ""
+header_path = os.path.join(include_directory, "Python.h") if include_directory else ""
+library_candidates = []
+if os.name == "nt":
+    library_directory = sysconfig.get_config_var("LIBDIR") or os.path.join(base_prefix, "libs")
+    configured_library = sysconfig.get_config_var("LDLIBRARY") or ""
+    if configured_library:
+        library_candidates.append(os.path.join(library_directory, os.path.splitext(configured_library)[0] + ".lib"))
+    library_candidates.append(os.path.join(library_directory, f"python{sys.version_info.major}{sys.version_info.minor}.lib"))
+else:
+    for directory in [
+        sysconfig.get_config_var("LIBDIR"),
+        sysconfig.get_config_var("LIBPL"),
+        os.path.join(base_prefix, "lib"),
+    ]:
+        for name in [sysconfig.get_config_var("LDLIBRARY"), sysconfig.get_config_var("LIBRARY")]:
+            if directory and name:
+                library_candidates.append(os.path.join(directory, name))
+
+release_suffix = {"alpha": "a", "beta": "b", "candidate": "rc", "final": ""}[sys.version_info.releaselevel]
+if release_suffix:
+    release_suffix += str(sys.version_info.serial)
+
+print(json.dumps({
+    "executable": sys.executable,
+    "version": ".".join(map(str, sys.version_info[:3])) + release_suffix,
+    "implementation": sys.implementation.name,
+    "architecture": platform.machine().lower(),
+    "pointerBits": struct.calcsize("P") * 8,
+    "gilDisabled": bool(sysconfig.get_config_var("Py_GIL_DISABLED")),
+    "embedding": os.path.isfile(header_path) and any(os.path.isfile(path) for path in library_candidates),
+}))
+`;
+export class PythonContext {
+    #cwd;
+    #env;
+    /** Absolute path to the resolved uv executable. */
+    uv;
+    /** Absolute path to the resolved Python interpreter. */
+    python;
+    constructor(uvPath, pythonPath, cwd = process.cwd(), env = process.env) {
+        this.#cwd = cwd;
+        this.#env = { ...env };
+        this.uv = uvPath;
+        this.python = pythonPath;
+        Object.freeze(this);
+    }
+    run(...input) {
+        const { args, spawnOptions } = splitRunInput(input);
+        return spawn(this.uv, buildRunArgs(this.python, args), {
+            cwd: this.#cwd,
+            env: this.#env,
+            stdio: 'inherit',
+            windowsHide: true,
+            ...spawnOptions,
+        });
+    }
+}
+/** Resolve compatible uv and Python executables without owning either environment. */
+export async function pyfig(options = {}) {
+    const { uv: uvRequest = DEFAULT_UV, python: pythonRequest, requireEmbedding = false, requireGil = false, cwd = process.cwd(), env: suppliedEnvironment, } = options;
+    const env = mergeEnvironment(suppliedEnvironment);
+    const workingDirectory = path.resolve(cwd);
+    const uvPath = await selectUv(uvRequest, workingDirectory, env);
+    const selectedPythonPath = await selectPython({
+        cwd: workingDirectory,
+        env,
+        pythonRequest,
+        requireEmbedding,
+        requireGil,
+        uvPath,
+    });
+    return new PythonContext(uvPath, selectedPythonPath, workingDirectory, env);
+}
+/** @internal Build a safe `uv run` argv array from the public variadic input. */
+export function buildRunArgs(pythonPath, args) {
+    const separator = args.indexOf('--');
+    if (separator < 0) {
+        return ['run', '--python', pythonPath, '--', ...args];
+    }
+    const uvArgs = args.slice(0, separator);
+    const command = args.slice(separator + 1);
+    if (uvArgs.some(argument => argument === '--python' || argument.startsWith('--python='))) {
+        throw new TypeError('run() does not accept --python before --; Python is selected by pyfig().');
+    }
+    uvArgs.push('--python', pythonPath);
+    return ['run', ...uvArgs, '--', ...command];
+}
+function splitRunInput(input) {
+    const values = [...input];
+    const last = values.at(-1);
+    const spawnOptions = typeof last === 'object' && last !== null && !Array.isArray(last)
+        ? values.pop()
+        : {};
+    if (!values.every((value) => typeof value === 'string')) {
+        throw new TypeError('uv run arguments must be strings with an optional SpawnOptions object last.');
+    }
+    return { args: values, spawnOptions };
+}
+async function selectUv(request, cwd, env) {
+    const selection = await executableOrSpecifier('uv', request, cwd, env);
+    if (selection.executable)
+        return selection.executable;
+    const specifier = selection.specifier;
+    if (!specifier)
+        throw new Error('uv selection did not contain a version specifier.');
+    return resolveUv(specifier, cwd, env);
+}
+async function selectPython(options) {
+    if (options.pythonRequest !== undefined) {
+        const selection = await executableOrSpecifier('python', options.pythonRequest, options.cwd, options.env);
+        if (selection.executable) {
+            const explicit = await probePython(selection.executable, options.cwd, options.env);
+            validatePythonCapabilities(explicit, options);
+            return explicit.executable;
+        }
+        if (!selection.specifier)
+            throw new Error('Python selection did not contain a version specifier.');
+        return selectDiscoveredPython(selection.specifier, options);
+    }
+    return selectDiscoveredPython(null, options);
+}
+async function selectDiscoveredPython(specifier, options) {
+    const request = specifier ? [specifier] : [];
+    let systemFailure;
+    try {
+        // `--system` excludes virtual environments; `--no-managed-python` also
+        // excludes uv's cache so this pass genuinely prefers host installations.
+        const systemPath = await findPython(options.uvPath, ['--system', '--no-managed-python', ...request], options);
+        const system = await probePython(systemPath, options.cwd, options.env);
+        validatePythonVersion(system, specifier);
+        validatePythonCapabilities(system, options);
+        return system.executable;
+    }
+    catch (error) {
+        systemFailure = error;
+    }
+    try {
+        const managedPath = await findPython(options.uvPath, ['--managed-python', ...request], options);
+        const managed = await probePython(managedPath, options.cwd, options.env);
+        validatePythonVersion(managed, specifier);
+        validatePythonCapabilities(managed, options);
+        return managed.executable;
+    }
+    catch (error) {
+        throw new Error(`No compatible Python was found. System: ${errorMessage(systemFailure)} Managed: ${errorMessage(error)}`, { cause: error });
+    }
+}
+async function findPython(uvPath, args, options) {
+    const output = await capture(uvPath, ['python', 'find', ...args], options.cwd, options.env);
+    const executable = output.trim().split(/\r?\n/u).at(-1) ?? '';
+    if (!path.isAbsolute(executable)) {
+        throw new Error(`uv did not report an absolute Python path: ${executable || '<empty>'}`);
+    }
+    return path.normalize(executable);
+}
+async function probePython(executable, cwd, env) {
+    const output = await capture(executable, ['-I', '-S', '-c', PYTHON_PROBE], cwd, env);
+    const line = output.trim().split(/\r?\n/u).at(-1) ?? '';
+    let value;
+    try {
+        value = JSON.parse(line);
+    }
+    catch (error) {
+        throw new Error(`${JSON.stringify(executable)} did not return valid Python metadata.`, {
+            cause: error,
+        });
+    }
+    if (!isPythonProbe(value)) {
+        throw new Error(`${JSON.stringify(executable)} returned incomplete Python metadata.`);
+    }
+    if (!path.isAbsolute(value.executable)) {
+        throw new Error(`${JSON.stringify(executable)} reported a non-absolute executable path.`);
+    }
+    return { ...value, executable: path.normalize(value.executable) };
+}
+function validatePythonVersion(python, specifier) {
+    if (!specifier)
+        return;
+    const version = validVersion(python.version);
+    if (!version)
+        throw new Error(`Python ${python.executable} reported invalid version ${python.version}.`);
+    if (filter([version], specifier).length !== 1) {
+        throw new Error(`Python ${version} does not satisfy ${specifier}.`);
+    }
+}
+function validatePythonCapabilities(python, options) {
+    if (options.requireEmbedding) {
+        if (python.implementation !== 'cpython') {
+            throw new Error(`Python embedding requires CPython, received ${python.implementation}.`);
+        }
+        if (!python.embedding) {
+            throw new Error(`Python ${python.executable} does not provide embedding headers and a library.`);
+        }
+        if (!pythonArchitectureMatchesRuntime(python)) {
+            throw new Error(`Python ${python.executable} does not match the JavaScript runtime architecture.`);
+        }
+    }
+    if (options.requireGil && python.gilDisabled) {
+        throw new Error(`Python ${python.executable} is free-threaded but requireGil is enabled.`);
+    }
+}
+function pythonArchitectureMatchesRuntime(python) {
+    if (python.pointerBits !== (process.arch === 'ia32' ? 32 : 64))
+        return false;
+    if (process.arch === 'x64')
+        return python.architecture === 'x86_64' || python.architecture === 'amd64';
+    if (process.arch === 'arm64')
+        return python.architecture === 'aarch64' || python.architecture === 'arm64';
+    if (process.arch === 'ia32') {
+        return python.architecture === 'x86' || python.architecture === 'i386' ||
+            python.architecture === 'i686';
+    }
+    return python.architecture === process.arch;
+}
+async function executableOrSpecifier(name, value, cwd, env) {
+    assertNonempty(name, value);
+    const executable = await findExecutable(value, cwd, env);
+    if (executable)
+        return { executable, specifier: null };
+    if (validRange(value))
+        return { executable: null, specifier: value };
+    throw new TypeError(`${name} must resolve to an executable or be a valid PEP 440 specifier, received ${JSON.stringify(value)}.`);
+}
+function isPythonProbe(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const probe = value;
+    return typeof probe['architecture'] === 'string' &&
+        typeof probe['embedding'] === 'boolean' &&
+        typeof probe['executable'] === 'string' &&
+        typeof probe['gilDisabled'] === 'boolean' &&
+        typeof probe['implementation'] === 'string' &&
+        typeof probe['pointerBits'] === 'number' &&
+        typeof probe['version'] === 'string';
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/** Apply caller overrides without leaving case-variant duplicate keys on Windows. */
+function mergeEnvironment(supplied) {
+    const environment = { ...process.env };
+    for (const [key, value] of Object.entries(supplied ?? {})) {
+        if (process.platform === 'win32') {
+            const existing = Object.keys(environment).find(candidate => candidate.toLowerCase() === key.toLowerCase());
+            if (existing && existing !== key)
+                delete environment[existing];
+        }
+        if (value === undefined)
+            delete environment[key];
+        else
+            environment[key] = value;
+    }
+    return environment;
+}
+function assertNonempty(name, value) {
+    if (value.trim() === '')
+        throw new TypeError(`${name} must not be empty.`);
+}
+//# sourceMappingURL=pyfig.js.map

package/dist/pyfig.js.map

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

package/dist/uv.d.ts

@@ -0,0 +1,3 @@
+/** Prefer a compatible PATH or cached uv, then provision an official release. */
+export declare function resolveUv(specifier: string, cwd: string, env: NodeJS.ProcessEnv): Promise<string>;
+//# sourceMappingURL=uv.d.ts.map

package/dist/uv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uv.d.ts","sourceRoot":"","sources":["../src/uv.ts"],"names":[],"mappings":"AAoDA,iFAAiF;AACjF,wBAAsB,SAAS,CAC7B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAAC,MAAM,CAAC,CAmCjB"}