pythonlib 1.0.1 → 2.0.0

package/dist/sys-IL8LgI_W.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Python sys module for TypeScript
+ *
+ * Provides access to system-specific parameters and functions.
+ * This module provides variables and functions that interact with the
+ * interpreter and its environment.
+ *
+ * @see {@link https://docs.python.org/3/library/sys.html | Python sys documentation}
+ * @module
+ */
+/**
+ * Command line arguments passed to the script.
+ * Unlike Python, this excludes the Node.js executable and script path.
+ *
+ * @example
+ * ```typescript
+ * // node script.js arg1 arg2
+ * console.log(argv) // ["arg1", "arg2"]
+ * ```
+ */
+declare const argv: string[];
+/**
+ * A string identifying the platform (operating system).
+ *
+ * @example
+ * ```typescript
+ * console.log(platform) // "darwin", "linux", "win32", etc.
+ * ```
+ */
+declare const platform: string;
+/**
+ * A string containing the version number of the Python interpreter (emulated).
+ * Returns a custom version string for pythonlib.
+ */
+declare const version = "3.11.0 (pythonlib TypeScript implementation)";
+/**
+ * Version information as a named tuple-like object.
+ * Contains major, minor, micro, releaselevel, and serial components.
+ */
+declare const versionInfo: {
+    major: number;
+    minor: number;
+    micro: number;
+    releaselevel: "final";
+    serial: number;
+    0: number;
+    1: number;
+    2: number;
+    3: "final";
+    4: number;
+    length: number;
+    [Symbol.iterator]: () => Generator<number | "final", void, unknown>;
+};
+/**
+ * Path to the interpreter executable (Node.js executable path).
+ *
+ * @example
+ * ```typescript
+ * console.log(executable) // "/usr/local/bin/node"
+ * ```
+ */
+declare const executable: string;
+/**
+ * A list of strings specifying the search path for modules.
+ * In Node.js context, this returns module.paths or an empty array.
+ */
+declare const path: string[];
+/**
+ * Maximum value a variable of type Py_ssize_t can take.
+ * Equivalent to Number.MAX_SAFE_INTEGER in JavaScript.
+ */
+declare const maxsize: number;
+/**
+ * Standard input stream.
+ */
+declare const stdin: NodeJS.ReadStream | null;
+/**
+ * Standard output stream.
+ */
+declare const stdout: NodeJS.WriteStream | null;
+/**
+ * Standard error stream.
+ */
+declare const stderr: NodeJS.WriteStream | null;
+/**
+ * Exit from Python (terminate the process).
+ *
+ * @param code - Optional exit status code (default: 0 for success)
+ * @throws This function never returns; it terminates the process.
+ *
+ * @example
+ * ```typescript
+ * exit()    // Exit with success
+ * exit(1)   // Exit with error code 1
+ * ```
+ */
+declare function exit(code?: number): never;
+/**
+ * Return the current recursion limit.
+ * In JavaScript, this is effectively unlimited, but we return a reasonable default.
+ */
+declare function getRecursionLimit(): number;
+/**
+ * Set the maximum depth of the Python interpreter stack.
+ * This is a no-op in JavaScript as recursion is managed differently.
+ *
+ * @param limit - The new recursion limit
+ */
+declare function setRecursionLimit(limit: number): void;
+/**
+ * Return the size of an object in bytes.
+ * This is an approximation as JavaScript doesn't provide exact memory sizes.
+ *
+ * @param obj - Object to measure
+ * @returns Approximate size in bytes
+ */
+declare function getSizeOf(obj: unknown): number;
+/**
+ * Return the reference count for the object.
+ * JavaScript uses garbage collection, so this always returns a placeholder value.
+ *
+ * @param _obj - Object to check
+ * @returns Always returns 1 (reference counting not available in JS)
+ */
+declare function getRefCount(obj: unknown): number;
+/**
+ * Return the default string encoding used by the Unicode implementation.
+ */
+declare function getDefaultEncoding(): string;
+/**
+ * Return the name of the encoding used to convert filenames.
+ */
+declare function getFilesystemEncoding(): string;
+/**
+ * Integer specifying the API version, in Node.js context returns 0.
+ */
+declare const apiVersion = 0;
+/**
+ * A string giving the site-specific directory prefix.
+ */
+declare const prefix: string;
+/**
+ * Byte order indicator: "little" or "big".
+ */
+declare const byteorder: "little" | "big";
+/**
+ * Float representation info (similar to Python's sys.float_info).
+ */
+declare const floatInfo: {
+    max: number;
+    maxExp: number;
+    max10Exp: number;
+    min: number;
+    minExp: number;
+    min10Exp: number;
+    dig: number;
+    mant_dig: number;
+    epsilon: number;
+    radix: number;
+    rounds: number;
+};
+/**
+ * Integer representation info (similar to Python's sys.int_info).
+ */
+declare const intInfo: {
+    bitsPerDigit: number;
+    sizeofDigit: number;
+    defaultMaxStrDigits: number;
+    strDigitsCheckThreshold: number;
+};
+/**
+ * Hash implementation info.
+ */
+declare const hashInfo: {
+    width: number;
+    modulus: bigint;
+    inf: number;
+    nan: number;
+    imag: number;
+    algorithm: string;
+    hashBits: number;
+    seedBits: number;
+};
+
+declare const sysModule_apiVersion: typeof apiVersion;
+declare const sysModule_argv: typeof argv;
+declare const sysModule_byteorder: typeof byteorder;
+declare const sysModule_executable: typeof executable;
+declare const sysModule_exit: typeof exit;
+declare const sysModule_floatInfo: typeof floatInfo;
+declare const sysModule_getDefaultEncoding: typeof getDefaultEncoding;
+declare const sysModule_getFilesystemEncoding: typeof getFilesystemEncoding;
+declare const sysModule_getRecursionLimit: typeof getRecursionLimit;
+declare const sysModule_getRefCount: typeof getRefCount;
+declare const sysModule_getSizeOf: typeof getSizeOf;
+declare const sysModule_hashInfo: typeof hashInfo;
+declare const sysModule_intInfo: typeof intInfo;
+declare const sysModule_maxsize: typeof maxsize;
+declare const sysModule_path: typeof path;
+declare const sysModule_platform: typeof platform;
+declare const sysModule_prefix: typeof prefix;
+declare const sysModule_setRecursionLimit: typeof setRecursionLimit;
+declare const sysModule_stderr: typeof stderr;
+declare const sysModule_stdin: typeof stdin;
+declare const sysModule_stdout: typeof stdout;
+declare const sysModule_version: typeof version;
+declare const sysModule_versionInfo: typeof versionInfo;
+declare namespace sysModule {
+  export { sysModule_apiVersion as apiVersion, sysModule_argv as argv, sysModule_byteorder as byteorder, sysModule_executable as executable, sysModule_exit as exit, sysModule_floatInfo as floatInfo, sysModule_getDefaultEncoding as getDefaultEncoding, sysModule_getFilesystemEncoding as getFilesystemEncoding, sysModule_getRecursionLimit as getRecursionLimit, sysModule_getRefCount as getRefCount, sysModule_getSizeOf as getSizeOf, sysModule_hashInfo as hashInfo, sysModule_intInfo as intInfo, sysModule_maxsize as maxsize, sysModule_path as path, sysModule_platform as platform, sysModule_prefix as prefix, sysModule_setRecursionLimit as setRecursionLimit, sysModule_stderr as stderr, sysModule_stdin as stdin, sysModule_stdout as stdout, sysModule_version as version, sysModule_versionInfo as versionInfo };
+}
+
+export { argv as a, versionInfo as b, path as c, stdin as d, executable as e, stdout as f, stderr as g, exit as h, getRecursionLimit as i, setRecursionLimit as j, getSizeOf as k, getRefCount as l, maxsize as m, getDefaultEncoding as n, getFilesystemEncoding as o, platform as p, apiVersion as q, prefix as r, sysModule as s, byteorder as t, floatInfo as u, version as v, intInfo as w, hashInfo as x };

package/dist/sys.d.ts

@@ -0,0 +1 @@
+export { q as apiVersion, a as argv, t as byteorder, e as executable, h as exit, u as floatInfo, n as getDefaultEncoding, o as getFilesystemEncoding, i as getRecursionLimit, l as getRefCount, k as getSizeOf, x as hashInfo, w as intInfo, m as maxsize, c as path, p as platform, r as prefix, j as setRecursionLimit, g as stderr, d as stdin, f as stdout, v as version, b as versionInfo } from './sys-IL8LgI_W.js';

package/dist/sys.js

@@ -0,0 +1,51 @@
+import {
+  apiVersion,
+  argv,
+  byteorder,
+  executable,
+  exit,
+  floatInfo,
+  getDefaultEncoding,
+  getFilesystemEncoding,
+  getRecursionLimit,
+  getRefCount,
+  getSizeOf,
+  hashInfo,
+  intInfo,
+  maxsize,
+  path,
+  platform,
+  prefix,
+  setRecursionLimit,
+  stderr,
+  stdin,
+  stdout,
+  version,
+  versionInfo
+} from "./chunk-U4X5DEIP.js";
+import "./chunk-MLKGABMK.js";
+export {
+  apiVersion,
+  argv,
+  byteorder,
+  executable,
+  exit,
+  floatInfo,
+  getDefaultEncoding,
+  getFilesystemEncoding,
+  getRecursionLimit,
+  getRefCount,
+  getSizeOf,
+  hashInfo,
+  intInfo,
+  maxsize,
+  path,
+  platform,
+  prefix,
+  setRecursionLimit,
+  stderr,
+  stdin,
+  stdout,
+  version,
+  versionInfo
+};

package/dist/tempfile.browser-DciOKfNm.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Python tempfile module for TypeScript - Browser version
+ *
+ * Browser stub - temporary file operations are not available.
+ *
+ * @see {@link https://docs.python.org/3/library/tempfile.html | Python tempfile documentation}
+ * @module
+ */
+/**
+ * Return the name of the directory used for temporary files.
+ */
+declare function getTempDir(): string;
+/**
+ * Return the default prefix for temporary names.
+ */
+declare function getPrefix(): string;
+/**
+ * Generate a unique temporary file path (does not create the file).
+ * Browser stub - returns a path that would be used in Node.js.
+ */
+declare function mktemp(suffix?: string, prefix?: string, dir?: string): string;
+/**
+ * Create a temporary file and return [handle, path].
+ * Browser stub - throws error.
+ */
+declare function mkstemp(_suffix?: string, _prefix?: string, _dir?: string): Promise<[unknown, string]>;
+/**
+ * Create a temporary directory and return its path.
+ * Browser stub - throws error.
+ */
+declare function mkdtemp(_suffix?: string, _prefix?: string, _dir?: string): Promise<string>;
+/**
+ * Named temporary file - Browser stub.
+ */
+declare class NamedTemporaryFile {
+    readonly name: string;
+    readonly deleteOnClose: boolean;
+    private constructor();
+    static create(_options?: {
+        mode?: string;
+        suffix?: string;
+        prefix?: string;
+        dir?: string;
+        delete?: boolean;
+    }): Promise<NamedTemporaryFile>;
+    write(_data: string | Uint8Array): Promise<number>;
+    read(_size?: number): Promise<Uint8Array>;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+}
+/**
+ * Temporary directory - Browser stub.
+ */
+declare class TemporaryDirectory {
+    readonly name: string;
+    private constructor();
+    static create(_options?: {
+        suffix?: string;
+        prefix?: string;
+        dir?: string;
+    }): Promise<TemporaryDirectory>;
+    cleanup(): Promise<void>;
+}
+
+type tempfileModule_NamedTemporaryFile = NamedTemporaryFile;
+declare const tempfileModule_NamedTemporaryFile: typeof NamedTemporaryFile;
+type tempfileModule_TemporaryDirectory = TemporaryDirectory;
+declare const tempfileModule_TemporaryDirectory: typeof TemporaryDirectory;
+declare const tempfileModule_getPrefix: typeof getPrefix;
+declare const tempfileModule_getTempDir: typeof getTempDir;
+declare const tempfileModule_mkdtemp: typeof mkdtemp;
+declare const tempfileModule_mkstemp: typeof mkstemp;
+declare const tempfileModule_mktemp: typeof mktemp;
+declare namespace tempfileModule {
+  export { tempfileModule_NamedTemporaryFile as NamedTemporaryFile, tempfileModule_TemporaryDirectory as TemporaryDirectory, tempfileModule_getPrefix as getPrefix, tempfileModule_getTempDir as getTempDir, tempfileModule_mkdtemp as mkdtemp, tempfileModule_mkstemp as mkstemp, tempfileModule_mktemp as mktemp };
+}
+
+export { NamedTemporaryFile as N, TemporaryDirectory as T, getPrefix as a, mkstemp as b, mkdtemp as c, getTempDir as g, mktemp as m, tempfileModule as t };

package/dist/tempfile.browser.d.ts

@@ -0,0 +1 @@
+export { N as NamedTemporaryFile, T as TemporaryDirectory, a as getPrefix, g as getTempDir, c as mkdtemp, b as mkstemp, m as mktemp } from './tempfile.browser-DciOKfNm.js';

package/dist/tempfile.browser.js

@@ -0,0 +1,19 @@
+import {
+  NamedTemporaryFile,
+  TemporaryDirectory,
+  getPrefix,
+  getTempDir,
+  mkdtemp,
+  mkstemp,
+  mktemp
+} from "./chunk-2YTO24B5.js";
+import "./chunk-MLKGABMK.js";
+export {
+  NamedTemporaryFile,
+  TemporaryDirectory,
+  getPrefix,
+  getTempDir,
+  mkdtemp,
+  mkstemp,
+  mktemp
+};

package/dist/tempfile.node-bVMY60Cu.d.ts

@@ -0,0 +1,195 @@
+import { FileHandle } from 'node:fs/promises';
+
+/**
+ * Python tempfile module for TypeScript
+ *
+ * Provides async functions for creating temporary files and directories.
+ * All filesystem operations use the async fs/promises API.
+ *
+ * @see {@link https://docs.python.org/3/library/tempfile.html | Python tempfile documentation}
+ * @module
+ */
+
+/**
+ * Return the default directory for temporary files.
+ *
+ * @returns The temporary directory path
+ */
+declare function gettempdir(): string;
+/**
+ * Generate a unique temporary file path (but don't create the file).
+ *
+ * Note: This is deprecated in Python but still useful in some cases.
+ * Consider using mkstemp() or NamedTemporaryFile() instead.
+ *
+ * @param suffix - Optional suffix for the filename
+ * @param prefix - Optional prefix for the filename (default: "tmp")
+ * @param dir - Optional directory (default: system temp dir)
+ * @returns Path to the temporary file
+ */
+declare function mktemp(suffix?: string, prefix?: string, dir?: string): string;
+/**
+ * Create a temporary file and return a tuple of (handle, path).
+ *
+ * @param suffix - Optional suffix for the filename
+ * @param prefix - Optional prefix for the filename (default: "tmp")
+ * @param dir - Optional directory (default: system temp dir)
+ * @param text - If true, open in text mode (default: false)
+ * @returns Promise of tuple [FileHandle, path]
+ *
+ * @example
+ * ```typescript
+ * const [handle, path] = await mkstemp(".txt", "myapp-")
+ * await handle.write(Buffer.from("data"))
+ * await handle.close()
+ * ```
+ */
+declare function mkstemp(suffix?: string, prefix?: string, dir?: string, _text?: boolean): Promise<[FileHandle, string]>;
+/**
+ * Create a temporary directory and return its path.
+ *
+ * @param suffix - Optional suffix for the directory name
+ * @param prefix - Optional prefix for the directory name (default: "tmp")
+ * @param dir - Optional parent directory (default: system temp dir)
+ * @returns Promise of path to the created directory
+ *
+ * @example
+ * ```typescript
+ * const dir = await mkdtemp("", "myapp-")
+ * // Use directory...
+ * await rm(dir, { recursive: true })
+ * ```
+ */
+declare function mkdtemp(suffix?: string, prefix?: string, dir?: string): Promise<string>;
+/**
+ * A named temporary file with async operations.
+ *
+ * Use the static `create()` method to instantiate (constructors cannot be async).
+ *
+ * @example
+ * ```typescript
+ * const tmp = await NamedTemporaryFile.create({ suffix: ".txt" })
+ * await tmp.write("hello world")
+ * await tmp.close() // File is deleted if deleteOnClose is true
+ * ```
+ */
+declare class NamedTemporaryFile {
+    /** The file handle */
+    readonly handle: FileHandle;
+    /** The file path */
+    readonly name: string;
+    /** Whether to delete the file on close */
+    readonly deleteOnClose: boolean;
+    private _closed;
+    private constructor();
+    /**
+     * Create a new NamedTemporaryFile.
+     */
+    static create(options?: {
+        suffix?: string;
+        prefix?: string;
+        dir?: string;
+        delete?: boolean;
+        mode?: string;
+    }): Promise<NamedTemporaryFile>;
+    /**
+     * Write data to the file.
+     */
+    write(data: string | Uint8Array): Promise<number>;
+    /**
+     * Read data from the file.
+     */
+    read(size?: number): Promise<Buffer>;
+    /**
+     * Seek to a position in the file.
+     */
+    seek(_offset: number, _whence?: number): void;
+    /**
+     * Flush the file buffer.
+     */
+    flush(): Promise<void>;
+    /**
+     * Close the file.
+     */
+    close(): Promise<void>;
+    /**
+     * Check if the file is closed.
+     */
+    get closed(): boolean;
+}
+/**
+ * A temporary directory that cleans itself up.
+ *
+ * Use the static `create()` method to instantiate (constructors cannot be async).
+ *
+ * @example
+ * ```typescript
+ * const tmp = await TemporaryDirectory.create({ prefix: "myapp-" })
+ * // Use tmp.name as directory path...
+ * await tmp.cleanup() // Removes directory and contents
+ * ```
+ */
+declare class TemporaryDirectory {
+    /** The directory path */
+    readonly name: string;
+    private _cleaned;
+    private constructor();
+    /**
+     * Create a new TemporaryDirectory.
+     */
+    static create(options?: {
+        suffix?: string;
+        prefix?: string;
+        dir?: string;
+    }): Promise<TemporaryDirectory>;
+    /**
+     * Remove the temporary directory and its contents.
+     */
+    cleanup(): Promise<void>;
+}
+/**
+ * Create a temporary file that is automatically deleted when closed.
+ *
+ * @param options - Options for creating the file
+ * @returns Promise of NamedTemporaryFile object
+ */
+declare function namedTemporaryFile(options?: {
+    suffix?: string;
+    prefix?: string;
+    dir?: string;
+    delete?: boolean;
+    mode?: string;
+}): Promise<NamedTemporaryFile>;
+/**
+ * Create a temporary directory that is automatically cleaned up.
+ *
+ * @param options - Options for creating the directory
+ * @returns Promise of TemporaryDirectory object
+ */
+declare function temporaryDirectory(options?: {
+    suffix?: string;
+    prefix?: string;
+    dir?: string;
+}): Promise<TemporaryDirectory>;
+/**
+ * Return the name of the file used to store temporary file names.
+ * This is platform-specific and may not exist on all systems.
+ */
+declare function gettempprefix(): string;
+
+type tempfileModule_NamedTemporaryFile = NamedTemporaryFile;
+declare const tempfileModule_NamedTemporaryFile: typeof NamedTemporaryFile;
+type tempfileModule_TemporaryDirectory = TemporaryDirectory;
+declare const tempfileModule_TemporaryDirectory: typeof TemporaryDirectory;
+declare const tempfileModule_gettempdir: typeof gettempdir;
+declare const tempfileModule_gettempprefix: typeof gettempprefix;
+declare const tempfileModule_mkdtemp: typeof mkdtemp;
+declare const tempfileModule_mkstemp: typeof mkstemp;
+declare const tempfileModule_mktemp: typeof mktemp;
+declare const tempfileModule_namedTemporaryFile: typeof namedTemporaryFile;
+declare const tempfileModule_temporaryDirectory: typeof temporaryDirectory;
+declare namespace tempfileModule {
+  export { tempfileModule_NamedTemporaryFile as NamedTemporaryFile, tempfileModule_TemporaryDirectory as TemporaryDirectory, tempfileModule_gettempdir as gettempdir, tempfileModule_gettempprefix as gettempprefix, tempfileModule_mkdtemp as mkdtemp, tempfileModule_mkstemp as mkstemp, tempfileModule_mktemp as mktemp, tempfileModule_namedTemporaryFile as namedTemporaryFile, tempfileModule_temporaryDirectory as temporaryDirectory };
+}
+
+export { NamedTemporaryFile as N, TemporaryDirectory as T, mkstemp as a, mkdtemp as b, temporaryDirectory as c, gettempprefix as d, gettempdir as g, mktemp as m, namedTemporaryFile as n, tempfileModule as t };

package/dist/tempfile.node.d.ts

@@ -0,0 +1,2 @@
+import 'node:fs/promises';
+export { N as NamedTemporaryFile, T as TemporaryDirectory, g as gettempdir, d as gettempprefix, b as mkdtemp, a as mkstemp, m as mktemp, n as namedTemporaryFile, c as temporaryDirectory } from './tempfile.node-bVMY60Cu.js';

package/dist/tempfile.node.js

@@ -0,0 +1,23 @@
+import {
+  NamedTemporaryFile,
+  TemporaryDirectory,
+  gettempdir,
+  gettempprefix,
+  mkdtemp,
+  mkstemp,
+  mktemp,
+  namedTemporaryFile,
+  temporaryDirectory
+} from "./chunk-UGZ5OY5Z.js";
+import "./chunk-MLKGABMK.js";
+export {
+  NamedTemporaryFile,
+  TemporaryDirectory,
+  gettempdir,
+  gettempprefix,
+  mkdtemp,
+  mkstemp,
+  mktemp,
+  namedTemporaryFile,
+  temporaryDirectory
+};