package quick

import "testing/quick"

Package quick 实现了帮助进行黑盒测试的实用函数。

testing/quick 包已冻结,不再接受新特性。

Index

Functions

func Check

func Check(f any, config *Config) error

Check 为 f(任何返回 bool 的函数)寻找一个使 f 返回 false 的输入。 它使用每个参数的任意值重复调用 f。如果 f 在某个输入上返回 false, Check 将该输入作为 *CheckError 返回。 例如:

func TestOddMultipleOfThree(t *testing.T) {
	f := func(x int) bool {
		y := OddMultipleOfThree(x)
		return y%2 == 1 && y%3 == 0
	}
	if err := quick.Check(f, nil); err != nil {
		t.Error(err)
	}
}

func CheckEqual

func CheckEqual(f, g any, config *Config) error

CheckEqual 寻找一个使 f 和 g 返回不同结果的输入。 它使用每个参数的任意值重复调用 f 和 g。 如果 f 和 g 返回不同的答案,CheckEqual 返回一个 *CheckEqualError, 其中描述该输入和输出。

func Value

func Value(t reflect.Type, rand *rand.Rand) (value reflect.Value, ok bool)

Value 返回给定类型的任意值。 如果该类型实现了 Generator 接口,则会使用它。 注意:要为结构体创建任意值,所有字段都必须导出。

Types

type CheckEqualError

type CheckEqualError struct {
	CheckError
	Out1 []any
	Out2 []any
}

CheckEqualError 是 CheckEqual 发现错误的结果。

func (*CheckEqualError) Error
func (s *CheckEqualError) Error() string

type CheckError

type CheckError struct {
	Count int
	In    []any
}

CheckError 是 Check 发现错误的结果。

func (*CheckError) Error
func (s *CheckError) Error() string

type Config

type Config struct {
	// MaxCount 设置最大迭代次数。
	// 如果为零,则使用 MaxCountScale。
	MaxCount int
	// MaxCountScale 是应用于默认最大值的非负缩放因子。
	// 计数为零表示使用默认值,该值通常为 100,
	// 但可以通过 -quickchecks 标志设置。
	MaxCountScale float64
	// Rand 指定随机数来源。
	// 如果为 nil,将使用默认的伪随机源。
	Rand *rand.Rand
	// Values 指定一个函数,用于生成与被测函数参数
	// 相匹配的任意 reflect.Value 切片。
	// 如果为 nil,则使用顶层 Value 函数来生成它们。
	Values func([]reflect.Value, *rand.Rand)
}

Config 结构体包含运行测试的选项。

type Generator

type Generator interface {
	// Generate 返回该方法所属类型的一个随机实例,
	// 并将 size 用作大小提示。
	Generate(rand *rand.Rand, size int) reflect.Value
}

Generator 可以生成其自身类型的随机值。

type SetupError

type SetupError string

SetupError 表示 check 使用方式出错的结果,与被测函数无关。

func (SetupError) Error
func (s SetupError) Error() string