@trigger.dev/python 0.0.0-python-preview-20250226140121

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,102 @@
+# 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>pythonBinaryPath</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
+        pythonBinaryPath: path.join(rootDir, `.venv/bin/python`), // Optional: Custom Python binary path
+        scripts: ["my_script.py"], // List of Python scripts to include
+      }),
+    ],
+  },
+});
+```
+
+2. (Optional) Create a <code>requirements.txt</code> file in your project root with the necessary Python dependencies.
+
+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
+
+pandas.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.
+- Only basic Python script execution is supported; scripts are not automatically copied to staging/production containers.
+- 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,24 @@
+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`
+     */
+    pythonBinaryPath?: 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;
+export default pythonExtension;

package/dist/commonjs/extension.js

@@ -0,0 +1,83 @@
+"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 core_1 = require("@trigger.dev/build/extensions/core");
+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, core_1.additionalFiles)({
+            files: this.options.scripts ?? [],
+        }).onBuildComplete(context, manifest);
+        if (context.target === "dev") {
+            if (this.options.pythonBinaryPath) {
+                process.env.PYTHON_BIN_PATH = this.options.pythonBinaryPath;
+            }
+            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,
+            },
+        });
+        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,
+            },
+        });
+    }
+}
+exports.default = pythonExtension;
+//# 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":";;;;;AAkCA,0CAEC;AApCD,sDAAyB;AACzB,8DAAiC;AACjC,6DAAqE;AA0BrE,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,SAAgB,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,IAAA,qBAAM,EACJ,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,IAAA,qBAAM,EACJ,iBAAE,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,iBAAE,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,IAAA,sBAAe,EAAC;YACpB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE;SAClC,CAAC,CAAC,eAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAEvC,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YAC7B,IAAI,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;gBAClC,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC;YAC9D,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,OAAO,CAAC,QAAQ,CAAC;YACf,EAAE,EAAE,qBAAqB;YACzB,KAAK,EAAE;gBACL,GAAG,EAAE;oBACH,oBAAoB,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;iBAClE;aACF;YACD,KAAK,EAAE;gBACL,YAAY,EAAE,qBAAqB,CAAC;;;;;;SAMnC,CAAC;aACH;YACD,MAAM,EAAE;gBACN,QAAQ,EAAE,IAAI;aACf;SACF,CAAC,CAAC;IACL,CAAC;CACF;AAED,kBAAe,eAAe,CAAC"}

package/dist/commonjs/index.d.ts

@@ -0,0 +1,10 @@
+import { Options as XOptions, Result } from "tinyexec";
+export declare const run: (scriptArgs?: string[], options?: Partial<XOptions>) => Promise<Result>;
+export declare const runScript: (scriptPath: string, scriptArgs?: string[], options?: Partial<XOptions>) => Promise<Result>;
+export declare const runInline: (scriptContent: string, options?: Partial<XOptions>) => Promise<import("tinyexec").Output>;
+declare const _default: {
+    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<import("tinyexec").Output>;
+};
+export default _default;

package/dist/commonjs/index.js

@@ -0,0 +1,56 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInline = exports.runScript = exports.run = 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 run = async (scriptArgs = [], options = {}) => {
+    const pythonBin = process.env.PYTHON_BIN_PATH || "python";
+    return await v3_1.logger.trace("Python call", async (span) => {
+        span.addEvent("Properties", {
+            command: `${pythonBin} ${scriptArgs.join(" ")}`,
+        });
+        const result = await (0, tinyexec_1.x)(pythonBin, scriptArgs, {
+            ...options,
+            throwOnError: false, // Ensure errors are handled manually
+        });
+        span.addEvent("Output", { ...result });
+        if (result.exitCode !== 0) {
+            v3_1.logger.error(result.stderr, { ...result });
+            throw new Error(`Python command exited with non-zero code ${result.exitCode}`);
+        }
+        return result;
+    });
+};
+exports.run = run;
+const 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 (0, exports.run)([scriptPath, ...scriptArgs], options);
+};
+exports.runScript = runScript;
+const runInline = async (scriptContent, options = {}) => {
+    (0, node_assert_1.default)(scriptContent, "Script content is required");
+    const tmpFile = `/tmp/script_${Date.now()}.py`;
+    await node_fs_1.default.promises.writeFile(tmpFile, scriptContent, { mode: 0o600 });
+    try {
+        return await (0, exports.runScript)(tmpFile, [], options);
+    }
+    finally {
+        try {
+            await node_fs_1.default.promises.unlink(tmpFile);
+        }
+        catch (error) {
+            v3_1.logger.warn(`Failed to clean up temporary file ${tmpFile}:`, {
+                error: error.stack || error.message,
+            });
+        }
+    }
+};
+exports.runInline = runInline;
+exports.default = { run: exports.run, runScript: exports.runScript, runInline: exports.runInline };
+//# 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":";;;;;;AAAA,sDAAyB;AACzB,8DAAiC;AACjC,4CAA6C;AAC7C,uCAA0D;AAEnD,MAAM,GAAG,GAAG,KAAK,EACtB,aAAuB,EAAE,EACzB,UAA6B,EAAE,EACd,EAAE;IACnB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,QAAQ,CAAC;IAE1D,OAAO,MAAM,WAAM,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtD,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE;YAC1B,OAAO,EAAE,GAAG,SAAS,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;SAChD,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,IAAA,YAAC,EAAC,SAAS,EAAE,UAAU,EAAE;YAC5C,GAAG,OAAO;YACV,YAAY,EAAE,KAAK,EAAE,qCAAqC;SAC3D,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QAEvC,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YAC1B,WAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,4CAA4C,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjF,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAzBW,QAAA,GAAG,OAyBd;AAEK,MAAM,SAAS,GAAG,CACvB,UAAkB,EAClB,aAAuB,EAAE,EACzB,UAA6B,EAAE,EAC/B,EAAE;IACF,IAAA,qBAAM,EAAC,UAAU,EAAE,yBAAyB,CAAC,CAAC;IAC9C,IAAA,qBAAM,EAAC,iBAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,0BAA0B,UAAU,EAAE,CAAC,CAAC;IAE1E,OAAO,IAAA,WAAG,EAAC,CAAC,UAAU,EAAE,GAAG,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC,CAAC;AATW,QAAA,SAAS,aASpB;AAEK,MAAM,SAAS,GAAG,KAAK,EAAE,aAAqB,EAAE,UAA6B,EAAE,EAAE,EAAE;IACxF,IAAA,qBAAM,EAAC,aAAa,EAAE,4BAA4B,CAAC,CAAC;IAEpD,MAAM,OAAO,GAAG,eAAe,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC;IAC/C,MAAM,iBAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAErE,IAAI,CAAC;QACH,OAAO,MAAM,IAAA,iBAAS,EAAC,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YACH,MAAM,iBAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAM,CAAC,IAAI,CAAC,qCAAqC,OAAO,GAAG,EAAE;gBAC3D,KAAK,EAAG,KAAe,CAAC,KAAK,IAAK,KAAe,CAAC,OAAO;aAC1D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAjBW,QAAA,SAAS,aAiBpB;AAEF,kBAAe,EAAE,GAAG,EAAH,WAAG,EAAE,SAAS,EAAT,iBAAS,EAAE,SAAS,EAAT,iBAAS,EAAE,CAAC"}

package/dist/commonjs/package.json

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

package/dist/esm/extension.d.ts

@@ -0,0 +1,24 @@
+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`
+     */
+    pythonBinaryPath?: 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;
+export default pythonExtension;

package/dist/esm/extension.js

@@ -0,0 +1,77 @@
+import fs from "node:fs";
+import assert from "node:assert";
+import { additionalFiles } from "@trigger.dev/build/extensions/core";
+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 additionalFiles({
+            files: this.options.scripts ?? [],
+        }).onBuildComplete(context, manifest);
+        if (context.target === "dev") {
+            if (this.options.pythonBinaryPath) {
+                process.env.PYTHON_BIN_PATH = this.options.pythonBinaryPath;
+            }
+            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,
+            },
+        });
+        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,
+            },
+        });
+    }
+}
+export default pythonExtension;
+//# 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,eAAe,EAAE,MAAM,oCAAoC,CAAC;AA0BrE,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,eAAe,CAAC;YACpB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE;SAClC,CAAC,CAAC,eAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAEvC,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YAC7B,IAAI,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;gBAClC,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC;YAC9D,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,OAAO,CAAC,QAAQ,CAAC;YACf,EAAE,EAAE,qBAAqB;YACzB,KAAK,EAAE;gBACL,GAAG,EAAE;oBACH,oBAAoB,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;iBAClE;aACF;YACD,KAAK,EAAE;gBACL,YAAY,EAAE,qBAAqB,CAAC;;;;;;SAMnC,CAAC;aACH;YACD,MAAM,EAAE;gBACN,QAAQ,EAAE,IAAI;aACf;SACF,CAAC,CAAC;IACL,CAAC;CACF;AAED,eAAe,eAAe,CAAC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,10 @@
+import { Options as XOptions, Result } from "tinyexec";
+export declare const run: (scriptArgs?: string[], options?: Partial<XOptions>) => Promise<Result>;
+export declare const runScript: (scriptPath: string, scriptArgs?: string[], options?: Partial<XOptions>) => Promise<Result>;
+export declare const runInline: (scriptContent: string, options?: Partial<XOptions>) => Promise<import("tinyexec").Output>;
+declare const _default: {
+    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<import("tinyexec").Output>;
+};
+export default _default;

package/dist/esm/index.js

@@ -0,0 +1,47 @@
+import fs from "node:fs";
+import assert from "node:assert";
+import { logger } from "@trigger.dev/sdk/v3";
+import { x } from "tinyexec";
+export const run = async (scriptArgs = [], options = {}) => {
+    const pythonBin = process.env.PYTHON_BIN_PATH || "python";
+    return await logger.trace("Python call", async (span) => {
+        span.addEvent("Properties", {
+            command: `${pythonBin} ${scriptArgs.join(" ")}`,
+        });
+        const result = await x(pythonBin, scriptArgs, {
+            ...options,
+            throwOnError: false, // Ensure errors are handled manually
+        });
+        span.addEvent("Output", { ...result });
+        if (result.exitCode !== 0) {
+            logger.error(result.stderr, { ...result });
+            throw new Error(`Python command exited with non-zero code ${result.exitCode}`);
+        }
+        return result;
+    });
+};
+export const runScript = (scriptPath, scriptArgs = [], options = {}) => {
+    assert(scriptPath, "Script path is required");
+    assert(fs.existsSync(scriptPath), `Script does not exist: ${scriptPath}`);
+    return run([scriptPath, ...scriptArgs], options);
+};
+export const runInline = async (scriptContent, options = {}) => {
+    assert(scriptContent, "Script content is required");
+    const tmpFile = `/tmp/script_${Date.now()}.py`;
+    await fs.promises.writeFile(tmpFile, scriptContent, { mode: 0o600 });
+    try {
+        return await runScript(tmpFile, [], options);
+    }
+    finally {
+        try {
+            await fs.promises.unlink(tmpFile);
+        }
+        catch (error) {
+            logger.warn(`Failed to clean up temporary file ${tmpFile}:`, {
+                error: error.stack || error.message,
+            });
+        }
+    }
+};
+export default { run, runScript, runInline };
+//# 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;AAE1D,MAAM,CAAC,MAAM,GAAG,GAAG,KAAK,EACtB,aAAuB,EAAE,EACzB,UAA6B,EAAE,EACd,EAAE;IACnB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,QAAQ,CAAC;IAE1D,OAAO,MAAM,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtD,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE;YAC1B,OAAO,EAAE,GAAG,SAAS,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;SAChD,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE;YAC5C,GAAG,OAAO;YACV,YAAY,EAAE,KAAK,EAAE,qCAAqC;SAC3D,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QAEvC,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,4CAA4C,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjF,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,UAAkB,EAClB,aAAuB,EAAE,EACzB,UAA6B,EAAE,EAC/B,EAAE;IACF,MAAM,CAAC,UAAU,EAAE,yBAAyB,CAAC,CAAC;IAC9C,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,0BAA0B,UAAU,EAAE,CAAC,CAAC;IAE1E,OAAO,GAAG,CAAC,CAAC,UAAU,EAAE,GAAG,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,aAAqB,EAAE,UAA6B,EAAE,EAAE,EAAE;IACxF,MAAM,CAAC,aAAa,EAAE,4BAA4B,CAAC,CAAC;IAEpD,MAAM,OAAO,GAAG,eAAe,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC;IAC/C,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAErE,IAAI,CAAC;QACH,OAAO,MAAM,SAAS,CAAC,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,qCAAqC,OAAO,GAAG,EAAE;gBAC3D,KAAK,EAAG,KAAe,CAAC,KAAK,IAAK,KAAe,CAAC,OAAO;aAC1D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC"}

package/dist/esm/package.json

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

package/package.json

@@ -0,0 +1,93 @@
+{
+  "name": "@trigger.dev/python",
+  "version": "0.0.0-python-preview-20250226140121",
+  "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/build": "0.0.0-python-preview-20250226140121",
+    "@trigger.dev/core": "0.0.0-python-preview-20250226140121",
+    "@trigger.dev/sdk": "0.0.0-python-preview-20250226140121",
+    "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"
+  },
+  "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 ."
+  }
+}