VirtualClock (GenServerVirtualTime v0.1.0)

A GenServer that manages virtual time for testing time-dependent behaviors.

The VirtualClock maintains a virtual timestamp and scheduled events. Time can be advanced manually, triggering all events scheduled up to that point.

Example

iex> {:ok, clock} = VirtualClock.start_link()
iex> VirtualClock.now(clock)
0
iex> VirtualClock.advance(clock, 1000)
{:ok, 1000}
iex> VirtualClock.now(clock)
1000

Summary

Functions

advance(clock, amount)

Advances the virtual clock by the specified amount. All events scheduled up to the new time will be triggered.

advance_to_next(clock)

Advances the virtual clock to the next scheduled event. Returns the time advanced, or 0 if no events are scheduled.

cancel_timer(clock, ref)

Cancels a scheduled timer.

child_spec(init_arg)

Returns a specification to start this module under a supervisor.

now(clock)

Gets the current virtual time.

scheduled_count(clock)

Returns the number of events currently scheduled.

send_after(clock, dest, message, delay)

Schedules a message to be sent after a delay in virtual time. Returns a reference that can be used to cancel the timer.

start_link(opts \\ [])

Starts a new virtual clock.