Struct TimeOptions

#[non_exhaustive]
pub struct TimeOptions<F = fn() -> DateTime<Utc>> {
    pub leeway: TimeDelta,
    pub clock_fn: F,
}

Time-related options for token creation and validation.

If the clock crate feature is on (and it’s on by default), TimeOptions can be created using the Default impl or [Self::from_leeway()]. If the feature is off, you can still create options using a generic constructor.

Examples

// Default options.
let default_options = TimeOptions::default();
let options_with_custom_leeway =
    TimeOptions::from_leeway(Duration::seconds(5));
// Options that have a fixed time. Can be useful for testing.
let clock_time = Utc::now();
let options_with_stopped_clock =
    TimeOptions::new(Duration::seconds(10), move || clock_time);

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

leeway: TimeDelta

Leeway to use during validation.

clock_fn: F

Source of the current timestamps.

Implementations

impl<F> TimeOptions<F>

where F: Fn() -> DateTime<Utc>,

pub const fn new(leeway: TimeDelta, clock_fn: F) -> TimeOptions<F>

Creates options based on the specified time leeway and clock function.

Trait Implementations

impl<F> Clone for TimeOptions<F>

where F: Clone,

fn clone(&self) -> TimeOptions<F>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<F> Debug for TimeOptions<F>

where F: Debug,

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

Formats the value using the given formatter.

impl<F> Copy for TimeOptions<F>

where F: Copy,