Struct CompiledSchedule 

pub struct CompiledSchedule {
    pub overlap_policy: OverlapPolicy,
    pub on_failure: ScheduleOnFailure,
    pub max_runs: Option<u64>,
    pub max_consecutive_failures: Option<u64>,
    pub start_immediately: bool,
    pub run_timeout: Option<Duration>,
    pub shutdown_grace: Duration,
    /* private fields */
}

Available on crate feature schedule only.

A ScheduleSpec whose cron + timezone have been parsed and whose invariants have been checked. Built once at startup; next_after is called per tick.

Fields

overlap_policy: OverlapPolicy

on_failure: ScheduleOnFailure

max_runs: Option<u64>

max_consecutive_failures: Option<u64>

start_immediately: bool

run_timeout: Option<Duration>

shutdown_grace: Duration

Implementations

impl CompiledSchedule

pub fn compile(spec: &ScheduleSpec) -> CliResult<Self>

Validate + compile. Every problem surfaces here, never mid-run.

pub fn clock_at(&self, at: DateTime<Utc>) -> DateTime<FixedOffset>

Render a UTC instant in the schedule’s timezone, as a fixed-offset clock for ${now.*} interpolation.

pub fn next_after(&self, after: DateTime<Utc>) -> Option<DateTime<Utc>>

The next UTC instant strictly after after that matches the cron in the configured timezone. None when there is no such occurrence.

Operating on strictly-increasing UTC instants gives the production-cron semantics: a DST fall-back repeated hour fires once, a spring-forward skipped hour rolls to the next valid time, and occurrences that elapsed between two after values are simply skipped (no backfill).

pub fn next_due_after_tick( &self, fired: DateTime<Utc>, now: DateTime<Utc>, ) -> Option<DateTime<Utc>>

The next due tick after firing the tick scheduled for fired, given the current wall clock now.

Advances from the scheduled tick (not wall-clock now) so an occurrence isn’t silently skipped merely because dispatch latency pushed the clock past it — the loop fires the returned tick promptly even if it is already slightly in the past (this is the sub-minute-skip fix). But if firing that occurrence would still leave a further occurrence already elapsed (the process was suspended across many ticks), the backlog is collapsed to the next occurrence strictly after now, so a long sleep produces a single catch-up run rather than a flood of backfilled runs. Returns None when the schedule has no further occurrence.

Trait Implementations

impl Debug for CompiledSchedule

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.