testt

Documentation

Overview

Package testt (for test tools), provides a couple of useful helpers for common test patterns. To be used as a optional companion of the assert/check library.

Index

• func Context(t testing.TB) context.Context
• func ContextWithTimeout(t testing.TB, dur time.Duration) context.Context
• func Log(t testing.TB, args ...any)
• func Logf(t testing.TB, format string, args ...any)
• func Ticker(t testing.TB, dur time.Duration) *time.Ticker
• func Timer(t testing.TB, dur time.Duration) *time.Timer

Functions

func Context

func Context(t testing.TB) context.Context

Context creates a context and attaches its cancellation function to the test execution's Cleanup. Given the execution of tests, this means that the context is canceled *after* the test functions defers have run.

func ContextWithTimeout

func ContextWithTimeout(t testing.TB, dur time.Duration) context.Context

ContextWithTimeout creates a context with the specified timeout, and attaches the cancellation to the test execution's cleanup.

func Log

func Log(t testing.TB, args ...any)

Log calls t.Log with the given arguments *if* the test has failed.

func Logf

func Logf(t testing.TB, format string, args ...any)

Logf calls t.Log with the given arguments *if* the test has failed.

func Ticker

func Ticker(t testing.TB, dur time.Duration) *time.Ticker

Ticker creates a new time.Ticker with the specified interval, and manages the cleanup of the ticker.

func Timer

func Timer(t testing.TB, dur time.Duration) *time.Timer

Timer creates a new time.Timer with the specified starting duration, and manages the cleanup of the timer.