Struct TestCronContext 

pub struct TestCronContext {
    pub run_id: Uuid,
    pub cron_name: String,
    pub scheduled_time: DateTime<Utc>,
    pub execution_time: DateTime<Utc>,
    pub timezone: String,
    pub is_catch_up: bool,
    pub auth: AuthContext,
    pub log: TestCronLog,
    /* private fields */
}

Test context for cron functions.

Provides an isolated testing environment for crons with delay detection, catch-up simulation, and structured logging.

Example

let ctx = TestCronContext::builder("daily_cleanup")
    .scheduled_at(Utc::now() - Duration::minutes(5))
    .build();

assert!(ctx.is_late());

ctx.log.info("Starting cleanup");
assert_eq!(ctx.log.entries().len(), 1);

Fields

run_id: Uuid

Cron run ID.

cron_name: String

Cron name.

scheduled_time: DateTime<Utc>

Scheduled time.

execution_time: DateTime<Utc>

Execution time.

timezone: String

Timezone.

is_catch_up: bool

Whether this is a catch-up run.

auth: AuthContext

Authentication context.

log: TestCronLog

Structured logger.

Implementations

impl TestCronContext

pub fn builder(cron_name: impl Into<String>) -> TestCronContextBuilder

Create a new builder.

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

Get the database pool (if available).

pub fn http(&self) -> &MockHttp

Get the mock HTTP client.

pub fn delay(&self) -> Duration

Get the delay between scheduled and actual execution time.

pub fn is_late(&self) -> bool

Check if the cron is running late (more than 1 minute delay).

pub fn env_mock(&self) -> &MockEnvProvider

Get the mock env provider for verification.

Trait Implementations

impl EnvAccess for TestCronContext

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.