clock

package

v0.0.0-...-804b954 Latest Latest Go to latest Published: Aug 13, 2026 License: MIT Imports: 3 Imported by: 0

Details

Package clock provides explicit time sources for deterministic runtime decisions.

This section is empty.

This section is empty.

This section is empty.

type Clock interface {
	// Now returns the current UTC instant.
	Now() time.Time
}

Clock supplies UTC wall-clock instants to a consumer.

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

Fake is a concurrency-safe Clock whose time advances only when requested.

func NewFake(start time.Time) (*Fake, error)

NewFake creates a Fake at start, normalized to UTC.

func (f *Fake) Advance(delta time.Duration) error

Advance moves the fake clock forward by delta without waiting.

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

Now returns the fake clock's current UTC instant.