clock

package

v0.3.0 Latest Latest Go to latest Published: May 13, 2026 License: MIT Imports: 2 Imported by: 0

Details

Package clock provides an injectable time source for paper-board services.

Real returns wall-clock time in UTC. Fake is settable for tests.

This section is empty.

This section is empty.

This section is empty.

type Clock interface {
	Now() time.Time
}

Clock returns the current time. All implementations MUST return UTC.

type Fake struct {
	// contains filtered or unexported fields
}

Fake is a controllable clock for tests. Safe for concurrent use.

func NewFake(t time.Time) *Fake

NewFake returns a Fake initialised at t (normalised to UTC).

func (f *Fake) Advance(d time.Duration)

Advance moves the fake clock forward (or back, if d is negative) by d.

func (f *Fake) Now() time.Time

Now returns the currently set fake time (UTC).

func (f *Fake) Set(t time.Time)

Set replaces the fake time (normalised to UTC).

type Real struct{}

Real is the production wall-clock implementation.

func (Real) Now() time.Time

Now returns time.Now() converted to UTC.