Feature/v0.4.2/environment variables

[mavdol]

Environment variables

This PR introduces improvements to the developer experience:

1. Environment variables option

We now have an environment variable option env_variables. By default, sandboxes don't have access to your .env file. With this option, you can select variables from your .env and make them available inside your sandbox.

from capsule import task
import os

@task(name="main", env_variables=["API_KEY"])
def main() -> dict:
    api_key = os.environ.get("API_KEY")
    return {"api_key": api_key}

2. env API for TypeScript

fs isn't available in the sandbox for TypeScript. So we provide an env API to read environment variables declared in the options.

import { task, env } from "@capsule-run/sdk";

export const main = task({
    name: "main",
    envVariables: ["API_KEY"]
}, () => {
    const apiKey = env.get("API_KEY");
    return { apiKeySet: apiKey !== undefined, environment };
});

Available methods:

• env.get(key) — Get a specific environment variable (returns undefined if not found)
• env.has(key) — Check if an environment variable exists
• env.getAll() — Get all environment variables as an object