Module env 

Typesafe environment variable access for FORGE functions.

This module provides a centralized, testable abstraction for reading environment variables. Instead of scattering std::env::var() calls throughout your functions, use ctx.env() methods which:

• Provide type-safe parsing with clear error messages
• Are easily mockable in tests via test context builders
• Record which variables were accessed (for debugging)

Example

#[forge::action]
async fn call_stripe(ctx: &ActionContext, input: ChargeInput) -> Result<Charge> {
    // Get required env var (returns error if missing)
    let api_key = ctx.env_require("STRIPE_API_KEY")?;

    // Get optional env var with default
    let timeout = ctx.env_or("STRIPE_TIMEOUT", "30");

    // Get and parse to specific type
    let max_retries: u32 = ctx.env_parse("STRIPE_MAX_RETRIES")?;

    // ...
}

Testing

#[test]
fn test_stripe_action() {
    let ctx = TestActionContext::builder()
        .with_env("STRIPE_API_KEY", "sk_test_xxx")
        .with_env("STRIPE_TIMEOUT", "60")
        .build();

    // Function will use mocked env vars
}

Structs

MockEnvProvider

Mock environment provider for testing.

RealEnvProvider

Production environment provider that reads from std::env.

Traits

EnvAccess

Extension methods for environment variable access on contexts.

EnvProvider

Trait for environment variable access.