clock

package

v0.1.0 Latest Latest Go to latest Published: Mar 23, 2026 License: MIT Imports: 2 Imported by: 0

Details

This section is empty.

This section is empty.

This section is empty.

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

Clock abstracts time operations for deterministic testing.

func System() Clock

System returns a Clock backed by the real system time.

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

MockClock is a deterministic clock for testing.

func Mock(now time.Time) *MockClock

Mock returns a manually-controlled Clock for tests.

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

Advance moves the clock forward by d and fires any expired timers.

func (m *MockClock) After(d time.Duration) <-chan time.Time

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

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

func (m *MockClock) Set(t time.Time)

Set sets the clock to an absolute time and fires any expired timers.

func (m *MockClock) Since(t time.Time) time.Duration

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

Timer abstracts time.Timer for testability.