clock

package

v0.2.0 Latest Latest Go to latest Published: Apr 30, 2026 License: MIT Imports: 2 Imported by: 0

Details

Package clock provides a time abstraction so business logic can be tested deterministically. Production code uses Real; tests use Fake.

This section is empty.

This section is empty.

This section is empty.

type Clock interface {
	Now() time.Time
}

Clock returns the current time. All decay-and-reinforce logic accepts a Clock so tests can fast-forward without sleeping.

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

Fake is a controllable Clock for tests.

func NewFake(t time.Time) *Fake

NewFake creates a Fake initialized to the given time.

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

Advance moves the fake's clock forward by d.

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

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

Set replaces the fake's current time.

type Real struct{}

Real returns the wall-clock time.

func (Real) Now() time.Time