pynect 0.0.0 → 0.2.1

package/dist/core/isolated-worker.js

@@ -0,0 +1,178 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsolatedWorker = void 0;
+const readline_1 = require("readline");
+const pyfig_adapter_1 = require("../env/pyfig-adapter");
+/** Persistent JSON-only child process used when hard termination is required. */
+class IsolatedWorker {
+    options;
+    child;
+    lines;
+    nextId = 0;
+    pending = new Map();
+    closing = false;
+    stderrTail = '';
+    constructor(options) {
+        this.options = options;
+    }
+    async call(moduleName, functionName, args = [], callOptions = {}) {
+        if (callOptions.signal?.aborted)
+            throw this.abortError();
+        const child = await this.ensureStarted();
+        const id = ++this.nextId;
+        const timeout = callOptions.timeout ?? this.options.timeout;
+        return new Promise((resolve, reject) => {
+            const pending = {
+                resolve: value => resolve(value),
+                reject,
+                signal: callOptions.signal,
+            };
+            if (timeout > 0) {
+                pending.timer = setTimeout(() => {
+                    this.terminate(new Error(`Isolated Python call exceeded ${timeout}ms`));
+                }, timeout);
+            }
+            if (callOptions.signal) {
+                pending.onAbort = () => this.terminate(this.abortError());
+                callOptions.signal.addEventListener('abort', pending.onAbort, { once: true });
+            }
+            this.pending.set(id, pending);
+            this.setReferenced(true);
+            const request = {
+                id,
+                module: moduleName,
+                function: functionName,
+                args,
+                kwargs: callOptions.kwargs ?? {},
+                executionTimeout: timeout,
+            };
+            child.stdin.write(`${JSON.stringify(request)}\n`, error => {
+                if (error)
+                    this.terminate(error);
+            });
+        });
+    }
+    async close() {
+        this.closing = true;
+        this.terminate(new Error('Isolated Python worker closed'));
+    }
+    closeSync() {
+        this.closing = true;
+        this.terminate(new Error('Isolated Python worker closed'));
+    }
+    async ensureStarted() {
+        if (this.child && !this.child.killed)
+            return this.child;
+        this.closing = false;
+        this.stderrTail = '';
+        const pythonPath = [
+            ...this.options.pythonPath,
+            process.env['PYTHONPATH'],
+        ].filter(Boolean).join(process.platform === 'win32' ? ';' : ':');
+        const client = (0, pyfig_adapter_1.createPynectPyfig)({
+            projectRoot: this.options.projectRoot,
+            pythonPath: this.options.pythonExecutable,
+            env: this.options.env,
+        });
+        const child = await client.python([this.options.scriptPath], {
+            cwd: this.options.cwd,
+            env: {
+                ...process.env,
+                ...this.options.env,
+                PYTHONPATH: pythonPath,
+                PYNECT_DISPATCHER_CONFIG: JSON.stringify(this.options.dispatcher),
+                PYNECT_INCLUDE_TRACEBACKS: this.options.includeTracebacks ? '1' : '0',
+            },
+            stdio: ['pipe', 'pipe', 'pipe'],
+            windowsHide: true,
+        });
+        this.child = child;
+        this.lines = (0, readline_1.createInterface)({ input: child.stdout });
+        this.lines.on('line', line => this.handleLine(line));
+        child.stderr.setEncoding('utf8');
+        child.stderr.on('data', chunk => {
+            this.stderrTail = `${this.stderrTail}${String(chunk)}`.slice(-4000);
+        });
+        child.on('error', error => this.terminate(error));
+        child.on('exit', (code, signal) => {
+            if (this.child !== child)
+                return;
+            this.child = undefined;
+            this.lines?.close();
+            this.lines = undefined;
+            if (!this.closing && this.pending.size) {
+                const detail = this.stderrTail.trim();
+                this.rejectAll(new Error(`Isolated Python worker exited (${signal ?? code ?? 'unknown'})${detail ? `: ${detail}` : ''}`));
+            }
+        });
+        this.setReferenced(false);
+        return child;
+    }
+    handleLine(line) {
+        let message;
+        try {
+            message = JSON.parse(line);
+        }
+        catch {
+            this.terminate(new Error('Isolated Python worker returned invalid JSON'));
+            return;
+        }
+        if (typeof message.id !== 'number')
+            return;
+        const pending = this.pending.get(message.id);
+        if (!pending)
+            return;
+        this.pending.delete(message.id);
+        this.cleanupPending(pending);
+        if (!this.pending.size)
+            this.setReferenced(false);
+        if (message.ok) {
+            pending.resolve(message.result);
+            return;
+        }
+        const error = new Error(message.error?.message ?? 'Isolated Python call failed');
+        error.name = message.error?.type ?? 'PythonError';
+        if (message.error?.traceback)
+            error.stack = message.error.traceback;
+        pending.reject(error);
+    }
+    terminate(error) {
+        const child = this.child;
+        this.child = undefined;
+        this.lines?.close();
+        this.lines = undefined;
+        if (child && !child.killed)
+            child.kill();
+        this.rejectAll(error);
+    }
+    rejectAll(error) {
+        for (const pending of this.pending.values()) {
+            this.cleanupPending(pending);
+            pending.reject(error);
+        }
+        this.pending.clear();
+    }
+    setReferenced(referenced) {
+        if (!this.child)
+            return;
+        const method = referenced ? 'ref' : 'unref';
+        this.child[method]();
+        for (const stream of [this.child.stdin, this.child.stdout, this.child.stderr]) {
+            stream[method]?.();
+        }
+    }
+    cleanupPending(pending) {
+        if (pending.timer)
+            clearTimeout(pending.timer);
+        if (pending.signal && pending.onAbort) {
+            pending.signal.removeEventListener('abort', pending.onAbort);
+        }
+    }
+    abortError() {
+        const error = new Error('Isolated Python call was aborted');
+        error.name = 'AbortError';
+        return error;
+    }
+}
+exports.IsolatedWorker = IsolatedWorker;
+//# sourceMappingURL=isolated-worker.js.map

package/dist/core/isolated-worker.js.map

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

package/dist/core/py-callable.d.ts

@@ -0,0 +1,67 @@
+/**
+ * pynect - PyCallable
+ * Represents a Python callable (function, method, class constructor).
+ * Extends PyProxy with call metadata and convenience methods.
+ */
+import { PyProxy } from './py-proxy';
+import type { NativeAddon } from '../types/addon';
+import type { PyCallOptions } from '../types/addon';
+import type { PyObjectId, AttributePath, PyCallableInfo } from '../types/python';
+/**
+ * PyCallable - wraps a Python function or method.
+ *
+ * @example
+ * ```typescript
+ * const np = await py.import('numpy');
+ * const zeros = await np.zeros;  // PyCallable
+ * const arr = await zeros([3, 3], { dtype: 'float64' });
+ *
+ * // Or more concisely:
+ * const arr2 = await np.zeros([3, 3]);
+ * ```
+ */
+export declare class PyCallable extends PyProxy {
+    private readonly _callableName;
+    constructor(objectId: PyObjectId, path: AttributePath, callableName: string, addon: NativeAddon, callTimeout?: number, executionTimeout?: number);
+    /** Callable name */
+    get callableName(): string;
+    /**
+     * Call the callable with given arguments.
+     * Same as using the callable directly (proxy syntax).
+     *
+     * @example
+     * ```typescript
+     * const result = await callable.invoke([1, 2, 3], { axis: 0 });
+     * // equivalent to: await callable([1, 2, 3], { axis: 0 })
+     * ```
+     */
+    invoke(...args: unknown[]): Promise<unknown>;
+    /** Invoke with cancellation or per-call timeout overrides. */
+    invokeWithOptions(options: PyCallOptions, ...args: unknown[]): Promise<unknown>;
+    /**
+     * Call with explicit positional args and keyword args.
+     *
+     * @example
+     * ```typescript
+     * const result = await callable.call([1, 2, 3], { axis: 0, keepdims: true });
+     * ```
+     */
+    call(args: unknown[], kwargs?: Record<string, unknown>, options?: PyCallOptions): Promise<unknown>;
+    /**
+     * Partially apply arguments (like functools.partial in Python).
+     *
+     * @example
+     * ```typescript
+     * const readCsvUtf8 = await pd.read_csv.partial({ encoding: 'utf-8' });
+     * const df = await readCsvUtf8('data.csv');
+     * ```
+     */
+    partial(...partialArgs: unknown[]): PyCallable;
+    /**
+     * Get introspection information about this callable.
+     */
+    getInfo(): Promise<PyCallableInfo | null>;
+    static fromProxy(proxy: PyProxy, name: string): PyCallable;
+    toString(): string;
+}
+//# sourceMappingURL=py-callable.d.ts.map

package/dist/core/py-callable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"py-callable.d.ts","sourceRoot":"","sources":["../../src/core/py-callable.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAoB,MAAM,YAAY,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjF;;;;;;;;;;;;GAYG;AACH,qBAAa,UAAW,SAAQ,OAAO;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAGrC,QAAQ,EAAE,UAAU,EACpB,IAAI,EAAE,aAAa,EACnB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,WAAW,EAClB,WAAW,CAAC,EAAE,MAAM,EACpB,gBAAgB,CAAC,EAAE,MAAM;IAY3B,oBAAoB;IACpB,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;;;;;;;;OASG;IACG,MAAM,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlD,8DAA8D;IACxD,iBAAiB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrF;;;;;;;OAOG;IACG,IAAI,CACR,IAAI,EAAE,OAAO,EAAE,EACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,OAAO,CAAC;IAInB;;;;;;;;OAQG;IACH,OAAO,CAAC,GAAG,WAAW,EAAE,OAAO,EAAE,GAAG,UAAU;IAwB9C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAI/C,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU;IAYjD,QAAQ,IAAI,MAAM;CAG5B"}

package/dist/core/py-callable.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * pynect - PyCallable
+ * Represents a Python callable (function, method, class constructor).
+ * Extends PyProxy with call metadata and convenience methods.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PyCallable = void 0;
+const py_proxy_1 = require("./py-proxy");
+/**
+ * PyCallable - wraps a Python function or method.
+ *
+ * @example
+ * ```typescript
+ * const np = await py.import('numpy');
+ * const zeros = await np.zeros;  // PyCallable
+ * const arr = await zeros([3, 3], { dtype: 'float64' });
+ *
+ * // Or more concisely:
+ * const arr2 = await np.zeros([3, 3]);
+ * ```
+ */
+class PyCallable extends py_proxy_1.PyProxy {
+    _callableName;
+    constructor(objectId, path, callableName, addon, callTimeout, executionTimeout) {
+        super({
+            objectId,
+            path,
+            addon,
+            callTimeout,
+            executionTimeout,
+        });
+        this._callableName = callableName;
+    }
+    /** Callable name */
+    get callableName() {
+        return this._callableName;
+    }
+    /**
+     * Call the callable with given arguments.
+     * Same as using the callable directly (proxy syntax).
+     *
+     * @example
+     * ```typescript
+     * const result = await callable.invoke([1, 2, 3], { axis: 0 });
+     * // equivalent to: await callable([1, 2, 3], { axis: 0 })
+     * ```
+     */
+    async invoke(...args) {
+        return this(...args);
+    }
+    /** Invoke with cancellation or per-call timeout overrides. */
+    async invokeWithOptions(options, ...args) {
+        return this.withOptions(options, ...args);
+    }
+    /**
+     * Call with explicit positional args and keyword args.
+     *
+     * @example
+     * ```typescript
+     * const result = await callable.call([1, 2, 3], { axis: 0, keepdims: true });
+     * ```
+     */
+    async call(args, kwargs, options = {}) {
+        return this.callWithOptions(args, options, kwargs);
+    }
+    /**
+     * Partially apply arguments (like functools.partial in Python).
+     *
+     * @example
+     * ```typescript
+     * const readCsvUtf8 = await pd.read_csv.partial({ encoding: 'utf-8' });
+     * const df = await readCsvUtf8('data.csv');
+     * ```
+     */
+    partial(...partialArgs) {
+        const internal = this[py_proxy_1.PYPROXY_INTERNAL];
+        const callableName = `${this._callableName}(partial)`;
+        const wrapper = new PyCallable(internal.objectId, internal.path, callableName, internal.addon, internal.callTimeout, internal.executionTimeout);
+        // Override: always prepend partialArgs (use arrow to capture outer `this` lexically)
+        const callSelf = (...a) => this(...a);
+        const overrideProxy = new Proxy(wrapper, {
+            apply(_target, _thisArg, args) {
+                return callSelf(...partialArgs, ...args);
+            },
+        });
+        return overrideProxy;
+    }
+    /**
+     * Get introspection information about this callable.
+     */
+    async getInfo() {
+        return null;
+    }
+    static fromProxy(proxy, name) {
+        const internal = proxy[py_proxy_1.PYPROXY_INTERNAL];
+        return new PyCallable(internal.objectId, internal.path, name, internal.addon, internal.callTimeout, internal.executionTimeout);
+    }
+    toString() {
+        return `[PyCallable '${this._callableName}' id=${this[py_proxy_1.PYPROXY_INTERNAL].objectId}]`;
+    }
+}
+exports.PyCallable = PyCallable;
+//# sourceMappingURL=py-callable.js.map

package/dist/core/py-callable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"py-callable.js","sourceRoot":"","sources":["../../src/core/py-callable.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,yCAAuD;AAKvD;;;;;;;;;;;;GAYG;AACH,MAAa,UAAW,SAAQ,kBAAO;IACpB,aAAa,CAAS;IAEvC,YACE,QAAoB,EACpB,IAAmB,EACnB,YAAoB,EACpB,KAAkB,EAClB,WAAoB,EACpB,gBAAyB;QAEzB,KAAK,CAAC;YACJ,QAAQ;YACR,IAAI;YACJ,KAAK;YACL,WAAW;YACX,gBAAgB;SACjB,CAAC,CAAC;QACH,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;IACpC,CAAC;IAED,oBAAoB;IACpB,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAM,CAAC,GAAG,IAAe;QAC7B,OAAQ,IAAgD,CAAC,GAAG,IAAI,CAAC,CAAC;IACpE,CAAC;IAED,8DAA8D;IAC9D,KAAK,CAAC,iBAAiB,CAAC,OAAsB,EAAE,GAAG,IAAe;QAChE,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI,CACR,IAAe,EACf,MAAgC,EAChC,UAAyB,EAAE;QAE3B,OAAO,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACrD,CAAC;IAED;;;;;;;;OAQG;IACH,OAAO,CAAC,GAAG,WAAsB;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,2BAAgB,CAAC,CAAC;QACxC,MAAM,YAAY,GAAG,GAAG,IAAI,CAAC,aAAa,WAAW,CAAC;QACtD,MAAM,OAAO,GAAG,IAAI,UAAU,CAC5B,QAAQ,CAAC,QAAQ,EACjB,QAAQ,CAAC,IAAI,EACb,YAAY,EACZ,QAAQ,CAAC,KAAK,EACd,QAAQ,CAAC,WAAW,EACpB,QAAQ,CAAC,gBAAgB,CAC1B,CAAC;QAEF,qFAAqF;QACrF,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAY,EAAE,EAAE,CAClC,IAAgD,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1D,MAAM,aAAa,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE;YACvC,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAe;gBACtC,OAAO,QAAQ,CAAC,GAAG,WAAW,EAAE,GAAG,IAAI,CAAC,CAAC;YAC3C,CAAC;SACF,CAAC,CAAC;QAEH,OAAO,aAA2B,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,KAAc,EAAE,IAAY;QAC3C,MAAM,QAAQ,GAAG,KAAK,CAAC,2BAAgB,CAAC,CAAC;QACzC,OAAO,IAAI,UAAU,CACnB,QAAQ,CAAC,QAAQ,EACjB,QAAQ,CAAC,IAAI,EACb,IAAI,EACJ,QAAQ,CAAC,KAAK,EACd,QAAQ,CAAC,WAAW,EACpB,QAAQ,CAAC,gBAAgB,CAC1B,CAAC;IACJ,CAAC;IAEQ,QAAQ;QACf,OAAO,gBAAgB,IAAI,CAAC,aAAa,QAAQ,IAAI,CAAC,2BAAgB,CAAC,CAAC,QAAQ,GAAG,CAAC;IACtF,CAAC;CACF;AApHD,gCAoHC"}

package/dist/core/py-context.d.ts

@@ -0,0 +1,76 @@
+/**
+ * pynect - PyContext
+ * Manages an isolated Python execution context (namespace).
+ * Useful for running code in isolation without polluting the global namespace.
+ */
+import type { NativeAddon } from '../types/addon';
+import { PyProxy } from './py-proxy';
+/**
+ * PyContext - an isolated Python execution environment.
+ *
+ * @example
+ * ```typescript
+ * const ctx = await PyContext.create(addon);
+ *
+ * // Run code in isolation
+ * await ctx.exec('x = 42');
+ * await ctx.exec('y = x * 2');
+ * const result = await ctx.eval('x + y');
+ * console.log(result);  // 126
+ *
+ * // Import into context
+ * const pd = await ctx.import('pandas');
+ * await ctx.exec("df = pd.DataFrame({'a': [1,2,3]})");
+ * const df = await ctx.get('df');
+ * ```
+ */
+export declare class PyContext {
+    private readonly _addon;
+    private readonly _namespacePyId;
+    private _variables;
+    private _destroyed;
+    private constructor();
+    /**
+     * Create a new isolated Python context.
+     */
+    static create(addon: NativeAddon): Promise<PyContext>;
+    /**
+     * Execute Python code in this context.
+     */
+    exec(code: string): Promise<void>;
+    /**
+     * Evaluate a Python expression in this context and return the result.
+     */
+    eval(expression: string): Promise<unknown>;
+    /**
+     * Import a module into this context.
+     */
+    import(moduleName: string): Promise<PyProxy>;
+    /**
+     * Get a variable from the context namespace.
+     */
+    get(name: string): Promise<unknown>;
+    /**
+     * Set a variable in the context namespace.
+     */
+    set(name: string, value: unknown): Promise<void>;
+    /**
+     * Check if a name is defined in the context.
+     */
+    has(name: string): Promise<boolean>;
+    /**
+     * Delete a variable from the context.
+     */
+    delete(name: string): Promise<void>;
+    /**
+     * Clear all variables in the context.
+     */
+    clear(): Promise<void>;
+    /**
+     * Destroy the context and free resources.
+     */
+    destroy(): Promise<void>;
+    private _ensureNotDestroyed;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+//# sourceMappingURL=py-context.d.ts.map

package/dist/core/py-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"py-context.d.ts","sourceRoot":"","sources":["../../src/core/py-context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EAAE,OAAO,EAAoB,MAAM,YAAY,CAAC;AAMvD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAa;IAC5C,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,UAAU,CAAS;IAE3B,OAAO;IAMP;;OAEG;WACU,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC;IA2B3D;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBvC;;OAEG;IACG,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAyChD;;OAEG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA+BlD;;OAEG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmDzC;;OAEG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBtD;;OAEG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUzC;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B,OAAO,CAAC,mBAAmB;IAM3B,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;CAGvC"}