Struct MockClock 

pub struct MockClock { /* private fields */ }

Mock clock for testing that allows controlling time

This clock implementation allows tests to:

• Set a fixed time point
• Advance time manually without actual delays
• Make time-dependent tests deterministic

The clock uses interior mutability to allow advancing time while implementing the Clock trait which takes &self.

Example

use torrust_tracker_deployer_lib::testing::MockClock;
use torrust_tracker_deployer_lib::shared::Clock;
use chrono::{TimeZone, Utc};

let fixed_time = Utc.with_ymd_and_hms(2025, 10, 7, 12, 0, 0).unwrap();
let clock = MockClock::new(fixed_time);

// Time is fixed
assert_eq!(clock.now(), fixed_time);
assert_eq!(clock.now(), fixed_time); // Still the same

// Advance time
clock.advance_secs(60);
let expected = Utc.with_ymd_and_hms(2025, 10, 7, 12, 1, 0).unwrap();
assert_eq!(clock.now(), expected);

Implementations

impl MockClock

pub fn new(initial_time: DateTime<Utc>) -> Self

Create a new mock clock with a fixed starting time

Example

use torrust_tracker_deployer_lib::testing::MockClock;
use chrono::{TimeZone, Utc};

let fixed_time = Utc.with_ymd_and_hms(2025, 10, 7, 12, 0, 0).unwrap();
let clock = MockClock::new(fixed_time);

pub fn advance(&self, duration: Duration)

Advance the clock by the specified duration

Panics

Panics if the internal mutex is poisoned (which would indicate a panic occurred while holding the lock in another thread).

Example

use torrust_tracker_deployer_lib::testing::MockClock;
use torrust_tracker_deployer_lib::shared::Clock;
use chrono::{Duration, TimeZone, Utc};

let initial = Utc.with_ymd_and_hms(2025, 10, 7, 12, 0, 0).unwrap();
let clock = MockClock::new(initial);

clock.advance(Duration::hours(2));
let expected = Utc.with_ymd_and_hms(2025, 10, 7, 14, 0, 0).unwrap();
assert_eq!(clock.now(), expected);

pub fn advance_secs(&self, secs: i64)

Advance the clock by the specified number of seconds

Convenience method for advancing time without creating a Duration.

Example

use torrust_tracker_deployer_lib::testing::MockClock;
use torrust_tracker_deployer_lib::shared::Clock;
use chrono::{TimeZone, Utc};

let initial = Utc.with_ymd_and_hms(2025, 10, 7, 12, 0, 0).unwrap();
let clock = MockClock::new(initial);

clock.advance_secs(30);
let expected = Utc.with_ymd_and_hms(2025, 10, 7, 12, 0, 30).unwrap();
assert_eq!(clock.now(), expected);

pub fn set_time(&self, time: DateTime<Utc>)

Set the clock to a specific time

Panics

Panics if the internal mutex is poisoned (which would indicate a panic occurred while holding the lock in another thread).

Example

use torrust_tracker_deployer_lib::testing::MockClock;
use torrust_tracker_deployer_lib::shared::Clock;
use chrono::{TimeZone, Utc};

let initial = Utc.with_ymd_and_hms(2025, 10, 7, 12, 0, 0).unwrap();
let clock = MockClock::new(initial);

let new_time = Utc.with_ymd_and_hms(2025, 12, 25, 18, 30, 0).unwrap();
clock.set_time(new_time);
assert_eq!(clock.now(), new_time);

Trait Implementations

impl Clock for MockClock

fn now(&self) -> DateTime<Utc>

Returns the current time in UTC

impl Clone for MockClock

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MockClock

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

Formats the value using the given formatter.