Struct TestActionContext 

pub struct TestActionContext {
    pub auth: AuthContext,
    pub request: RequestMetadata,
    /* private fields */
}

Test context for action functions.

Provides an isolated testing environment for actions with HTTP mocking, configurable authentication, and optional database access.

Example

let ctx = TestActionContext::builder()
    .as_user(Uuid::new_v4())
    .mock_http_json("https://api.example.com/*", json!({"status": "ok"}))
    .build();

// Make HTTP call (will return mocked response)
let response = ctx.http().execute(...).await;

// Verify HTTP call was made
ctx.http().assert_called("https://api.example.com/*");

Fields

auth: AuthContext

Authentication context.

request: RequestMetadata

Request metadata.

Implementations

impl TestActionContext

pub fn builder() -> TestActionContextBuilder

Create a new builder.

pub fn minimal() -> TestActionContext

Create a minimal unauthenticated context.

pub fn authenticated(user_id: Uuid) -> TestActionContext

Create an authenticated context.

pub fn db(&self) -> Option<&Pool<Postgres>>

Get the database pool (if available).

pub fn http(&self) -> &MockHttp

Get the mock HTTP client.

pub fn job_dispatch(&self) -> &MockJobDispatch

Get the mock job dispatch for verification.

pub fn workflow_dispatch(&self) -> &MockWorkflowDispatch

Get the mock workflow dispatch for verification.

pub fn require_user_id(&self) -> Result<Uuid, ForgeError>

Get the authenticated user ID or return an error.

pub async fn dispatch_job<T>( &self, job_type: &str, args: T, ) -> Result<Uuid, ForgeError>

where T: Serialize,

Dispatch a job (records for later verification).

pub async fn start_workflow<T>( &self, name: &str, input: T, ) -> Result<Uuid, ForgeError>

where T: Serialize,

Start a workflow (records for later verification).

pub fn env_mock(&self) -> &MockEnvProvider

Get the mock env provider for verification.

Trait Implementations

impl EnvAccess for TestActionContext

fn env_provider(&self) -> &dyn EnvProvider

Get the environment provider.

fn env(&self, key: &str) -> Option<String>

Get an environment variable.

fn env_or(&self, key: &str, default: &str) -> String

Get an environment variable with a default value.

fn env_require(&self, key: &str) -> Result<String, ForgeError>

Get a required environment variable.

fn env_parse<T>(&self, key: &str) -> Result<T, ForgeError>

where T: FromStr, <T as FromStr>::Err: Display,

Get an environment variable and parse it to the specified type.

fn env_parse_or<T>(&self, key: &str, default: T) -> Result<T, ForgeError>

where T: FromStr, <T as FromStr>::Err: Display,

Get an environment variable and parse it, with a default.

fn env_contains(&self, key: &str) -> bool

Check if an environment variable is set.