Interface Clock

pkg/clock/interface.go:12–25

Clock is an interface for getting the current time and creating tickers. By abstracting time operations behind this interface, code can be written that works with both the system clock in production and controlled time in tests, enabling deterministic testing of time-dependent logic. This approach

// This approach helps avoid flaky tests caused by timing dependencies and
// allows for simulating time-based scenarios without waiting for real time to pass.
type Clock interface {
	// Now returns the current time.
	// In production implementations, this returns the system time.
	// In test implementations, this returns a controlled time that
	// can be manipulated for testing purposes.
	Now() time.Time

	// NewTicker returns a Ticker that fires every d. Production
	// implementations delegate to time.NewTicker. Test implementations
	// fire when simulated time advances past the ticker period, so a
	// background goroutine driven by NewTicker observes the same notion
	// of time as the rest of the test instead of running on real time.
	NewTicker(d time.Duration) Ticker
}

// Ticker delivers ticks on a channel at a regular cadence. It mirrors
// the surface of [time.Ticker] needed by callers that work against the