assert

Documentation

Overview

Package assert implements assertions for the standard testing package.

Index

• func AsErr[T Param](t TB, err error, target any, formatAndArgs ...any)
• func Equal[T Param, V any](t TB, got, want V, formatAndArgs ...any)
• func IsErr[T Param](t TB, err, target error, formatAndArgs ...any)
• func NoErr[T Param](t TB, err error, formatAndArgs ...any)
• func Panics[T Param](t TB, fn func(), v any, formatAndArgs ...any)
• type E
• type F
• type Param
• type TB

Functions

func AsErr

func AsErr[T Param](t TB, err error, target any, formatAndArgs ...any)

AsErr asserts that errors.As(err, target) is true.

func Equal

func Equal[T Param, V any](t TB, got, want V, formatAndArgs ...any)

Equal asserts that two values are equal.

func IsErr

func IsErr[T Param](t TB, err, target error, formatAndArgs ...any)

IsErr asserts that errors.Is(err, target) is true.

func NoErr

func NoErr[T Param](t TB, err error, formatAndArgs ...any)

NoErr asserts that the error is nil.

func Panics

func Panics[T Param](t TB, fn func(), v any, formatAndArgs ...any)

Panics asserts that the given function panics with the argument v. If v is nil, the panic argument is ignored.

Types

type E

type E struct{}

E is a Param that marks the test as failed but continues execution (similar to testing.T.Errorf).

type F

type F struct{}

F is a Param that marks the test as failed and stops execution (similar to testing.T.Fatalf).

type Param

type Param interface {
	// contains filtered or unexported methods
}

Param controls the behavior of an assertion if it fails. Either E or F must be specified as the type parameter.

type TB

type TB interface {
	Helper()
	Errorf(format string, args ...any)
	Fatalf(format string, args ...any)
}

TB is a tiny subset of testing.TB.