@trigger.dev/python 0.0.0-prerelease-20250226191317

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Trigger.dev
+
+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

@@ -0,0 +1,122 @@
+# Python Extension for Trigger.dev
+
+The Python extension enhances Trigger.dev's build process by enabling limited support for executing Python scripts within your tasks.
+
+## Overview
+
+This extension introduces the <code>pythonExtension</code> build extension, which offers several key capabilities:
+
+- **Install Python Dependencies (Except in Dev):** Automatically installs Python and specified dependencies using <code>pip</code>.
+- **Requirements File Support:** You can specify dependencies in a <code>requirements.txt</code> file.
+- **Inline Requirements:** Define dependencies directly within your <code>trigger.config.ts</code> file using the <code>requirements</code> option.
+- **Virtual Environment:** Creates a virtual environment (<code>/opt/venv</code>) inside containers to isolate Python dependencies.
+- **Helper Functions:** Provides a variety of functions for executing Python code:
+  - <code>run</code>: Executes Python commands with proper environment setup.
+  - <code>runInline</code>: Executes inline Python code directly from Node.
+  - <code>runScript</code>: Executes standalone <code>.py</code> script files.
+- **Custom Python Path:** In development, you can configure <code>devPythonBinaryPath</code> to point to a custom Python installation.
+
+## Usage
+
+1. Add the extension to your <code>trigger.config.ts</code> file:
+
+```typescript
+import { defineConfig } from "@trigger.dev/sdk/v3";
+import { pythonExtension } from "@trigger.dev/python/extension";
+
+export default defineConfig({
+  project: "<project ref>",
+  build: {
+    extensions: [
+      pythonExtension({
+        requirementsFile: "./requirements.txt", // Optional: Path to your requirements file
+        devPythonBinaryPath: ".venv/bin/python", // Optional: Custom Python binary path
+        scripts: ["src/python/**/*.py"], // Glob pattern for Python scripts
+      }),
+    ],
+  },
+});
+```
+
+2. (Optional) Create a <code>requirements.txt</code> file in your project root with the necessary Python dependencies.
+
+```plaintext title="requirements.txt"
+pandas==1.3.3
+numpy==1.21.2
+```
+
+```typescript title="trigger.config.ts"
+import { defineConfig } from "@trigger.dev/sdk/v3";
+import { pythonExtension } from "@trigger.dev/python/extension";
+
+export default defineConfig({
+  project: "<project ref>",
+  build: {
+    extensions: [
+      pythonExtension({
+        requirementsFile: "./requirements.txt",
+      }),
+    ],
+  },
+});
+```
+
+3. Execute Python scripts within your tasks using one of the provided functions:
+
+### Running a Python Script
+
+```typescript
+import { task } from "@trigger.dev/sdk/v3";
+import { python } from "@trigger.dev/python";
+
+export const myScript = task({
+  id: "my-python-script",
+  run: async () => {
+    const result = await python.runScript("my_script.py", ["hello", "world"]);
+    return result.stdout;
+  },
+});
+```
+
+### Running Inline Python Code
+
+```typescript
+import { task } from "@trigger.dev/sdk/v3";
+import { python } from "@trigger.dev/python";
+
+export const myTask = task({
+  id: "to_datetime-task",
+  run: async () => {
+    const result = await python.runInline(`
+import pandas as pd
+
+pd.to_datetime("${+new Date() / 1000}")
+`);
+    return result.stdout;
+  },
+});
+```
+
+### Running Lower-Level Commands
+
+```typescript
+import { task } from "@trigger.dev/sdk/v3";
+import { python } from "@trigger.dev/python";
+
+export const pythonVersionTask = task({
+  id: "python-version-task",
+  run: async () => {
+    const result = await python.run(["--version"]);
+    return result.stdout; // Expected output: Python 3.12.8
+  },
+});
+```
+
+## Limitations
+
+- This is a **partial implementation** and does not provide full Python support as an execution runtime for tasks.
+- Manual intervention may be required for installing and configuring binary dependencies in development environments.
+
+## Additional Information
+
+For more detailed documentation, visit the official docs at [Trigger.dev Documentation](https://trigger.dev/docs).

package/dist/commonjs/extension.d.ts

@@ -0,0 +1,23 @@
+import { BuildExtension } from "@trigger.dev/core/v3/build";
+export type PythonOptions = {
+    requirements?: string[];
+    requirementsFile?: string;
+    /**
+     * [Dev-only] The path to the python binary.
+     *
+     * @remarks
+     * This option is typically used during local development or in specific testing environments
+     * where a particular Python installation needs to be targeted.  It should point to the full path of the python executable.
+     *
+     * Example: `/usr/bin/python3` or `C:\\Python39\\python.exe`
+     */
+    devPythonBinaryPath?: string;
+    /**
+     * An array of glob patterns that specify which Python scripts are allowed to be executed.
+     *
+     * @remarks
+     * These scripts will be copied to the container during the build process.
+     */
+    scripts?: string[];
+};
+export declare function pythonExtension(options?: PythonOptions): BuildExtension;

package/dist/commonjs/extension.js

@@ -0,0 +1,108 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pythonExtension = pythonExtension;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_assert_1 = __importDefault(require("node:assert"));
+const internal_1 = require("@trigger.dev/build/internal");
+const splitAndCleanComments = (str) => str
+    .split("\n")
+    .map((line) => line.trim())
+    .filter((line) => line && !line.startsWith("#"));
+function pythonExtension(options = {}) {
+    return new PythonExtension(options);
+}
+class PythonExtension {
+    options;
+    name = "PythonExtension";
+    constructor(options = {}) {
+        this.options = options;
+        (0, node_assert_1.default)(!(this.options.requirements && this.options.requirementsFile), "Cannot specify both requirements and requirementsFile");
+        if (this.options.requirementsFile) {
+            (0, node_assert_1.default)(node_fs_1.default.existsSync(this.options.requirementsFile), `Requirements file not found: ${this.options.requirementsFile}`);
+            this.options.requirements = splitAndCleanComments(node_fs_1.default.readFileSync(this.options.requirementsFile, "utf-8"));
+        }
+    }
+    async onBuildComplete(context, manifest) {
+        await (0, internal_1.addAdditionalFilesToBuild)("pythonExtension", {
+            files: this.options.scripts ?? [],
+        }, context, manifest);
+        if (context.target === "dev") {
+            if (this.options.devPythonBinaryPath) {
+                process.env.PYTHON_BIN_PATH = this.options.devPythonBinaryPath;
+            }
+            return;
+        }
+        context.logger.debug(`Adding ${this.name} to the build`);
+        context.addLayer({
+            id: "python-installation",
+            image: {
+                instructions: splitAndCleanComments(`
+          # Install Python
+          RUN apt-get update && apt-get install -y --no-install-recommends \
+              python3 python3-pip python3-venv && \
+              apt-get clean && rm -rf /var/lib/apt/lists/*
+
+          # Set up Python environment
+          RUN python3 -m venv /opt/venv
+          ENV PATH="/opt/venv/bin:$PATH"
+        `),
+            },
+            deploy: {
+                env: {
+                    PYTHON_BIN_PATH: `/opt/venv/bin/python`,
+                },
+                override: true,
+            },
+        });
+        if (this.options.requirementsFile) {
+            if (this.options.requirements) {
+                context.logger.warn(`[pythonExtension] Both options.requirements and options.requirementsFile are specified. requirements will be ignored.`);
+            }
+            // Copy requirements file to the container
+            await (0, internal_1.addAdditionalFilesToBuild)("pythonExtension", {
+                files: [this.options.requirementsFile],
+            }, context, manifest);
+            // Add a layer to the build that installs the requirements
+            context.addLayer({
+                id: "python-dependencies",
+                image: {
+                    instructions: splitAndCleanComments(`
+            # Copy the requirements file
+            COPY ${this.options.requirementsFile} .
+            # Install dependencies
+            RUN pip install --no-cache-dir -r ${this.options.requirementsFile}
+          `),
+                },
+                deploy: {
+                    override: true,
+                },
+            });
+        }
+        else if (this.options.requirements) {
+            context.addLayer({
+                id: "python-dependencies",
+                build: {
+                    env: {
+                        REQUIREMENTS_CONTENT: this.options.requirements?.join("\n") || "",
+                    },
+                },
+                image: {
+                    instructions: splitAndCleanComments(`
+          ARG REQUIREMENTS_CONTENT
+          RUN echo "$REQUIREMENTS_CONTENT" > requirements.txt
+
+          # Install dependencies
+          RUN pip install --no-cache-dir -r requirements.txt
+        `),
+                },
+                deploy: {
+                    override: true,
+                },
+            });
+        }
+    }
+}
+//# sourceMappingURL=extension.js.map

package/dist/commonjs/extension.js.map

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

package/dist/commonjs/index.d.ts

@@ -0,0 +1,6 @@
+import { Options as XOptions, Result } from "tinyexec";
+export declare const python: {
+    run(scriptArgs?: string[], options?: Partial<XOptions>): Promise<Result>;
+    runScript(scriptPath: string, scriptArgs?: string[], options?: Partial<XOptions>): Promise<Result>;
+    runInline(scriptContent: string, options?: Partial<XOptions>): Promise<Result>;
+};

package/dist/commonjs/index.js

@@ -0,0 +1,90 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.python = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_assert_1 = __importDefault(require("node:assert"));
+const v3_1 = require("@trigger.dev/sdk/v3");
+const tinyexec_1 = require("tinyexec");
+const v3_2 = require("@trigger.dev/core/v3");
+const tempFiles_js_1 = require("./utils/tempFiles.js");
+exports.python = {
+    async run(scriptArgs = [], options = {}) {
+        const pythonBin = process.env.PYTHON_BIN_PATH || "python";
+        return await v3_1.logger.trace("python.run()", async (span) => {
+            const result = await (0, tinyexec_1.x)(pythonBin, scriptArgs, {
+                ...options,
+                throwOnError: false, // Ensure errors are handled manually
+            });
+            if (result.exitCode) {
+                span.setAttribute("exitCode", result.exitCode);
+            }
+            if (result.exitCode !== 0) {
+                throw new Error(`${scriptArgs.join(" ")} exited with a non-zero code ${result.exitCode}:\n${result.stderr}`);
+            }
+            return result;
+        }, {
+            attributes: {
+                pythonBin,
+                args: scriptArgs.join(" "),
+                [v3_2.SemanticInternalAttributes.STYLE_ICON]: "brand-python",
+            },
+        });
+    },
+    async runScript(scriptPath, scriptArgs = [], options = {}) {
+        (0, node_assert_1.default)(scriptPath, "Script path is required");
+        (0, node_assert_1.default)(node_fs_1.default.existsSync(scriptPath), `Script does not exist: ${scriptPath}`);
+        return await v3_1.logger.trace("python.runScript()", async (span) => {
+            span.setAttribute("scriptPath", scriptPath);
+            const result = await (0, tinyexec_1.x)(process.env.PYTHON_BIN_PATH || "python", [scriptPath, ...scriptArgs], {
+                ...options,
+                throwOnError: false,
+            });
+            if (result.exitCode) {
+                span.setAttribute("exitCode", result.exitCode);
+            }
+            if (result.exitCode !== 0) {
+                throw new Error(`${scriptPath} ${scriptArgs.join(" ")} exited with a non-zero code ${result.exitCode}:\n${result.stderr}`);
+            }
+            return result;
+        }, {
+            attributes: {
+                pythonBin: process.env.PYTHON_BIN_PATH || "python",
+                scriptPath,
+                args: scriptArgs.join(" "),
+                [v3_2.SemanticInternalAttributes.STYLE_ICON]: "brand-python",
+            },
+        });
+    },
+    async runInline(scriptContent, options = {}) {
+        (0, node_assert_1.default)(scriptContent, "Script content is required");
+        return await v3_1.logger.trace("python.runInline()", async (span) => {
+            span.setAttribute("contentLength", scriptContent.length);
+            // Using the withTempFile utility to handle the temporary file
+            return await (0, tempFiles_js_1.withTempFile)(`script_${Date.now()}.py`, async (tempFilePath) => {
+                span.setAttribute("tempFilePath", tempFilePath);
+                const pythonBin = process.env.PYTHON_BIN_PATH || "python";
+                const result = await (0, tinyexec_1.x)(pythonBin, [tempFilePath], {
+                    ...options,
+                    throwOnError: false,
+                });
+                if (result.exitCode) {
+                    span.setAttribute("exitCode", result.exitCode);
+                }
+                if (result.exitCode !== 0) {
+                    throw new Error(`Inline script exited with a non-zero code ${result.exitCode}:\n${result.stderr}`);
+                }
+                return result;
+            }, scriptContent);
+        }, {
+            attributes: {
+                pythonBin: process.env.PYTHON_BIN_PATH || "python",
+                contentPreview: scriptContent.substring(0, 100) + (scriptContent.length > 100 ? "..." : ""),
+                [v3_2.SemanticInternalAttributes.STYLE_ICON]: "brand-python",
+            },
+        });
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/commonjs/index.js.map

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

package/dist/commonjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/commonjs/utils/tempFiles.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Creates a temporary file with a custom filename, passes it to the callback function, and ensures cleanup
+ * @param filename The filename to use for the temporary file
+ * @param callback Function that receives the path to the temporary file
+ * @param content Optional content to write to the file
+ * @returns Whatever the callback returns
+ */
+export declare function withTempFile<T>(filename: string, callback: (filePath: string) => Promise<T>, content?: string | Buffer): Promise<T>;

package/dist/commonjs/utils/tempFiles.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withTempFile = withTempFile;
+const promises_1 = require("node:fs/promises");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+/**
+ * Creates a temporary file with a custom filename, passes it to the callback function, and ensures cleanup
+ * @param filename The filename to use for the temporary file
+ * @param callback Function that receives the path to the temporary file
+ * @param content Optional content to write to the file
+ * @returns Whatever the callback returns
+ */
+async function withTempFile(filename, callback, content = "") {
+    // Create temporary directory with random suffix
+    const tempDir = await (0, promises_1.mkdtemp)((0, node_path_1.join)((0, node_os_1.tmpdir)(), "app-"));
+    const tempFile = (0, node_path_1.join)(tempDir, filename);
+    try {
+        // Write to the temporary file with appropriate permissions
+        await (0, promises_1.writeFile)(tempFile, content, { mode: 0o600 });
+        // Use the file
+        return await callback(tempFile);
+    }
+    finally {
+        // Clean up
+        await (0, promises_1.rm)(tempDir, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=tempFiles.js.map

package/dist/commonjs/utils/tempFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tempFiles.js","sourceRoot":"","sources":["../../../src/utils/tempFiles.ts"],"names":[],"mappings":";;AAWA,oCAkBC;AA7BD,+CAA0D;AAC1D,qCAAiC;AACjC,yCAAiC;AAEjC;;;;;;GAMG;AACI,KAAK,UAAU,YAAY,CAChC,QAAgB,EAChB,QAA0C,EAC1C,UAA2B,EAAE;IAE7B,gDAAgD;IAChD,MAAM,OAAO,GAAG,MAAM,IAAA,kBAAO,EAAC,IAAA,gBAAI,EAAC,IAAA,gBAAM,GAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,IAAA,gBAAI,EAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAEzC,IAAI,CAAC;QACH,2DAA2D;QAC3D,MAAM,IAAA,oBAAS,EAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACpD,eAAe;QACf,OAAO,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;YAAS,CAAC;QACT,WAAW;QACX,MAAM,IAAA,aAAE,EAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC"}

package/dist/esm/extension.d.ts

@@ -0,0 +1,23 @@
+import { BuildExtension } from "@trigger.dev/core/v3/build";
+export type PythonOptions = {
+    requirements?: string[];
+    requirementsFile?: string;
+    /**
+     * [Dev-only] The path to the python binary.
+     *
+     * @remarks
+     * This option is typically used during local development or in specific testing environments
+     * where a particular Python installation needs to be targeted.  It should point to the full path of the python executable.
+     *
+     * Example: `/usr/bin/python3` or `C:\\Python39\\python.exe`
+     */
+    devPythonBinaryPath?: string;
+    /**
+     * An array of glob patterns that specify which Python scripts are allowed to be executed.
+     *
+     * @remarks
+     * These scripts will be copied to the container during the build process.
+     */
+    scripts?: string[];
+};
+export declare function pythonExtension(options?: PythonOptions): BuildExtension;

package/dist/esm/extension.js

@@ -0,0 +1,102 @@
+import fs from "node:fs";
+import assert from "node:assert";
+import { addAdditionalFilesToBuild } from "@trigger.dev/build/internal";
+const splitAndCleanComments = (str) => str
+    .split("\n")
+    .map((line) => line.trim())
+    .filter((line) => line && !line.startsWith("#"));
+export function pythonExtension(options = {}) {
+    return new PythonExtension(options);
+}
+class PythonExtension {
+    options;
+    name = "PythonExtension";
+    constructor(options = {}) {
+        this.options = options;
+        assert(!(this.options.requirements && this.options.requirementsFile), "Cannot specify both requirements and requirementsFile");
+        if (this.options.requirementsFile) {
+            assert(fs.existsSync(this.options.requirementsFile), `Requirements file not found: ${this.options.requirementsFile}`);
+            this.options.requirements = splitAndCleanComments(fs.readFileSync(this.options.requirementsFile, "utf-8"));
+        }
+    }
+    async onBuildComplete(context, manifest) {
+        await addAdditionalFilesToBuild("pythonExtension", {
+            files: this.options.scripts ?? [],
+        }, context, manifest);
+        if (context.target === "dev") {
+            if (this.options.devPythonBinaryPath) {
+                process.env.PYTHON_BIN_PATH = this.options.devPythonBinaryPath;
+            }
+            return;
+        }
+        context.logger.debug(`Adding ${this.name} to the build`);
+        context.addLayer({
+            id: "python-installation",
+            image: {
+                instructions: splitAndCleanComments(`
+          # Install Python
+          RUN apt-get update && apt-get install -y --no-install-recommends \
+              python3 python3-pip python3-venv && \
+              apt-get clean && rm -rf /var/lib/apt/lists/*
+
+          # Set up Python environment
+          RUN python3 -m venv /opt/venv
+          ENV PATH="/opt/venv/bin:$PATH"
+        `),
+            },
+            deploy: {
+                env: {
+                    PYTHON_BIN_PATH: `/opt/venv/bin/python`,
+                },
+                override: true,
+            },
+        });
+        if (this.options.requirementsFile) {
+            if (this.options.requirements) {
+                context.logger.warn(`[pythonExtension] Both options.requirements and options.requirementsFile are specified. requirements will be ignored.`);
+            }
+            // Copy requirements file to the container
+            await addAdditionalFilesToBuild("pythonExtension", {
+                files: [this.options.requirementsFile],
+            }, context, manifest);
+            // Add a layer to the build that installs the requirements
+            context.addLayer({
+                id: "python-dependencies",
+                image: {
+                    instructions: splitAndCleanComments(`
+            # Copy the requirements file
+            COPY ${this.options.requirementsFile} .
+            # Install dependencies
+            RUN pip install --no-cache-dir -r ${this.options.requirementsFile}
+          `),
+                },
+                deploy: {
+                    override: true,
+                },
+            });
+        }
+        else if (this.options.requirements) {
+            context.addLayer({
+                id: "python-dependencies",
+                build: {
+                    env: {
+                        REQUIREMENTS_CONTENT: this.options.requirements?.join("\n") || "",
+                    },
+                },
+                image: {
+                    instructions: splitAndCleanComments(`
+          ARG REQUIREMENTS_CONTENT
+          RUN echo "$REQUIREMENTS_CONTENT" > requirements.txt
+
+          # Install dependencies
+          RUN pip install --no-cache-dir -r requirements.txt
+        `),
+                },
+                deploy: {
+                    override: true,
+                },
+            });
+        }
+    }
+}
+//# sourceMappingURL=extension.js.map

package/dist/esm/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../../src/extension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AA0BxE,MAAM,qBAAqB,GAAG,CAAC,GAAW,EAAE,EAAE,CAC5C,GAAG;KACA,KAAK,CAAC,IAAI,CAAC;KACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;KAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;AAErD,MAAM,UAAU,eAAe,CAAC,UAAyB,EAAE;IACzD,OAAO,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,eAAe;IAGC;IAFJ,IAAI,GAAG,iBAAiB,CAAC;IAEzC,YAAoB,UAAyB,EAAE;QAA3B,YAAO,GAAP,OAAO,CAAoB;QAC7C,MAAM,CACJ,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAC7D,uDAAuD,CACxD,CAAC;QAEF,IAAI,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAClC,MAAM,CACJ,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAC5C,gCAAgC,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAChE,CAAC;YACF,IAAI,CAAC,OAAO,CAAC,YAAY,GAAG,qBAAqB,CAC/C,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,OAAO,CAAC,CACxD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,OAAqB,EAAE,QAAuB;QAClE,MAAM,yBAAyB,CAC7B,iBAAiB,EACjB;YACE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE;SAClC,EACD,OAAO,EACP,QAAQ,CACT,CAAC;QAEF,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YAC7B,IAAI,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC;gBACrC,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC;YACjE,CAAC;YAED,OAAO;QACT,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,IAAI,eAAe,CAAC,CAAC;QAEzD,OAAO,CAAC,QAAQ,CAAC;YACf,EAAE,EAAE,qBAAqB;YACzB,KAAK,EAAE;gBACL,YAAY,EAAE,qBAAqB,CAAC;;;;;;;;;SASnC,CAAC;aACH;YACD,MAAM,EAAE;gBACN,GAAG,EAAE;oBACH,eAAe,EAAE,sBAAsB;iBACxC;gBACD,QAAQ,EAAE,IAAI;aACf;SACF,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAClC,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;gBAC9B,OAAO,CAAC,MAAM,CAAC,IAAI,CACjB,uHAAuH,CACxH,CAAC;YACJ,CAAC;YAED,0CAA0C;YAC1C,MAAM,yBAAyB,CAC7B,iBAAiB,EACjB;gBACE,KAAK,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC;aACvC,EACD,OAAO,EACP,QAAQ,CACT,CAAC;YAEF,0DAA0D;YAC1D,OAAO,CAAC,QAAQ,CAAC;gBACf,EAAE,EAAE,qBAAqB;gBACzB,KAAK,EAAE;oBACL,YAAY,EAAE,qBAAqB,CAAC;;mBAE3B,IAAI,CAAC,OAAO,CAAC,gBAAgB;;gDAEA,IAAI,CAAC,OAAO,CAAC,gBAAgB;WAClE,CAAC;iBACH;gBACD,MAAM,EAAE;oBACN,QAAQ,EAAE,IAAI;iBACf;aACF,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;YACrC,OAAO,CAAC,QAAQ,CAAC;gBACf,EAAE,EAAE,qBAAqB;gBACzB,KAAK,EAAE;oBACL,GAAG,EAAE;wBACH,oBAAoB,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;qBAClE;iBACF;gBACD,KAAK,EAAE;oBACL,YAAY,EAAE,qBAAqB,CAAC;;;;;;SAMrC,CAAC;iBACD;gBACD,MAAM,EAAE;oBACN,QAAQ,EAAE,IAAI;iBACf;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

package/dist/esm/index.d.ts

@@ -0,0 +1,6 @@
+import { Options as XOptions, Result } from "tinyexec";
+export declare const python: {
+    run(scriptArgs?: string[], options?: Partial<XOptions>): Promise<Result>;
+    runScript(scriptPath: string, scriptArgs?: string[], options?: Partial<XOptions>): Promise<Result>;
+    runInline(scriptContent: string, options?: Partial<XOptions>): Promise<Result>;
+};

package/dist/esm/index.js

@@ -0,0 +1,84 @@
+import fs from "node:fs";
+import assert from "node:assert";
+import { logger } from "@trigger.dev/sdk/v3";
+import { x } from "tinyexec";
+import { SemanticInternalAttributes } from "@trigger.dev/core/v3";
+import { withTempFile } from "./utils/tempFiles.js";
+export const python = {
+    async run(scriptArgs = [], options = {}) {
+        const pythonBin = process.env.PYTHON_BIN_PATH || "python";
+        return await logger.trace("python.run()", async (span) => {
+            const result = await x(pythonBin, scriptArgs, {
+                ...options,
+                throwOnError: false, // Ensure errors are handled manually
+            });
+            if (result.exitCode) {
+                span.setAttribute("exitCode", result.exitCode);
+            }
+            if (result.exitCode !== 0) {
+                throw new Error(`${scriptArgs.join(" ")} exited with a non-zero code ${result.exitCode}:\n${result.stderr}`);
+            }
+            return result;
+        }, {
+            attributes: {
+                pythonBin,
+                args: scriptArgs.join(" "),
+                [SemanticInternalAttributes.STYLE_ICON]: "brand-python",
+            },
+        });
+    },
+    async runScript(scriptPath, scriptArgs = [], options = {}) {
+        assert(scriptPath, "Script path is required");
+        assert(fs.existsSync(scriptPath), `Script does not exist: ${scriptPath}`);
+        return await logger.trace("python.runScript()", async (span) => {
+            span.setAttribute("scriptPath", scriptPath);
+            const result = await x(process.env.PYTHON_BIN_PATH || "python", [scriptPath, ...scriptArgs], {
+                ...options,
+                throwOnError: false,
+            });
+            if (result.exitCode) {
+                span.setAttribute("exitCode", result.exitCode);
+            }
+            if (result.exitCode !== 0) {
+                throw new Error(`${scriptPath} ${scriptArgs.join(" ")} exited with a non-zero code ${result.exitCode}:\n${result.stderr}`);
+            }
+            return result;
+        }, {
+            attributes: {
+                pythonBin: process.env.PYTHON_BIN_PATH || "python",
+                scriptPath,
+                args: scriptArgs.join(" "),
+                [SemanticInternalAttributes.STYLE_ICON]: "brand-python",
+            },
+        });
+    },
+    async runInline(scriptContent, options = {}) {
+        assert(scriptContent, "Script content is required");
+        return await logger.trace("python.runInline()", async (span) => {
+            span.setAttribute("contentLength", scriptContent.length);
+            // Using the withTempFile utility to handle the temporary file
+            return await withTempFile(`script_${Date.now()}.py`, async (tempFilePath) => {
+                span.setAttribute("tempFilePath", tempFilePath);
+                const pythonBin = process.env.PYTHON_BIN_PATH || "python";
+                const result = await x(pythonBin, [tempFilePath], {
+                    ...options,
+                    throwOnError: false,
+                });
+                if (result.exitCode) {
+                    span.setAttribute("exitCode", result.exitCode);
+                }
+                if (result.exitCode !== 0) {
+                    throw new Error(`Inline script exited with a non-zero code ${result.exitCode}:\n${result.stderr}`);
+                }
+                return result;
+            }, scriptContent);
+        }, {
+            attributes: {
+                pythonBin: process.env.PYTHON_BIN_PATH || "python",
+                contentPreview: scriptContent.substring(0, 100) + (scriptContent.length > 100 ? "..." : ""),
+                [SemanticInternalAttributes.STYLE_ICON]: "brand-python",
+            },
+        });
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,CAAC,EAA+B,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,CAAC,GAAG,CAAC,aAAuB,EAAE,EAAE,UAA6B,EAAE;QAClE,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,QAAQ,CAAC;QAE1D,OAAO,MAAM,MAAM,CAAC,KAAK,CACvB,cAAc,EACd,KAAK,EAAE,IAAI,EAAE,EAAE;YACb,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE;gBAC5C,GAAG,OAAO;gBACV,YAAY,EAAE,KAAK,EAAE,qCAAqC;aAC3D,CAAC,CAAC;YAEH,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACpB,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;YACjD,CAAC;YAED,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CACb,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,gCAAgC,MAAM,CAAC,QAAQ,MACpE,MAAM,CAAC,MACT,EAAE,CACH,CAAC;YACJ,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC,EACD;YACE,UAAU,EAAE;gBACV,SAAS;gBACT,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC;gBAC1B,CAAC,0BAA0B,CAAC,UAAU,CAAC,EAAE,cAAc;aACxD;SACF,CACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS,CACb,UAAkB,EAClB,aAAuB,EAAE,EACzB,UAA6B,EAAE;QAE/B,MAAM,CAAC,UAAU,EAAE,yBAAyB,CAAC,CAAC;QAC9C,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,0BAA0B,UAAU,EAAE,CAAC,CAAC;QAE1E,OAAO,MAAM,MAAM,CAAC,KAAK,CACvB,oBAAoB,EACpB,KAAK,EAAE,IAAI,EAAE,EAAE;YACb,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;YAE5C,MAAM,MAAM,GAAG,MAAM,CAAC,CACpB,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,QAAQ,EACvC,CAAC,UAAU,EAAE,GAAG,UAAU,CAAC,EAC3B;gBACE,GAAG,OAAO;gBACV,YAAY,EAAE,KAAK;aACpB,CACF,CAAC;YAEF,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACpB,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;YACjD,CAAC;YAED,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CACb,GAAG,UAAU,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,gCACnC,MAAM,CAAC,QACT,MAAM,MAAM,CAAC,MAAM,EAAE,CACtB,CAAC;YACJ,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC,EACD;YACE,UAAU,EAAE;gBACV,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,QAAQ;gBAClD,UAAU;gBACV,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC;gBAC1B,CAAC,0BAA0B,CAAC,UAAU,CAAC,EAAE,cAAc;aACxD;SACF,CACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,aAAqB,EAAE,UAA6B,EAAE;QACpE,MAAM,CAAC,aAAa,EAAE,4BAA4B,CAAC,CAAC;QAEpD,OAAO,MAAM,MAAM,CAAC,KAAK,CACvB,oBAAoB,EACpB,KAAK,EAAE,IAAI,EAAE,EAAE;YACb,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;YAEzD,8DAA8D;YAC9D,OAAO,MAAM,YAAY,CACvB,UAAU,IAAI,CAAC,GAAG,EAAE,KAAK,EACzB,KAAK,EAAE,YAAY,EAAE,EAAE;gBACrB,IAAI,CAAC,YAAY,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;gBAEhD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,QAAQ,CAAC;gBAC1D,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,SAAS,EAAE,CAAC,YAAY,CAAC,EAAE;oBAChD,GAAG,OAAO;oBACV,YAAY,EAAE,KAAK;iBACpB,CAAC,CAAC;gBAEH,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACpB,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACjD,CAAC;gBAED,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;oBAC1B,MAAM,IAAI,KAAK,CACb,6CAA6C,MAAM,CAAC,QAAQ,MAAM,MAAM,CAAC,MAAM,EAAE,CAClF,CAAC;gBACJ,CAAC;gBAED,OAAO,MAAM,CAAC;YAChB,CAAC,EACD,aAAa,CACd,CAAC;QACJ,CAAC,EACD;YACE,UAAU,EAAE;gBACV,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,QAAQ;gBAClD,cAAc,EACZ,aAAa,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7E,CAAC,0BAA0B,CAAC,UAAU,CAAC,EAAE,cAAc;aACxD;SACF,CACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/dist/esm/utils/tempFiles.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Creates a temporary file with a custom filename, passes it to the callback function, and ensures cleanup
+ * @param filename The filename to use for the temporary file
+ * @param callback Function that receives the path to the temporary file
+ * @param content Optional content to write to the file
+ * @returns Whatever the callback returns
+ */
+export declare function withTempFile<T>(filename: string, callback: (filePath: string) => Promise<T>, content?: string | Buffer): Promise<T>;

package/dist/esm/utils/tempFiles.js

@@ -0,0 +1,26 @@
+import { mkdtemp, writeFile, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+/**
+ * Creates a temporary file with a custom filename, passes it to the callback function, and ensures cleanup
+ * @param filename The filename to use for the temporary file
+ * @param callback Function that receives the path to the temporary file
+ * @param content Optional content to write to the file
+ * @returns Whatever the callback returns
+ */
+export async function withTempFile(filename, callback, content = "") {
+    // Create temporary directory with random suffix
+    const tempDir = await mkdtemp(join(tmpdir(), "app-"));
+    const tempFile = join(tempDir, filename);
+    try {
+        // Write to the temporary file with appropriate permissions
+        await writeFile(tempFile, content, { mode: 0o600 });
+        // Use the file
+        return await callback(tempFile);
+    }
+    finally {
+        // Clean up
+        await rm(tempDir, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=tempFiles.js.map

package/dist/esm/utils/tempFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tempFiles.js","sourceRoot":"","sources":["../../../src/utils/tempFiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAgB,EAChB,QAA0C,EAC1C,UAA2B,EAAE;IAE7B,gDAAgD;IAChD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAEzC,IAAI,CAAC;QACH,2DAA2D;QAC3D,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACpD,eAAe;QACf,OAAO,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;YAAS,CAAC;QACT,WAAW;QACX,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,97 @@
+{
+  "name": "@trigger.dev/python",
+  "version": "0.0.0-prerelease-20250226191317",
+  "description": "Python runtime and build extension for Trigger.dev",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/triggerdotdev/trigger.dev",
+    "directory": "packages/python"
+  },
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "tshy": {
+    "selfLink": false,
+    "main": true,
+    "module": true,
+    "project": "./tsconfig.src.json",
+    "exports": {
+      "./package.json": "./package.json",
+      ".": "./src/index.ts",
+      "./extension": "./src/extension.ts"
+    },
+    "sourceDialects": [
+      "@triggerdotdev/source"
+    ]
+  },
+  "typesVersions": {
+    "*": {
+      "extension": [
+        "dist/commonjs/extension.d.ts"
+      ]
+    }
+  },
+  "dependencies": {
+    "@trigger.dev/core": "0.0.0-prerelease-20250226191317",
+    "tinyexec": "^0.3.2"
+  },
+  "devDependencies": {
+    "@types/node": "20.14.14",
+    "rimraf": "6.0.1",
+    "tshy": "^3.0.2",
+    "typescript": "^5.5.4",
+    "tsx": "4.17.0",
+    "esbuild": "^0.23.0",
+    "@arethetypeswrong/cli": "^0.15.4",
+    "@trigger.dev/build": "0.0.0-prerelease-20250226191317",
+    "@trigger.dev/sdk": "0.0.0-prerelease-20250226191317"
+  },
+  "peerDependencies": {
+    "@trigger.dev/sdk": "0.0.0-prerelease-20250226191317",
+    "@trigger.dev/build": "0.0.0-prerelease-20250226191317"
+  },
+  "engines": {
+    "node": ">=18.20.0"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "import": {
+        "@triggerdotdev/source": "./src/index.ts",
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/commonjs/index.d.ts",
+        "default": "./dist/commonjs/index.js"
+      }
+    },
+    "./extension": {
+      "import": {
+        "@triggerdotdev/source": "./src/extension.ts",
+        "types": "./dist/esm/extension.d.ts",
+        "default": "./dist/esm/extension.js"
+      },
+      "require": {
+        "types": "./dist/commonjs/extension.d.ts",
+        "default": "./dist/commonjs/extension.js"
+      }
+    }
+  },
+  "main": "./dist/commonjs/index.js",
+  "types": "./dist/commonjs/index.d.ts",
+  "module": "./dist/esm/index.js",
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "tshy && pnpm run update-version",
+    "dev": "tshy --watch",
+    "typecheck": "tsc --noEmit -p tsconfig.src.json",
+    "update-version": "tsx ../../scripts/updateVersion.ts",
+    "check-exports": "attw --pack ."
+  }
+}