Function TestSpec_PublicAPI_FormatDuration

pkg/timeutil/spec_test.go:17–48

TestSpec_PublicAPI_FormatDuration validates the documented behavior of FormatDuration as described in the timeutil package README.md specification. Spec section: "### FormatDuration(d time.Duration) string"

(t *testing.T)

// as described in the timeutil package README.md specification.
// Spec section: "### FormatDuration(d time.Duration) string"
func TestSpec_PublicAPI_FormatDuration(t *testing.T) {
	tests := []struct {
		name     string
		input    time.Duration
		expected string
	}{
		// From spec range table: < 1µs → e.g. "500ns"
		{name: "sub-microsecond outputs nanoseconds", input: 500 * time.Nanosecond, expected: "500ns"},
		// From spec range table: 1µs – < 1ms → e.g. "250µs"
		{name: "microsecond range outputs µs", input: 250 * time.Microsecond, expected: "250µs"},
		// From spec range table: 1ms – < 1s → e.g. "750ms"
		{name: "millisecond range outputs ms", input: 750 * time.Millisecond, expected: "750ms"},
		// From spec range table: 1s – < 1min → e.g. "2.5s"
		{name: "second range outputs s with decimal", input: 2500 * time.Millisecond, expected: "2.5s"},
		// From spec range table: 1min – < 1h → e.g. "1.3m"
		{name: "minute range outputs m with decimal", input: 90 * time.Second, expected: "1.5m"},
		// From spec range table: ≥ 1h → e.g. "2.0h"
		{name: "hour range outputs h with decimal", input: 2 * time.Hour, expected: "2.0h"},
		// From spec code examples
		{name: "spec example: 500ms → 500ms", input: 500 * time.Millisecond, expected: "500ms"},
		{name: "spec example: 2500ms → 2.5s", input: 2500 * time.Millisecond, expected: "2.5s"},
		{name: "spec example: 90s → 1.5m", input: 90 * time.Second, expected: "1.5m"},
	}

	for _, tt := range tests {
		t.Run(tt.name, func(t *testing.T) {
			result := timeutil.FormatDuration(tt.input)
			assert.Equal(t, tt.expected, result,
				"FormatDuration(%v) should return %q as documented in spec", tt.input, tt.expected)
		})
	}
}

// TestSpec_PublicAPI_FormatDurationMs validates the documented behavior of FormatDurationMs
// as described in the timeutil package README.md specification.