clock

package

v0.1.2 Latest Latest Go to latest Published: Oct 7, 2026 License: Apache-2.0 Imports: 2 Imported by: 0

Details

Package clock gives code that depends on the time a replaceable source of it, so tests can control expiry, long-poll timeouts and timestamps exactly.

This section is empty.

This section is empty.

This section is empty.

type Clock interface {
	Now() time.Time
	After(d time.Duration) <-chan time.Time
}

Clock tells the time and makes timers.

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

Fake is a clock that only moves when Advance is called.

func NewFake(t time.Time) *Fake

NewFake returns a fake clock set to t.

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

Advance moves the clock forward by d and fires every timer that is now due.

func (f *Fake) After(d time.Duration) <-chan time.Time

After fires once Advance moves the clock d or more past the current fake time.

func (f *Fake) Next() (time.Time, bool)

Next returns when the earliest timer waiting for the clock to move fires, and false when none waits.

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

Now returns the fake time.

func (f *Fake) Waiters() int

Waiters returns how many timers wait for the clock to move, so a test can move it once everything it expects is waiting.

type Real struct{}

Real is the system clock.

func (Real) After(d time.Duration) <-chan time.Time

After waits for d on the system clock.

func (Real) Now() time.Time

Now returns the current time.