Struct TestQueryContext 

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

Test context for query functions.

Provides an isolated testing environment for queries with configurable authentication and optional database access.

Example

// Simple authenticated context
let ctx = TestQueryContext::authenticated(Uuid::new_v4());

// Context with roles and claims
let ctx = TestQueryContext::builder()
    .as_user(Uuid::new_v4())
    .with_role("admin")
    .with_claim("org_id", json!("org-123"))
    .build();

Fields

auth: AuthContext

Authentication context.

request: RequestMetadata

Request metadata.

Implementations

impl TestQueryContext

pub fn builder() -> TestQueryContextBuilder

Create a new builder.

pub fn minimal() -> Self

Create a minimal unauthenticated context (no database).

pub fn authenticated(user_id: Uuid) -> Self

Create an authenticated context with the given user ID (no database).

pub fn with_pool(pool: PgPool, user_id: Option<Uuid>) -> Self

Create a context with a database pool.

pub fn db(&self) -> Option<&PgPool>

Get the database pool (if available).

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

Get the authenticated user ID or return an error.

pub fn require_subject(&self) -> Result<&str>

Like require_user_id() but for non-UUID auth providers.

pub fn has_role(&self, role: &str) -> bool

Check if a specific role is present.

pub fn claim(&self, key: &str) -> Option<&Value>

Get a claim value.

pub fn tenant_id(&self) -> Option<Uuid>

Get the tenant ID (if set).

pub fn env_mock(&self) -> &MockEnvProvider

Get the mock env provider for verification.

Trait Implementations

impl EnvAccess for TestQueryContext

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>

Get a required environment variable.

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

where T::Err: Display,

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

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

where T::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.