coder
diff --git a/‎clock/clock.go
Lines changed: 23 additions & 0 deletions b/‎clock/clock.go
Lines changed: 23 additions & 0 deletions
@@ -0,0 +1,23 @@
+// Package clock is a library for testing time related code.  It exports an interface Clock that
+// mimics the standard library time package functions.  In production, an implementation that calls
+// thru to the standard libary is used.  In testing, a Mock clock is used to precisely control and
+// intercept time functions.
+package clock
+
+import (
+	"context"
+	"time"
+)
+
+type Clock interface {
+	// NewContextTicker is a convenience function that calls f on the interval d until either the
+	// given context expires or f returns an error.  Callers may call Wait() on the returned Waiter
+	// to wait until this happens and obtain the errror.
+	NewContextTicker(ctx context.Context, d time.Duration, f func() error, tags ...string) Waiter
+	NewTimer(d time.Duration, tags ...string) *Timer
+}
+
+// Waiter can be waited on for an error.
+type Waiter interface {
+	Wait(tags ...string) error
+}