package quick
import "testing/quick"
Package quick 实现了帮助进行黑盒测试的实用函数。
testing/quick 包已冻结,不再接受新特性。
Index
- func Check(f any, config *Config) error
- func CheckEqual(f, g any, config *Config) error
- func Value(t reflect.Type, rand *rand.Rand) (value reflect.Value, ok bool)
- type CheckEqualError
- type CheckError
- type Config
- type Generator
- type SetupError
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