runner

Documentation

Overview

Package runner executes test.Test values under Go's native test framework and other test frameworks with a similar interface.

Index

• type Input
• type Output
• type OutputGenerator
• type Runner
  • func (r *Runner[T]) Run(t T, x test.Test)
• type TestingT

Types

type Input

type Input interface {
	io.Reader

	// Language returns the language of the input value, if known, e.g. "json",
	// "yaml", etc.
	Language() string

	// Attributes returns a set of key-value pairs that provide additional
	// loader-specific information about the input.
	Attributes() map[string]string
}

Input is an interface for the input to a test.

type Output

type Output interface {
	io.Writer

	// Language returns the expected language of the output value, if known,
	// e.g. "json", "yaml", etc.
	Language() string

	// Attributes returns a set of key-value pairs that provide additional
	// loader-specific information about the expected output.
	Attributes() map[string]string
}

Output is an interface for producing the output for a test.

type OutputGenerator

type OutputGenerator[T TestingT[T]] func(T, Input, Output) error

OutputGenerator produces the output of a specific test.

type Runner

type Runner[T TestingT[T]] struct {
	GenerateOutput OutputGenerator[T]
	TrimSpace      bool // TODO: make this a loader concern
}

Runner executes tests under any test framework with an interface similar to Go's native *testing.T.

func (*Runner[T]) Run

func (r *Runner[T]) Run(t T, x test.Test)

Run makes the assertions described by all documents within a [TestSuite].

type TestingT

type TestingT[T any] interface {
	Helper()
	Log(...any)
	SkipNow()
	Fail()
	Failed() bool
	Run(string, func(T)) bool
}

TestingT is a constraint for types that are compatible with testing.T.