clock

package

v1.0.0 Latest Latest Go to latest Published: Nov 6, 2026 License: MIT Imports: 3 Imported by: 0

Details

Package clock supplies injectable clocks and cancellable waiting.

This section is empty.

This section is empty.

func Wait(ctx context.Context, c Clock, d time.Duration) error

Wait waits using an injected clock, stopping on context cancellation.

type Clock interface {
	Now() time.Time
	NewTimer(time.Duration) Timer
}

Clock abstracts current time and owned timers.

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

Manual advances only when Advance is called; timers have buffered channels.

func NewManual(now time.Time) *Manual

NewManual creates a deterministic manual clock.

func (m *Manual) Advance(d time.Duration)

Advance advances the manual clock and fires due timers.

func (m *Manual) NewTimer(d time.Duration) Timer

NewTimer creates an owned timer.

func (m *Manual) Now() time.Time

Now returns the current UTC time.

type Real struct{}

Real uses the system UTC clock and timers.

func (Real) NewTimer(d time.Duration) Timer

NewTimer creates an owned timer.

func (Real) Now() time.Time

Now returns the current UTC time.

type Timer interface {
	C() <-chan time.Time
	Stop() bool
}

Timer exposes timer delivery and cancellation.