diff --git a/.circleci/config.yml b/.circleci/config.yml index 5ada2f0..a7b8fa2 100644 --- a/.circleci/config.yml +++ b/.circleci/config.yml @@ -10,6 +10,7 @@ commands: setup: steps: - checkout + - restore_cache: keys: - go-mod-v4-{{ checksum "go.sum" }}-{{ .Environment.CACHE_VERSION }} @@ -20,14 +21,31 @@ commands: - save_cache: key: go-mod-v4-{{ checksum "go.sum" }}-{{ .Environment.CACHE_VERSION }} paths: - - "/go/pkg/mod" + - /go/pkg/mod + + - restore_cache: + keys: + - gotip-{{ .Environment.CACHE_VERSION }} + - run: + name: Install gotip + command: | + command -v /go/bin/gotip && echo "Skipping gotip installation" && exit + go install golang.org/dl/gotip@latest + - save_cache: + key: gotip-{{ .Environment.CACHE_VERSION }} + paths: + - /go/bin/gotip + - run: + name: Run gotip download + command: | # Nov 12 (https://go-review.googlesource.com/c/go/+/359478) + yes | gotip download 359478 || true setup-lint: description: Set up lint parameters: version: type: string - default: v1.40.1 + default: v1.43.0 steps: - restore_cache: keys: @@ -68,7 +86,7 @@ commands: - run: name: Install goimports command: | - command -v /go/bin/goimports && echo "Skipping go-acc installation" && exit + command -v /go/bin/goimports && echo "Skipping goimports installation" && exit go get -v golang.org/x/tools/cmd/goimports - save_cache: @@ -123,4 +141,3 @@ workflows: - lint - test - gen - diff --git a/.golangci.yml b/.golangci.yml index db2f26b..bc76426 100644 --- a/.golangci.yml +++ b/.golangci.yml @@ -104,7 +104,7 @@ linters-settings: sizeThreshold: 256 gofumpt: - lang-version: "1.16" + lang-version: "1.18" extra-rules: true goimports: @@ -117,11 +117,11 @@ linters-settings: enableAllRules: true staticcheck: - go: "1.16" + go: "1.18" checks: [all] stylecheck: - go: "1.16" + go: "1.18" checks: [all] linters: @@ -147,6 +147,7 @@ linters: - thelper # enforce t.Helper() - varcheck # unused global var and const - wastedassign + disable: fast: false issues: @@ -156,3 +157,12 @@ issues: - dupl - gocognit - gocyclo + + # temporary fixes for unsupported type parameters syntax + exclude: + - "expected .*, found .*" + - "expected expression" + - "undeclared name: `any`" + - "missing ',' in parameter list" + - "missing element type in array type expression" + - "mixed named and unnamed parameters" diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 1d98386..30b5cdd 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -26,7 +26,6 @@ The main documentation can help understand how the repository globally works: - [Go package documentation](https://pkg.go.dev/github.com/drykit-go/testx#section-documentation) - [Main Readme](./README.md) - [Package `check` Readme](./check/README.md) -- [Package `checkconv` Readme](./checkconv/README.md) ## Internal documentation @@ -36,7 +35,6 @@ The main documentation can help understand how the repository globally works: . # Package testx (test runners) ├── bin # Binary files (for code generation) ├── check # Package check (checkers interfaces & providers) -├── checkconv # Package checkconv (checkers conversion) ├── cmd # Runnable source files │   └── gen # Code generation main command └── internal # Cross-packages utilities for internal use only @@ -55,47 +53,19 @@ The main documentation can help understand how the repository globally works: We use code generation to reduce code repetition, and consequently reduce the complexity of implementations and the risks of errors. -We have 2 use cases for that: -- Generate repetitive declarations for each checker type declared in `internal/gen/types.go`. -- Generate public interfaces of checker providers from their implementation. +We have 1 use case for that: generate public interfaces of checker providers +from their implementation. #### Generated files The following files are generated: -
- Generated files - - - - - - - - - - - - - - - - - - - - - - - - - -
FileUse case
check/check.goCheckers types declarations
check/checkers.goCheckers types declarations
check/providers.goCheckers providers interfaces
checkconv/assert.goCheckers types declarations
-
+- `check/providers.go` These files should **never** be manually edited, as specified in their header (your IDE will likely inform you it shouldn't be edited if you attempt to). +If an update is needed, re-generated them using the command described below. #### Command @@ -111,11 +81,8 @@ then runs all `//go:generate` directives found in the whole repository. Located in `gen.go` files, these directives execute `bin/gen` binary with various arguments. -Run this command each time: - -- you declare a new checker type (in file `internal/gen/types.go`) -- you implement a new `check.CheckerProvider` or update one -in a way that changes its public interface, which includes: +Run this command each time you implement a new `check.CheckerProvider` +or update one in a way that changes its public interface, which includes: - Adding/removing a method - Changing a method signature (a parameter name change counts) - Editing a doc comment for a method @@ -126,18 +93,6 @@ To illustrate the process described above, let's implement `check.Complex128`, a `check.Complex128CheckerProvider` that performs checks on type `complex128`: -1. In file `internal/gen/types.go`, add a new entry to `types`: - ```go - {N: "Complex128", T: "complex128"}, - ``` - Note: `N` is the **Name** of the checker provider, while **T** refers - to the **Type** of the value it checks. Technically, the former could be - any valid name, whereas the second must be a valid Go type. - -1. Run `make gen` -This generates `check.Complex128Checker` interface along with other -necessary declarations to work with this new type. - 1. Create file `check/providers_complex128.go` and implement `complex128CheckerProvider` following the existing models. @@ -157,11 +112,13 @@ Here are some contributing suggestions: ## Dev environment -For an optimal dev experience, we recommend: +This branches uses Go 1.18 type parameters, which is yet to be released. +As a consequence it has specific requirements: -- Go 1.16 or higher ([download](https://golang.org/dl/)) +- Go 1.18 (we recommand using the wrapper [`gotip`](https://pkg.go.dev/golang.org/dl/gotip)) - `make` commands available (native on Unix-based systems) - `golangci-lint` to run linters locally ([installation](https://golangci-lint.run/usage/install/#local-installation)) + Note: it currently doesn't work properly with type parameters syntax. ## Conventions @@ -170,6 +127,8 @@ For an optimal dev experience, we recommend: Code style conventions are enforced by `golangci-lint`. Run `make lint` to ensure your code is compliant. +Note: the linter currently doesn't work properly with type parameters syntax. + ### Unit tests We try to maintain a high level of test coverage, so we encourage you diff --git a/Makefile b/Makefile index 1142a52..845b719 100644 --- a/Makefile +++ b/Makefile @@ -9,9 +9,9 @@ default: .PHONY: gen gen: @echo "🛠 Building gen binary" - @go build -o ./bin/gen ./cmd/gen/main.go + @gotip build -o ./bin/gen ./cmd/gen/main.go @echo "✅ Done\n" - @go generate ./... + @gotip generate ./... # Check code @@ -26,11 +26,11 @@ lint: .PHONY: tests tests: - @go test ./... + @gotip test ./... .PHONY: test-cov test-cov: # Unit tests with coverage, excluding gen-related files - @go-acc --ignore cmd/gen,internal/gen ./... + @GO_TEST_BINARY="gotip test" go-acc --ignore cmd/gen,internal/gen ./... TEST_FUNC=^.*$$ ifdef t @@ -43,7 +43,7 @@ endif .PHONY: test test: - @go test -timeout 30s -run $(TEST_FUNC) $(TEST_PKG) + @gotip test -timeout 30s -run $(TEST_FUNC) $(TEST_PKG) # Docs diff --git a/README.md b/README.md index bf5da05..a9d3923 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,6 @@ testx testx/check - testx/checkconv @@ -22,7 +21,7 @@

`testx` is a Go testing library that provides test runners to write reliable -and expressive unit tests effortlessly, with minimal boilerplate. +and expressive unit tests with minimal boilerplate. ## Table of contents @@ -58,11 +57,11 @@ go get -u github.com/drykit-go/testx func TestGet42(t *testing.T) { testx.Value(Get42()). Exp(42). // expect 42 - Not(3, "hello"). // expect not 3 nor "hello" - Pass(checkconv.AssertMany( // expect to pass input checkers: + Not(3, 4, 5). // expect not 3 nor 4 nor 5 + Pass( // expect to pass all input checkers: check.Int.InRange(41, 43), // expect in range [41:43] // ... - )...). + ). Run(t) } ``` @@ -185,7 +184,3 @@ Related examples: - Package `check` 📄 [Readme](./check/README.md) > Package `check` provides extensible and customizable checkers to perform checks on typed values. - -- Package `checkconv` 📄 [Readme](./checkconv/README.md) - > Package `checkconv` provides conversion utilities to convert any typed checker to a `check.ValueChecker` - diff --git a/check/README.md b/check/README.md index 8122158..7be0885 100644 --- a/check/README.md +++ b/check/README.md @@ -4,7 +4,6 @@ testx testx/check - testx/checkconv @@ -24,22 +23,14 @@ for `testx` test runners. ## Checker interfaces -A checker is a type-specific interface composed of 2 funcs `Pass` and `Explain`: +A _checker_ is a generic interface composed of 2 methods `Pass` and `Explain`: ```go -// IntChecker provides methods to run checks on type int. -type IntChecker interface { - IntPasser - Explainer +// Checker provides methods to run checks on any typed value. +type Checker[T any] interface { + Pass(got T) bool + Explain(label string, got interface{}) string } - -// IntPasser provides a method Pass(got int) bool to determinate -// whether the got int passes a check. -type IntPasser interface { Pass(got int) bool } - - -// Explainer provides a method Explain to describe the reason of a failed check. -type Explainer interface { Explain(label string, got interface{}) string } ``` ## Provided checkers @@ -58,29 +49,38 @@ Package `check` provides a collection of basic checkers for common types and kin - bool - check.Bool + int, intN (8, 16, 32, 64) + check.Int, check.IntN - - TypeCheckerProvider + + NumberCheckerProvider[int], NumberCheckerProvider[intN] + + + + + uint, uintN (8, 16, 32, 64) + check.Uint, check.UintN + + + NumberCheckerProvider[uint], NumberCheckerProvider[uintN] - int - check.Int + floatN (32, 64) + check.FloatN - - IntCheckerProvider + + NumberCheckerProvider[floatN] - float64 - check.Float64 + bool + check.Bool - - Float64CheckerProvider + + BoolCheckerProvider @@ -148,7 +148,7 @@ Package `check` provides a collection of basic checkers for common types and kin - interface{} + any check.Value @@ -184,7 +184,7 @@ Package `check` provides a collection of basic checkers for common types and kin struct - check.Bool + check.Struct StructCheckerProvider @@ -205,29 +205,28 @@ There are 2 ways to extend a provided checker. #### Using a `New` function -With every `` covered by this package comes a `NewChecker` function. +Package `check` provides a `NewChecker` function to create a custom checker. -It takes a `PassFunc` for the corresponding type (`func(got Type) bool`) -and an `ExplainFunc`, then returns a checker for that type. +It takes a `PassFunc` that determinates if a got value passes the check +and an `ExplainFunc` that outputs the reason of a failed check, +then returns a checker for that type. ```go func Test42IsEven(t *testing.T) { - checkIsEven := check.NewIntChecker( + checkIsEven := check.NewChecker( func(got int) bool { return got&1 == 0 }, - func(label string, got interface{}) string { + func(label string, got any) string { return fmt.Sprintf("%s: expect even int, got %v", label, got) }, ) - testx.Value(42). - Pass(checkconv.FromInt(checkIsEven)). - Run(t) + testx.Value(42).Pass(checkIsEven).Run(t) } ``` Related examples: -- [NewIntChecker](https://pkg.go.dev/github.com/drykit-go/testx/check#example-package-NewIntChecker) +- [NewChecker](https://pkg.go.dev/github.com/drykit-go/testx/check#example-package-NewChecker) #### Using `check.Value.Custom` @@ -235,40 +234,31 @@ Related examples: func Test42IsEven(t *testing.T) { checkIsEven := check.Value.Custom( "even int", - func(got interface{}) bool { + func(got any) bool { gotInt, ok := got.(int) return ok && got&1 == 0 }, ) - testx.Value(42). - Pass(checkIsEven). - Run(t) + testx.Value(42).Pass(checkIsEven).Run(t) } ``` -### Custom checkers of any type - -At some point you may need a checker for a type that is not (yet?) covered -by `check`, such as `float32` or `complex128`. -You may also want custom checkers for your own local types, like `User`. +### Custom checker implementation -Fortunately, because _checkers_ are interfaces, it is easy to implement -a custom checker for any type. +Any type that implements `check.Checker[T any]` interface is a valid checker +and can be used for `testx` runners. -In practice, any type that implements `func Pass(got Type) bool` -and `Explainer` interface is recognized as a valid checker and -can be used for `testx` runners via `checkconv.Cast`. +For runners that require a `check.Checker[interface{}]` specifically +(such as `testx.Case.Pass`), use `check.Wrap` to perform the conversion. Related examples: - [CustomChecker](https://pkg.go.dev/github.com/drykit-go/testx/check#example-package-CustomChecker): - implementation of a custom checker that implements `IntChecker` -- [CustomCheckerUnknownType](https://pkg.go.dev/github.com/drykit-go/testx/check#example-package-CustomCheckerUnknownType): - implementation of a custom checker for a local type `MyType` struct + implementation of a custom checker. - [CustomCheckerClosures](https://pkg.go.dev/github.com/drykit-go/testx/check#example-package-CustomCheckerClosures): advanced implementation of a parameterized custom checker - for uncovered type `complex128`, using closures. + for type `complex128`, using closures. ### Contribute! diff --git a/check/check.go b/check/check.go index 17652ca..eb60b25 100644 --- a/check/check.go +++ b/check/check.go @@ -1,165 +1,54 @@ -// Code generated by go generate ./...; DO NOT EDIT -// Last generated on 30 Oct 21 12:10 UTC - -// Package check provides types to perform checks on values -// in a testing context. package check import ( - "context" - "net/http" - "time" + "github.com/drykit-go/testx/internal/checktypes" ) +type Numeric interface{ checktypes.Numeric } + type ( - // BoolPassFunc is the required method to implement BoolPasser. - // It returns a boolean that indicates whether the gotten bool value - // passes the current check. - BoolPassFunc func(got bool) bool - // BytesPassFunc is the required method to implement BytesPasser. - // It returns a boolean that indicates whether the gotten []byte value - // passes the current check. - BytesPassFunc func(got []byte) bool - // StringPassFunc is the required method to implement StringPasser. - // It returns a boolean that indicates whether the gotten string value - // passes the current check. - StringPassFunc func(got string) bool - // IntPassFunc is the required method to implement IntPasser. - // It returns a boolean that indicates whether the gotten int value - // passes the current check. - IntPassFunc func(got int) bool - // Float64PassFunc is the required method to implement Float64Passer. - // It returns a boolean that indicates whether the gotten float64 value - // passes the current check. - Float64PassFunc func(got float64) bool - // DurationPassFunc is the required method to implement DurationPasser. - // It returns a boolean that indicates whether the gotten time.Duration value - // passes the current check. - DurationPassFunc func(got time.Duration) bool - // ContextPassFunc is the required method to implement ContextPasser. - // It returns a boolean that indicates whether the gotten context.Context value + // PassFunc is the required method to implement Passer. + // It returns a boolean that indicates whether the got value // passes the current check. - ContextPassFunc func(got context.Context) bool - // HTTPHeaderPassFunc is the required method to implement HTTPHeaderPasser. - // It returns a boolean that indicates whether the gotten http.Header value - // passes the current check. - HTTPHeaderPassFunc func(got http.Header) bool - // HTTPRequestPassFunc is the required method to implement HTTPRequestPasser. - // It returns a boolean that indicates whether the gotten *http.Request value - // passes the current check. - HTTPRequestPassFunc func(got *http.Request) bool - // HTTPResponsePassFunc is the required method to implement HTTPResponsePasser. - // It returns a boolean that indicates whether the gotten *http.Response value - // passes the current check. - HTTPResponsePassFunc func(got *http.Response) bool - // ValuePassFunc is the required method to implement ValuePasser. - // It returns a boolean that indicates whether the gotten interface{} value - // passes the current check. - ValuePassFunc func(got interface{}) bool + PassFunc[T any] checktypes.PassFunc[T] // ExplainFunc is the required method to implement Explainer. // It returns a string explaining why the gotten value failed the check. // The label provides some context, such as "response code". - ExplainFunc func(label string, got interface{}) string + ExplainFunc = checktypes.ExplainFunc ) type ( - // BoolPasser provides a method Pass that returns a bool that indicates - // whether the gotten bool value passes the current check. - BoolPasser interface{ Pass(got bool) bool } - // BytesPasser provides a method Pass that returns a bool that indicates - // whether the gotten []byte value passes the current check. - BytesPasser interface{ Pass(got []byte) bool } - // StringPasser provides a method Pass that returns a bool that indicates - // whether the gotten string value passes the current check. - StringPasser interface{ Pass(got string) bool } - // IntPasser provides a method Pass that returns a bool that indicates - // whether the gotten int value passes the current check. - IntPasser interface{ Pass(got int) bool } - // Float64Passer provides a method Pass that returns a bool that indicates - // whether the gotten float64 value passes the current check. - Float64Passer interface{ Pass(got float64) bool } - // DurationPasser provides a method Pass that returns a bool that indicates - // whether the gotten time.Duration value passes the current check. - DurationPasser interface{ Pass(got time.Duration) bool } - // ContextPasser provides a method Pass that returns a bool that indicates - // whether the gotten context.Context value passes the current check. - ContextPasser interface { - Pass(got context.Context) bool - } - // HTTPHeaderPasser provides a method Pass that returns a bool that indicates - // whether the gotten http.Header value passes the current check. - HTTPHeaderPasser interface{ Pass(got http.Header) bool } - // HTTPRequestPasser provides a method Pass that returns a bool that indicates - // whether the gotten *http.Request value passes the current check. - HTTPRequestPasser interface{ Pass(got *http.Request) bool } - // HTTPResponsePasser provides a method Pass that returns a bool that indicates - // whether the gotten *http.Response value passes the current check. - HTTPResponsePasser interface{ Pass(got *http.Response) bool } - // ValuePasser provides a method Pass that returns a bool that indicates - // whether the gotten interface{} value passes the current check. - ValuePasser interface{ Pass(got interface{}) bool } + // Passer provides a method Pass that returns a bool that indicates + // whether the got value passes the current check. + Passer[T any] interface{ checktypes.Passer[T] } // Explainer provides a method Explain describing the reason of a failed check. - Explainer interface { - Explain(label string, got interface{}) string - } -) + Explainer interface{ checktypes.Explainer } -type ( - // BoolChecker implements both BoolPasser and Explainer interfaces. - BoolChecker interface { - BoolPasser - Explainer - } - // BytesChecker implements both BytesPasser and Explainer interfaces. - BytesChecker interface { - BytesPasser - Explainer - } - // StringChecker implements both StringPasser and Explainer interfaces. - StringChecker interface { - StringPasser - Explainer - } - // IntChecker implements both IntPasser and Explainer interfaces. - IntChecker interface { - IntPasser - Explainer - } - // Float64Checker implements both Float64Passer and Explainer interfaces. - Float64Checker interface { - Float64Passer - Explainer - } - // DurationChecker implements both DurationPasser and Explainer interfaces. - DurationChecker interface { - DurationPasser - Explainer - } - // ContextChecker implements both ContextPasser and Explainer interfaces. - ContextChecker interface { - ContextPasser - Explainer - } - // HTTPHeaderChecker implements both HTTPHeaderPasser and Explainer interfaces. - HTTPHeaderChecker interface { - HTTPHeaderPasser - Explainer - } - // HTTPRequestChecker implements both HTTPRequestPasser and Explainer interfaces. - HTTPRequestChecker interface { - HTTPRequestPasser - Explainer - } - // HTTPResponseChecker implements both HTTPResponsePasser and Explainer interfaces. - HTTPResponseChecker interface { - HTTPResponsePasser - Explainer - } - // ValueChecker implements both ValuePasser and Explainer interfaces. - ValueChecker interface { - ValuePasser - Explainer - } + // Checker satisfies both Passer and Explainer interfaces. + Checker[T any] interface{ checktypes.Checker[T] } ) + +type checker[T any] struct { + pass PassFunc[T] + expl ExplainFunc +} + +func (c checker[T]) Pass(got T) bool { + return c.pass(got) +} + +func (c checker[T]) Explain(label string, got any) string { + return c.expl(label, got) +} + +func NewChecker[T any]( + passFunc PassFunc[T], + explainFunc ExplainFunc, +) Checker[T] { + return checker[T]{ + pass: passFunc, + expl: explainFunc, + } +} diff --git a/check/checkers.go b/check/checkers.go deleted file mode 100644 index 1597827..0000000 --- a/check/checkers.go +++ /dev/null @@ -1,201 +0,0 @@ -// Code generated by go generate ./...; DO NOT EDIT -// Last generated on 30 Oct 21 12:10 UTC - -package check - -import ( - "context" - "net/http" - "time" -) - -// baseChecker is a base checker for all checkers. It implements Explainer. -type baseChecker struct { - explFunc ExplainFunc -} - -// Explain returns a string explaining the reason of a failed check -// for the gotten value. -func (c baseChecker) Explain(label string, got interface{}) string { - return c.explFunc(label, got) -} - -func newBaseChecker(explFunc ExplainFunc) baseChecker { - return baseChecker{explFunc: explFunc} -} - -// boolChecker is an implementation of BoolChecker interface -type boolChecker struct { - baseChecker - passFunc BoolPassFunc -} - -// Pass returns a boolean that indicates whether the gotten bool value -// passes the current check. -func (c boolChecker) Pass(got bool) bool { return c.passFunc(got) } - -// NewBoolChecker returns a custom BoolChecker with the provided -// BoolPassFunc and ExplainFunc. -func NewBoolChecker(passFunc BoolPassFunc, explainFunc ExplainFunc) BoolChecker { - return boolChecker{baseChecker: newBaseChecker(explainFunc), passFunc: passFunc} -} - -// bytesChecker is an implementation of BytesChecker interface -type bytesChecker struct { - baseChecker - passFunc BytesPassFunc -} - -// Pass returns a boolean that indicates whether the gotten []byte value -// passes the current check. -func (c bytesChecker) Pass(got []byte) bool { return c.passFunc(got) } - -// NewBytesChecker returns a custom BytesChecker with the provided -// BytesPassFunc and ExplainFunc. -func NewBytesChecker(passFunc BytesPassFunc, explainFunc ExplainFunc) BytesChecker { - return bytesChecker{baseChecker: newBaseChecker(explainFunc), passFunc: passFunc} -} - -// stringChecker is an implementation of StringChecker interface -type stringChecker struct { - baseChecker - passFunc StringPassFunc -} - -// Pass returns a boolean that indicates whether the gotten string value -// passes the current check. -func (c stringChecker) Pass(got string) bool { return c.passFunc(got) } - -// NewStringChecker returns a custom StringChecker with the provided -// StringPassFunc and ExplainFunc. -func NewStringChecker(passFunc StringPassFunc, explainFunc ExplainFunc) StringChecker { - return stringChecker{baseChecker: newBaseChecker(explainFunc), passFunc: passFunc} -} - -// intChecker is an implementation of IntChecker interface -type intChecker struct { - baseChecker - passFunc IntPassFunc -} - -// Pass returns a boolean that indicates whether the gotten int value -// passes the current check. -func (c intChecker) Pass(got int) bool { return c.passFunc(got) } - -// NewIntChecker returns a custom IntChecker with the provided -// IntPassFunc and ExplainFunc. -func NewIntChecker(passFunc IntPassFunc, explainFunc ExplainFunc) IntChecker { - return intChecker{baseChecker: newBaseChecker(explainFunc), passFunc: passFunc} -} - -// float64Checker is an implementation of Float64Checker interface -type float64Checker struct { - baseChecker - passFunc Float64PassFunc -} - -// Pass returns a boolean that indicates whether the gotten float64 value -// passes the current check. -func (c float64Checker) Pass(got float64) bool { return c.passFunc(got) } - -// NewFloat64Checker returns a custom Float64Checker with the provided -// Float64PassFunc and ExplainFunc. -func NewFloat64Checker(passFunc Float64PassFunc, explainFunc ExplainFunc) Float64Checker { - return float64Checker{baseChecker: newBaseChecker(explainFunc), passFunc: passFunc} -} - -// durationChecker is an implementation of DurationChecker interface -type durationChecker struct { - baseChecker - passFunc DurationPassFunc -} - -// Pass returns a boolean that indicates whether the gotten time.Duration value -// passes the current check. -func (c durationChecker) Pass(got time.Duration) bool { return c.passFunc(got) } - -// NewDurationChecker returns a custom DurationChecker with the provided -// DurationPassFunc and ExplainFunc. -func NewDurationChecker(passFunc DurationPassFunc, explainFunc ExplainFunc) DurationChecker { - return durationChecker{baseChecker: newBaseChecker(explainFunc), passFunc: passFunc} -} - -// contextChecker is an implementation of ContextChecker interface -type contextChecker struct { - baseChecker - passFunc ContextPassFunc -} - -// Pass returns a boolean that indicates whether the gotten context.Context value -// passes the current check. -func (c contextChecker) Pass(got context.Context) bool { return c.passFunc(got) } - -// NewContextChecker returns a custom ContextChecker with the provided -// ContextPassFunc and ExplainFunc. -func NewContextChecker(passFunc ContextPassFunc, explainFunc ExplainFunc) ContextChecker { - return contextChecker{baseChecker: newBaseChecker(explainFunc), passFunc: passFunc} -} - -// httpHeaderChecker is an implementation of HTTPHeaderChecker interface -type httpHeaderChecker struct { - baseChecker - passFunc HTTPHeaderPassFunc -} - -// Pass returns a boolean that indicates whether the gotten http.Header value -// passes the current check. -func (c httpHeaderChecker) Pass(got http.Header) bool { return c.passFunc(got) } - -// NewHTTPHeaderChecker returns a custom HTTPHeaderChecker with the provided -// HTTPHeaderPassFunc and ExplainFunc. -func NewHTTPHeaderChecker(passFunc HTTPHeaderPassFunc, explainFunc ExplainFunc) HTTPHeaderChecker { - return httpHeaderChecker{baseChecker: newBaseChecker(explainFunc), passFunc: passFunc} -} - -// httpRequestChecker is an implementation of HTTPRequestChecker interface -type httpRequestChecker struct { - baseChecker - passFunc HTTPRequestPassFunc -} - -// Pass returns a boolean that indicates whether the gotten *http.Request value -// passes the current check. -func (c httpRequestChecker) Pass(got *http.Request) bool { return c.passFunc(got) } - -// NewHTTPRequestChecker returns a custom HTTPRequestChecker with the provided -// HTTPRequestPassFunc and ExplainFunc. -func NewHTTPRequestChecker(passFunc HTTPRequestPassFunc, explainFunc ExplainFunc) HTTPRequestChecker { - return httpRequestChecker{baseChecker: newBaseChecker(explainFunc), passFunc: passFunc} -} - -// httpResponseChecker is an implementation of HTTPResponseChecker interface -type httpResponseChecker struct { - baseChecker - passFunc HTTPResponsePassFunc -} - -// Pass returns a boolean that indicates whether the gotten *http.Response value -// passes the current check. -func (c httpResponseChecker) Pass(got *http.Response) bool { return c.passFunc(got) } - -// NewHTTPResponseChecker returns a custom HTTPResponseChecker with the provided -// HTTPResponsePassFunc and ExplainFunc. -func NewHTTPResponseChecker(passFunc HTTPResponsePassFunc, explainFunc ExplainFunc) HTTPResponseChecker { - return httpResponseChecker{baseChecker: newBaseChecker(explainFunc), passFunc: passFunc} -} - -// valueChecker is an implementation of ValueChecker interface -type valueChecker struct { - baseChecker - passFunc ValuePassFunc -} - -// Pass returns a boolean that indicates whether the gotten interface{} value -// passes the current check. -func (c valueChecker) Pass(got interface{}) bool { return c.passFunc(got) } - -// NewValueChecker returns a custom ValueChecker with the provided -// ValuePassFunc and ExplainFunc. -func NewValueChecker(passFunc ValuePassFunc, explainFunc ExplainFunc) ValueChecker { - return valueChecker{baseChecker: newBaseChecker(explainFunc), passFunc: passFunc} -} diff --git a/check/example_custom_closures_test.go b/check/example_custom_closures_test.go index 14c8c6d..842b077 100644 --- a/check/example_custom_closures_test.go +++ b/check/example_custom_closures_test.go @@ -4,7 +4,6 @@ import ( "fmt" "github.com/drykit-go/testx" - "github.com/drykit-go/testx/checkconv" ) /* @@ -22,18 +21,16 @@ import ( // func fields pass and explain respectively. type Complex128Checker struct { pass func(got complex128) bool - explain func(label string, got interface{}) string + explain func(label string, got any) string } -// Pass do not satisfy any interface declared by check, but has a valid -// signature Pass(got T) bool, allowing Complex128Checker to be casted -// as a ValueChecker using checkconv.Cast. +// Pass implements check.Passer[complex128] interface. func (c Complex128Checker) Pass(got complex128) bool { return c.pass(got) } -// Explain satisfies check.Explainer interface. -func (c Complex128Checker) Explain(label string, got interface{}) string { +// Explain implements check.Explainer interface. +func (c Complex128Checker) Explain(label string, got any) string { return c.explain(label, got) } @@ -45,7 +42,7 @@ func checkComplex128ImagIsInRange(lo, hi float64) Complex128Checker { gotImag = imag(got) return lo <= gotImag && gotImag <= hi } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return fmt.Sprintf( "%s: exp imag(%v) in range [%.0f:%.0f], got %.0f", label, got, lo, hi, gotImag, @@ -57,13 +54,11 @@ func checkComplex128ImagIsInRange(lo, hi float64) Complex128Checker { func Example_customCheckerClosures() { const testedValue = 42i - // We first cast our custom checkers to a typed ValueChecker. - checkers, _ := checkconv.CastMany( + results := testx.Value(testedValue).Pass( checkComplex128ImagIsInRange(41, 43), // pass checkComplex128ImagIsInRange(0, 1), // fail - ) + ).DryRun() - results := testx.Value(testedValue).Pass(checkers...).DryRun() fmt.Println(results.Checks()) // Output: diff --git a/check/example_custom_test.go b/check/example_custom_test.go index bab6b17..b039096 100644 --- a/check/example_custom_test.go +++ b/check/example_custom_test.go @@ -13,17 +13,17 @@ import ( Example: implementation of a custom checker */ -// StatusOKChecker is a custom checker that implements IntChecker interface. -// In consequence in can be used in any function that accepts an IntChecker. +// StatusOKChecker is a custom checker that implements Checker[int] interface. +// In consequence in can be used in any function that accepts an Checker[int]. type StatusOKChecker struct{} -// Pass satisfies IntPasser interface. +// Pass satisfies Passer[int] interface. func (c StatusOKChecker) Pass(got int) bool { return (got >= 200 && got < 300) || got == 304 } // Explain satisfies Explainer interface. -func (c StatusOKChecker) Explain(label string, got interface{}) string { +func (c StatusOKChecker) Explain(label string, got any) string { return fmt.Sprintf("%s: got bad http code: %v", label, got) } @@ -36,8 +36,8 @@ func Example_customChecker() { request := httptest.NewRequest("GET", "/", nil) results := testx.HTTPHandlerFunc(HandleNotFound).WithRequest(request). - // check.HTTPResponse.StatusCode accepts an IntChecker, - // StatusOKChecker satisfies IntChecker interface. + // check.HTTPResponse.StatusCode accepts a Checker[int], + // StatusOKChecker satisfies Checker[int] interface. Response(check.HTTPResponse.StatusCode(StatusOKChecker{})). DryRun() @@ -49,6 +49,6 @@ func Example_customChecker() { // false // 404 // http response: - // exp status code to pass IntChecker + // exp status code to pass Checker[int] // got explanation: status code: got bad http code: 404 } diff --git a/check/example_custom_unknown_test.go b/check/example_custom_unknown_test.go deleted file mode 100644 index 6c6ebdc..0000000 --- a/check/example_custom_unknown_test.go +++ /dev/null @@ -1,61 +0,0 @@ -package check_test - -import ( - "fmt" - - "github.com/drykit-go/testx" - "github.com/drykit-go/testx/checkconv" -) - -/* - Example: implementation of a custom checker of unknown type - having no match in interfaces declared by package check. -*/ - -type MyType struct { - ID int - Name string -} - -// MyTypeValidityChecker is a custom checker for type MyType -// that is not handled by package check. -// However, it works with any test runner that requires a generic checker -// because it implements Pass(got T) bool and check.Explainer. -type MyTypeValidityChecker struct{} - -// Pass do not satisfy any interface declared by check, but has a valid -// signature Pass(got T) bool, thus allowing IsPositiveComplexChecker -// to be recognized as a valid checker. -func (c MyTypeValidityChecker) Pass(got MyType) bool { - return got.ID >= 0 && len(got.Name) >= 3 -} - -// Explain satisfies Explainer interface. -func (c MyTypeValidityChecker) Explain(label string, got interface{}) string { - return fmt.Sprintf("%s: got bad CustomType value: %v", label, got) -} - -// identityCustomType returns the input CustomType -func identityCustomType(v MyType) MyType { - return v -} - -func Example_customCheckerUnknownType() { - checkIsValid := MyTypeValidityChecker{} - checkers, _ := checkconv.CastMany(checkIsValid) - results := testx.Table(identityCustomType). - Cases([]testx.Case{ - {In: MyType{ID: 0, Name: "yes"}, Pass: checkers}, // pass - {In: MyType{ID: -1, Name: "no"}, Pass: checkers}, // fail - }). - DryRun() - - fmt.Println(results.PassedAt(0)) - fmt.Println(results.PassedAt(1)) - fmt.Println(results.Checks()) - - // Output: - // true - // false - // [{passed} {failed : got bad CustomType value: {-1 no}}] -} diff --git a/check/example_newchecker_test.go b/check/example_newchecker_test.go new file mode 100644 index 0000000..b1f5713 --- /dev/null +++ b/check/example_newchecker_test.go @@ -0,0 +1,31 @@ +package check_test + +import ( + "fmt" + + "github.com/drykit-go/testx" + "github.com/drykit-go/testx/check" +) + +/* + Example: implementation of a custom checker using check.NewChecker +*/ + +func Example_newChecker() { + checkIsEven := check.NewChecker( + func(got int) bool { return got&1 == 0 }, + func(label string, got any) string { + return fmt.Sprintf("%s: expect even int, got %v", label, got) + }, + ) + + resultPass := testx.Value(42).Pass(checkIsEven).DryRun() + resultFail := testx.Value(43).Pass(checkIsEven).DryRun() + + fmt.Println(resultPass.Passed()) + fmt.Println(resultFail.Passed()) + + // Output: + // true + // false +} diff --git a/check/example_newintchecker_test.go b/check/example_newintchecker_test.go deleted file mode 100644 index 5024830..0000000 --- a/check/example_newintchecker_test.go +++ /dev/null @@ -1,33 +0,0 @@ -package check_test - -import ( - "fmt" - - "github.com/drykit-go/testx" - "github.com/drykit-go/testx/check" - "github.com/drykit-go/testx/checkconv" -) - -/* - Example: implementation of a custom checker of a type - defined by package check -*/ - -func Example_newIntChecker() { - checkIsEven := check.NewIntChecker( - func(got int) bool { return got&1 == 0 }, - func(label string, got interface{}) string { - return fmt.Sprintf("%s: expect even int, got %v", label, got) - }, - ) - - resultPass := testx.Value(42).Pass(checkconv.FromInt(checkIsEven)).DryRun() - resultFail := testx.Value(43).Pass(checkconv.FromInt(checkIsEven)).DryRun() - - fmt.Println(resultPass.Passed()) - fmt.Println(resultFail.Passed()) - - // Output: - // true - // false -} diff --git a/check/gen.go b/check/gen.go deleted file mode 100644 index 96df8b3..0000000 --- a/check/gen.go +++ /dev/null @@ -1,30 +0,0 @@ -package check - -//go:generate ../bin/gen -kind types -name check -//go:generate ../bin/gen -kind types -name checkers -//go:generate ../bin/gen -kind interfaces -name providers - -// For every type {N,T} defined in ./gen/types.go, running go generate -// will create the following definitions: -// -// NPassFunc func(got T) bool -// -// NPasser interface{ Pass(got T) bool } -// -// NChecker interface { -// NPasser -// Explainer -// } -// -// type nChecker struct { -// passFunc NPassFunc -// explFunc ExplainFunc -// } -// -// func (c nChecker) Pass(got T) bool { return c.passFunc(got) } -// -// func (c nChecker) Explain(label string, got interface{}) string { return c.explFunc(label, got) } -// -// func NewNChecker(passFunc NPassFunc, explainFunc ExplainFunc) NChecker { -// return nChecker{passFunc: passFunc, explFunc: explainFunc} -// } diff --git a/check/providers.go b/check/providers.go index 6486729..efe7a22 100644 --- a/check/providers.go +++ b/check/providers.go @@ -1,290 +1,66 @@ // Code generated by go generate ./...; DO NOT EDIT -// Last generated on 30 Oct 21 12:10 UTC +// Last generated on 21 Nov 21 13:15 UTC package check import ( - "regexp" - "time" + "github.com/drykit-go/testx/internal/providers" ) -type ( - // BoolCheckerProvider provides checks on type bool. - BoolCheckerProvider interface { - // Is checks the gotten bool is equal to the target. - Is(tar bool) BoolChecker - } - - // BytesCheckerProvider provides checks on type []byte. - BytesCheckerProvider interface { - // AsMap checks the gotten []byte passes the given mapChecker - // once json-unmarshaled to a map[string]interface{}. - // It fails if it is not a valid JSON. - AsMap(mapChecker ValueChecker) BytesChecker - // AsString checks the gotten []byte passes the given StringChecker - // once converted to a string. - AsString(c StringChecker) BytesChecker - // Contains checks the gotten []byte contains a specific subslice. - Contains(subslice []byte) BytesChecker - // Is checks the gotten []byte is equal to the target. - Is(tar []byte) BytesChecker - // Len checks the gotten []byte's length passes the provided - // IntChecker. - Len(c IntChecker) BytesChecker - // Not checks the gotten []byte is not equal to the target. - Not(values ...[]byte) BytesChecker - // NotContains checks the gotten []byte contains a specific subslice. - NotContains(subslice []byte) BytesChecker - // SameJSON checks the gotten []byte and the target read as the same - // JSON value, ignoring formatting and keys order. - SameJSON(tar []byte) BytesChecker - } - - // ContextCheckerProvider provides checks on type context.Context. - ContextCheckerProvider interface { - // Done checks the gotten context is done. - Done(expectDone bool) ContextChecker - // HasKeys checks the gotten context has the given keys set. - HasKeys(keys ...interface{}) ContextChecker - // Value checks the gotten context's value for the given key passes - // the given ValueChecker. It fails if value is nil. - // - // Examples: - // Context.Value("userID", Value.Is("abcde")) - // Context.Value("userID", checkconv.Assert(String.Contains("abc"))) - Value(key interface{}, c ValueChecker) ContextChecker - } - - // DurationCheckerProvider provides checks on type time.Duration. - DurationCheckerProvider interface { - // InRange checks the gotten time.Duration is in range [lo:hi] - InRange(lo, hi time.Duration) DurationChecker - // OutRange checks the gotten time.Duration is not in range [lo:hi] - OutRange(lo, hi time.Duration) DurationChecker - // Over checks the gotten time.Duration is over the target duration. - Over(tar time.Duration) DurationChecker - // Under checks the gotten time.Duration is under the target duration. - Under(tar time.Duration) DurationChecker - } - - // Float64CheckerProvider provides checks on type float64. - Float64CheckerProvider interface { - // GT checks the gotten float64 is greater than the target. - GT(tar float64) Float64Checker - // GTE checks the gotten float64 is greater or equal to the target. - GTE(tar float64) Float64Checker - // InRange checks the gotten float64 is in the closed interval [lo:hi]. - InRange(lo, hi float64) Float64Checker - // Is checks the gotten float64 is equal to the target. - Is(tar float64) Float64Checker - // LT checks the gotten float64 is lesser than the target. - LT(tar float64) Float64Checker - // LTE checks the gotten float64 is lesser or equal to the target. - LTE(tar float64) Float64Checker - // Not checks the gotten float64 is not equal to the target. - Not(values ...float64) Float64Checker - // OutRange checks the gotten float64 is not in the closed interval [lo:hi]. - OutRange(lo, hi float64) Float64Checker - } - - // HTTPHeaderCheckerProvider provides checks on type http.Header. - HTTPHeaderCheckerProvider interface { - // CheckValue checks the gotten http.Header has a value for the matching key - // that passes the given StringChecker. - // It only checks the first result for the given key. - CheckValue(key string, c StringChecker) HTTPHeaderChecker - // HasKey checks the gotten http.Header has a specific key set. - // The corresponding value is ignored, meaning an empty value - // for that key passes the check. - HasKey(key string) HTTPHeaderChecker - // HasNotKey checks the gotten http.Header does not have - // a specific key set. - HasNotKey(key string) HTTPHeaderChecker - // HasNotValue checks the gotten http.Header does not have a value equal to val. - // It only compares the first result for each key. - HasNotValue(val string) HTTPHeaderChecker - // HasValue checks the gotten http.Header has any value equal to val. - // It only compares the first result for each key. - HasValue(val string) HTTPHeaderChecker - } - - // HTTPRequestCheckerProvider provides checks on type *http.Request. - HTTPRequestCheckerProvider interface { - // Body checks the gotten *http.Request Body passes the input BytesChecker. - // It should be used only once on a same *http.Request as it closes its body - // after reading it. - Body(c BytesChecker) HTTPRequestChecker - // ContentLength checks the gotten *http.Request ContentLength passes - // the input IntChecker. - ContentLength(c IntChecker) HTTPRequestChecker - // Context checks the gotten *http.Request Context passes - // the input ContextChecker. - Context(c ContextChecker) HTTPRequestChecker - // Header checks the gotten *http.Request Header passes - // the input HTTPHeaderChecker. - Header(c HTTPHeaderChecker) HTTPRequestChecker - } - - // HTTPResponseCheckerProvider provides checks on type *http.Response. - HTTPResponseCheckerProvider interface { - // Body checks the gotten *http.Response Body passes the input BytesChecker. - // It should be used only once on a same *http.Response as it closes its body - // after reading it. - Body(c BytesChecker) HTTPResponseChecker - // ContentLength checks the gotten *http.Response ContentLength passes - // the input IntChecker. - ContentLength(c IntChecker) HTTPResponseChecker - // Header checks the gotten *http.Response Header passes - // the input HTTPHeaderChecker. - Header(c HTTPHeaderChecker) HTTPResponseChecker - // Status checks the gotten *http.Response Status passes - // the input StringChecker. - Status(c StringChecker) HTTPResponseChecker - // StatusCode checks the gotten *http.Response StatusCode passes - // the input IntChecker. - StatusCode(c IntChecker) HTTPResponseChecker - } - - // IntCheckerProvider provides checks on type int. - IntCheckerProvider interface { - // GT checks the gotten int is greater than the target. - GT(tar int) IntChecker - // GTE checks the gotten int is greater or equal to the target. - GTE(tar int) IntChecker - // InRange checks the gotten int is in the closed interval [lo:hi]. - InRange(lo, hi int) IntChecker - // Is checks the gotten int is equal to the target. - Is(tar int) IntChecker - // LT checks the gotten int is lesser than the target. - LT(tar int) IntChecker - // LTE checks the gotten int is lesser or equal to the target. - LTE(tar int) IntChecker - // Not checks the gotten int is not equal to the target. - Not(values ...int) IntChecker - // OutRange checks the gotten int is not in the closed interval [lo:hi]. - OutRange(lo, hi int) IntChecker - } - - // MapCheckerProvider provides checks on kind map. - MapCheckerProvider interface { - ValueCheckerProvider - - // CheckValues checks the gotten map's values corresponding to the given keys - // pass the given checker. A key not found is considered a fail. - // If len(keys) == 0, the check is made on all map values. - CheckValues(c ValueChecker, keys ...interface{}) ValueChecker - // HasKeys checks the gotten map has the given keys set. - HasKeys(keys ...interface{}) ValueChecker - // HasNotKeys checks the gotten map has the given keys set. - HasNotKeys(keys ...interface{}) ValueChecker - // HasNotValues checks the gotten map has not the given values set. - HasNotValues(values ...interface{}) ValueChecker - // HasValues checks the gotten map has the given values set. - HasValues(values ...interface{}) ValueChecker - // Len checks the gotten map passes the given IntChecker. - Len(c IntChecker) ValueChecker - } - - // SliceCheckerProvider provides checks on kind slice. - SliceCheckerProvider interface { - ValueCheckerProvider - - // Cap checks the capacity of the gotten slice passes the given IntChecker. - Cap(c IntChecker) ValueChecker - // CheckValues checks the values of the gotten slice pass the given ValueChecker. - // If a filterFunc is provided, the values not passing it are ignored. - CheckValues(c ValueChecker, filters ...func(i int, v interface{}) bool) ValueChecker - // HasNotValues checks the gotten slice has not the given values set. - HasNotValues(values ...interface{}) ValueChecker - // HasValues checks the gotten slice has the given values set. - HasValues(values ...interface{}) ValueChecker - // Len checks the length of the gotten slice passes the given IntChecker. - Len(c IntChecker) ValueChecker - } - - // StringCheckerProvider provides checks on type string. - StringCheckerProvider interface { - // Contains checks the gotten string contains the target substring. - Contains(sub string) StringChecker - // Is checks the gotten string is equal to the target. - Is(tar string) StringChecker - // Len checks the gotten string's length passes the given IntChecker. - Len(c IntChecker) StringChecker - // Match checks the gotten string matches the given regexp. - Match(rgx *regexp.Regexp) StringChecker - // Not checks the gotten string is not equal to the target. - Not(values ...string) StringChecker - // NotContains checks the gotten string do not contain the target - // substring. - NotContains(sub string) StringChecker - // NotMatch checks the gotten string do not match the given regexp. - NotMatch(rgx *regexp.Regexp) StringChecker - } - - // StructCheckerProvider provides checks on kind struct. - StructCheckerProvider interface { - ValueCheckerProvider +var ( + // Int provides checks on type int. + Int = providers.NumberCheckerProvider[int]{} + // Int8 provides checks on type int8. + Int8 = providers.NumberCheckerProvider[int8]{} + // Int16 provides checks on type int16. + Int16 = providers.NumberCheckerProvider[int16]{} + // Int32 provides checks on type int32. + Int32 = providers.NumberCheckerProvider[int32]{} + // Int64 provides checks on type int64. + Int64 = providers.NumberCheckerProvider[int64]{} + // Uint provides checks on type uint. + Uint = providers.NumberCheckerProvider[uint]{} + // Uint8 provides checks on type uint8. + Uint8 = providers.NumberCheckerProvider[uint8]{} + // Uint16 provides checks on type uint16. + Uint16 = providers.NumberCheckerProvider[uint16]{} + // Uint32 provides checks on type uint32. + Uint32 = providers.NumberCheckerProvider[uint32]{} + // Uint64 provides checks on type uint64. + Uint64 = providers.NumberCheckerProvider[uint64]{} + // Float32 provides checks on type float32. + Float32 = providers.NumberCheckerProvider[float32]{} + // Float64 provides checks on type float64. + Float64 = providers.NumberCheckerProvider[float64]{} + // Bytes provides checks on type []byte. + Bytes = providers.BytesCheckerProvider{} + // Context provides checks on type context.Context. + Context = providers.ContextCheckerProvider{} + // Duration provides checks on type time.Duration. + Duration = providers.DurationCheckerProvider{} + // HTTPHeader provides checks on type http.Header. + HTTPHeader = providers.HTTPHeaderCheckerProvider{} + // HTTPRequest provides checks on type *http.Request. + HTTPRequest = providers.HTTPRequestCheckerProvider{} + // HTTPResponse provides checks on type *http.Response. + HTTPResponse = providers.HTTPResponseCheckerProvider{} + // String provides checks on type string. + String = providers.StringCheckerProvider{} + // Struct provides checks on kind struct. + Struct = providers.StructCheckerProvider{} +) - // CheckFields checks all given fields pass the ValueChecker. - // It panics if the fields do not exist or are not exported, - // or if the tested value is not a struct. - CheckFields(c ValueChecker, fields []string) ValueChecker - // FieldsEqual checks all given fields equal the exp value. - // It panics if the fields do not exist or are not exported, - // or if the tested value is not a struct. - FieldsEqual(exp interface{}, fields []string) ValueChecker - } +// Map provides checks on type map[Key]Val. +func Map[Key comparable, Val any]() providers.MapCheckerProvider[Key, Val] { + return providers.MapCheckerProvider[Key, Val]{} +} - // ValueCheckerProvider provides checks on type interface{}. - ValueCheckerProvider interface { - // Custom checks the gotten value passes the given ValuePassFunc. - // The description should give information about the expected value, - // as it outputs in format "exp " in case of failure. - Custom(desc string, f ValuePassFunc) ValueChecker - // Is checks the gotten value is equal to the target. - Is(tar interface{}) ValueChecker - // IsZero checks the gotten value is a zero value, indicating it might not - // have been initialized. - IsZero() ValueChecker - // Not checks the gotten value is not equal to the target. - Not(values ...interface{}) ValueChecker - // NotZero checks the gotten struct contains at least 1 non-zero value, - // meaning it has been initialized. - NotZero() ValueChecker - // SameJSON checks the gotten value and the target value - // produce the same JSON, ignoring formatting and keys order. - // It panics if any error occurs in the marshaling process. - SameJSON(tar interface{}) ValueChecker - } -) +// Slice provides checks on type []Elem. +func Slice[Elem any]() providers.SliceCheckerProvider[Elem] { + return providers.SliceCheckerProvider[Elem]{} +} -var ( - // Bool implements BoolCheckerProvider. - Bool BoolCheckerProvider = boolCheckerProvider{} - // Bytes implements BytesCheckerProvider. - Bytes BytesCheckerProvider = bytesCheckerProvider{} - // Context implements ContextCheckerProvider. - Context ContextCheckerProvider = contextCheckerProvider{} - // Duration implements DurationCheckerProvider. - Duration DurationCheckerProvider = durationCheckerProvider{} - // Float64 implements Float64CheckerProvider. - Float64 Float64CheckerProvider = float64CheckerProvider{} - // HTTPHeader implements HTTPHeaderCheckerProvider. - HTTPHeader HTTPHeaderCheckerProvider = httpHeaderCheckerProvider{} - // HTTPRequest implements HTTPRequestCheckerProvider. - HTTPRequest HTTPRequestCheckerProvider = httpRequestCheckerProvider{} - // HTTPResponse implements HTTPResponseCheckerProvider. - HTTPResponse HTTPResponseCheckerProvider = httpResponseCheckerProvider{} - // Int implements IntCheckerProvider. - Int IntCheckerProvider = intCheckerProvider{} - // Map implements MapCheckerProvider. - Map MapCheckerProvider = mapCheckerProvider{} - // Slice implements SliceCheckerProvider. - Slice SliceCheckerProvider = sliceCheckerProvider{} - // String implements StringCheckerProvider. - String StringCheckerProvider = stringCheckerProvider{} - // Struct implements StructCheckerProvider. - Struct StructCheckerProvider = structCheckerProvider{} - // Value implements ValueCheckerProvider. - Value ValueCheckerProvider = valueCheckerProvider{} -) +// ValueCheckerProvider provides generic checks on any type. +func Value[T any]() providers.ValueCheckerProvider[T] { + return providers.ValueCheckerProvider[T]{} +} diff --git a/check/providers_bool.go b/check/providers_bool.go deleted file mode 100644 index b4639c3..0000000 --- a/check/providers_bool.go +++ /dev/null @@ -1,13 +0,0 @@ -package check - -// boolCheckerProvider provides checks on type bool. -type boolCheckerProvider struct{ baseCheckerProvider } - -// Is checks the gotten bool is equal to the target. -func (p boolCheckerProvider) Is(tar bool) BoolChecker { - pass := func(got bool) bool { return got == tar } - expl := func(label string, got interface{}) string { - return p.explain(label, tar, got) - } - return NewBoolChecker(pass, expl) -} diff --git a/check/providers_bool_test.go b/check/providers_bool_test.go deleted file mode 100644 index f1c2300..0000000 --- a/check/providers_bool_test.go +++ /dev/null @@ -1,47 +0,0 @@ -package check_test - -import ( - "testing" - - "github.com/drykit-go/testx/check" -) - -func TestBoolCheckerProvider(t *testing.T) { - const b = true - - t.Run("Is pass", func(t *testing.T) { - c := check.Bool.Is(b) - assertPassBoolChecker(t, "Is", c, b) - c = check.Bool.Is(!b) - assertPassBoolChecker(t, "Is", c, !b) - }) - - t.Run("Is fail", func(t *testing.T) { - c := check.Bool.Is(!b) - assertFailBoolChecker(t, "Is", c, b, makeExpl("false", "true")) - c = check.Bool.Is(b) - assertFailBoolChecker(t, "Is", c, !b, makeExpl("true", "false")) - }) -} - -// Helpers - -func assertPassBoolChecker(t *testing.T, method string, c check.BoolChecker, b bool) { - t.Helper() - if !c.Pass(b) { - failBoolCheckerTest(t, true, method, b, c.Explain) - } -} - -func assertFailBoolChecker(t *testing.T, method string, c check.BoolChecker, b bool, expexpl string) { - t.Helper() - if c.Pass(b) { - failBoolCheckerTest(t, false, method, b, c.Explain) - } - assertGoodExplain(t, c, b, expexpl) -} - -func failBoolCheckerTest(t *testing.T, expPass bool, method string, b bool, explain check.ExplainFunc) { - t.Helper() - failCheckerTest(t, expPass, "Bool."+method, explain("Bool value", b)) -} diff --git a/check/providers_bytes_test.go b/check/providers_bytes_test.go deleted file mode 100644 index 9f30f91..0000000 --- a/check/providers_bytes_test.go +++ /dev/null @@ -1,189 +0,0 @@ -package check_test - -import ( - "encoding/json" - "fmt" - "testing" - - "github.com/drykit-go/testx/check" -) - -func TestBytesCheckerProvider(t *testing.T) { - var ( - b = []byte(`{"id":42,"name":"Marcel Patulacci"}`) - sub = []byte(`"id":42`) - diff = []byte(`{"id":43,"name":"Robert Robichet"}`) - eqJSON = []byte("{\n\"id\": 42,\n\n\n \"name\":\"Marcel Patulacci\" } ") - ) - - mapof := func(b []byte) (m map[string]interface{}) { - json.Unmarshal(b, &m) //nolint:errcheck - return - } - - t.Run("Is pass", func(t *testing.T) { - c := check.Bytes.Is(b) - assertPassBytesChecker(t, "Is", c, b) - }) - - t.Run("Is fail", func(t *testing.T) { - c := check.Bytes.Is(diff) - assertFailBytesChecker(t, "Is", c, b, makeExpl( - fmt.Sprint(diff), - fmt.Sprint(b), - )) - }) - - t.Run("Not pass", func(t *testing.T) { - c := check.Bytes.Not(diff, eqJSON) - assertPassBytesChecker(t, "Not", c, b) - }) - - t.Run("Not fail", func(t *testing.T) { - c := check.Bytes.Not(diff, eqJSON, b) - assertFailBytesChecker(t, "Not", c, b, makeExpl( - fmt.Sprintf("not %v", b), - fmt.Sprint(b), - )) - }) - - t.Run("Len pass", func(t *testing.T) { - c := check.Bytes.Len(check.Int.Is(len(b))) - assertPassBytesChecker(t, "Len", c, b) - }) - - t.Run("Len fail", func(t *testing.T) { - gotlen := len(b) - explen := gotlen + 1 - c := check.Bytes.Len(check.Int.Is(explen)) - assertFailBytesChecker(t, "Len", c, b, makeExpl( - "length to pass IntChecker", - "explanation: length:\n"+makeExpl( - fmt.Sprint(explen), - fmt.Sprint(gotlen), - ), - )) - }) - - t.Run("SameJSON pass", func(t *testing.T) { - c := check.Bytes.SameJSON(eqJSON) - assertPassBytesChecker(t, "SameJSON", c, b) - c = check.Bytes.SameJSON(b) - assertPassBytesChecker(t, "SameJSON", c, b) - }) - - t.Run("SameJSON fail", func(t *testing.T) { - c := check.Bytes.SameJSON(diff) - assertFailBytesChecker(t, "SameJSON", c, b, makeExpl( - fmt.Sprintf("json data: %v", mapof(diff)), - fmt.Sprintf("json data: %v", mapof(b)), - )) - }) - - t.Run("Contains pass", func(t *testing.T) { - c := check.Bytes.Contains(sub) - assertPassBytesChecker(t, "Contains", c, b) - c = check.Bytes.Contains(b) - assertPassBytesChecker(t, "Contains", c, b) - }) - - t.Run("Contains fail", func(t *testing.T) { - c := check.Bytes.Contains(diff) - assertFailBytesChecker(t, "Contains", c, b, - makeExpl( - fmt.Sprintf("to contain subslice %v", diff), - fmt.Sprint(b), - ), - ) - - c = check.Bytes.Contains(eqJSON) - assertFailBytesChecker(t, "Contains", c, b, - makeExpl( - fmt.Sprintf("to contain subslice %v", eqJSON), - fmt.Sprint(b), - ), - ) - }) - - t.Run("NotContains pass", func(t *testing.T) { - c := check.Bytes.NotContains(diff) - assertPassBytesChecker(t, "NotContains", c, b) - c = check.Bytes.NotContains(eqJSON) - assertPassBytesChecker(t, "NotContains", c, b) - }) - - t.Run("NotContains fail", func(t *testing.T) { - c := check.Bytes.NotContains(sub) - assertFailBytesChecker(t, "NotContains", c, b, makeExpl( - fmt.Sprintf("not to contain subslice %v", sub), - fmt.Sprint(b), - )) - - c = check.Bytes.NotContains(b) - assertFailBytesChecker(t, "NotContains", c, b, makeExpl( - fmt.Sprintf("not to contain subslice %v", b), - fmt.Sprint(b), - )) - }) - - t.Run("AsMap pass", func(t *testing.T) { - c := check.Bytes.AsMap(check.Map.HasKeys("id")) - assertPassBytesChecker(t, "AsMap", c, b) - assertPassBytesChecker(t, "AsMap", c, eqJSON) - }) - - t.Run("AsMap fail", func(t *testing.T) { - c := check.Bytes.AsMap(check.Map.HasKeys("id", "nomatch")) - assertFailBytesChecker(t, "AsMap", c, b, makeExpl( - "to pass MapChecker", - "explanation: json map:\n"+makeExpl( - "to have keys [nomatch]", - fmt.Sprint(mapof(b)), - ), - )) - - c = check.Bytes.AsMap(check.Map.HasKeys("id")) - assertFailBytesChecker(t, "AsMap", c, sub, makeExpl( - "to pass MapChecker", - "error: json: cannot unmarshal string into Go value of type map[string]interface {}", - )) - }) - - t.Run("AsString pass", func(t *testing.T) { - c := check.Bytes.AsString(check.String.Is(string(b))) - assertPassBytesChecker(t, "AsString", c, b) - }) - - t.Run("AsString fail", func(t *testing.T) { - c := check.Bytes.AsString(check.String.Is(string(diff))) - assertFailBytesChecker(t, "AsString", c, b, makeExpl( - "to pass StringChecker", - "explanation: converted bytes:\n"+makeExpl( - string(diff), - string(b), - ), - )) - }) -} - -// Helpers - -func assertPassBytesChecker(t *testing.T, method string, c check.BytesChecker, in []byte) { - t.Helper() - if !c.Pass(in) { - failBytesCheckerTest(t, true, method, in, c.Explain) - } -} - -func assertFailBytesChecker(t *testing.T, method string, c check.BytesChecker, in []byte, expexpl string) { - t.Helper() - if c.Pass(in) { - failBytesCheckerTest(t, false, method, in, c.Explain) - } - assertGoodExplain(t, c, in, expexpl) -} - -func failBytesCheckerTest(t *testing.T, expPass bool, method string, in []byte, explain check.ExplainFunc) { - t.Helper() - failCheckerTest(t, expPass, "Bytes."+method, explain("Bytes value", in)) -} diff --git a/check/providers_context_test.go b/check/providers_context_test.go deleted file mode 100644 index 0e22a44..0000000 --- a/check/providers_context_test.go +++ /dev/null @@ -1,113 +0,0 @@ -package check_test - -import ( - "context" - "testing" - - "github.com/drykit-go/testx/check" - "github.com/drykit-go/testx/checkconv" -) - -func TestContextCheckerProvider(t *testing.T) { - ctxNotDone := func() (context.Context, context.CancelFunc) { - return context.WithCancel(context.Background()) - } - ctxDone := func() context.Context { - ctx, cancel := ctxNotDone() - cancel() - return ctx - } - ctxVal := func(key, val interface{}) context.Context { - return context.WithValue(context.Background(), key, val) - } - - t.Run("Done pass", func(t *testing.T) { - checkDone := check.Context.Done(true) - ctxDone := ctxDone() - assertPassContextChecker(t, "Done", checkDone, ctxDone) - - checkNotDone := check.Context.Done(false) - ctxNotDone, cancel := ctxNotDone() - assertPassContextChecker(t, "Done", checkNotDone, ctxNotDone) - cancel() - }) - - t.Run("Done fail", func(t *testing.T) { - checkDone := check.Context.Done(true) - ctxNotDone, cancel := ctxNotDone() - assertFailContextChecker(t, "Done", checkDone, ctxNotDone, makeExpl( - "context to be done", - "context not done", - )) - cancel() - - checkNotDone := check.Context.Done(false) - ctxDone := ctxDone() - assertFailContextChecker(t, "Done", checkNotDone, ctxDone, makeExpl( - "context not to be done", - "context canceled", - )) - }) - - t.Run("HasKeys pass", func(t *testing.T) { - c := check.Context.HasKeys("user") - ctx := ctxVal("user", struct{}{}) - assertPassContextChecker(t, "HasKeys", c, ctx) - }) - - t.Run("HasKeys fail", func(t *testing.T) { - c := check.Context.HasKeys("secret", "user", "token") - ctx := ctxVal("user", struct{}{}) - assertFailContextChecker(t, "HasKeys", c, ctx, makeExpl( - "to have keys [secret, token]", - "keys not set", - )) - }) - - t.Run("Value pass", func(t *testing.T) { - c := check.Context.Value("userID", checkconv.FromInt(check.Int.GT(0))) - ctx := ctxVal("userID", 42) - assertPassContextChecker(t, "Value", c, ctx) - }) - - t.Run("Value fail", func(t *testing.T) { - c := check.Context.Value("userID", check.Value.Is(0)) - - ctxMissingKey := context.Background() - assertFailContextChecker(t, "Value", c, ctxMissingKey, makeExpl( - "value for key userID to pass ValueChecker", - "explanation: value:\n"+makeExpl("0", ""), - )) - - ctxBadValue := ctxVal("userID", -1) - assertFailContextChecker(t, "Value", c, ctxBadValue, makeExpl( - "value for key userID to pass ValueChecker", - "explanation: value:\n"+makeExpl("0", "-1"), - )) - }) -} - -// Helpers - -//nolint: revive // context-as-argument rule not relevant here -func assertPassContextChecker(t *testing.T, method string, c check.ContextChecker, ctx context.Context) { - t.Helper() - if !c.Pass(ctx) { - failContextCheckerTest(t, true, method, ctx, c.Explain) - } -} - -//nolint: revive // context-as-argument rule not relevant here -func assertFailContextChecker(t *testing.T, method string, c check.ContextChecker, ctx context.Context, expexpl string) { - t.Helper() - if c.Pass(ctx) { - failContextCheckerTest(t, false, method, ctx, c.Explain) - } - assertGoodExplain(t, c, ctx, expexpl) -} - -//nolint: revive // context-as-argument rule not relevant here -func failContextCheckerTest(t *testing.T, expPass bool, method string, ctx context.Context, explain check.ExplainFunc) { - t.Helper() - failCheckerTest(t, expPass, "Context."+method, explain("Context value", ctx)) -} diff --git a/check/providers_duration_test.go b/check/providers_duration_test.go deleted file mode 100644 index afda5ac..0000000 --- a/check/providers_duration_test.go +++ /dev/null @@ -1,126 +0,0 @@ -package check_test - -import ( - "fmt" - "testing" - "time" - - "github.com/drykit-go/testx/check" -) - -func TestDurationCheckerProvider(t *testing.T) { - const ( - d = 1 * time.Second - less = d - time.Millisecond - more = d + time.Millisecond - moremore = more + time.Millisecond - ) - - ms := func(d time.Duration) int64 { - return d.Milliseconds() - } - - t.Run("Under pass", func(t *testing.T) { - c := check.Duration.Under(more) - assertPassDurationChecker(t, "Under", c, d) - }) - - t.Run("Under fail", func(t *testing.T) { - c := check.Duration.Under(less) - assertFailDurationChecker(t, "Under", c, d, makeExpl( - fmt.Sprintf("under %dms", ms(less)), - fmt.Sprintf("%dms", ms(d)), - )) - - c = check.Duration.Under(d) - assertFailDurationChecker(t, "Under", c, d, makeExpl( - fmt.Sprintf("under %dms", ms(d)), - fmt.Sprintf("%dms", ms(d)), - )) - }) - - t.Run("Over pass", func(t *testing.T) { - c := check.Duration.Over(less) - assertPassDurationChecker(t, "Over", c, d) - }) - - t.Run("Over fail", func(t *testing.T) { - c := check.Duration.Over(more) - assertFailDurationChecker(t, "Over", c, d, makeExpl( - fmt.Sprintf("over %dms", ms(more)), - fmt.Sprintf("%dms", ms(d)), - )) - - c = check.Duration.Over(d) - assertFailDurationChecker(t, "Over", c, d, makeExpl( - fmt.Sprintf("over %dms", ms(d)), - fmt.Sprintf("%dms", ms(d)), - )) - }) - - t.Run("InRange pass", func(t *testing.T) { - c := check.Duration.InRange(less, more) - assertPassDurationChecker(t, "InRange", c, d) - - c = check.Duration.InRange(d, d) - assertPassDurationChecker(t, "InRange", c, d) - }) - - t.Run("InRange fail", func(t *testing.T) { - c := check.Duration.InRange(more, moremore) - assertFailDurationChecker(t, "InRange", c, d, makeExpl( - fmt.Sprintf("in range [%dms:%dms]", ms(more), ms(moremore)), - fmt.Sprintf("%dms", ms(d)), - )) - - c = check.Duration.InRange(more, less) - assertFailDurationChecker(t, "InRange", c, d, makeExpl( - fmt.Sprintf("in range [%dms:%dms]", ms(more), ms(less)), - fmt.Sprintf("%dms", ms(d)), - )) - }) - - t.Run("OutRange pass", func(t *testing.T) { - c := check.Duration.OutRange(more, moremore) - assertPassDurationChecker(t, "OutRange", c, d) - - c = check.Duration.OutRange(more, less) - assertPassDurationChecker(t, "OutRange", c, d) - }) - - t.Run("OutRange fail", func(t *testing.T) { - c := check.Duration.OutRange(less, more) - assertFailDurationChecker(t, "OutRange", c, d, makeExpl( - fmt.Sprintf("not in range [%dms:%dms]", ms(less), ms(more)), - fmt.Sprintf("%dms", ms(d)), - )) - - c = check.Duration.OutRange(d, d) - assertFailDurationChecker(t, "OutRange", c, d, makeExpl( - fmt.Sprintf("not in range [%dms:%dms]", ms(d), ms(d)), - fmt.Sprintf("%dms", ms(d)), - )) - }) -} - -// Helpers - -func assertPassDurationChecker(t *testing.T, method string, c check.DurationChecker, d time.Duration) { - t.Helper() - if !c.Pass(d) { - failDurationCheckerTest(t, true, method, d, c.Explain) - } -} - -func assertFailDurationChecker(t *testing.T, method string, c check.DurationChecker, d time.Duration, expexpl string) { - t.Helper() - if c.Pass(d) { - failDurationCheckerTest(t, false, method, d, c.Explain) - } - assertGoodExplain(t, c, d, expexpl) -} - -func failDurationCheckerTest(t *testing.T, expPass bool, method string, d time.Duration, explain check.ExplainFunc) { - t.Helper() - failCheckerTest(t, expPass, "Duration."+method, explain("Duration value", d)) -} diff --git a/check/providers_float64.go b/check/providers_float64.go deleted file mode 100644 index be1e7df..0000000 --- a/check/providers_float64.go +++ /dev/null @@ -1,95 +0,0 @@ -package check - -import "fmt" - -// float64CheckerProvider provides checks on type float64. -type float64CheckerProvider struct{ baseCheckerProvider } - -// Is checks the gotten float64 is equal to the target. -func (p float64CheckerProvider) Is(tar float64) Float64Checker { - pass := func(got float64) bool { return got == tar } - expl := func(label string, got interface{}) string { - return p.explain(label, tar, got) - } - return NewFloat64Checker(pass, expl) -} - -// Not checks the gotten float64 is not equal to the target. -func (p float64CheckerProvider) Not(values ...float64) Float64Checker { - var match float64 - pass := func(got float64) bool { - for _, v := range values { - if got == v { - match = v - return false - } - } - return true - } - expl := func(label string, got interface{}) string { - return p.explainNot(label, match, got) - } - return NewFloat64Checker(pass, expl) -} - -// InRange checks the gotten float64 is in the closed interval [lo:hi]. -func (p float64CheckerProvider) InRange(lo, hi float64) Float64Checker { - pass := func(got float64) bool { return p.inrange(got, lo, hi) } - expl := func(label string, got interface{}) string { - return p.explain(label, fmt.Sprintf("in range [%v:%v]", lo, hi), got) - } - return NewFloat64Checker(pass, expl) -} - -// OutRange checks the gotten float64 is not in the closed interval [lo:hi]. -func (p float64CheckerProvider) OutRange(lo, hi float64) Float64Checker { - pass := func(got float64) bool { return !p.inrange(got, lo, hi) } - expl := func(label string, got interface{}) string { - return p.explainNot(label, fmt.Sprintf("in range [%v:%v]", lo, hi), got) - } - return NewFloat64Checker(pass, expl) -} - -// GT checks the gotten float64 is greater than the target. -func (p float64CheckerProvider) GT(tar float64) Float64Checker { - pass := func(got float64) bool { return !p.lte(got, tar) } - expl := func(label string, got interface{}) string { - return p.explain(label, fmt.Sprintf("> %v", tar), got) - } - return NewFloat64Checker(pass, expl) -} - -// GTE checks the gotten float64 is greater or equal to the target. -func (p float64CheckerProvider) GTE(tar float64) Float64Checker { - pass := func(got float64) bool { return !p.lt(got, tar) } - expl := func(label string, got interface{}) string { - return p.explain(label, fmt.Sprintf(">= %v", tar), got) - } - return NewFloat64Checker(pass, expl) -} - -// LT checks the gotten float64 is lesser than the target. -func (p float64CheckerProvider) LT(tar float64) Float64Checker { - pass := func(got float64) bool { return p.lt(got, tar) } - expl := func(label string, got interface{}) string { - return p.explain(label, fmt.Sprintf("< %v", tar), got) - } - return NewFloat64Checker(pass, expl) -} - -// LTE checks the gotten float64 is lesser or equal to the target. -func (p float64CheckerProvider) LTE(tar float64) Float64Checker { - pass := func(got float64) bool { return p.lte(got, tar) } - expl := func(label string, got interface{}) string { - return p.explain(label, fmt.Sprintf("<= %v", tar), got) - } - return NewFloat64Checker(pass, expl) -} - -// Helpers - -func (float64CheckerProvider) lt(a, b float64) bool { return a < b } -func (float64CheckerProvider) lte(a, b float64) bool { return a <= b } -func (p float64CheckerProvider) inrange(n, lo, hi float64) bool { - return !p.lt(n, lo) && p.lte(n, hi) -} diff --git a/check/providers_float64_test.go b/check/providers_float64_test.go deleted file mode 100644 index 0a4d562..0000000 --- a/check/providers_float64_test.go +++ /dev/null @@ -1,155 +0,0 @@ -package check_test - -import ( - "fmt" - "testing" - - "github.com/drykit-go/testx/check" -) - -func TestFloat64CheckerProvider(t *testing.T) { - const ( - n = 42 - inf = n - 1 - sup = n + 1 - ) - var ( - nstr = fmt.Sprint(n) - infstr = fmt.Sprint(inf) - supstr = fmt.Sprint(sup) - ) - - t.Run("Is pass", func(t *testing.T) { - c := check.Float64.Is(n) - assertPassFloat64Checker(t, "Is", c, n) - }) - - t.Run("Is fail", func(t *testing.T) { - c := check.Float64.Is(inf) - assertFailFloat64Checker(t, "Is", c, n, makeExpl(infstr, nstr)) - }) - - t.Run("Not pass", func(t *testing.T) { - c := check.Float64.Not(-1, 314, -n) - assertPassFloat64Checker(t, "Not", c, n) - }) - - t.Run("Not fail", func(t *testing.T) { - c := check.Float64.Not(-1, 314, n, 1618) - assertFailFloat64Checker(t, "Not", c, n, makeExpl("not "+nstr, nstr)) - }) - - t.Run("LT pass", func(t *testing.T) { - c := check.Float64.LT(sup) - assertPassFloat64Checker(t, "LT", c, n) - }) - - t.Run("LT fail", func(t *testing.T) { - c := check.Float64.LT(inf) - assertFailFloat64Checker(t, "LT", c, n, makeExpl("< "+infstr, nstr)) - c = check.Float64.LT(n) - assertFailFloat64Checker(t, "LT", c, n, makeExpl("< "+nstr, nstr)) - }) - - t.Run("LTE pass", func(t *testing.T) { - c := check.Float64.LTE(sup) - assertPassFloat64Checker(t, "LTE", c, n) - c = check.Float64.LTE(n) - assertPassFloat64Checker(t, "LTE", c, n) - }) - - t.Run("LTE fail", func(t *testing.T) { - c := check.Float64.LTE(inf) - assertFailFloat64Checker(t, "LTE", c, n, makeExpl("<= "+infstr, nstr)) - }) - - t.Run("GT pass", func(t *testing.T) { - c := check.Float64.GT(inf) - assertPassFloat64Checker(t, "GT", c, n) - }) - - t.Run("GT fail", func(t *testing.T) { - c := check.Float64.GT(sup) - assertFailFloat64Checker(t, "GT", c, n, makeExpl("> "+supstr, nstr)) - c = check.Float64.GT(n) - assertFailFloat64Checker(t, "GT", c, n, makeExpl("> "+nstr, nstr)) - }) - - t.Run("GTE pass", func(t *testing.T) { - c := check.Float64.GTE(inf) - assertPassFloat64Checker(t, "GTE", c, n) - c = check.Float64.GTE(n) - assertPassFloat64Checker(t, "GTE", c, n) - }) - - t.Run("GTE fail", func(t *testing.T) { - c := check.Float64.GTE(sup) - assertFailFloat64Checker(t, "GTE", c, n, makeExpl(">= "+supstr, nstr)) - }) - - t.Run("InRange pass", func(t *testing.T) { - c := check.Float64.InRange(inf, sup) - assertPassFloat64Checker(t, "InRange", c, n) - - c = check.Float64.InRange(n, n) - assertPassFloat64Checker(t, "InRange", c, n) - }) - - t.Run("InRange fail", func(t *testing.T) { - c := check.Float64.InRange(sup, sup+1) - assertFailFloat64Checker(t, "InRange", c, n, makeExpl( - fmt.Sprintf("in range [%v:%v]", sup, sup+1), - nstr, - )) - - c = check.Float64.InRange(sup, inf) - assertFailFloat64Checker(t, "InRange", c, n, makeExpl( - fmt.Sprintf("in range [%v:%v]", sup, inf), - nstr, - )) - }) - - t.Run("OutRange pass", func(t *testing.T) { - c := check.Float64.OutRange(sup, sup+1) - assertPassFloat64Checker(t, "OutRange", c, n) - - c = check.Float64.OutRange(sup, inf) - assertPassFloat64Checker(t, "OutRange", c, n) - }) - - t.Run("OutRange fail", func(t *testing.T) { - c := check.Float64.OutRange(inf, sup) - assertFailFloat64Checker(t, "OutRange", c, n, makeExpl( - fmt.Sprintf("not in range [%v:%v]", inf, sup), - nstr, - )) - - c = check.Float64.OutRange(n, n) - assertFailFloat64Checker(t, "OutRange", c, n, makeExpl( - fmt.Sprintf("not in range [%v:%v]", n, n), - nstr, - )) - }) -} - -// Helpers - -func assertPassFloat64Checker(t *testing.T, method string, c check.Float64Checker, n float64) { - t.Helper() - if !c.Pass(n) { - failFloat64CheckerTest(t, true, method, n, c.Explain) - } -} - -func assertFailFloat64Checker(t *testing.T, method string, c check.Float64Checker, n float64, expexpl string) { - t.Helper() - if c.Pass(n) { - failFloat64CheckerTest(t, false, method, n, c.Explain) - } - assertGoodExplain(t, c, n, expexpl) -} - -func failFloat64CheckerTest(t *testing.T, expPass bool, method string, n float64, explain check.ExplainFunc) { - t.Helper() - failCheckerTest(t, expPass, "Float64."+method, explain("Float64 value", n)) -} diff --git a/check/providers_httpheader_test.go b/check/providers_httpheader_test.go deleted file mode 100644 index 9eb924d..0000000 --- a/check/providers_httpheader_test.go +++ /dev/null @@ -1,115 +0,0 @@ -package check_test - -import ( - "fmt" - "net/http" - "testing" - - "github.com/drykit-go/testx/check" -) - -func TestHTTPHeaderCheckerProvider(t *testing.T) { - h := http.Header{ - "Content-Length": []string{"42"}, - "API_KEY": []string{"secret0", "secret1"}, - } - hstr := fmt.Sprint(h) - - t.Run("HasKey pass", func(t *testing.T) { - c := check.HTTPHeader.HasKey("API_KEY") - assertPassHTTPHeaderChecker(t, "HasKey", c, h) - }) - - t.Run("HasKey fail", func(t *testing.T) { - c := check.HTTPHeader.HasKey("password") - assertFailHTTPHeaderChecker(t, "HasKey", c, h, - makeExpl(`to have key "password"`, hstr), - ) - }) - - t.Run("HasNotKey pass", func(t *testing.T) { - c := check.HTTPHeader.HasNotKey("password") - assertPassHTTPHeaderChecker(t, "HasNotKey", c, h) - }) - - t.Run("HasNotKey fail", func(t *testing.T) { - c := check.HTTPHeader.HasNotKey("API_KEY") - assertFailHTTPHeaderChecker(t, "HasNotKey", c, h, - makeExpl(`not to have key "API_KEY"`, hstr), - ) - }) - - t.Run("HasValue pass", func(t *testing.T) { - c := check.HTTPHeader.HasValue("42") - assertPassHTTPHeaderChecker(t, "HasValue", c, h) - c = check.HTTPHeader.HasValue("secret0") - assertPassHTTPHeaderChecker(t, "HasValue", c, h) - }) - - t.Run("HasValue fail", func(t *testing.T) { - c := check.HTTPHeader.HasValue("secret42") - assertFailHTTPHeaderChecker(t, "HasValue", c, h, - makeExpl(`to have value secret42`, hstr), - ) - - c = check.HTTPHeader.HasValue("secret1") - assertFailHTTPHeaderChecker(t, "HasValue", c, h, - makeExpl(`to have value secret1`, hstr), - ) - }) - - t.Run("HasNotValue pass", func(t *testing.T) { - c := check.HTTPHeader.HasNotValue("secret42") - assertPassHTTPHeaderChecker(t, "HasNotValue", c, h) - }) - - t.Run("HasNotValue fail", func(t *testing.T) { - c := check.HTTPHeader.HasNotValue("42") - assertFailHTTPHeaderChecker(t, "HasNotValue", c, h, - makeExpl(`not to have value 42`, hstr), - ) - - c = check.HTTPHeader.HasNotValue("secret0") - assertFailHTTPHeaderChecker(t, "HasNotValue", c, h, - makeExpl(`not to have value secret0`, hstr), - ) - }) - - t.Run("CheckValue pass", func(t *testing.T) { - c := check.HTTPHeader.CheckValue("API_KEY", check.String.Is("secret0")) - assertPassHTTPHeaderChecker(t, "CheckValue", c, h) - }) - - t.Run("CheckValue fail", func(t *testing.T) { - c := check.HTTPHeader.CheckValue("API_KEY", check.String.Not("secret0")) - assertFailHTTPHeaderChecker(t, "CheckValue", c, h, makeExpl( - `value for key "API_KEY" to pass StringChecker`, - `explanation: http.Header["API_KEY"]:`+"\n"+makeExpl( - "not secret0", - "secret0", - ), - )) - }) -} - -// Helpers - -func assertPassHTTPHeaderChecker(t *testing.T, method string, c check.HTTPHeaderChecker, h http.Header) { - t.Helper() - if !c.Pass(h) { - failHTTPHeaderCheckerTest(t, true, method, h, c.Explain) - } -} - -func assertFailHTTPHeaderChecker(t *testing.T, method string, c check.HTTPHeaderChecker, h http.Header, expexpl string) { - t.Helper() - if c.Pass(h) { - failHTTPHeaderCheckerTest(t, false, method, h, c.Explain) - } - assertGoodExplain(t, c, h, expexpl) -} - -func failHTTPHeaderCheckerTest(t *testing.T, expPass bool, method string, h http.Header, explain check.ExplainFunc) { - t.Helper() - failCheckerTest(t, expPass, "HTTPHeader."+method, explain("HTTPHeader value", h)) -} diff --git a/check/providers_httprequest.go b/check/providers_httprequest.go deleted file mode 100644 index e63c1fa..0000000 --- a/check/providers_httprequest.go +++ /dev/null @@ -1,71 +0,0 @@ -package check - -import ( - "context" - "net/http" - - "github.com/drykit-go/testx/internal/ioutil" -) - -// httpRequestCheckerProvider provides checks on type *http.Request. -type httpRequestCheckerProvider struct{ baseHTTPCheckerProvider } - -// ContentLength checks the gotten *http.Request ContentLength passes -// the input IntChecker. -func (p httpRequestCheckerProvider) ContentLength(c IntChecker) HTTPRequestChecker { - var clen int - pass := func(got *http.Request) bool { - clen = int(got.ContentLength) - return c.Pass(clen) - } - return NewHTTPRequestChecker( - pass, - p.explainContentLengthFunc(c, func() int { return clen }), - ) -} - -// Header checks the gotten *http.Request Header passes -// the input HTTPHeaderChecker. -func (p httpRequestCheckerProvider) Header(c HTTPHeaderChecker) HTTPRequestChecker { - var header http.Header - pass := func(got *http.Request) bool { - header = got.Header - return c.Pass(header) - } - return NewHTTPRequestChecker( - pass, - p.explainHeaderFunc(c, func() http.Header { return header }), - ) -} - -// Body checks the gotten *http.Request Body passes the input BytesChecker. -// It should be used only once on a same *http.Request as it closes its body -// after reading it. -func (p httpRequestCheckerProvider) Body(c BytesChecker) HTTPRequestChecker { - var body []byte - pass := func(got *http.Request) bool { - body = ioutil.NopRead(&got.Body) - return c.Pass(body) - } - return NewHTTPRequestChecker( - pass, - p.explainBodyFunc(c, func() []byte { return body }), - ) -} - -// Context checks the gotten *http.Request Context passes -// the input ContextChecker. -func (p httpRequestCheckerProvider) Context(c ContextChecker) HTTPRequestChecker { - var ctx context.Context - pass := func(got *http.Request) bool { - ctx = got.Context() - return c.Pass(ctx) - } - expl := func(label string, got interface{}) string { - return p.explainCheck(label, - "context to pass ContextChecker", - c.Explain("context", ctx), - ) - } - return NewHTTPRequestChecker(pass, expl) -} diff --git a/check/providers_httprequest_test.go b/check/providers_httprequest_test.go deleted file mode 100644 index 9f33b72..0000000 --- a/check/providers_httprequest_test.go +++ /dev/null @@ -1,122 +0,0 @@ -package check_test - -import ( - "bytes" - "context" - "encoding/json" - "fmt" - "net/http" - "testing" - - "github.com/drykit-go/testx/check" -) - -func TestHTTPRequestCheckerProvider(t *testing.T) { - newCtx := func(key, val interface{}) context.Context { - return context.WithValue(context.Background(), key, val) - } - newReq := func() *http.Request { - ctx := newCtx("userID", 42) - body, _ := json.Marshal(map[string]interface{}{"answer": 42}) - r, _ := http.NewRequestWithContext(ctx, "GET", "/endpoint?id=42", bytes.NewReader(body)) - r.Header.Set("Content-Type", "application/json") - return r - } - - var ( - expContentLength = 13 - expBody = []byte(`{"answer":42}`) - expCtxKey = "userID" - expCtxVal = 42 - ) - - t.Run("ContentLength pass", func(t *testing.T) { - c := check.HTTPRequest.ContentLength(check.Int.Is(expContentLength)) - assertPassHTTPRequestChecker(t, "ContentLength", c, newReq()) - }) - - t.Run("ContentLength fail", func(t *testing.T) { - c := check.HTTPRequest.ContentLength(check.Int.Not(expContentLength)) - assertFailHTTPRequestChecker(t, "ContentLength", c, newReq(), makeExpl( - "content length to pass IntChecker", - fmt.Sprintf( - "explanation: content length:\nexp not %d\ngot %d", - expContentLength, expContentLength, - ), - )) - }) - - t.Run("Header pass", func(t *testing.T) { - c := check.HTTPRequest.Header(check.HTTPHeader.HasKey("Content-Type")) - assertPassHTTPRequestChecker(t, "Header", c, newReq()) - }) - - t.Run("Header fail", func(t *testing.T) { - c := check.HTTPRequest.Header(check.HTTPHeader.HasNotKey("Content-Type")) - r := newReq() - assertFailHTTPRequestChecker(t, "Header", c, r, makeExpl( - "header to pass HTTPHeaderChecker", - fmt.Sprintf( - "explanation: http.Header:\nexp not to have key \"Content-Type\"\ngot %v", - r.Header, - ), - )) - }) - - t.Run("Body pass", func(t *testing.T) { - c := check.HTTPRequest.Body(check.Bytes.Is(expBody)) - assertPassHTTPRequestChecker(t, "Body", c, newReq()) - }) - - t.Run("Body fail", func(t *testing.T) { - c := check.HTTPRequest.Body(check.Bytes.Not(expBody)) - assertFailHTTPRequestChecker(t, "Body", c, newReq(), makeExpl( - "body to pass BytesChecker", - "explanation: bytes:\n"+makeExpl( - "not "+fmt.Sprint(expBody), - fmt.Sprint(expBody), - ), - )) - }) - - t.Run("Context pass", func(t *testing.T) { - c := check.HTTPRequest.Context(check.Context.Value(expCtxKey, check.Value.Is(expCtxVal))) - assertPassHTTPRequestChecker(t, "Context", c, newReq()) - }) - - t.Run("Context fail", func(t *testing.T) { - c := check.HTTPRequest.Context(check.Context.Value(expCtxKey, check.Value.Not(expCtxVal))) - assertFailHTTPRequestChecker(t, "Context", c, newReq(), makeExpl( - "context to pass ContextChecker", - "explanation: context:\n"+makeExpl( - "value for key userID to pass ValueChecker", - "explanation: value:\n"+makeExpl( - "not 42", - "42", - ), - ), - )) - }) -} - -// Helpers - -func assertPassHTTPRequestChecker(t *testing.T, method string, c check.HTTPRequestChecker, r *http.Request) { - t.Helper() - if !c.Pass(r) { - failHTTPRequestCheckerTest(t, true, method, r, c.Explain) - } -} - -func assertFailHTTPRequestChecker(t *testing.T, method string, c check.HTTPRequestChecker, r *http.Request, expexpl string) { - t.Helper() - if c.Pass(r) { - failHTTPRequestCheckerTest(t, false, method, r, c.Explain) - } - assertGoodExplain(t, c, r, expexpl) -} - -func failHTTPRequestCheckerTest(t *testing.T, expPass bool, method string, r *http.Request, explain check.ExplainFunc) { - t.Helper() - failCheckerTest(t, expPass, "HTTPRequest."+method, explain("HTTPRequest value", r)) -} diff --git a/check/providers_httpresponse.go b/check/providers_httpresponse.go deleted file mode 100644 index c5fe995..0000000 --- a/check/providers_httpresponse.go +++ /dev/null @@ -1,87 +0,0 @@ -package check - -import ( - "net/http" - - "github.com/drykit-go/testx/internal/ioutil" -) - -// httpResponseCheckerProvider provides checks on type *http.Response. -type httpResponseCheckerProvider struct{ baseHTTPCheckerProvider } - -// StatusCode checks the gotten *http.Response StatusCode passes -// the input IntChecker. -func (p httpResponseCheckerProvider) StatusCode(c IntChecker) HTTPResponseChecker { - var code int - pass := func(got *http.Response) bool { - code = got.StatusCode - return c.Pass(code) - } - expl := func(label string, _ interface{}) string { - return p.explainCheck(label, - "status code to pass IntChecker", - c.Explain("status code", code), - ) - } - return NewHTTPResponseChecker(pass, expl) -} - -// Status checks the gotten *http.Response Status passes -// the input StringChecker. -func (p httpResponseCheckerProvider) Status(c StringChecker) HTTPResponseChecker { - var status string - pass := func(got *http.Response) bool { - status = got.Status - return c.Pass(status) - } - expl := func(label string, _ interface{}) string { - return p.explainCheck(label, - "status to pass StringChecker", - c.Explain("status", status), - ) - } - return NewHTTPResponseChecker(pass, expl) -} - -// ContentLength checks the gotten *http.Response ContentLength passes -// the input IntChecker. -func (p httpResponseCheckerProvider) ContentLength(c IntChecker) HTTPResponseChecker { - var clen int - pass := func(got *http.Response) bool { - clen = int(got.ContentLength) - return c.Pass(clen) - } - return NewHTTPResponseChecker( - pass, - p.explainContentLengthFunc(c, func() int { return clen }), - ) -} - -// Header checks the gotten *http.Response Header passes -// the input HTTPHeaderChecker. -func (p httpResponseCheckerProvider) Header(c HTTPHeaderChecker) HTTPResponseChecker { - var header http.Header - pass := func(got *http.Response) bool { - header = got.Header - return c.Pass(header) - } - return NewHTTPResponseChecker( - pass, - p.explainHeaderFunc(c, func() http.Header { return header }), - ) -} - -// Body checks the gotten *http.Response Body passes the input BytesChecker. -// It should be used only once on a same *http.Response as it closes its body -// after reading it. -func (p httpResponseCheckerProvider) Body(c BytesChecker) HTTPResponseChecker { - var body []byte - pass := func(got *http.Response) bool { - body = ioutil.NopRead(&got.Body) - return c.Pass(body) - } - return NewHTTPResponseChecker( - pass, - p.explainBodyFunc(c, func() []byte { return body }), - ) -} diff --git a/check/providers_httpresponse_test.go b/check/providers_httpresponse_test.go deleted file mode 100644 index eb184a6..0000000 --- a/check/providers_httpresponse_test.go +++ /dev/null @@ -1,142 +0,0 @@ -package check_test - -import ( - "encoding/json" - "fmt" - "net/http" - "net/http/httptest" - "testing" - - "github.com/drykit-go/testx/check" -) - -//nolint:bodyclose -func TestHTTPResponseCheckerProvider(t *testing.T) { - newResp := func() *http.Response { - rr := httptest.NewRecorder() - rq := httptest.NewRequest("GET", "/", nil) - body, _ := json.Marshal(map[string]interface{}{"answer": 42}) - clen := len(body) - - func(w http.ResponseWriter, _ *http.Request) { - w.WriteHeader(http.StatusTeapot) - w.Header().Set("Content-Type", "application/json") - w.Write(body) - }(rr, rq) - - resp := rr.Result() - resp.Header = rr.Header() - resp.ContentLength = int64(clen) - return resp - } - - var ( - expStatusCode = 418 - expStatus = "418 I'm a teapot" - expContentLength = 13 - expBody = []byte(`{"answer":42}`) - ) - - t.Run("StatusCode pass", func(t *testing.T) { - c := check.HTTPResponse.StatusCode(check.Int.Is(expStatusCode)) - assertPassHTTPResponseChecker(t, "StatusCode", c, newResp()) - }) - - t.Run("StatusCode fail", func(t *testing.T) { - c := check.HTTPResponse.StatusCode(check.Int.Not(expStatusCode)) - assertFailHTTPResponseChecker(t, "StatusCode", c, newResp(), makeExpl( - "status code to pass IntChecker", - "explanation: status code:\n"+makeExpl( - "not "+fmt.Sprint(expStatusCode), - fmt.Sprint(expStatusCode), - ), - )) - }) - - t.Run("Status pass", func(t *testing.T) { - c := check.HTTPResponse.Status(check.String.Is(expStatus)) - assertPassHTTPResponseChecker(t, "Status", c, newResp()) - }) - - t.Run("Status fail", func(t *testing.T) { - c := check.HTTPResponse.Status(check.String.Not(expStatus)) - assertFailHTTPResponseChecker(t, "Status", c, newResp(), makeExpl( - "status to pass StringChecker", - "explanation: status:\n"+makeExpl( - "not "+expStatus, - expStatus, - ), - )) - }) - - t.Run("ContentLength pass", func(t *testing.T) { - c := check.HTTPResponse.ContentLength(check.Int.Is(expContentLength)) - assertPassHTTPResponseChecker(t, "ContentLength", c, newResp()) - }) - - t.Run("ContentLength fail", func(t *testing.T) { - c := check.HTTPResponse.ContentLength(check.Int.Not(expContentLength)) - assertFailHTTPResponseChecker(t, "ContentLength", c, newResp(), makeExpl( - "content length to pass IntChecker", - "explanation: content length:\n"+makeExpl( - "not "+fmt.Sprint(expContentLength), - fmt.Sprint(expContentLength), - ), - )) - }) - - t.Run("Header pass", func(t *testing.T) { - c := check.HTTPResponse.Header(check.HTTPHeader.HasKey("Content-Type")) - assertPassHTTPResponseChecker(t, "Header", c, newResp()) - }) - - t.Run("Header fail", func(t *testing.T) { - c := check.HTTPResponse.Header(check.HTTPHeader.HasNotKey("Content-Type")) - resp := newResp() - assertFailHTTPResponseChecker(t, "Header", c, resp, makeExpl( - "header to pass HTTPHeaderChecker", - "explanation: http.Header:\n"+makeExpl( - `not to have key "Content-Type"`, - fmt.Sprint(resp.Header), - ), - )) - }) - - t.Run("Body pass", func(t *testing.T) { - c := check.HTTPResponse.Body(check.Bytes.Is(expBody)) - assertPassHTTPResponseChecker(t, "Body", c, newResp()) - }) - - t.Run("Body fail", func(t *testing.T) { - c := check.HTTPResponse.Body(check.Bytes.Not(expBody)) - assertFailHTTPResponseChecker(t, "Body", c, newResp(), makeExpl( - "body to pass BytesChecker", - "explanation: bytes:\n"+makeExpl( - "not "+fmt.Sprint(expBody), - fmt.Sprint(expBody), - ), - )) - }) -} - -// Helpers - -func assertPassHTTPResponseChecker(t *testing.T, method string, c check.HTTPResponseChecker, resp *http.Response) { - t.Helper() - if !c.Pass(resp) { - failHTTPResponseCheckerTest(t, true, method, resp, c.Explain) - } -} - -func assertFailHTTPResponseChecker(t *testing.T, method string, c check.HTTPResponseChecker, resp *http.Response, expexpl string) { - t.Helper() - if c.Pass(resp) { - failHTTPResponseCheckerTest(t, false, method, resp, c.Explain) - } - assertGoodExplain(t, c, resp, expexpl) -} - -func failHTTPResponseCheckerTest(t *testing.T, expPass bool, method string, resp *http.Response, explain check.ExplainFunc) { - t.Helper() - failCheckerTest(t, expPass, "HTTPResponse."+method, explain("HTTPResponse value", resp)) -} diff --git a/check/providers_int.go b/check/providers_int.go deleted file mode 100644 index e7e907c..0000000 --- a/check/providers_int.go +++ /dev/null @@ -1,95 +0,0 @@ -package check - -import "fmt" - -// intCheckerProvider provides checks on type int. -type intCheckerProvider struct{ baseCheckerProvider } - -// Is checks the gotten int is equal to the target. -func (p intCheckerProvider) Is(tar int) IntChecker { - pass := func(got int) bool { return got == tar } - expl := func(label string, got interface{}) string { - return p.explain(label, tar, got) - } - return NewIntChecker(pass, expl) -} - -// Not checks the gotten int is not equal to the target. -func (p intCheckerProvider) Not(values ...int) IntChecker { - var match int - pass := func(got int) bool { - for _, v := range values { - if got == v { - match = v - return false - } - } - return true - } - expl := func(label string, got interface{}) string { - return p.explainNot(label, match, got) - } - return NewIntChecker(pass, expl) -} - -// InRange checks the gotten int is in the closed interval [lo:hi]. -func (p intCheckerProvider) InRange(lo, hi int) IntChecker { - pass := func(got int) bool { return p.inrange(got, lo, hi) } - expl := func(label string, got interface{}) string { - return p.explain(label, fmt.Sprintf("in range [%v:%v]", lo, hi), got) - } - return NewIntChecker(pass, expl) -} - -// OutRange checks the gotten int is not in the closed interval [lo:hi]. -func (p intCheckerProvider) OutRange(lo, hi int) IntChecker { - pass := func(got int) bool { return !p.inrange(got, lo, hi) } - expl := func(label string, got interface{}) string { - return p.explainNot(label, fmt.Sprintf("in range [%v:%v]", lo, hi), got) - } - return NewIntChecker(pass, expl) -} - -// GT checks the gotten int is greater than the target. -func (p intCheckerProvider) GT(tar int) IntChecker { - pass := func(got int) bool { return !p.lte(got, tar) } - expl := func(label string, got interface{}) string { - return p.explain(label, fmt.Sprintf("> %v", tar), got) - } - return NewIntChecker(pass, expl) -} - -// GTE checks the gotten int is greater or equal to the target. -func (p intCheckerProvider) GTE(tar int) IntChecker { - pass := func(got int) bool { return !p.lt(got, tar) } - expl := func(label string, got interface{}) string { - return p.explain(label, fmt.Sprintf(">= %v", tar), got) - } - return NewIntChecker(pass, expl) -} - -// LT checks the gotten int is lesser than the target. -func (p intCheckerProvider) LT(tar int) IntChecker { - pass := func(got int) bool { return p.lt(got, tar) } - expl := func(label string, got interface{}) string { - return p.explain(label, fmt.Sprintf("< %v", tar), got) - } - return NewIntChecker(pass, expl) -} - -// LTE checks the gotten int is lesser or equal to the target. -func (p intCheckerProvider) LTE(tar int) IntChecker { - pass := func(got int) bool { return p.lte(got, tar) } - expl := func(label string, got interface{}) string { - return p.explain(label, fmt.Sprintf("<= %v", tar), got) - } - return NewIntChecker(pass, expl) -} - -// Helpers - -func (intCheckerProvider) lt(a, b int) bool { return a < b } -func (intCheckerProvider) lte(a, b int) bool { return a <= b } -func (p intCheckerProvider) inrange(n, lo, hi int) bool { - return !p.lt(n, lo) && p.lte(n, hi) -} diff --git a/check/providers_int_test.go b/check/providers_int_test.go deleted file mode 100644 index 9ff7f7c..0000000 --- a/check/providers_int_test.go +++ /dev/null @@ -1,155 +0,0 @@ -package check_test - -import ( - "fmt" - "testing" - - "github.com/drykit-go/testx/check" -) - -func TestIntCheckerProvider(t *testing.T) { - const ( - n = 42 - inf = n - 1 - sup = n + 1 - ) - var ( - nstr = fmt.Sprint(n) - infstr = fmt.Sprint(inf) - supstr = fmt.Sprint(sup) - ) - - t.Run("Is pass", func(t *testing.T) { - c := check.Int.Is(n) - assertPassIntChecker(t, "Is", c, n) - }) - - t.Run("Is fail", func(t *testing.T) { - c := check.Int.Is(inf) - assertFailIntChecker(t, "Is", c, n, makeExpl(infstr, nstr)) - }) - - t.Run("Not pass", func(t *testing.T) { - c := check.Int.Not(-1, 314, -n) - assertPassIntChecker(t, "Not", c, n) - }) - - t.Run("Not fail", func(t *testing.T) { - c := check.Int.Not(-1, 314, n, 1618) - assertFailIntChecker(t, "Not", c, n, makeExpl("not "+nstr, nstr)) - }) - - t.Run("LT pass", func(t *testing.T) { - c := check.Int.LT(sup) - assertPassIntChecker(t, "LT", c, n) - }) - - t.Run("LT fail", func(t *testing.T) { - c := check.Int.LT(inf) - assertFailIntChecker(t, "LT", c, n, makeExpl("< "+infstr, nstr)) - c = check.Int.LT(n) - assertFailIntChecker(t, "LT", c, n, makeExpl("< "+nstr, nstr)) - }) - - t.Run("LTE pass", func(t *testing.T) { - c := check.Int.LTE(sup) - assertPassIntChecker(t, "LTE", c, n) - c = check.Int.LTE(n) - assertPassIntChecker(t, "LTE", c, n) - }) - - t.Run("LTE fail", func(t *testing.T) { - c := check.Int.LTE(inf) - assertFailIntChecker(t, "LTE", c, n, makeExpl("<= "+infstr, nstr)) - }) - - t.Run("GT pass", func(t *testing.T) { - c := check.Int.GT(inf) - assertPassIntChecker(t, "GT", c, n) - }) - - t.Run("GT fail", func(t *testing.T) { - c := check.Int.GT(sup) - assertFailIntChecker(t, "GT", c, n, makeExpl("> "+supstr, nstr)) - c = check.Int.GT(n) - assertFailIntChecker(t, "GT", c, n, makeExpl("> "+nstr, nstr)) - }) - - t.Run("GTE pass", func(t *testing.T) { - c := check.Int.GTE(inf) - assertPassIntChecker(t, "GTE", c, n) - c = check.Int.GTE(n) - assertPassIntChecker(t, "GTE", c, n) - }) - - t.Run("GTE fail", func(t *testing.T) { - c := check.Int.GTE(sup) - assertFailIntChecker(t, "GTE", c, n, makeExpl(">= "+supstr, nstr)) - }) - - t.Run("InRange pass", func(t *testing.T) { - c := check.Int.InRange(inf, sup) - assertPassIntChecker(t, "InRange", c, n) - - c = check.Int.InRange(n, n) - assertPassIntChecker(t, "InRange", c, n) - }) - - t.Run("InRange fail", func(t *testing.T) { - c := check.Int.InRange(sup, sup+1) - assertFailIntChecker(t, "InRange", c, n, makeExpl( - fmt.Sprintf("in range [%v:%v]", sup, sup+1), - nstr, - )) - - c = check.Int.InRange(sup, inf) - assertFailIntChecker(t, "InRange", c, n, makeExpl( - fmt.Sprintf("in range [%v:%v]", sup, inf), - nstr, - )) - }) - - t.Run("OutRange pass", func(t *testing.T) { - c := check.Int.OutRange(sup, sup+1) - assertPassIntChecker(t, "OutRange", c, n) - - c = check.Int.OutRange(sup, inf) - assertPassIntChecker(t, "OutRange", c, n) - }) - - t.Run("OutRange fail", func(t *testing.T) { - c := check.Int.OutRange(inf, sup) - assertFailIntChecker(t, "OutRange", c, n, makeExpl( - fmt.Sprintf("not in range [%v:%v]", inf, sup), - nstr, - )) - - c = check.Int.OutRange(n, n) - assertFailIntChecker(t, "OutRange", c, n, makeExpl( - fmt.Sprintf("not in range [%v:%v]", n, n), - nstr, - )) - }) -} - -// Helpers - -func assertPassIntChecker(t *testing.T, method string, c check.IntChecker, n int) { - t.Helper() - if !c.Pass(n) { - failIntCheckerTest(t, true, method, n, c.Explain) - } -} - -func assertFailIntChecker(t *testing.T, method string, c check.IntChecker, n int, expexpl string) { - t.Helper() - if c.Pass(n) { - failIntCheckerTest(t, false, method, n, c.Explain) - } - assertGoodExplain(t, c, n, expexpl) -} - -func failIntCheckerTest(t *testing.T, expPass bool, method string, n int, explain check.ExplainFunc) { - t.Helper() - failCheckerTest(t, expPass, "Int."+method, explain("Int value", n)) -} diff --git a/check/providers_map_test.go b/check/providers_map_test.go deleted file mode 100644 index a2cf89d..0000000 --- a/check/providers_map_test.go +++ /dev/null @@ -1,142 +0,0 @@ -package check_test - -import ( - "fmt" - "testing" - - "github.com/drykit-go/testx/check" - "github.com/drykit-go/testx/checkconv" -) - -func TestMapCheckerProvider(t *testing.T) { - m := map[string]interface{}{ - "name": "Marcel Patulacci", - "age": 42, - "friends": []string{"Robert Robichet", "Jean-Pierre Avidol"}, - } - - t.Run("Len pass", func(t *testing.T) { - c := check.Map.Len(check.Int.Is(3)) - assertPassMapChecker(t, "Len", c, m) - }) - - t.Run("Len fail", func(t *testing.T) { - c := check.Map.Len(check.Int.Not(3)) - assertFailMapChecker(t, "Len", c, m, makeExpl( - "length to pass IntChecker", - "explanation: length:\n"+makeExpl("not 3", "3"), - )) - }) - - t.Run("HasKeys pass", func(t *testing.T) { - c := check.Map.HasKeys("name", "friends") - assertPassMapChecker(t, "HasKeys", c, m) - }) - - t.Run("HasKeys fail", func(t *testing.T) { - c := check.Map.HasKeys("name", "hello", "bad") - assertFailMapChecker(t, "HasKeys", c, m, makeExpl( - "to have keys [hello, bad]", - fmt.Sprint(m), - )) - }) - - t.Run("HasNotKeys pass", func(t *testing.T) { - c := check.Map.HasNotKeys("hello", 42) - assertPassMapChecker(t, "HasNotKeys", c, m) - }) - - t.Run("HasNotKeys fail", func(t *testing.T) { - c := check.Map.HasNotKeys("name", "hello", "age") - assertFailMapChecker(t, "HasNotKeys", c, m, makeExpl( - "not to have keys [name, age]", - fmt.Sprint(m), - )) - }) - - t.Run("HasValues pass", func(t *testing.T) { - c := check.Map.HasValues(42, []string{"Robert Robichet", "Jean-Pierre Avidol"}) - assertPassMapChecker(t, "HasValues", c, m) - }) - - t.Run("HasValues fail", func(t *testing.T) { - c := check.Map.HasValues(42, "hello", true) - assertFailMapChecker(t, "HasValues", c, m, makeExpl( - "to have values [hello, true]", - fmt.Sprint(m), - )) - }) - - t.Run("HasNotValues pass", func(t *testing.T) { - c := check.Map.HasNotValues("hello", -1) - assertPassMapChecker(t, "HasNotValues", c, m) - }) - - t.Run("HasNotValues fail", func(t *testing.T) { - c := check.Map.HasNotValues(42, "hi", []string{"Robert Robichet", "Jean-Pierre Avidol"}) - assertFailMapChecker(t, "HasNotValues", c, m, makeExpl( - "not to have values [42, [Robert Robichet Jean-Pierre Avidol]]", - fmt.Sprint(m), - )) - }) - - t.Run("CheckValues pass", func(t *testing.T) { - // keys subset - c := check.Map.CheckValues( - checkconv.FromInt(check.Int.InRange(41, 43)), - "age", - ) - assertPassMapChecker(t, "CheckValues", c, m) - - // all keys - c = check.Map.CheckValues(check.Value.Not(0)) - assertPassMapChecker(t, "CheckValues", c, m) - }) - - t.Run("CheckValues fail", func(t *testing.T) { - // keys subset - c := check.Map.CheckValues( - checkconv.FromInt(check.Int.OutRange(41, 43)), - "age", "badkey", - ) - assertFailMapChecker(t, "CheckValues", c, m, makeExpl( - "values for keys [age badkey] to pass ValueChecker", - "explanation: values:\n"+makeExpl( - "not in range [41:43]", - "[age:42, badkey:]", - ), - )) - - // all keys - c = check.Map.CheckValues(check.Value.Is("Marcel Patulacci")) - assertFailMapChecker(t, "CheckValues", c, m, makeExpl( - "values for all keys to pass ValueChecker", - "explanation: values:\n"+makeExpl( - "Marcel Patulacci", - "[age:42, friends:[Robert Robichet Jean-Pierre Avidol]]", - ), - )) - }) -} - -// Helpers - -func assertPassMapChecker(t *testing.T, method string, c check.ValueChecker, gotm interface{}) { - t.Helper() - if !c.Pass(gotm) { - failMapCheckerTest(t, true, method, gotm, c.Explain) - } -} - -func assertFailMapChecker(t *testing.T, method string, c check.ValueChecker, gotm interface{}, expexpl string) { - t.Helper() - if c.Pass(gotm) { - failMapCheckerTest(t, false, method, gotm, c.Explain) - } - assertGoodExplain(t, c, gotm, expexpl) -} - -func failMapCheckerTest(t *testing.T, expPass bool, method string, gotm interface{}, explain check.ExplainFunc) { - t.Helper() - failCheckerTest(t, expPass, "Map."+method, explain("Map value", gotm)) -} diff --git a/check/providers_slice_test.go b/check/providers_slice_test.go deleted file mode 100644 index 37d3e67..0000000 --- a/check/providers_slice_test.go +++ /dev/null @@ -1,106 +0,0 @@ -package check_test - -import ( - "fmt" - "testing" - - "github.com/drykit-go/testx/check" - "github.com/drykit-go/testx/checkconv" -) - -func TestSliceCheckerProvider(t *testing.T) { - s := []interface{}{"hello", 42, "Marcel Patulacci", []float32{3.14}} - - t.Run("Len pass", func(t *testing.T) { - c := check.Slice.Len(check.Int.Is(4)) - assertPassSliceChecker(t, "Len", c, s) - }) - - t.Run("Len fail", func(t *testing.T) { - c := check.Slice.Len(check.Int.Not(4)) - assertFailSliceChecker(t, "Len", c, s, makeExpl( - "length to pass IntChecker", - "explanation: length:\n"+makeExpl("not 4", "4"), - )) - }) - - t.Run("Cap pass", func(t *testing.T) { - c := check.Slice.Cap(check.Int.Is(4)) - assertPassSliceChecker(t, "Cap", c, s) - }) - - t.Run("Cap fail", func(t *testing.T) { - c := check.Slice.Cap(check.Int.Not(4)) - assertFailSliceChecker(t, "Cap", c, s, makeExpl( - "capacity to pass IntChecker", - "explanation: capacity:\n"+makeExpl("not 4", "4"), - )) - }) - - t.Run("HasValues pass", func(t *testing.T) { - c := check.Slice.HasValues("hello", 42, []float32{3.14}) - assertPassSliceChecker(t, "HasValues", c, s) - }) - - t.Run("HasValues fail", func(t *testing.T) { - c := check.Slice.HasValues([]float64{3.14}) - assertFailSliceChecker(t, "HasValues", c, s, makeExpl( - "to have values [[3.14]]", - fmt.Sprint(s), - )) - }) - - t.Run("HasNotValues pass", func(t *testing.T) { - c := check.Slice.HasNotValues("hi", -1, []float64{3.14}) - assertPassSliceChecker(t, "HasNotValues", c, s) - }) - - t.Run("HasNotValues fail", func(t *testing.T) { - c := check.Slice.HasNotValues("hi", -1, []float32{3.14}) - assertFailSliceChecker(t, "HasNotValues", c, s, makeExpl( - "not to have values [[3.14]]", - fmt.Sprint(s), - )) - }) - - t.Run("CheckValues pass", func(t *testing.T) { - c := check.Slice.CheckValues( - checkconv.FromInt(check.Int.InRange(41, 43)), - func(_ int, v interface{}) bool { _, ok := v.(int); return ok }, - ) - assertPassSliceChecker(t, "CheckValues", c, s) - }) - - t.Run("CheckValues fail", func(t *testing.T) { - c := check.Slice.CheckValues( - checkconv.FromInt(check.Int.OutRange(41, 43)), - func(_ int, v interface{}) bool { _, ok := v.(int); return ok }, - ) - assertFailSliceChecker(t, "CheckValues", c, s, makeExpl( - "values to pass ValueChecker", - "explanation: values:\n"+makeExpl("not in range [41:43]", "[1:42]"), - )) - }) -} - -// Helpers - -func assertPassSliceChecker(t *testing.T, method string, c check.ValueChecker, slc interface{}) { - t.Helper() - if !c.Pass(slc) { - failSliceCheckerTest(t, true, method, slc, c.Explain) - } -} - -func assertFailSliceChecker(t *testing.T, method string, c check.ValueChecker, slc interface{}, expexpl string) { - t.Helper() - if c.Pass(slc) { - failSliceCheckerTest(t, false, method, slc, c.Explain) - } - assertGoodExplain(t, c, slc, expexpl) -} - -func failSliceCheckerTest(t *testing.T, expPass bool, method string, slc interface{}, explain check.ExplainFunc) { - t.Helper() - failCheckerTest(t, expPass, "Slice."+method, explain("Slice value", slc)) -} diff --git a/check/providers_string_test.go b/check/providers_string_test.go deleted file mode 100644 index f920826..0000000 --- a/check/providers_string_test.go +++ /dev/null @@ -1,137 +0,0 @@ -package check_test - -import ( - "fmt" - "regexp" - "testing" - - "github.com/drykit-go/testx/check" -) - -func TestStringCheckerProvider(t *testing.T) { - const ( - s = "sator arepo tenet opera rotas" - sub = "tenet" - exp = s + "." - ) - - t.Run("Is pass", func(t *testing.T) { - c := check.String.Is(s) - assertPassStringChecker(t, "Is", c, s) - }) - - t.Run("Is fail", func(t *testing.T) { - c := check.String.Is(exp) - assertFailStringChecker(t, "Is", c, s, makeExpl(exp, s)) - }) - - t.Run("Not pass", func(t *testing.T) { - c := check.String.Not("hello", sub, exp) - assertPassStringChecker(t, "Not", c, s) - }) - - t.Run("Not fail", func(t *testing.T) { - c := check.String.Not("hello", sub, s, exp) - assertFailStringChecker(t, "Not", c, s, makeExpl("not "+s, s)) - }) - - t.Run("Len pass", func(t *testing.T) { - c := check.String.Len(check.Int.Is(len(s))) - assertPassStringChecker(t, "Len", c, s) - }) - - t.Run("Len fail", func(t *testing.T) { - gotlen := len(s) - explen := gotlen + 1 - c := check.String.Len(check.Int.Is(explen)) - assertFailStringChecker(t, "Len", c, s, makeExpl( - "length to pass IntChecker", - "explanation: length:\n"+makeExpl( - fmt.Sprint(explen), - fmt.Sprint(gotlen), - ), - )) - }) - - t.Run("Match pass", func(t *testing.T) { - c := check.String.Match(regexp.MustCompile(`(?i)\sTENET\s`)) - assertPassStringChecker(t, "Match", c, s) - }) - - t.Run("Match fail", func(t *testing.T) { - r := regexp.MustCompile(`\sTENET\s`) - c := check.String.Match(r) - assertFailStringChecker(t, "Match", c, s, - makeExpl("to match regexp "+r.String(), s), - ) - }) - - t.Run("NotMatch pass", func(t *testing.T) { - c := check.String.NotMatch(regexp.MustCompile(`\sTENET\s`)) - assertPassStringChecker(t, "NotMatch", c, s) - }) - - t.Run("NotMatch fail", func(t *testing.T) { - r := regexp.MustCompile(`(?i)\sTENET\s`) - c := check.String.NotMatch(r) - assertFailStringChecker(t, "NotMatch", c, s, makeExpl( - "not to match regexp "+r.String(), - s, - )) - }) - - t.Run("Contains pass", func(t *testing.T) { - c := check.String.Contains(sub) - assertPassStringChecker(t, "Contains", c, s) - c = check.String.Contains(s) - assertPassStringChecker(t, "Contains", c, s) - }) - - t.Run("Contains fail", func(t *testing.T) { - c := check.String.Contains(exp) - assertFailStringChecker(t, "Contains", c, s, makeExpl( - "to contain substring "+exp, - s, - )) - }) - - t.Run("NotContains pass", func(t *testing.T) { - c := check.String.NotContains(exp) - assertPassStringChecker(t, "NotContains", c, s) - }) - - t.Run("NotContains fail", func(t *testing.T) { - c := check.String.NotContains(sub) - assertFailStringChecker(t, "NotContains", c, s, makeExpl( - "not to contain substring "+sub, - s, - )) - c = check.String.NotContains(s) - assertFailStringChecker(t, "NotContains", c, s, makeExpl( - "not to contain substring "+s, - s, - )) - }) -} - -// Helpers - -func assertPassStringChecker(t *testing.T, method string, c check.StringChecker, in string) { - t.Helper() - if !c.Pass(in) { - failStringCheckerTest(t, true, method, in, c.Explain) - } -} - -func assertFailStringChecker(t *testing.T, method string, c check.StringChecker, in, expexpl string) { - t.Helper() - if c.Pass(in) { - failStringCheckerTest(t, false, method, in, c.Explain) - } - assertGoodExplain(t, c, in, expexpl) -} - -func failStringCheckerTest(t *testing.T, expPass bool, method, in string, explain check.ExplainFunc) { - t.Helper() - failCheckerTest(t, expPass, "String."+method, explain("String value", in)) -} diff --git a/check/providers_struct_test.go b/check/providers_struct_test.go deleted file mode 100644 index e575f79..0000000 --- a/check/providers_struct_test.go +++ /dev/null @@ -1,75 +0,0 @@ -package check_test - -import ( - "fmt" - "testing" - - "github.com/drykit-go/testx/check" - "github.com/drykit-go/testx/checkconv" -) - -type structTest struct { - A, B, X, Y int -} - -func TestStructCheckerProvider(t *testing.T) { - const ( - vAB = 10 - vXY = 20 - ) - s := structTest{A: vAB, B: vAB, X: vXY, Y: vXY} - - t.Run("FieldsEqual pass", func(t *testing.T) { - c := check.Struct.FieldsEqual(vAB, []string{"A", "B"}) - assertPassStructChecker(t, "FieldsEqual", c, s) - }) - - t.Run("FieldsEqual fail", func(t *testing.T) { - c := check.Struct.FieldsEqual(vAB, []string{"A", "B", "X", "Y"}) - assertFailStructChecker(t, "FieldsEqual", c, s, makeExpl( - fmt.Sprintf("fields [.A, .B, .X, .Y] to equal %v", vAB), - fmt.Sprintf(".X=%v, .Y=%v", vXY, vXY), - )) - }) - - t.Run("CheckFields pass", func(t *testing.T) { - c := check.Struct.CheckFields( - checkconv.FromInt(check.Int.LT(vAB+1)), - []string{"A", "B"}, - ) - assertPassStructChecker(t, "CheckFields", c, s) - }) - - t.Run("CheckFields fail", func(t *testing.T) { - c := check.Struct.CheckFields( - checkconv.FromInt(check.Int.LT(vAB+1)), - []string{"A", "B", "X", "Y"}, - ) - assertFailStructChecker(t, "CheckFields", c, s, makeExpl( - "fields [.A, .B, .X, .Y] to pass ValueChecker", - "explanation: fields:\n"+makeExpl("< 11", ".X=20, .Y=20"), - )) - }) -} - -// Helpers - -func assertPassStructChecker(t *testing.T, method string, c check.ValueChecker, s structTest) { - t.Helper() - if !c.Pass(s) { - failStructCheckerTest(t, true, method, s, c.Explain) - } -} - -func assertFailStructChecker(t *testing.T, method string, c check.ValueChecker, s structTest, expexpl string) { - t.Helper() - if c.Pass(s) { - failStructCheckerTest(t, false, method, s, c.Explain) - } - assertGoodExplain(t, c, s, expexpl) -} - -func failStructCheckerTest(t *testing.T, expPass bool, method string, s structTest, explain check.ExplainFunc) { - t.Helper() - failCheckerTest(t, expPass, "Struct."+method, explain("struct value", s)) -} diff --git a/check/providers_test.go b/check/providers_test.go deleted file mode 100644 index a64a3cc..0000000 --- a/check/providers_test.go +++ /dev/null @@ -1,35 +0,0 @@ -package check_test - -import ( - "fmt" - "testing" - - "github.com/drykit-go/testx/check" -) - -func failCheckerTest(t *testing.T, expPass bool, name, expl string) { - t.Helper() - passOrFail := "PASS" - if !expPass { - passOrFail = "FAIL" - } - t.Errorf("\n❌ exp %s to %s, explain:\n%s", name, passOrFail, expl) -} - -func makeExpl(expstr, gotstr string) string { - return fmt.Sprintf("exp %s\ngot %s", expstr, gotstr) -} - -func assertGoodExplain( - t *testing.T, - c check.Explainer, - gotval interface{}, - expexpl string, -) { - t.Helper() - gotexpl := c.Explain("label", gotval) - expexpl = "label:\n" + expexpl - if gotexpl != expexpl { - t.Errorf("bad Explain output:\nexp \"%s\"\ngot \"%s\"", expexpl, gotexpl) - } -} diff --git a/check/providers_value.go b/check/providers_value.go deleted file mode 100644 index 413ccad..0000000 --- a/check/providers_value.go +++ /dev/null @@ -1,83 +0,0 @@ -package check - -import ( - "fmt" - - "github.com/drykit-go/testx/internal/reflectutil" -) - -// valueCheckerProvider provides checks on type interface{}. -type valueCheckerProvider struct{ baseCheckerProvider } - -// Custom checks the gotten value passes the given ValuePassFunc. -// The description should give information about the expected value, -// as it outputs in format "exp " in case of failure. -func (p valueCheckerProvider) Custom(desc string, f ValuePassFunc) ValueChecker { - expl := func(label string, got interface{}) string { - return p.explain(label, desc, got) - } - return NewValueChecker(f, expl) -} - -// Is checks the gotten value is equal to the target. -func (p valueCheckerProvider) Is(tar interface{}) ValueChecker { - pass := func(got interface{}) bool { return p.deq(got, tar) } - expl := func(label string, got interface{}) string { - return p.explain(label, tar, got) - } - return NewValueChecker(pass, expl) -} - -// Not checks the gotten value is not equal to the target. -func (p valueCheckerProvider) Not(values ...interface{}) ValueChecker { - var match interface{} - pass := func(got interface{}) bool { - for _, v := range values { - if p.deq(got, v) { - match = v - return false - } - } - return true - } - expl := func(label string, got interface{}) string { - return p.explainNot(label, match, got) - } - return NewValueChecker(pass, expl) -} - -// IsZero checks the gotten value is a zero value, indicating it might not -// have been initialized. -func (p valueCheckerProvider) IsZero() ValueChecker { - expl := func(label string, got interface{}) string { - return p.explain(label, "to be a zero value", got) - } - return NewValueChecker(reflectutil.IsZero, expl) -} - -// NotZero checks the gotten struct contains at least 1 non-zero value, -// meaning it has been initialized. -func (p valueCheckerProvider) NotZero() ValueChecker { - pass := func(got interface{}) bool { return !reflectutil.IsZero(got) } - expl := func(label string, got interface{}) string { - return p.explainNot(label, "to be a zero value", got) - } - return NewValueChecker(pass, expl) -} - -// SameJSON checks the gotten value and the target value -// produce the same JSON, ignoring formatting and keys order. -// It panics if any error occurs in the marshaling process. -func (p valueCheckerProvider) SameJSON(tar interface{}) ValueChecker { - var gotDec, tarDec interface{} - pass := func(got interface{}) bool { - return p.sameJSONProduced(got, tar, &gotDec, &tarDec) - } - expl := func(label string, got interface{}) string { - return p.explain(label, - fmt.Sprintf("json data: %v", tarDec), - fmt.Sprintf("json data: %v", gotDec), - ) - } - return NewValueChecker(pass, expl) -} diff --git a/check/providers_value_test.go b/check/providers_value_test.go deleted file mode 100644 index d8e2755..0000000 --- a/check/providers_value_test.go +++ /dev/null @@ -1,138 +0,0 @@ -package check_test - -import ( - "fmt" - "testing" - - "github.com/drykit-go/testx/check" -) - -func TestValueCheckerProvider(t *testing.T) { - type Thing struct { - Name string - } - - var ( - vorig = Thing{"hi"} - vsame = Thing{"hi"} - vzero = Thing{} - badval = Thing{"hello"} - badtyp = struct{ Name string }{"hi"} - - emptyMap map[int]bool - emptySlice []float32 - - zeros = []interface{}{0, "", 0i + 0, vzero, emptyMap, emptySlice} - nozeros = []interface{}{1, "hi", 0i + 1, vorig, map[int]bool{}, []float32{}} - ) - - t.Run("Is pass", func(t *testing.T) { - c := check.Value.Is(vsame) - assertPassValueChecker(t, "Is", c, vorig) - }) - - t.Run("Is fail", func(t *testing.T) { - c := check.Value.Is(badval) - assertFailValueChecker(t, "Is", c, vorig, makeExpl("{hello}", "{hi}")) - }) - - t.Run("Not pass", func(t *testing.T) { - c := check.Value.Not(badval, badtyp) - assertPassValueChecker(t, "Not", c, vorig) - }) - - t.Run("Not fail", func(t *testing.T) { - c := check.Value.Not(badval, vsame, badtyp) - assertFailValueChecker(t, "Not", c, vorig, makeExpl("not {hi}", "{hi}")) - }) - - t.Run("IsZero pass", func(t *testing.T) { - c := check.Value.IsZero() - for _, z := range zeros { - assertPassValueChecker(t, "IsZero", c, z) - } - }) - - t.Run("IsZero fail", func(t *testing.T) { - c := check.Value.IsZero() - for _, nz := range nozeros { - assertFailValueChecker(t, "IsZero", c, nz, makeExpl( - "to be a zero value", - fmt.Sprint(nz), - )) - } - }) - - t.Run("NotZero pass", func(t *testing.T) { - c := check.Value.NotZero() - for _, nz := range nozeros { - assertPassValueChecker(t, "NotZero", c, nz) - } - }) - - t.Run("NotZero fail", func(t *testing.T) { - c := check.Value.NotZero() - for _, z := range zeros { - assertFailValueChecker(t, "NotZero", c, z, makeExpl( - "not to be a zero value", - fmt.Sprint(z), - )) - } - }) - - isEvenInt := func(n interface{}) bool { - nint, ok := n.(int) - return ok && nint&1 == 0 - } - - t.Run("Custom pass", func(t *testing.T) { - c := check.Value.Custom("", isEvenInt) - assertPassValueChecker(t, "Custom", c, 42) - }) - - t.Run("Custom fail", func(t *testing.T) { - c := check.Value.Custom("even int", isEvenInt) - assertFailValueChecker(t, "Custom", c, -1, makeExpl("even int", "-1")) - }) - - t.Run("SameJSON pass", func(t *testing.T) { - mapequiv := map[string]interface{}{ - "Name": "hi", - } - c := check.Value.SameJSON(mapequiv) - assertPassValueChecker(t, "SameJSON", c, vorig) - }) - - t.Run("SameJSON fail", func(t *testing.T) { - mapdiff := map[string]interface{}{ - "Name": "bad", - } - c := check.Value.SameJSON(mapdiff) - assertFailValueChecker(t, "SameJSON", c, vorig, makeExpl( - "json data: map[Name:bad]", - "json data: map[Name:hi]", - )) - }) -} - -// Helpers - -func assertPassValueChecker(t *testing.T, method string, c check.ValueChecker, v interface{}) { - t.Helper() - if !c.Pass(v) { - failValueCheckerTest(t, true, method, v, c.Explain) - } -} - -func assertFailValueChecker(t *testing.T, method string, c check.ValueChecker, v interface{}, expexpl string) { - t.Helper() - if c.Pass(v) { - failValueCheckerTest(t, false, method, v, c.Explain) - } - assertGoodExplain(t, c, v, expexpl) -} - -func failValueCheckerTest(t *testing.T, expPass bool, method string, v interface{}, explain check.ExplainFunc) { - t.Helper() - failCheckerTest(t, expPass, "Value."+method, explain("Value value", v)) -} diff --git a/check/wrap.go b/check/wrap.go new file mode 100644 index 0000000..613725e --- /dev/null +++ b/check/wrap.go @@ -0,0 +1,18 @@ +package check + +// Wrap returns a Checker[any] that wraps the given checker. +func Wrap[T any](checker Checker[T]) Checker[any] { + return NewChecker( + func(got interface{}) bool { return checker.Pass(got.(T)) }, + checker.Explain, + ) +} + +// Wrap returns a slice of Checker[any] that wrap the given checkers. +func WrapMany[T any](checkers ...Checker[T]) []Checker[any] { + anyCheckers := make([]Checker[any], len(checkers)) + for i, c := range checkers { + anyCheckers[i] = Wrap(c) + } + return anyCheckers +} diff --git a/check/wrap_test.go b/check/wrap_test.go new file mode 100644 index 0000000..769c499 --- /dev/null +++ b/check/wrap_test.go @@ -0,0 +1,168 @@ +package check_test + +import ( + "testing" + + "github.com/drykit-go/slicex" + + "github.com/drykit-go/testx/check" +) + +type checkerTestcase[T any] struct { + checker check.Checker[T] + in T + exppass bool + expexpl string +} + +func TestWrap(t *testing.T) { + t.Run("native checkers", func(t *testing.T) { + testcases := []checkerTestcase[any]{ + { + checker: check.Wrap[[]byte](check.Bytes.Is([]byte{42})), + in: []byte{42}, + exppass: true, + expexpl: "", + }, + { + checker: check.Wrap[int](check.Int.InRange(41, 43)), + in: -1, + exppass: false, + expexpl: "value:\nexp in range [41:43]\ngot -1", + }, + { + checker: check.Value[any]().Custom("", func(got any) bool { return true }), + in: "", + exppass: true, + expexpl: "", + }, + } + + for _, tc := range testcases { + assertValidAnyChecker(t, tc) + } + }) + + t.Run("new checkers", func(t *testing.T) { + testcases := []checkerTestcase[any]{ + { + checker: check.Wrap(newComplex128Checker(true, "")), + in: 1i + 1, + exppass: true, + expexpl: "", + }, + { + checker: check.Wrap(newComplex128Checker(false, "bad")), + in: 1i + 1, + exppass: false, + expexpl: "bad", + }, + } + + for _, tc := range testcases { + assertValidAnyChecker(t, tc) + } + }) + + t.Run("custom checkers", func(t *testing.T) { + testcases := []checkerTestcase[any]{ + { + checker: check.Wrap(customComplex128Checker(true, "")), + in: 1i + 1, + exppass: true, + expexpl: "", + }, + { + checker: check.Wrap(customComplex128Checker(false, "bad")), + in: 1i + 1, + exppass: false, + expexpl: "bad", + }, + } + + for _, tc := range testcases { + assertValidAnyChecker(t, tc) + } + }) +} + +func TestWrapMany(t *testing.T) { + testcases := []checkerTestcase[complex128]{ + { + checker: newComplex128Checker(true, ""), + in: 1i + 1, + exppass: true, + expexpl: "", + }, + { + checker: newComplex128Checker(false, "bad"), + in: 1i + 1, + exppass: false, + expexpl: "bad", + }, + { + checker: customComplex128Checker(true, ""), + in: 1i + 1, + exppass: true, + expexpl: "", + }, + { + checker: customComplex128Checker(false, "bad"), + in: 1i + 1, + exppass: false, + expexpl: "bad", + }, + } + wrappedCheckers := check.WrapMany(slicex.Map(testcases, + func(v checkerTestcase[complex128]) check.Checker[complex128] { + return v.checker + }, + )...) + + for i, tc := range testcases { + assertValidAnyChecker(t, checkerTestcase[any]{ + checker: wrappedCheckers[i], + in: tc.in, + exppass: tc.exppass, + expexpl: tc.expexpl, + }) + } +} + +func assertValidAnyChecker(t *testing.T, tc checkerTestcase[any]) { + t.Helper() + c := tc.checker + if pass := c.Pass(tc.in); pass != tc.exppass { + t.Errorf( + "unexpected Pass return value with checker %v: exp %v, got %v", + tc.checker, tc.exppass, pass, + ) + } + if expl := c.Explain("value", tc.in); tc.expexpl != "" && expl != tc.expexpl { + t.Errorf( + "unexpected Explain return value with checker %#v:\nexp:\n%v\n\ngot:\n%v", + tc.checker, tc.expexpl, expl, + ) + } +} + +// Helpers + +type customComplex128CheckerImpl struct { + exppass bool + expexpl string +} + +func (c customComplex128CheckerImpl) Pass(complex128) bool { return c.exppass } +func (c customComplex128CheckerImpl) Explain(string, interface{}) string { return c.expexpl } + +func newComplex128Checker(exppass bool, expexpl string) check.Checker[complex128] { + return check.NewChecker( + func(complex128) bool { return exppass }, + func(string, interface{}) string { return expexpl }, + ) +} + +func customComplex128Checker(exppass bool, expexpl string) check.Checker[complex128] { + return customComplex128CheckerImpl{exppass: exppass, expexpl: expexpl} +} diff --git a/checkconv/README.md b/checkconv/README.md deleted file mode 100644 index ec41a85..0000000 --- a/checkconv/README.md +++ /dev/null @@ -1,198 +0,0 @@ -

testx/checkconv

- - - - - - -
testxtestx/checktestx/checkconv
- -Package `checkconv` provides conversion utilities to convert any typed checker to a `check.ValueChecker` - -## Table of contents - -- [Why convert checkers](#why-convert-checkers) -- [Available functions](#from-functions) - - [`From` functions](#from-functions) - - [`Assert` functions](#assert-functions) - - [`Cast` functions](#cast-functions) -- [`Assert` vs `Cast`](#assert-vs-cast) - - [Should I use `Assert` or `Cast`](#should-i-use-assert-or-cast) - -## Why convert checkers - -Some runners from `testx` have methods that require generic checkers as parameters, -such as `testx.ValueRunner.Pass`: - -```go -type ValueRunner interface { - // Pass adds checkers on the tested value. - Pass(checkers ...check.ValueChecker) ValueRunner - // ... -} -``` - -These methods theorically accept any checker, either from package `check` -or locally implemented with custom types. - -However, without a language support for generic types, -package `check` cannot provide a generic checker interface because -they have distinct signatures for method `Pass(got T) bool`. - -```go -// What we need: -type GenericChecker[T any] interface { - Pass(got T) bool - Explainer -} - -// What we have: -type IntChecker interface { - Pass(got int) bool - Explainer -} -type StringChecker interface { - Pass(got string) bool - Explainer -} -``` - -As a consequence, there is no way to combine `IntChecker` and `StringChecker` -into a generic `Checker` interface. -For that reason, we use `check.ValueChecker` checker (checker on type `interface{}`), -because it can wrap any checker type. - -That's what this package provides: functions to wrap any typed checker -into a generic `check.ValueChecker`. - -## Available functions - -### `From` functions - -`From` functions return a generic `check.ValueChecker` that wraps -the input `check.Checker`. - -It is typically used for runners that expect a `check.ValueRunner` -when one wants to use a typed checker: - -```go -testx. - Value(42). - // Pass expects a check.ValueChecker - Pass( - // We use check.IntChecker then we convert it using checkconv.FromInt. - checkconv.FromInt(check.Int.InRange(41, 43)), - ). - Run(t) -) -``` - -### Assert functions - -- `Assert(checker interface{}) check.ValueChecker` -- `AssertMany(checkers ...interface{}) []check.ValueChecker` - -Assert functions basically return `From(inputChecker)` -if that `From` function exists for the input checker. -Else, it panics. - -```go -testx. - Value(42). - // Pass expects a check.ValueChecker - Pass( - // We use check.IntChecker then we convert it using checkconv.Assert. - checkconv.Assert(check.Int.InRange(41, 43)), - ). - Run(t) -) -``` - -Alternatively, `AssertMany` can be used to convert several checkers at once: - -```go -testx. - Value(42). - // Pass expects a check.ValueChecker - Pass( - // We use several check.IntChecker then we convert them - // using checkconv.AssertMany. - checkconv.AssertMany( - check.Int.InRange(41, 43), - check.Int.Not(-1), - check.Int.GTE(99), - )..., - ). - Run(t) -) -``` - -### Cast functions - -- `Cast(checker interface{}) (check.ValueChecker, bool)` -- `CastMany(checkers ...interface{}) []check.ValueChecker` - -Cast functions serve the same purpose as Assert functions: -they wrap the given checker in a `check.ValueChecker`. -The difference is that it works with _any_ type that implement -a checker interface (`Pass(T) bool` and `Explain(string, interface{} string`) -while Assert functions are restricted to the types defined in package `check`. - -### `Assert` vs `Cast` - -There is a fundamental difference between `Assert` and `Cast` implementations: - -- `Assert` uses `From` functions that rely on type assertion - to wrap the input checker: - ```go - func Assert(knownChecker interface{}) check.ValueChecker { - switch c := knownChecker.(type) { - case check.StringChecker: - return FromString(c) - // ... - default: - // Assert panics if the input checker is not defined in package check. - log.Panic("assert from unknown checker type") - return nil - } - } - - func FromString(c check.StringChecker) check.ValueChecker { - return check.NewValueChecker( - func(got interface{}) bool { return c.Pass(got.(string)) }, - c.Explain, // ^^^^^^^^^^^^^^^^^^^ got is safely asserted - ) - } - ``` - This is faster, but requires the input checker to implement one of the native - `check.Checker` interfaces. - -- `Cast` uses **reflection** to determinate whether a checker is valid and call -its methods in the resulting checker. As a consequence it is slower than -`Assert`, however it remains the only way to wrap a `check.ValueChecker` -around a full-fledged custom checker that performs checks on types that are not -defined in package `check`. - -#### Should I use `Assert` or `Cast` - -- Use `Assert`/`From` to convert any checker from package `check`, - or custom checkers that implement any `check.Checker` interface - (see [provided checkers](../check/README.md#provided-checkers)). - - ```go - checkconv.AssertMany( - check.Int.Range(41, 43), // satisfies check.IntChecker - check.NewIntChecker(isEven, explainIsEven), // satisfies check.IntChecker - myCustomIntChecker, // satisfies check.IntChecker - ) - ``` - -- Use `Cast` to convert any checker on types that are not defined - in package `check`. - - ```go - checkconv.CastMany( - myCustomComplex128Checker, - myCustomUserChecker, - ) - ``` \ No newline at end of file diff --git a/checkconv/assert.go b/checkconv/assert.go deleted file mode 100644 index eac6408..0000000 --- a/checkconv/assert.go +++ /dev/null @@ -1,154 +0,0 @@ -// Code generated by go generate ./...; DO NOT EDIT -// Last generated on 30 Oct 21 12:10 UTC - -// Package checkconv provides functions to convert typed checkers -// into generic ones. -package checkconv - -import ( - "context" - "net/http" - "time" - - "github.com/drykit-go/testx/check" -) - -// FromBool returns a check.ValueChecker that wraps the given -// check.BoolChecker, so it can be used as a generic checker. -func FromBool(c check.BoolChecker) check.ValueChecker { - return check.NewValueChecker( - func(got interface{}) bool { return c.Pass(got.(bool)) }, - c.Explain, - ) -} - -// FromBytes returns a check.ValueChecker that wraps the given -// check.BytesChecker, so it can be used as a generic checker. -func FromBytes(c check.BytesChecker) check.ValueChecker { - return check.NewValueChecker( - func(got interface{}) bool { return c.Pass(got.([]byte)) }, - c.Explain, - ) -} - -// FromString returns a check.ValueChecker that wraps the given -// check.StringChecker, so it can be used as a generic checker. -func FromString(c check.StringChecker) check.ValueChecker { - return check.NewValueChecker( - func(got interface{}) bool { return c.Pass(got.(string)) }, - c.Explain, - ) -} - -// FromInt returns a check.ValueChecker that wraps the given -// check.IntChecker, so it can be used as a generic checker. -func FromInt(c check.IntChecker) check.ValueChecker { - return check.NewValueChecker( - func(got interface{}) bool { return c.Pass(got.(int)) }, - c.Explain, - ) -} - -// FromFloat64 returns a check.ValueChecker that wraps the given -// check.Float64Checker, so it can be used as a generic checker. -func FromFloat64(c check.Float64Checker) check.ValueChecker { - return check.NewValueChecker( - func(got interface{}) bool { return c.Pass(got.(float64)) }, - c.Explain, - ) -} - -// FromDuration returns a check.ValueChecker that wraps the given -// check.DurationChecker, so it can be used as a generic checker. -func FromDuration(c check.DurationChecker) check.ValueChecker { - return check.NewValueChecker( - func(got interface{}) bool { return c.Pass(got.(time.Duration)) }, - c.Explain, - ) -} - -// FromContext returns a check.ValueChecker that wraps the given -// check.ContextChecker, so it can be used as a generic checker. -func FromContext(c check.ContextChecker) check.ValueChecker { - return check.NewValueChecker( - func(got interface{}) bool { return c.Pass(got.(context.Context)) }, - c.Explain, - ) -} - -// FromHTTPHeader returns a check.ValueChecker that wraps the given -// check.HTTPHeaderChecker, so it can be used as a generic checker. -func FromHTTPHeader(c check.HTTPHeaderChecker) check.ValueChecker { - return check.NewValueChecker( - func(got interface{}) bool { return c.Pass(got.(http.Header)) }, - c.Explain, - ) -} - -// FromHTTPRequest returns a check.ValueChecker that wraps the given -// check.HTTPRequestChecker, so it can be used as a generic checker. -func FromHTTPRequest(c check.HTTPRequestChecker) check.ValueChecker { - return check.NewValueChecker( - func(got interface{}) bool { return c.Pass(got.(*http.Request)) }, - c.Explain, - ) -} - -// FromHTTPResponse returns a check.ValueChecker that wraps the given -// check.HTTPResponseChecker, so it can be used as a generic checker. -func FromHTTPResponse(c check.HTTPResponseChecker) check.ValueChecker { - return check.NewValueChecker( - func(got interface{}) bool { return c.Pass(got.(*http.Response)) }, - c.Explain, - ) -} - -// Assert returns a check.ValueChecker that wraps the given -// check.Checker (such as check.IntChecker). -// -// It panics if checker is not a known checker type. For instance, -// a custom checker that implements check.IntChecker will be successfully -// converted, while a valid implementation of an unknown interface, -// such as Complex128Checker, will panic. -// For that matter, Cast should be used instead. -func Assert(knownChecker interface{}) check.ValueChecker { - switch c := knownChecker.(type) { - case check.BoolChecker: - return FromBool(c) - case check.BytesChecker: - return FromBytes(c) - case check.StringChecker: - return FromString(c) - case check.IntChecker: - return FromInt(c) - case check.Float64Checker: - return FromFloat64(c) - case check.DurationChecker: - return FromDuration(c) - case check.ContextChecker: - return FromContext(c) - case check.HTTPHeaderChecker: - return FromHTTPHeader(c) - case check.HTTPRequestChecker: - return FromHTTPRequest(c) - case check.HTTPResponseChecker: - return FromHTTPResponse(c) - case check.ValueChecker: - return c - default: - panic("assert from unknown checker type") - } -} - -// AssertMany returns a slice of check.ValueChecker that wrap the given -// check.Checkers (such as check.IntChecker). -// -// It panics if any checker is not a known checker type. See Assert -// for further documentation. -func AssertMany(knownCheckers ...interface{}) []check.ValueChecker { - valueCheckers := []check.ValueChecker{} - for _, c := range knownCheckers { - valueCheckers = append(valueCheckers, Assert(c)) - } - return valueCheckers -} diff --git a/checkconv/assert_test.go b/checkconv/assert_test.go deleted file mode 100644 index 1703744..0000000 --- a/checkconv/assert_test.go +++ /dev/null @@ -1,130 +0,0 @@ -package checkconv_test - -import ( - "context" - "net/http" - "testing" - "time" - - "github.com/drykit-go/testx/check" - "github.com/drykit-go/testx/checkconv" - "github.com/drykit-go/testx/internal/testutil" -) - -func TestAssert(t *testing.T) { - t.Run("known checker type", func(t *testing.T) { - cases := []checkerTestcase{ - { - checker: check.String.Contains("a"), - in: "aaa", - expPass: true, - expExpl: "", - }, - { - checker: check.NewIntChecker(isEven, isEvenExpl), - in: -1, - expPass: false, - expExpl: "expect value to be even, got -1", - }, - { - checker: validCheckerInt{}, - in: 0, - expPass: true, - expExpl: "ok", - }, - } - - for _, tc := range cases { - c := checkconv.Assert(tc.checker) - assertValidValueChecker(t, c, tc) - } - }) - - t.Run("unknown checker type", func(t *testing.T) { - defer testutil.AssertPanicMessage(t, "assert from unknown checker type") - checkconv.Assert(validCheckerFloat32{}) - }) - - t.Run("invalid checkers", func(t *testing.T) { - for _, badChecker := range badCheckers { - func() { - defer testutil.AssertPanicMessage(t, "assert from unknown checker type") - checkconv.Assert(badChecker) - }() - } - }) -} - -func TestAssertMany(t *testing.T) { - t.Run("all provided checkers", func(t *testing.T) { - testcases := []struct { - checker interface{} - in interface{} - }{ - {checker: check.Bool.Is(true), in: true}, - {checker: check.Bytes.Is([]byte{'a'}), in: []byte{'a'}}, - {checker: check.String.Is("a"), in: "a"}, - {checker: check.Int.Is(1), in: 1}, - {checker: check.Float64.Is(1), in: 1.}, - {checker: check.Duration.Over(time.Millisecond), in: time.Second}, - {checker: check.Context.Done(true), in: ctxDone()}, - {checker: check.HTTPHeader.HasKey("a"), in: http.Header{"a": []string{"b"}}}, - {checker: check.HTTPRequest.ContentLength(check.Int.GT(1)), in: &http.Request{ContentLength: 2}}, - {checker: check.HTTPResponse.StatusCode(check.Int.GT(1)), in: &http.Response{StatusCode: 2}}, - {checker: check.Value.Is(1), in: 1}, - {checker: check.Map.HasKeys("a"), in: map[string]int{"a": 1}}, - {checker: check.Slice.HasValues("a"), in: []string{"a"}}, - {checker: check.Struct.NotZero(), in: struct{ n int }{1}}, - } - - providedCheckers := func() (checkers []interface{}) { - for _, tc := range testcases { - checkers = append(checkers, tc.checker) - } - return - }() - - res := checkconv.AssertMany(providedCheckers...) - - if gotLen, expLen := len(res), len(providedCheckers); gotLen != expLen { - t.Errorf( - "failed to assert provided checkers: exp len %d, got %d", - expLen, gotLen, - ) - } - - for i, tc := range testcases { - if !res[i].Pass(tc.in) { - t.Errorf( - "failed to assert provided checkers: exp test case %d to pass", - i, - ) - } - } - }) - - t.Run("custom checkers known type", func(t *testing.T) { - knownCheckers := []interface{}{ - check.Value.Custom("", func(_ interface{}) bool { return true }), - check.NewIntChecker(isEven, validExplainFunc), - validCheckerInt{}, - validCheckerInterface{}, - } - res := checkconv.AssertMany(knownCheckers...) - if len(res) != len(knownCheckers) { - t.Error("failed to assert many known checkers") - } - }) - - t.Run("custom checkers unknown type", func(t *testing.T) { - defer testutil.AssertPanicMessage(t, "assert from unknown checker type") - unknownCheckers := []interface{}{validCheckerFloat32{}} - checkconv.AssertMany(unknownCheckers...) - }) -} - -func ctxDone() context.Context { - ctx, cancel := context.WithCancel(context.Background()) - cancel() - return ctx -} diff --git a/checkconv/benchmark_test.go b/checkconv/benchmark_test.go deleted file mode 100644 index c5d3744..0000000 --- a/checkconv/benchmark_test.go +++ /dev/null @@ -1,58 +0,0 @@ -package checkconv_test - -import ( - "testing" - "time" - - "github.com/drykit-go/testx/check" - "github.com/drykit-go/testx/checkconv" -) - -func BenchmarkAll(b *testing.B) { - b.Run("IsChecker", BenchmarkIsChecker) - b.Run("Cast", BenchmarkCast) - b.Run("Assert", BenchmarkAssert) - b.Run("From", BenchmarkFrom) -} - -func BenchmarkIsChecker(b *testing.B) { - c := validCheckerInt{} - for i := 0; i < b.N; i++ { - checkconv.IsChecker(c) - } -} - -func BenchmarkAssert(b *testing.B) { - b.Run("check.BoolChecker first_case", func(b *testing.B) { - c := check.Bool.Is(true) - for i := 0; i < b.N; i++ { - checkconv.Assert(c) - } - }) - b.Run("check.DurationChecker midway_case", func(b *testing.B) { - c := check.Duration.Over(time.Second) - for i := 0; i < b.N; i++ { - checkconv.Assert(c) - } - }) - b.Run("check.HTTPResponseChecker last_case", func(b *testing.B) { - c := check.HTTPResponse.Body(check.Bytes.Is([]byte{0})) - for i := 0; i < b.N; i++ { - checkconv.Assert(c) - } - }) -} - -func BenchmarkCast(b *testing.B) { - c := validCheckerInt{} - for i := 0; i < b.N; i++ { - checkconv.Cast(c) - } -} - -func BenchmarkFrom(b *testing.B) { - c := validCheckerInt{} - for i := 0; i < b.N; i++ { - checkconv.FromInt(c) - } -} diff --git a/checkconv/cast.go b/checkconv/cast.go deleted file mode 100644 index b6baa12..0000000 --- a/checkconv/cast.go +++ /dev/null @@ -1,61 +0,0 @@ -package checkconv - -import ( - "reflect" - - "github.com/drykit-go/testx/check" -) - -// Cast returns a check.ValueChecker built upon the given checker -// and a bool indicating whether it was successful. -// -// Contrary to Assert, it can perform conversions from checker types -// unknown by package check. That means it can work with any custom -// implementation provided it is valid (see IsChecker for details). -// -// However, Assert should be the first choice for a known checker type -// as Cast is about 10 times slower. -func Cast(anyChecker interface{}) (c check.ValueChecker, ok bool) { - if !IsChecker(anyChecker) { - return - } - - v := reflect.ValueOf(anyChecker) - c = check.NewValueChecker( - func(got interface{}) bool { - gotv := reflect.ValueOf(got) - return v.MethodByName(signaturePass.Name). - Call([]reflect.Value{gotv})[0]. - Bool() - }, - func(label string, got interface{}) string { - labv := reflect.ValueOf(label) - gotv := reflect.ValueOf(got) - return v.MethodByName(signatureExpl.Name). - Call([]reflect.Value{labv, gotv})[0]. - String() - }, - ) - ok = true - return -} - -// CastMany converts the given checkers as described by Cast, -// and returns them as a slice of check.ValueChecker and a bool -// indicating whether all conversions were successful. -// -// An invalid checker in the args list is silently dismissed, -// this the resulting checkers length can be inferior to the number of args -// if ok === false. -func CastMany(anyCheckers ...interface{}) (checkers []check.ValueChecker, ok bool) { - ok = true - for _, in := range anyCheckers { - c, valid := Cast(in) - if valid { - checkers = append(checkers, c) - } else { - ok = false - } - } - return -} diff --git a/checkconv/cast_test.go b/checkconv/cast_test.go deleted file mode 100644 index 07d4125..0000000 --- a/checkconv/cast_test.go +++ /dev/null @@ -1,134 +0,0 @@ -package checkconv_test - -import ( - "testing" - - "github.com/drykit-go/testx/check" - "github.com/drykit-go/testx/checkconv" -) - -type checkerTestcase struct { - checker interface{} - in interface{} - expPass bool - expExpl string -} - -func TestCast(t *testing.T) { - t.Run("native checker", func(t *testing.T) { - cases := []checkerTestcase{ - { - checker: check.Bytes.Is([]byte{42}), - in: []byte{42}, - expPass: true, - expExpl: "", - }, - { - checker: check.Int.InRange(41, 43), - in: -1, - expPass: false, - expExpl: "value:\nexp in range [41:43]\ngot -1", - }, - { - checker: check.Value.Custom("", func(got interface{}) bool { return true }), - in: "", - expPass: true, - expExpl: "", - }, - } - - for _, c := range cases { - assertCastable(t, c) - } - }) - - t.Run("custom checker", func(t *testing.T) { - cases := []checkerTestcase{ - { - checker: check.NewIntChecker(isEven, isEvenExpl), - in: 0, - expPass: true, - expExpl: "", - }, - { - checker: check.NewIntChecker(isEven, isEvenExpl), - in: 1, - expPass: false, - expExpl: "expect value to be even, got 1", - }, - } - - for _, c := range cases { - assertCastable(t, c) - } - }) - - t.Run("unknown checker", func(t *testing.T) { - cases := []checkerTestcase{ - { - checker: validCheckerInt{}, - in: 0, - expPass: true, - expExpl: "ok", - }, - { - checker: validCheckerInterface{}, - in: "anything", - expPass: true, - expExpl: "ok", - }, - } - - for _, c := range cases { - assertCastable(t, c) - } - }) - - t.Run("invalid checker", func(t *testing.T) { - for _, c := range badCheckers { - assertNotCastable(t, c) - } - }) -} - -func TestCastMany(t *testing.T) { - t.Run("valid checkers", func(t *testing.T) { - res, ok := checkconv.CastMany(goodCheckers...) - if !ok { - t.Error("returned !ok from good checkers") - } - if len(res) != len(goodCheckers) { - t.Error("failed to cast valid checkers") - } - }) - - t.Run("invalid checkers", func(t *testing.T) { - res, ok := checkconv.CastMany(badCheckers...) - if ok { - t.Error("returned ok from invalid checkers") - } - if len(res) != 0 { - t.Error("casted invalid checkers") - } - }) -} - -func assertCastable(t *testing.T, tc checkerTestcase) { - t.Helper() - c, ok := checkconv.Cast(tc.checker) - if !ok { - t.Errorf("failed to cast checker: %#v", tc.checker) - } - assertValidValueChecker(t, c, tc) -} - -func assertNotCastable(t *testing.T, badChecker interface{}) { - t.Helper() - got, ok := checkconv.Cast(badChecker) - if ok { - t.Errorf("returned ok from bad input: %#v", badChecker) - } - if got != nil { - t.Errorf("returned a non-nil checker from bad input: %#v", badChecker) - } -} diff --git a/checkconv/checkconv_test.go b/checkconv/checkconv_test.go deleted file mode 100644 index 8c31fa9..0000000 --- a/checkconv/checkconv_test.go +++ /dev/null @@ -1,106 +0,0 @@ -package checkconv_test - -import ( - "errors" - "fmt" - "testing" - - "github.com/drykit-go/testx/check" -) - -// Common definitions used across test files. - -type onlyPasser struct{} - -func (onlyPasser) Pass(int) bool { return true } - -type onlyExplainer struct{} - -func (onlyExplainer) PassX(int) bool { return true } -func (onlyExplainer) Explain(string, interface{}) string { return "" } - -type badPasser struct{} - -func (badPasser) Pass(int) int { return 0 } -func (badPasser) Explain(string, interface{}) string { return "" } - -type badExplainerIn struct{} - -func (badExplainerIn) Pass(int) bool { return true } -func (badExplainerIn) Explain(interface{}, interface{}) string { return "" } - -type badExplainerOut struct{} - -func (badExplainerOut) Pass(int) bool { return true } -func (badExplainerOut) Explain(string, interface{}) interface{} { return "" } - -type checkerAsFields struct { - Pass func(int) bool - Explain func(string, interface{}) string -} - -type validCheckerInt struct{} - -func (validCheckerInt) Pass(int) bool { return true } -func (validCheckerInt) Explain(string, interface{}) string { return "ok" } - -type validCheckerFloat32 struct{} - -func (validCheckerFloat32) Pass(float32) bool { return true } -func (validCheckerFloat32) Explain(string, interface{}) string { return "ok" } - -type validCheckerInterface struct{} - -func (validCheckerInterface) Pass(interface{}) bool { return true } -func (validCheckerInterface) Explain(string, interface{}) string { return "ok" } - -var badCheckers = []interface{}{ - -1, - "hi", - errors.New(""), - onlyPasser{}, - onlyExplainer{}, - badPasser{}, - badExplainerIn{}, - badExplainerOut{}, - checkerAsFields{ - Pass: func(int) bool { return true }, - Explain: func(string, interface{}) string { return "" }, - }, -} - -var goodCheckers = []interface{}{ - validCheckerInt{}, - validCheckerFloat32{}, - validCheckerInterface{}, -} - -func validExplainFunc(_ string, _ interface{}) string { - return "ok" -} - -// isEven is a dummy passFunc for custom checkers -func isEven(n int) bool { return n&1 == 0 } - -// isEvenExpl is a dummy explainFunc for custom checkers -func isEvenExpl(_ string, got interface{}) string { - return fmt.Sprintf("expect value to be even, got %v", got) -} - -// Test helpers - -func assertValidValueChecker(t *testing.T, c check.ValueChecker, tc checkerTestcase) { - t.Helper() - if pass := c.Pass(tc.in); pass != tc.expPass { - t.Errorf( - "unexpected Pass return value with checker %v: exp %v, got %v", - tc.checker, tc.expPass, pass, - ) - } - if expl := c.Explain("value", tc.in); tc.expExpl != "" && expl != tc.expExpl { - t.Errorf( - "unexpected Explain return value with checker %#v:\nexp:\n%v\n\ngot:\n%v", - tc.checker, tc.expExpl, expl, - ) - } -} diff --git a/checkconv/gen.go b/checkconv/gen.go deleted file mode 100644 index 3345dc4..0000000 --- a/checkconv/gen.go +++ /dev/null @@ -1,18 +0,0 @@ -package checkconv - -//go:generate ../bin/gen -kind types -name assert - -// For every type {N,T} defined in ../gen/types.go, running go generate -// will create the following definitions: -// -// func FromN(c check.NChecker) check.ValueChecker { -// return check.NewValueCheck( -// func(got interface{}) bool { return c.Pass(got.(T) }, -// c.Explain, -// ) -// } -// -// It will also add a new case in the switch statement of func Assert: -// -// case check.NChecker: -// return FromN(c) diff --git a/checkconv/ischecker.go b/checkconv/ischecker.go deleted file mode 100644 index da71d32..0000000 --- a/checkconv/ischecker.go +++ /dev/null @@ -1,44 +0,0 @@ -package checkconv - -import ( - "reflect" - - "github.com/drykit-go/testx/internal/reflectutil" -) - -var ( - signaturePass = reflectutil.FuncSignature{ - Name: "Pass", - In: []reflect.Kind{reflectutil.AnyKind}, - Out: []reflect.Kind{reflect.Bool}, - } - - signatureExpl = reflectutil.FuncSignature{ - Name: "Explain", - In: []reflect.Kind{reflect.String, reflect.Interface}, - Out: []reflect.Kind{reflect.String}, - } -) - -// IsChecker returns true if the provided value is a valid checker. -// A valid checker is any type exposing two methods: -// - Pass(got T) bool -// - Explain(label string, got interface{}) string -// Any custom implementation is considered valid whether or not it uses -// the package check. -// -// Note: The nature of Pass(got T) method, whose signature depend on the -// type of the tested value, prevents using a regular interface to identify -// a checker, hence the need of this helper. -func IsChecker(in interface{}) bool { - v := reflect.ValueOf(in) - return isPasser(v) && isExplainer(v) -} - -func isPasser(v reflect.Value) bool { - return signaturePass.ImplementedBy(v) -} - -func isExplainer(v reflect.Value) bool { - return signatureExpl.ImplementedBy(v) -} diff --git a/checkconv/ischecker_test.go b/checkconv/ischecker_test.go deleted file mode 100644 index e9a3bf8..0000000 --- a/checkconv/ischecker_test.go +++ /dev/null @@ -1,31 +0,0 @@ -package checkconv_test - -import ( - "testing" - - "github.com/drykit-go/testx/checkconv" -) - -func TestIsChecker(t *testing.T) { - t.Run("invalid checkers", func(t *testing.T) { - values := append([]interface{}{ - "a string", - 42, - func(int) bool { return true }, - }, badCheckers...) - - for _, v := range values { - if checkconv.IsChecker(v) { - t.Errorf("value %v was wrongly considered a checker", v) - } - } - }) - - t.Run("valid checkers", func(t *testing.T) { - for _, v := range goodCheckers { - if !checkconv.IsChecker(v) { - t.Errorf("checker %v was wrongly considered not a checker", v) - } - } - }) -} diff --git a/cmd/gen/main.go b/cmd/gen/main.go index b4f2270..d93d775 100644 --- a/cmd/gen/main.go +++ b/cmd/gen/main.go @@ -26,12 +26,12 @@ const ( var ( name = flag.String("name", "", "template name in internal/gen (without extension)") - kind = flag.String("kind", "", "data to be generated (types or interfaces)") + kind = flag.String("kind", "", "data to be generated (only 'types' currently") + out = flag.String("o", "", "output file path") ) var kindsFuncs = map[string]func(tpl, out string) error{ - "interfaces": gen.Interfaces, - "types": gen.Types, + "interfaces": gen.ProvidersVars, } func main() { @@ -69,6 +69,9 @@ func parseFlags() error { if *name == "" { return errors.New("missing template name (-name)") } + if *out == "" { + return errors.New("missing output path (-o)") + } return nil } @@ -90,7 +93,7 @@ func getFilesPaths() (tplPath, outPath string, err error) { } tplPath = filepath.Join(currDir, tplDirPath, filename(*name, tplExt)) - outPath = filepath.Join(workDir, filename(*name, outExt)) + outPath = filepath.Join(workDir, *out) return } diff --git a/example_httphandler_test.go b/example_httphandler_test.go index d133611..87c2859 100644 --- a/example_httphandler_test.go +++ b/example_httphandler_test.go @@ -55,7 +55,7 @@ func ExampleHTTPHandler_middlewares() { // withContextValue middleware attaches the input key-val pair // to the request context. - withContextValue := func(key, val interface{}) func(http.Handler) http.Handler { + withContextValue := func(key, val any) func(http.Handler) http.Handler { return func(next http.Handler) http.Handler { return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { ctx := context.WithValue(r.Context(), key, val) diff --git a/example_table_test.go b/example_table_test.go index 3187330..810ef2f 100644 --- a/example_table_test.go +++ b/example_table_test.go @@ -6,7 +6,6 @@ import ( "github.com/drykit-go/testx" "github.com/drykit-go/testx/check" - "github.com/drykit-go/testx/checkconv" ) func ExampleTable_monadic() { @@ -17,9 +16,9 @@ func ExampleTable_monadic() { // func double has 1 parameter and 1 return value, // hence no config is needed - testx.Table(double).Cases([]testx.Case{ + testx.Table[float64, float64](double).Cases([]testx.Case[float64, float64]{ {In: 0.0, Exp: 0.0}, - {In: -2.0, Pass: checkconv.AssertMany(check.Float64.InRange(-5, -3))}, + {In: -2.0, Pass: []check.Checker[float64]{check.Float64.InRange(-5, -3)}}, }).Run(t) } @@ -45,13 +44,14 @@ func ExampleTable_dyadic() { // at position 1). // We inject Case.In at position 1 (param y) and use a fixed value // of 42.0 at position 0 (param x) for all cases. - testx.Table(divide).Config(testx.TableConfig{ + testx.Table[float64, error](divide).Config(testx.TableConfig{ // Positions start at 0 - InPos: 1, // Case.In injected in param position 1 (y) - OutPos: 1, // Case.Exp compared to return value position 1 (error value) - FixedArgs: []interface{}{0: 42.0}, // param 0 (x) set to 42.0 for all cases - }).Cases([]testx.Case{ - {In: 1.0, Exp: testx.ExpNil}, // divide(42.0, 1.0) -> (_, nil) + InPos: 1, // Case.In injected in param position 1 (y) + OutPos: 1, // Case.Exp compared to return value position 1 (error value) + FixedArgs: []any{0: 42.0}, // param 0 (x) set to 42.0 for all cases + }).Cases([]testx.Case[float64, error]{ + // FIXME: ExpNil typing issues + // {In: 1.0, Exp: testx.ExpNil}, // divide(42.0, 1.0) -> (_, nil) {In: 0.0, Exp: errors.New("division by 0")}, // divide(42.0, 0.0) -> (_, err) }).Run(t) } diff --git a/example_value_test.go b/example_value_test.go index b3089e1..cc34faa 100644 --- a/example_value_test.go +++ b/example_value_test.go @@ -6,7 +6,6 @@ import ( "github.com/drykit-go/testx" "github.com/drykit-go/testx/check" - "github.com/drykit-go/testx/checkconv" ) /* @@ -19,9 +18,9 @@ func ExampleValueRunner() { // Run Value test via Run(t *testing.T) testx.Value(get42()). - Exp(42). // pass - Not(3, "hello"). // pass - Pass(checkconv.Assert(check.Int.InRange(41, 43))). // pass + Exp(42). // pass + Not(3, -1). // pass + Pass(check.Int.InRange(41, 43)). // pass Run(t) } @@ -30,10 +29,10 @@ func ExampleValueRunner_dryRun() { results := testx.Value(get42()). Exp(42). // pass - Pass(checkconv.AssertMany( + Pass( check.Int.GTE(41), // pass check.Int.InRange(-1, 1), // fail - )...). + ). DryRun() fmt.Println(results.Passed()) diff --git a/go.mod b/go.mod index b053f26..7bbad14 100644 --- a/go.mod +++ b/go.mod @@ -1,8 +1,11 @@ module github.com/drykit-go/testx -go 1.16 +go 1.18 require ( github.com/drykit-go/cond v0.1.0 + github.com/drykit-go/slicex v0.0.1 github.com/drykit-go/strcase v0.2.0 ) + +require github.com/drykit-go/slices v0.0.4 // indirect diff --git a/go.sum b/go.sum index a01b19e..20f950a 100644 --- a/go.sum +++ b/go.sum @@ -1,5 +1,9 @@ github.com/drykit-go/cond v0.1.0 h1:y7MNxREQLT83vGfcfSKjyFPLC/ZDjYBNp6KuaVVjOg4= github.com/drykit-go/cond v0.1.0/go.mod h1:7MXBFjjaB5ZCEB8Q4w2euNOaWuTqf7NjOFZAyV1Jpfg= +github.com/drykit-go/slices v0.0.4 h1:DNdJwPKJ3O4aq3oaXGQFZMTBYrrs9458ucN9uuX4txo= +github.com/drykit-go/slices v0.0.4/go.mod h1:xU3NP7e7CFy3lZpECQDCjn/jLdcLBeA7+duOyOFsLRg= +github.com/drykit-go/slicex v0.0.1 h1:w8+9x3opWIN4cwhmPLUOgzxgE3vWZV/sDuo42a6eCig= +github.com/drykit-go/slicex v0.0.1/go.mod h1:l68Za0PIxhCJ9Sm25dlIJEw1nYVonyfoBBc3aKfajaM= github.com/drykit-go/strcase v0.2.0 h1:Yzb2DZB6PcOzwMXKYOOQqaNYp5FqqlvZ1nfbGhlLvLU= github.com/drykit-go/strcase v0.2.0/go.mod h1:cWK0/az2f09UPIbJ42Sb8Iqdv01uENrFX+XXKGjPo+8= github.com/drykit-go/testx v0.1.0/go.mod h1:qGXb49a8CzQ82crBeCVW8R3kGU1KRgWHnI+Q6CNVbz8= diff --git a/internal/checktypes/checktypes.go b/internal/checktypes/checktypes.go new file mode 100644 index 0000000..8e59303 --- /dev/null +++ b/internal/checktypes/checktypes.go @@ -0,0 +1,59 @@ +package checktypes + +import "constraints" + +type Numeric interface { + constraints.Integer | constraints.Float +} + +type ( + // PassFunc is the required method to implement Passer. + // It returns a boolean that indicates whether the got value + // passes the current check. + PassFunc[T any] func(got T) bool + + // ExplainFunc is the required method to implement Explainer. + // It returns a string explaining why the gotten value failed the check. + // The label provides some context, such as "response code". + ExplainFunc func(label string, got any) string +) + +type ( + // Passer provides a method Pass that returns a bool that indicates + // whether the got value passes the current check. + Passer[T any] interface{ Pass(got T) bool } + + // Explainer provides a method Explain describing the reason of a failed check. + Explainer interface { + Explain(label string, got any) string + } +) + +// Checker satisfies both Passer and Explainer interfaces. +type Checker[T any] interface { + Passer[T] + Explainer +} + +type checker[T any] struct { + pass PassFunc[T] + expl ExplainFunc +} + +func (c checker[T]) Pass(got T) bool { + return c.pass(got) +} + +func (c checker[T]) Explain(label string, got any) string { + return c.expl(label, got) +} + +func NewChecker[T any]( + passFunc PassFunc[T], + explainFunc ExplainFunc, +) Checker[T] { + return checker[T]{ + pass: passFunc, + expl: explainFunc, + } +} diff --git a/internal/fmtexpl/fmtexpl.go b/internal/fmtexpl/fmtexpl.go index f984363..23f6c1f 100644 --- a/internal/fmtexpl/fmtexpl.go +++ b/internal/fmtexpl/fmtexpl.go @@ -8,14 +8,14 @@ import ( ) // Default computes and return an explain string in the default format. -func Default(label string, exp, got interface{}) string { +func Default(label string, exp, got any) string { return fmt.Sprintf("%s:\nexp %v\ngot %v", label, exp, got) } // Pretty computes and return an explain string in a pretty output. // Compatibility is not guaranteed, usage should be restricted to // local tests -- not in checkers explain func. -func Pretty(label string, exp, got interface{}) string { +func Pretty(label string, exp, got any) string { return "❌ " + Default(label, exp, got) } diff --git a/internal/fmtexpl/ioutil_test.go b/internal/fmtexpl/ioutil_test.go index 798da5d..fcbd9f9 100644 --- a/internal/fmtexpl/ioutil_test.go +++ b/internal/fmtexpl/ioutil_test.go @@ -24,8 +24,8 @@ func TestPretty(t *testing.T) { } func TestChecker(t *testing.T) { - exp := "int value:\nexp to pass IntChecker\ngot explanation: Oh hi Mark!" - got := fmtexpl.Checker("int value", "to pass IntChecker", "Oh hi Mark!") + exp := "int value:\nexp to pass Checker[int]\ngot explanation: Oh hi Mark!" + got := fmtexpl.Checker("int value", "to pass Checker[int]", "Oh hi Mark!") if got != exp { t.Errorf("\nexp %s\ngot %s", exp, got) } diff --git a/internal/gen/docparser/docparser.go b/internal/gen/docparser/docparser.go index 68ddd9f..69e8e3d 100644 --- a/internal/gen/docparser/docparser.go +++ b/internal/gen/docparser/docparser.go @@ -5,8 +5,8 @@ import ( ) // ParseDocLines reads the rawdoc got from go/doc parsing, -// adds a leading "// " to each line, applies the replacements, -// and returns a slice of strings for each line. +// applies the replacements, and returns a slice of strings +// for each line. // The result can then be conveniently used in a go template. // // Example: @@ -17,8 +17,8 @@ import ( // // // Output // []string{ -// "// MyFunc does this.", -// "// It is nice.", +// "MyFunc does this.", +// "It is nice.", // } func ParseDocLines(rawdoc string, repl map[string]string) []string { lines := []string{} diff --git a/internal/gen/gen.go b/internal/gen/gen.go index deecf01..0bc0670 100644 --- a/internal/gen/gen.go +++ b/internal/gen/gen.go @@ -7,59 +7,18 @@ import ( "strings" "text/template" "time" - - "github.com/drykit-go/strcase" ) -var tplFuncs = template.FuncMap{ - "camelcase": strcase.Camel, -} - type config struct { name, tpl, out string + src interface{} tplFuncs template.FuncMap - data interface{} } -// Types generates checkers declarations in packages check and checkconv -// for each type defined in var `types`. It should be run every time this -// list is modified. -// -// For instance, the following entry: -// {N: "Int", T: "int"}, -// generates the following declarations: -// -// // file check/check.go -// type IntPassFunc func(got int) bool -// type IntPasser interface { Pass(got int) bool } -// type IntChecker interface { IntPasser; Explainer } -// -// // file check/checkers.go -// type intChecker struct { ... } -// func (c intChecker) Pass(got int) bool { ... } -// func NewIntChecker(passFunc IntPassFunc, explainFunc ExplainFunc) IntChecker { ... } -// -// // file checkconv/assert.go -// func FromInt(c check.IntChecker) check.ValueChecker { ... } -// // also adds a case in checkconv.Assert: -// case check.IntChecker: -// return FromInt(c) -func Types(tpl, out string) error { - return generate(config{ - name: "types", - tpl: tpl, - out: out, - tplFuncs: tplFuncs, - data: types, - }) -} - -// Interfaces generates the public interfaces for checker providers -// implementations in package check (provider_*.go files). It should be run -// every time their API is modified (method signature change, doc comment, -// new method, method removal, ...) -func Interfaces(tpl, out string) error { - data, err := computeInterfaces() +// ProvidersVars generates the public instances of checker providers +// implementations in package check (providers_*.go files). +func ProvidersVars(tpl, out string) error { + src, err := computeProvidersMetaData() if err != nil { return err } @@ -67,7 +26,7 @@ func Interfaces(tpl, out string) error { name: "interfaces", tpl: tpl, out: out, - data: data, + src: src, }) } @@ -82,11 +41,15 @@ func generate(cfg config) error { return err } - if err := t.Execute(f, cfg.data); err != nil { + if err := t.Execute(f, cfg.src); err != nil { return err } - return runFormatter(cfg.out) + // FIXME: make goimports work with generics syntax + if err := runFormatter(cfg.out); err != nil { + fmt.Printf("goimports returned the following error (likely due to unsupported generics syntax):\n%s\n", err) + } + return nil } func newTemplate(name, src string, funcMap template.FuncMap) (*template.Template, error) { diff --git a/internal/gen/gen_providers.go b/internal/gen/gen_providers.go new file mode 100644 index 0000000..8d22abc --- /dev/null +++ b/internal/gen/gen_providers.go @@ -0,0 +1,144 @@ +package gen + +import ( + "fmt" + "go/doc" + "go/parser" + "go/token" + "io/fs" + "strings" + + "github.com/drykit-go/slicex" + + "github.com/drykit-go/testx/internal/gen/docparser" + "github.com/drykit-go/testx/internal/gen/metatype" +) + +// ProvidersMetaData is a representation of the parsed doc for providers files +// in package internal/providers. +// It is meant to be used as a data source for template providers.gotmpl. +type ProvidersMetaData struct { + Vars []metatype.Var +} + +func computeProvidersMetaData() (ProvidersMetaData, error) { + docp, err := newDocPackage("providers", isProviderFile) // TODO: package-agnostic + if err != nil { + return ProvidersMetaData{}, err + } + + data := ProvidersMetaData{Vars: numericMetaVars()} + for _, t := range docp.Types { + data.Vars = append(data.Vars, computeMetaVar(t)) + } + + return data, nil +} + +// computeMetaVar returns a MetaVar after the given *doc.Type. +func computeMetaVar(t *doc.Type) metatype.Var { + varname := structToVarName(t.Name) + return metatype.Var{ + Name: varname, + Value: structInstanceString(t.Name), + DocLines: docparser.ParseDocLines(t.Doc, map[string]string{ + t.Name: varname, + }), + } +} + +// newDocPackage returns a *doc.Package matching packageName after applying +// the given filter, or the first non-nil error occurring in the process. +func newDocPackage(packageName string, filter func(fs.FileInfo) bool) (*doc.Package, error) { + fset := token.NewFileSet() + pkgs, err := parser.ParseDir(fset, ".", filter, parser.ParseComments) + if err != nil { + return nil, err + } + astp, ok := pkgs[packageName] + if !ok { + return nil, fmt.Errorf( + "no files found for package %s, check path or filters", + packageName, + ) + } + return doc.New(astp, "./", doc.AllDecls), nil +} + +func numericMetaVars() []metatype.Var { + type namedType struct{ N, T string } + numerics := []namedType{ + {N: "Int", T: "int"}, + {N: "Int8", T: "int8"}, + {N: "Int16", T: "int16"}, + {N: "Int32", T: "int32"}, + {N: "Int64", T: "int64"}, + {N: "Uint", T: "uint"}, + {N: "Uint8", T: "uint8"}, + {N: "Uint16", T: "uint16"}, + {N: "Uint32", T: "uint32"}, + {N: "Uint64", T: "uint64"}, + {N: "Float32", T: "float32"}, + {N: "Float64", T: "float64"}, + } + return slicex.Map(numerics, func(nt namedType) metatype.Var { + return metatype.Var{ + Name: nt.N, + Value: structInstanceString(addProviderSuffix("Number"), nt.T), + DocLines: []string{ + fmt.Sprintf("%s provides checks on type %s.", nt.N, nt.T), + }, + } + }) +} + +// File filters + +func isProviderFile(file fs.FileInfo) bool { + return strings.HasPrefix(file.Name(), "providers_") && + !isTestFile(file) && + !isBaseFile(file) && + !isBlacklisted(file) +} + +func isTestFile(file fs.FileInfo) bool { + return strings.HasSuffix(file.Name(), "_test.go") +} + +func isBaseFile(file fs.FileInfo) bool { + return strings.HasSuffix(file.Name(), "_base.go") +} + +func isBlacklisted(file fs.FileInfo) bool { + blacklist := map[string]struct{}{ + "providers_number.go": {}, + "providers_map.go": {}, + "providers_slice.go": {}, + "providers_value.go": {}, + } + _, inBlacklist := blacklist[file.Name()] + return inBlacklist +} + +// String helpers + +const ( + providerSuffix = "CheckerProvider" + packagePrefix = "providers." +) + +func addProviderSuffix(name string) string { + return name + providerSuffix +} + +func structToVarName(structName string) string { + return strings.TrimSuffix(structName, providerSuffix) +} + +func structInstanceString(name string, typeparams ...string) string { + tpstr := "" + if len(typeparams) != 0 { + tpstr = "[" + strings.Join(typeparams, ", ") + "]" + } + return packagePrefix + name + tpstr + "{}" +} diff --git a/internal/gen/interfaces.go b/internal/gen/interfaces.go deleted file mode 100644 index 898bcb6..0000000 --- a/internal/gen/interfaces.go +++ /dev/null @@ -1,111 +0,0 @@ -package gen - -import ( - "fmt" - "go/doc" - "go/parser" - "go/token" - "io/fs" - "strings" - - "github.com/drykit-go/testx/internal/gen/docparser" - "github.com/drykit-go/testx/internal/gen/metatype" - "github.com/drykit-go/testx/internal/gen/serialize" -) - -// ProvidersMetaData is a representation of the parsed doc for providers files -// in package check. -// It is meant to be used as a data source for template providers.gotmpl. -type ProvidersMetaData struct { - Interfaces []metatype.Interface - Vars []metatype.Var -} - -func computeInterfaces() (ProvidersMetaData, error) { - docp, err := newDocPackage("check", isProviderFile) // TODO: package-agnostic - if err != nil { - return ProvidersMetaData{}, err - } - - data := ProvidersMetaData{} - for _, t := range docp.Types { - data.Vars = append(data.Vars, computeMetaVar(t)) - data.Interfaces = append(data.Interfaces, computeMetaInterface(t)) - } - - return data, nil -} - -// computeMetaInterface returns a MetaInterface after the given *doc.Type. -// It reads and attaches the type's name and docs and iterates over its methods. -// If a method is inherited, it embeds the computed interface name of the parent -// rather than adding it to the interface. -func computeMetaInterface(t *doc.Type) metatype.Interface { - name := structToInterfaceName(t.Name) - mitf := metatype.Interface{ - Name: name, - DocLines: docparser.ParseDocLines(t.Doc, map[string]string{ - t.Name: name, - }), - } - - for _, m := range t.Methods { - // ignore private methods - if !m.Decl.Name.IsExported() { - continue - } - // If a method is inherited, embed the interface of the parent - // rather than including all its methods - if m.Level != 0 { - orig := strings.TrimPrefix(m.Orig, "*") // m.Orig might have a leading "*" - mitf.EmbedInterface(structToInterfaceName(orig)) - continue - } - mitf.AddFunc(metatype.Func{ - Sign: serialize.FuncSignature(m.Name, m.Decl.Type), - DocLines: docparser.ParseDocLines(m.Doc, nil), - }) - } - return mitf -} - -// computeMetaVar returns a MetaVar after the given *doc.Type. -func computeMetaVar(t *doc.Type) metatype.Var { - return metatype.Var{ // var T TCheckerProvider = tCheckerProvider{} - Name: structToVarName(t.Name), - Type: structToInterfaceName(t.Name), - Value: t.Name + "{}", - } -} - -// newDocPackage returns a *doc.Package matching packageName after applying -// the given filter, or the first non-nil error occurring in the process. -func newDocPackage(packageName string, filter func(fs.FileInfo) bool) (*doc.Package, error) { - fset := token.NewFileSet() - pkgs, err := parser.ParseDir(fset, "./", filter, parser.ParseComments) - if err != nil { - return nil, err - } - astp, ok := pkgs[packageName] - if !ok { - return nil, fmt.Errorf( - "no files found for package %s, check path or filters", - packageName, - ) - } - return doc.New(astp, "./", doc.AllDecls), nil -} - -func isProviderFile(file fs.FileInfo) bool { - return strings.HasPrefix(file.Name(), "providers_") && - !isTestFile(file) && - !isBaseFile(file) -} - -func isTestFile(file fs.FileInfo) bool { - return strings.HasSuffix(file.Name(), "_test.go") -} - -func isBaseFile(file fs.FileInfo) bool { - return strings.HasSuffix(file.Name(), "_base.go") -} diff --git a/internal/gen/metatype/metatype.go b/internal/gen/metatype/metatype.go index 92c3f0a..3cd62d2 100644 --- a/internal/gen/metatype/metatype.go +++ b/internal/gen/metatype/metatype.go @@ -1,40 +1,8 @@ package metatype -// Interface gathers an interface informations so it can be generated -// via a go template. -type Interface struct { - Name string - DocLines []string - Embedded []string - Funcs []Func -} - -// EmbedInterface appends interfaceName to MetaInterface.Embedded -// if not already exists, else it is ignored. -func (mi *Interface) EmbedInterface(interfaceName string) { - for _, itf := range mi.Embedded { - if itf == interfaceName { - return - } - } - mi.Embedded = append(mi.Embedded, interfaceName) -} - -// AddFunc creates a MetaFunc from *doc.Func and appends it -// to MetaInterface.Funcs. -func (mi *Interface) AddFunc(f Func) { - mi.Funcs = append(mi.Funcs, f) -} - -// Func gathers a func informations so it can be generated -// via a go template. -type Func struct { - Sign string - DocLines []string -} - // Var gathers a variable informations so it can be generated // via a go template. type Var struct { - Name, Type, Value string + Name, Value string + DocLines []string } diff --git a/internal/gen/providers.go b/internal/gen/providers.go deleted file mode 100644 index 646f88c..0000000 --- a/internal/gen/providers.go +++ /dev/null @@ -1,35 +0,0 @@ -package gen - -import ( - "strings" - - "github.com/drykit-go/strcase" -) - -const ( - providerStructSuffix = "CheckerProvider" - providerInterfaceSuffix = "CheckerProvider" -) - -func structToInterfaceName(structName string) string { - baseName := trimProviderStructSuffix(structName) - interfaceName := appendProviderInterfaceSuffix(baseName) - return exportName(interfaceName) -} - -func structToVarName(structName string) string { - baseName := trimProviderStructSuffix(structName) - return exportName(baseName) -} - -func trimProviderStructSuffix(structName string) string { - return strings.TrimSuffix(structName, providerStructSuffix) -} - -func appendProviderInterfaceSuffix(baseName string) string { - return baseName + providerInterfaceSuffix -} - -func exportName(unexported string) string { - return strcase.Pascal(unexported) -} diff --git a/internal/gen/serialize/serialize.go b/internal/gen/serialize/serialize.go deleted file mode 100644 index 846a03a..0000000 --- a/internal/gen/serialize/serialize.go +++ /dev/null @@ -1,167 +0,0 @@ -package serialize - -import ( - "go/ast" - "log" - "strings" -) - -// stringBuilder is a wrapper of strings.Builder with additionnal methods -// to write serialized representation of go/ast types. -type stringBuilder struct{ strings.Builder } - -// FuncSignature builds a func signature given a name an *ast.FuncType -// and returns it as a string. -func FuncSignature(name string, ftyp *ast.FuncType) string { - b := stringBuilder{} - b.writeFunc(name, ftyp) - return b.String() -} - -// writeExpr writes a serialized ast.Expr to the builder. -func (b *stringBuilder) writeExpr(expr ast.Expr) { - switch t := expr.(type) { - case *ast.Ident: - b.WriteString(t.Name) - case *ast.ArrayType: - b.WriteString("[]") - b.writeExpr(t.Elt) - case *ast.Ellipsis: - b.WriteString("...") - b.writeExpr(t.Elt) - case *ast.FuncType: - b.writeFunc("func", t) - case *ast.SelectorExpr: - b.writeSelector(t) - case *ast.StarExpr: - b.WriteString("*") - b.writeExpr(t.X) - case *ast.ChanType: - b.writeChan(t) - case *ast.MapType: - b.writeMap(t) - case *ast.StructType: - b.writeStruct(t) - case *ast.InterfaceType: - b.writeInterface(t) - default: - log.Panicf("❌ unhandled ast.Expr: %#v", t) - } -} - -// writeFunc writes a serialized func type to the builder. -func (b *stringBuilder) writeFunc(name string, t *ast.FuncType) { - b.WriteString(name + "(") - b.writeFuncParams(t.Params) - b.WriteString(") ") - b.writeFuncResults(t.Results) -} - -// writeFuncParam writes a serialized func params list to the builder. -// It does nothing if params == nil -func (b *stringBuilder) writeFuncParams(params *ast.FieldList) { - if params == nil { - return - } - b.writeJoinedFields(params.List, ", ") -} - -// writeFuncResults writes a serialized func results list to the builder. -// It does nothing if results == nil. If results contains several values, -// they are wrapped in parentheses. -func (b *stringBuilder) writeFuncResults(results *ast.FieldList) { - if results == nil { - return - } - if results.NumFields() > 1 { - b.WriteString("(") - defer b.WriteString(")") - } - b.writeJoinedFields(results.List, ", ") -} - -// writeChan writes a serialized chan type to the builder. -func (b *stringBuilder) writeChan(t *ast.ChanType) { - var chanstr string - switch t.Dir { - case ast.RECV: - chanstr = "<-chan" - case ast.SEND: - chanstr = "chan<-" - default: - chanstr = "chan" - } - b.WriteString(chanstr) - b.WriteString(" ") - b.writeExpr(t.Value) -} - -// writeStruct writes a serialized struct type to the builder. -func (b *stringBuilder) writeStruct(t *ast.StructType) { - b.WriteString("struct{") - b.writeJoinedFields(t.Fields.List, "; ") - b.WriteString("}") -} - -// writeStruct writes a serialized map type to the builder. -func (b *stringBuilder) writeMap(t *ast.MapType) { - b.WriteString("map[") - b.writeExpr(t.Key) - b.WriteString("]") - b.writeExpr(t.Value) -} - -// writeStruct writes a serialized interface type to the builder. -func (b *stringBuilder) writeInterface(t *ast.InterfaceType) { - b.WriteString("interface{") - b.writeJoinedInterfaceFields(t.Methods.List, "; ") - b.WriteString("}") -} - -// writeStruct writes a serialized selector expression to the builder. -func (b *stringBuilder) writeSelector(t *ast.SelectorExpr) { - b.writeExpr(t.X) - b.WriteString(".") - b.WriteString(t.Sel.Name) -} - -// writeStruct writes joined identifiers separated by sep to the builder -func (b *stringBuilder) writeJoinedIdents(idents []*ast.Ident, sep string) { - for i, ident := range idents { - b.WriteString(ident.Name) - if i != len(idents)-1 { - b.WriteString(sep) - } - } -} - -// writeJoinedFields writes joined fields separated by sep to the builder. -// It can be used to serialiaze a list of func params or results, -// as well as struct fields. -// For interface fields and methods, use writeJoinedInterfaceFields instead -func (b *stringBuilder) writeJoinedFields(fields []*ast.Field, sep string) { - for i, f := range fields { - b.writeJoinedIdents(f.Names, ", ") - b.WriteString(" ") - b.writeExpr(f.Type) - if i != len(fields)-1 { - b.WriteString(sep) - } - } -} - -func (b *stringBuilder) writeJoinedInterfaceFields(fields []*ast.Field, sep string) { - for i, f := range fields { - switch t := f.Type.(type) { - case *ast.Ident: - b.WriteString(t.Name) - case *ast.FuncType: - b.WriteString(FuncSignature(f.Names[0].Name, t)) - default: - log.Panicf("joinInterfaceFields: unhandled type %#v", t) - } - if i != len(fields) { - b.WriteString(sep) - } - } -} diff --git a/internal/gen/templates/assert.gotmpl b/internal/gen/templates/assert.gotmpl deleted file mode 100644 index 88bbff6..0000000 --- a/internal/gen/templates/assert.gotmpl +++ /dev/null @@ -1,52 +0,0 @@ -// Package checkconv provides functions to convert typed checkers -// into generic ones. -package checkconv - -{{range . -}} -{{if ne .N "Value"}} -// From{{.N}} returns a check.ValueChecker that wraps the given -// check.{{.N}}Checker, so it can be used as a generic checker. -func From{{.N}}(c check.{{.N}}Checker) check.ValueChecker { - return check.NewValueChecker( - func(got interface{}) bool { return c.Pass(got.({{.T}})) }, - c.Explain, - ) -} -{{end}} -{{end}} - -// Assert returns a check.ValueChecker that wraps the given -// check.Checker (such as check.IntChecker). -// -// It panics if checker is not a known checker type. For instance, -// a custom checker that implements check.IntChecker will be successfully -// converted, while a valid implementation of an unknown interface, -// such as Complex128Checker, will panic. -// For that matter, Cast should be used instead. -func Assert(knownChecker interface{}) check.ValueChecker { - switch c := knownChecker.(type) { - {{range . -}} - case check.{{.N}}Checker: - {{if ne .N "Value" -}} - return From{{.N}}(c) - {{else -}} - return c - {{end -}} - {{end -}} - default: - panic("assert from unknown checker type") - } -} - -// AssertMany returns a slice of check.ValueChecker that wrap the given -// check.Checkers (such as check.IntChecker). -// -// It panics if any checker is not a known checker type. See Assert -// for further documentation. -func AssertMany(knownCheckers ...interface{}) []check.ValueChecker { - valueCheckers := []check.ValueChecker{} - for _, c := range knownCheckers { - valueCheckers = append(valueCheckers, Assert(c)) - } - return valueCheckers -} diff --git a/internal/gen/templates/check.gotmpl b/internal/gen/templates/check.gotmpl deleted file mode 100644 index 4620413..0000000 --- a/internal/gen/templates/check.gotmpl +++ /dev/null @@ -1,38 +0,0 @@ -// Package check provides types to perform checks on values -// in a testing context. -package check - -type ( - {{range . -}} - // {{.N}}PassFunc is the required method to implement {{.N}}Passer. - // It returns a boolean that indicates whether the gotten {{.T}} value - // passes the current check. - {{.N}}PassFunc func(got {{.T}}) bool - {{end}} - - // ExplainFunc is the required method to implement Explainer. - // It returns a string explaining why the gotten value failed the check. - // The label provides some context, such as "response code". - ExplainFunc func(label string, got interface{}) string -) - -type ( - {{range . -}} - // {{.N}}Passer provides a method Pass that returns a bool that indicates - // whether the gotten {{.T}} value passes the current check. - {{.N}}Passer interface { Pass(got {{.T}}) bool } - {{end}} - - // Explainer provides a method Explain describing the reason of a failed check. - Explainer interface { Explain(label string, got interface{}) string } -) - -type ( - {{range . -}} - // {{.N}}Checker implements both {{.N}}Passer and Explainer interfaces. - {{.N}}Checker interface { - {{.N}}Passer - Explainer - } - {{end}} -) diff --git a/internal/gen/templates/checkers.gotmpl b/internal/gen/templates/checkers.gotmpl deleted file mode 100644 index bd8da4d..0000000 --- a/internal/gen/templates/checkers.gotmpl +++ /dev/null @@ -1,35 +0,0 @@ -package check - -// baseChecker is a base checker for all checkers. It implements Explainer. -type baseChecker struct { - explFunc ExplainFunc -} - -// Explain returns a string explaining the reason of a failed check -// for the gotten value. -func (c baseChecker) Explain(label string, got interface{}) string { - return c.explFunc(label, got) -} - -func newBaseChecker(explFunc ExplainFunc) baseChecker { - return baseChecker{explFunc: explFunc} -} - -{{range . -}} -// {{camelcase .N}}Checker is an implementation of {{.N}}Checker interface -type {{camelcase .N}}Checker struct { - baseChecker - passFunc {{.N}}PassFunc -} - -// Pass returns a boolean that indicates whether the gotten {{.T}} value -// passes the current check. -func (c {{camelcase .N}}Checker) Pass(got {{.T}}) bool { return c.passFunc(got) } - - -// New{{.N}}Checker returns a custom {{.N}}Checker with the provided -// {{.N}}PassFunc and ExplainFunc. -func New{{.N}}Checker(passFunc {{.N}}PassFunc, explainFunc ExplainFunc) {{.N}}Checker { - return {{camelcase .N}}Checker{baseChecker: newBaseChecker(explainFunc), passFunc: passFunc} -} -{{end}} diff --git a/internal/gen/templates/providers.gotmpl b/internal/gen/templates/providers.gotmpl index 858fc01..3ea9f69 100644 --- a/internal/gen/templates/providers.gotmpl +++ b/internal/gen/templates/providers.gotmpl @@ -1,28 +1,31 @@ package check -type ( - {{- range .Interfaces -}} +import ( + "github.com/drykit-go/testx/internal/providers" +) + +var ( + {{- range .Vars -}} + {{if ne .Name "Number" -}} {{range .DocLines}} // {{.}} {{- end}} - {{.Name}} interface { - {{range .Embedded -}} - {{.}} - - {{end -}} - {{range .Funcs -}} - {{range .DocLines -}} - // {{.}} - {{end -}} - {{.Sign}} - {{end}} - } - {{end}} + {{.Name}} = {{.Value}} + {{- end}} + {{- end}} ) -var ( - {{range .Vars -}} - // {{.Name}} implements {{.Type}}. - {{.Name}} {{.Type}} = {{.Value}} - {{end}} -) +// Map provides checks on type map[Key]Val. +func Map[Key comparable, Val any]() providers.MapCheckerProvider[Key, Val] { + return providers.MapCheckerProvider[Key, Val]{} +} + +// Slice provides checks on type []Elem. +func Slice[Elem any]() providers.SliceCheckerProvider[Elem] { + return providers.SliceCheckerProvider[Elem]{} +} + +// ValueCheckerProvider provides generic checks on any type. +func Value[T any]() providers.ValueCheckerProvider[T] { + return providers.ValueCheckerProvider[T]{} +} diff --git a/internal/gen/types.go b/internal/gen/types.go deleted file mode 100644 index bf55635..0000000 --- a/internal/gen/types.go +++ /dev/null @@ -1,20 +0,0 @@ -package gen - -// types is a slice of source types used to generate -// their subsequent definitions. -var types = []struct { - // Name, underlying Type - N, T string -}{ - {N: "Bool", T: "bool"}, - {N: "Bytes", T: "[]byte"}, - {N: "String", T: "string"}, - {N: "Int", T: "int"}, - {N: "Float64", T: "float64"}, - {N: "Duration", T: "time.Duration"}, - {N: "Context", T: "context.Context"}, - {N: "HTTPHeader", T: "http.Header"}, - {N: "HTTPRequest", T: "*http.Request"}, - {N: "HTTPResponse", T: "*http.Response"}, - {N: "Value", T: "interface{}"}, -} diff --git a/internal/providers/bool.go b/internal/providers/bool.go new file mode 100644 index 0000000..854ba16 --- /dev/null +++ b/internal/providers/bool.go @@ -0,0 +1,15 @@ +package providers + +import check "github.com/drykit-go/testx/internal/checktypes" + +// BoolCheckerProvider provides checks on type bool. +type BoolCheckerProvider struct{ baseCheckerProvider } + +// Is checks the gotten bool is equal to the target. +func (p BoolCheckerProvider) Is(tar bool) check.Checker[bool] { + pass := func(got bool) bool { return got == tar } + expl := func(label string, got any) string { + return p.explain(label, tar, got) + } + return check.NewChecker(pass, expl) +} diff --git a/internal/providers/bool_test.go b/internal/providers/bool_test.go new file mode 100644 index 0000000..e03fbd2 --- /dev/null +++ b/internal/providers/bool_test.go @@ -0,0 +1,28 @@ +package providers_test + +import ( + "fmt" + "testing" + + "github.com/drykit-go/testx/internal/providers" +) + +func TestBoolCheckerProvider(t *testing.T) { + checkBool := providers.BoolCheckerProvider{} + const b = true + + t.Run("Is pass", func(t *testing.T) { + c := checkBool.Is(b) + fmt.Print(c) + assertPassChecker(t, "Bool.Is", c, b) + c = checkBool.Is(!b) + assertPassChecker(t, "Bool.Is", c, !b) + }) + + t.Run("Is fail", func(t *testing.T) { + c := checkBool.Is(!b) + assertFailChecker(t, "Bool.Is", c, b, makeExpl("false", "true")) + c = checkBool.Is(b) + assertFailChecker(t, "Bool.Is", c, !b, makeExpl("true", "false")) + }) +} diff --git a/internal/providers/gen.go b/internal/providers/gen.go new file mode 100644 index 0000000..c4d2f9e --- /dev/null +++ b/internal/providers/gen.go @@ -0,0 +1,3 @@ +package providers + +//go:generate ../../bin/gen -kind interfaces -name providers -o ../../check/providers.go diff --git a/check/providers_base.go b/internal/providers/providers_base.go similarity index 71% rename from check/providers_base.go rename to internal/providers/providers_base.go index 2e6a58e..711bb77 100644 --- a/check/providers_base.go +++ b/internal/providers/providers_base.go @@ -1,4 +1,4 @@ -package check +package providers import ( "encoding/json" @@ -7,6 +7,7 @@ import ( "reflect" "strings" + check "github.com/drykit-go/testx/internal/checktypes" "github.com/drykit-go/testx/internal/fmtexpl" ) @@ -18,8 +19,8 @@ type baseCheckerProvider struct{} // with unmarshaled x and y respectively. // // It panics on the first error encountered in the process. -func (p baseCheckerProvider) sameJSON(x, y []byte, xptr, yptr interface{}) bool { - mustUnmarshal := func(b []byte, ptr interface{}) { +func (p baseCheckerProvider) sameJSON(x, y []byte, xptr, yptr any) bool { + mustUnmarshal := func(b []byte, ptr any) { if err := json.Unmarshal(b, &ptr); err != nil { panic(err) } @@ -35,8 +36,8 @@ func (p baseCheckerProvider) sameJSON(x, y []byte, xptr, yptr interface{}) bool // with marshaled+unmarshaled json from xdata and ydata respectively. // // It panics on the first error encountered in the process. -func (p baseCheckerProvider) sameJSONProduced(xdata, ydata, xptr, yptr interface{}) bool { - mustMarshal := func(in interface{}) []byte { +func (p baseCheckerProvider) sameJSONProduced(xdata, ydata, xptr, yptr any) bool { + mustMarshal := func(in any) []byte { b, err := json.Marshal(in) if err != nil { panic(err) @@ -56,15 +57,15 @@ func (p baseCheckerProvider) formatList(values []string) string { return b.String() } -func (p baseCheckerProvider) deq(a, b interface{}) bool { +func (p baseCheckerProvider) deq(a, b any) bool { return reflect.DeepEqual(a, b) } -func (baseCheckerProvider) explain(label string, exp, got interface{}) string { +func (baseCheckerProvider) explain(label string, exp, got any) string { return fmtexpl.Default(label, exp, got) } -func (p baseCheckerProvider) explainNot(label string, exp, got interface{}) string { +func (p baseCheckerProvider) explainNot(label string, exp, got any) string { return p.explain(label, fmt.Sprintf("not %v", exp), got) } @@ -75,36 +76,36 @@ func (p baseCheckerProvider) explainCheck(label, expStr, gotExpl string) string type baseHTTPCheckerProvider struct{ baseCheckerProvider } func (p baseHTTPCheckerProvider) explainContentLengthFunc( - c IntChecker, + c check.Checker[int], got func() int, -) ExplainFunc { - return func(label string, _ interface{}) string { +) check.ExplainFunc { + return func(label string, _ any) string { return p.explainCheck(label, - "content length to pass IntChecker", + "content length to pass Checker[int]", c.Explain("content length", got()), ) } } func (p baseHTTPCheckerProvider) explainHeaderFunc( - c HTTPHeaderChecker, + c check.Checker[http.Header], got func() http.Header, -) ExplainFunc { - return func(label string, _ interface{}) string { +) check.ExplainFunc { + return func(label string, _ any) string { return p.explainCheck(label, - "header to pass HTTPHeaderChecker", + "header to pass Checker[http.Header]", c.Explain("http.Header", got()), ) } } func (p baseHTTPCheckerProvider) explainBodyFunc( - c BytesChecker, + c check.Checker[[]byte], got func() []byte, -) ExplainFunc { - return func(label string, _ interface{}) string { +) check.ExplainFunc { + return func(label string, _ any) string { return p.explainCheck(label, - "body to pass BytesChecker", + "body to pass Checker[[]byte]", c.Explain("bytes", got()), ) } diff --git a/check/providers_base_internal_test.go b/internal/providers/providers_base_internal_test.go similarity index 82% rename from check/providers_base_internal_test.go rename to internal/providers/providers_base_internal_test.go index 6963f94..bd1f3b3 100644 --- a/check/providers_base_internal_test.go +++ b/internal/providers/providers_base_internal_test.go @@ -1,4 +1,4 @@ -package check +package providers import ( "testing" @@ -14,7 +14,7 @@ func TestBaseCheckerProvider_sameJSON(t *testing.T) { ) t.Run("bad dst type", func(t *testing.T) { - var x map[string]interface{} + var x map[string]any var y int defer testutil.AssertPanicMessage(t, "json: cannot unmarshal object into Go value of type int", @@ -25,14 +25,14 @@ func TestBaseCheckerProvider_sameJSON(t *testing.T) { }) t.Run("same json", func(t *testing.T) { - var x, y map[string]interface{} + var x, y map[string]any if !(baseCheckerProvider{}).sameJSON(borig, bsame, &x, &y) { t.Error("exp true, got false", x, y) } }) t.Run("diff json", func(t *testing.T) { - var x, y map[string]interface{} + var x, y map[string]any if (baseCheckerProvider{}).sameJSON(borig, bdiff, &x, &y) { t.Error("exp false, got true") } @@ -45,26 +45,26 @@ func TestBaseCheckerProvider_sameJSONProduced(t *testing.T) { ID int `json:"id"` Name string `json:"name"` }{ID: 42, Name: "Marcel Patulacci"} - same = map[string]interface{}{"id": 42, "name": "Marcel Patulacci"} - diff = map[string]interface{}{"id": 42, "name": "Robert Robichet"} + same = map[string]any{"id": 42, "name": "Marcel Patulacci"} + diff = map[string]any{"id": 42, "name": "Robert Robichet"} ) t.Run("same json produced", func(t *testing.T) { - var x, y map[string]interface{} + var x, y map[string]any if !(baseCheckerProvider{}).sameJSONProduced(orig, same, &x, &y) { t.Error("exp true, got false", x, y) } }) t.Run("diff json produced", func(t *testing.T) { - var x, y map[string]interface{} + var x, y map[string]any if (baseCheckerProvider{}).sameJSONProduced(orig, diff, &x, &y) { t.Error("exp false, got true") } }) t.Run("bad input", func(t *testing.T) { - var x, y map[string]interface{} + var x, y map[string]any badinput := make(chan int) defer testutil.AssertPanicMessage(t, "json: unsupported type: chan int", diff --git a/check/providers_bytes.go b/internal/providers/providers_bytes.go similarity index 54% rename from check/providers_bytes.go rename to internal/providers/providers_bytes.go index 97e41bb..783a725 100644 --- a/check/providers_bytes.go +++ b/internal/providers/providers_bytes.go @@ -1,25 +1,27 @@ -package check +package providers import ( "bytes" "encoding/json" "fmt" + + check "github.com/drykit-go/testx/internal/checktypes" ) -// bytesCheckerProvider provides checks on type []byte. -type bytesCheckerProvider struct{ baseCheckerProvider } +// BytesCheckerProvider provides checks on type []byte. +type BytesCheckerProvider struct{ baseCheckerProvider } // Is checks the gotten []byte is equal to the target. -func (p bytesCheckerProvider) Is(tar []byte) BytesChecker { +func (p BytesCheckerProvider) Is(tar []byte) check.Checker[[]byte] { pass := func(got []byte) bool { return p.eq(got, tar) } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explain(label, tar, got) } - return NewBytesChecker(pass, expl) + return check.NewChecker(pass, expl) } // Not checks the gotten []byte is not equal to the target. -func (p bytesCheckerProvider) Not(values ...[]byte) BytesChecker { +func (p BytesCheckerProvider) Not(values ...[]byte) check.Checker[[]byte] { match := []byte{} pass := func(got []byte) bool { for _, v := range values { @@ -30,76 +32,76 @@ func (p bytesCheckerProvider) Not(values ...[]byte) BytesChecker { } return true } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explainNot(label, match, got) } - return NewBytesChecker(pass, expl) + return check.NewChecker(pass, expl) } // SameJSON checks the gotten []byte and the target read as the same // JSON value, ignoring formatting and keys order. -func (p bytesCheckerProvider) SameJSON(tar []byte) BytesChecker { - var decGot, decTar interface{} +func (p BytesCheckerProvider) SameJSON(tar []byte) check.Checker[[]byte] { + var decGot, decTar any pass := func(got []byte) bool { return p.sameJSON(got, tar, &decGot, &decTar) } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explain(label, fmt.Sprintf("json data: %v", decTar), fmt.Sprintf("json data: %v", decGot), ) } - return NewBytesChecker(pass, expl) + return check.NewChecker(pass, expl) } // Len checks the gotten []byte's length passes the provided -// IntChecker. -func (p bytesCheckerProvider) Len(c IntChecker) BytesChecker { +// Checker[int]. +func (p BytesCheckerProvider) Len(c check.Checker[int]) check.Checker[[]byte] { pass := func(got []byte) bool { return c.Pass(len(got)) } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explainCheck(label, - "length to pass IntChecker", + "length to pass Checker[int]", c.Explain("length", len(got.([]byte))), ) } - return NewBytesChecker(pass, expl) + return check.NewChecker(pass, expl) } // Contains checks the gotten []byte contains a specific subslice. -func (p bytesCheckerProvider) Contains(subslice []byte) BytesChecker { +func (p BytesCheckerProvider) Contains(subslice []byte) check.Checker[[]byte] { pass := func(got []byte) bool { return bytes.Contains(got, subslice) } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explain(label, fmt.Sprintf("to contain subslice %v", subslice), got, ) } - return NewBytesChecker(pass, expl) + return check.NewChecker(pass, expl) } // NotContains checks the gotten []byte contains a specific subslice. -func (p bytesCheckerProvider) NotContains(subslice []byte) BytesChecker { +func (p BytesCheckerProvider) NotContains(subslice []byte) check.Checker[[]byte] { pass := func(got []byte) bool { return !bytes.Contains(got, subslice) } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explainNot(label, fmt.Sprintf("to contain subslice %v", subslice), got, ) } - return NewBytesChecker(pass, expl) + return check.NewChecker(pass, expl) } // AsMap checks the gotten []byte passes the given mapChecker -// once json-unmarshaled to a map[string]interface{}. +// once json-unmarshaled to a map[string]any. // It fails if it is not a valid JSON. -func (p bytesCheckerProvider) AsMap(mapChecker ValueChecker) BytesChecker { - var m map[string]interface{} +func (p BytesCheckerProvider) AsMap(mapChecker check.Checker[map[string]any]) check.Checker[[]byte] { + var m map[string]any var goterr error pass := func(got []byte) bool { goterr = json.NewDecoder(bytes.NewReader(got)).Decode(&m) return goterr == nil && mapChecker.Pass(m) } - expl := func(label string, _ interface{}) string { + expl := func(label string, _ any) string { if goterr != nil { return p.explain(label, "to pass MapChecker", @@ -111,26 +113,26 @@ func (p bytesCheckerProvider) AsMap(mapChecker ValueChecker) BytesChecker { mapChecker.Explain("json map", m), ) } - return NewBytesChecker(pass, expl) + return check.NewChecker(pass, expl) } -// AsString checks the gotten []byte passes the given StringChecker +// AsString checks the gotten []byte passes the given Checker[string] // once converted to a string. -func (p bytesCheckerProvider) AsString(c StringChecker) BytesChecker { +func (p BytesCheckerProvider) AsString(c check.Checker[string]) check.Checker[[]byte] { var s string pass := func(got []byte) bool { s = string(got) return c.Pass(s) } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explainCheck(label, - "to pass StringChecker", + "to pass Checker[string]", c.Explain("converted bytes", s), ) } - return NewBytesChecker(pass, expl) + return check.NewChecker(pass, expl) } -func (bytesCheckerProvider) eq(a, b []byte) bool { +func (BytesCheckerProvider) eq(a, b []byte) bool { return bytes.Equal(a, b) } diff --git a/internal/providers/providers_bytes_test.go b/internal/providers/providers_bytes_test.go new file mode 100644 index 0000000..e0da366 --- /dev/null +++ b/internal/providers/providers_bytes_test.go @@ -0,0 +1,170 @@ +package providers_test + +import ( + "encoding/json" + "fmt" + "testing" + + "github.com/drykit-go/testx/check" + "github.com/drykit-go/testx/internal/providers" +) + +func TestBytesCheckerProvider(t *testing.T) { + checkBytes := providers.BytesCheckerProvider{} + + var ( + b = []byte(`{"id":42,"name":"Marcel Patulacci"}`) + sub = []byte(`"id":42`) + diff = []byte(`{"id":43,"name":"Robert Robichet"}`) + eqJSON = []byte("{\n\"id\": 42,\n\n\n \"name\":\"Marcel Patulacci\" } ") + ) + + mapof := func(b []byte) (m map[string]any) { + json.Unmarshal(b, &m) //nolint:errcheck + return + } + + t.Run("Is pass", func(t *testing.T) { + c := checkBytes.Is(b) + assertPassChecker(t, "Bytes.Is", c, b) + }) + + t.Run("Is fail", func(t *testing.T) { + c := checkBytes.Is(diff) + assertFailChecker(t, "Bytes.Is", c, b, makeExpl( + fmt.Sprint(diff), + fmt.Sprint(b), + )) + }) + + t.Run("Not pass", func(t *testing.T) { + c := checkBytes.Not(diff, eqJSON) + assertPassChecker(t, "Bytes.Not", c, b) + }) + + t.Run("Not fail", func(t *testing.T) { + c := checkBytes.Not(diff, eqJSON, b) + assertFailChecker(t, "Bytes.Not", c, b, makeExpl( + fmt.Sprintf("not %v", b), + fmt.Sprint(b), + )) + }) + + t.Run("Len pass", func(t *testing.T) { + c := checkBytes.Len(check.Int.Is(len(b))) + assertPassChecker(t, "Bytes.Len", c, b) + }) + + t.Run("Len fail", func(t *testing.T) { + gotlen := len(b) + explen := gotlen + 1 + c := checkBytes.Len(check.Int.Is(explen)) + assertFailChecker(t, "Bytes.Len", c, b, makeExpl( + "length to pass Checker[int]", + "explanation: length:\n"+makeExpl( + fmt.Sprint(explen), + fmt.Sprint(gotlen), + ), + )) + }) + + t.Run("SameJSON pass", func(t *testing.T) { + c := checkBytes.SameJSON(eqJSON) + assertPassChecker(t, "Bytes.SameJSON", c, b) + c = checkBytes.SameJSON(b) + assertPassChecker(t, "Bytes.SameJSON", c, b) + }) + + t.Run("SameJSON fail", func(t *testing.T) { + c := checkBytes.SameJSON(diff) + assertFailChecker(t, "Bytes.SameJSON", c, b, makeExpl( + fmt.Sprintf("json data: %v", mapof(diff)), + fmt.Sprintf("json data: %v", mapof(b)), + )) + }) + + t.Run("Contains pass", func(t *testing.T) { + c := checkBytes.Contains(sub) + assertPassChecker(t, "Bytes.Contains", c, b) + c = checkBytes.Contains(b) + assertPassChecker(t, "Bytes.Contains", c, b) + }) + + t.Run("Contains fail", func(t *testing.T) { + c := checkBytes.Contains(diff) + assertFailChecker(t, "Bytes.Contains", c, b, + makeExpl( + fmt.Sprintf("to contain subslice %v", diff), + fmt.Sprint(b), + ), + ) + + c = checkBytes.Contains(eqJSON) + assertFailChecker(t, "Bytes.Contains", c, b, + makeExpl( + fmt.Sprintf("to contain subslice %v", eqJSON), + fmt.Sprint(b), + ), + ) + }) + + t.Run("NotContains pass", func(t *testing.T) { + c := checkBytes.NotContains(diff) + assertPassChecker(t, "Bytes.NotContains", c, b) + c = checkBytes.NotContains(eqJSON) + assertPassChecker(t, "Bytes.NotContains", c, b) + }) + + t.Run("NotContains fail", func(t *testing.T) { + c := checkBytes.NotContains(sub) + assertFailChecker(t, "Bytes.NotContains", c, b, makeExpl( + fmt.Sprintf("not to contain subslice %v", sub), + fmt.Sprint(b), + )) + + c = checkBytes.NotContains(b) + assertFailChecker(t, "Bytes.NotContains", c, b, makeExpl( + fmt.Sprintf("not to contain subslice %v", b), + fmt.Sprint(b), + )) + }) + + t.Run("AsMap pass", func(t *testing.T) { + c := checkBytes.AsMap(check.Map[string, any]().HasKeys("id")) + assertPassChecker(t, "Bytes.AsMap", c, b) + assertPassChecker(t, "Bytes.AsMap", c, eqJSON) + }) + + t.Run("AsMap fail", func(t *testing.T) { + c := checkBytes.AsMap(check.Map[string, any]().HasKeys("id", "nomatch")) + assertFailChecker(t, "Bytes.AsMap", c, b, makeExpl( + "to pass MapChecker", + "explanation: json map:\n"+makeExpl( + "to have keys [nomatch]", + fmt.Sprint(mapof(b)), + ), + )) + + c = checkBytes.AsMap(check.Map[string, any]().HasKeys("id")) + assertFailChecker(t, "Bytes.AsMap", c, sub, makeExpl( + "to pass MapChecker", + "error: json: cannot unmarshal string into Go value of type map[string]interface {}", + )) + }) + + t.Run("AsString pass", func(t *testing.T) { + c := checkBytes.AsString(check.String.Is(string(b))) + assertPassChecker(t, "Bytes.AsString", c, b) + }) + + t.Run("AsString fail", func(t *testing.T) { + c := checkBytes.AsString(check.String.Is(string(diff))) + assertFailChecker(t, "Bytes.AsString", c, b, makeExpl( + "to pass Checker[string]", + "explanation: converted bytes:\n"+makeExpl( + string(diff), + string(b), + ), + )) + }) +} diff --git a/check/providers_context.go b/internal/providers/providers_context.go similarity index 59% rename from check/providers_context.go rename to internal/providers/providers_context.go index c4269df..26aa5cd 100644 --- a/check/providers_context.go +++ b/internal/providers/providers_context.go @@ -1,34 +1,36 @@ -package check +package providers import ( "context" "fmt" "github.com/drykit-go/cond" + + check "github.com/drykit-go/testx/internal/checktypes" ) -// contextCheckerProvider provides checks on type context.Context. -type contextCheckerProvider struct{ baseCheckerProvider } +// ContextCheckerProvider provides checks on type context.Context. +type ContextCheckerProvider struct{ baseCheckerProvider } // Done checks the gotten context is done. -func (p contextCheckerProvider) Done(expectDone bool) ContextChecker { +func (p ContextCheckerProvider) Done(expectDone bool) check.Checker[context.Context] { var err error done := func() bool { return err != nil } pass := func(got context.Context) bool { err = got.Err() return done() == expectDone } - expl := func(label string, _ interface{}) string { + expl := func(label string, _ any) string { notString := cond.String("", "not ", expectDone) expString := fmt.Sprintf("context %sto be done", notString) gotString := cond.String(fmt.Sprint(err), "context not done", done()) return p.explain(label, expString, gotString) } - return NewContextChecker(pass, expl) + return check.NewChecker(pass, expl) } // HasKeys checks the gotten context has the given keys set. -func (p contextCheckerProvider) HasKeys(keys ...interface{}) ContextChecker { +func (p ContextCheckerProvider) HasKeys(keys ...any) check.Checker[context.Context] { var missing []string pass := func(got context.Context) bool { for _, expk := range keys { @@ -39,13 +41,13 @@ func (p contextCheckerProvider) HasKeys(keys ...interface{}) ContextChecker { } return len(missing) == 0 } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explain(label, "to have keys "+p.formatList(missing), "keys not set", ) } - return NewContextChecker(pass, expl) + return check.NewChecker(pass, expl) } // Value checks the gotten context's value for the given key passes @@ -53,18 +55,18 @@ func (p contextCheckerProvider) HasKeys(keys ...interface{}) ContextChecker { // // Examples: // Context.Value("userID", Value.Is("abcde")) -// Context.Value("userID", checkconv.Assert(String.Contains("abc"))) -func (p contextCheckerProvider) Value(key interface{}, c ValueChecker) ContextChecker { - var v interface{} +// Context.Value("userID", Wrap(String.Contains("abc"))) +func (p ContextCheckerProvider) Value(key any, c check.Checker[any]) check.Checker[context.Context] { + var v any pass := func(got context.Context) bool { v = got.Value(key) return v != nil && c.Pass(v) } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explainCheck(label, - fmt.Sprintf("value for key %v to pass ValueChecker", key), + fmt.Sprintf("value for key %v to pass Checker[any]", key), c.Explain("value", v), ) } - return NewContextChecker(pass, expl) + return check.NewChecker(pass, expl) } diff --git a/internal/providers/providers_context_test.go b/internal/providers/providers_context_test.go new file mode 100644 index 0000000..c41d97c --- /dev/null +++ b/internal/providers/providers_context_test.go @@ -0,0 +1,90 @@ +package providers_test + +import ( + "context" + "testing" + + "github.com/drykit-go/testx/check" + "github.com/drykit-go/testx/internal/providers" +) + +func TestContextCheckerProvider(t *testing.T) { + checkContext := providers.ContextCheckerProvider{} + + ctxNotDone := func() (context.Context, context.CancelFunc) { + return context.WithCancel(context.Background()) + } + ctxDone := func() context.Context { + ctx, cancel := ctxNotDone() + cancel() + return ctx + } + ctxVal := func(key, val any) context.Context { + return context.WithValue(context.Background(), key, val) + } + + t.Run("Done pass", func(t *testing.T) { + checkDone := checkContext.Done(true) + ctxDone := ctxDone() + assertPassChecker(t, "Context.Done", checkDone, ctxDone) + + checkNotDone := checkContext.Done(false) + ctxNotDone, cancel := ctxNotDone() + assertPassChecker(t, "Context.Done", checkNotDone, ctxNotDone) + cancel() + }) + + t.Run("Done fail", func(t *testing.T) { + checkDone := checkContext.Done(true) + ctxNotDone, cancel := ctxNotDone() + assertFailChecker(t, "Context.Done", checkDone, ctxNotDone, makeExpl( + "context to be done", + "context not done", + )) + cancel() + + checkNotDone := checkContext.Done(false) + ctxDone := ctxDone() + assertFailChecker(t, "Context.Done", checkNotDone, ctxDone, makeExpl( + "context not to be done", + "context canceled", + )) + }) + + t.Run("HasKeys pass", func(t *testing.T) { + c := checkContext.HasKeys("user") + ctx := ctxVal("user", struct{}{}) + assertPassChecker(t, "Context.HasKeys", c, ctx) + }) + + t.Run("HasKeys fail", func(t *testing.T) { + c := checkContext.HasKeys("secret", "user", "token") + ctx := ctxVal("user", struct{}{}) + assertFailChecker(t, "Context.HasKeys", c, ctx, makeExpl( + "to have keys [secret, token]", + "keys not set", + )) + }) + + t.Run("Value pass", func(t *testing.T) { + c := checkContext.Value("userID", check.Wrap[int](check.Int.GT(0))) + ctx := ctxVal("userID", 42) + assertPassChecker(t, "Context.Value", c, ctx) + }) + + t.Run("Value fail", func(t *testing.T) { + c := checkContext.Value("userID", check.Value[any]().Is(0)) + + ctxMissingKey := context.Background() + assertFailChecker(t, "Context.Value", c, ctxMissingKey, makeExpl( + "value for key userID to pass Checker[any]", + "explanation: value:\n"+makeExpl("0", ""), + )) + + ctxBadValue := ctxVal("userID", -1) + assertFailChecker(t, "Context.Value", c, ctxBadValue, makeExpl( + "value for key userID to pass Checker[any]", + "explanation: value:\n"+makeExpl("0", "-1"), + )) + }) +} diff --git a/check/providers_duration.go b/internal/providers/providers_duration.go similarity index 54% rename from check/providers_duration.go rename to internal/providers/providers_duration.go index 3d9c2e9..0bac3ad 100644 --- a/check/providers_duration.go +++ b/internal/providers/providers_duration.go @@ -1,72 +1,74 @@ -package check +package providers import ( "fmt" "time" + + check "github.com/drykit-go/testx/internal/checktypes" ) -// durationCheckerProvider provides checks on type time.Duration. -type durationCheckerProvider struct{ baseCheckerProvider } +// DurationCheckerProvider provides checks on type time.Duration. +type DurationCheckerProvider struct{ baseCheckerProvider } // Over checks the gotten time.Duration is over the target duration. -func (p durationCheckerProvider) Over(tar time.Duration) DurationChecker { +func (p DurationCheckerProvider) Over(tar time.Duration) check.Checker[time.Duration] { pass := func(got time.Duration) bool { return p.ns(got) > p.ns(tar) } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explain(label, fmt.Sprintf("over %vms", p.ms(tar)), fmt.Sprintf("%vms", p.ms(got.(time.Duration))), ) } - return NewDurationChecker(pass, expl) + return check.NewChecker(pass, expl) } // Under checks the gotten time.Duration is under the target duration. -func (p durationCheckerProvider) Under(tar time.Duration) DurationChecker { +func (p DurationCheckerProvider) Under(tar time.Duration) check.Checker[time.Duration] { pass := func(got time.Duration) bool { return p.ns(got) < p.ns(tar) } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explain(label, fmt.Sprintf("under %vms", p.ms(tar)), fmt.Sprintf("%vms", p.ms(got.(time.Duration))), ) } - return NewDurationChecker(pass, expl) + return check.NewChecker(pass, expl) } // InRange checks the gotten time.Duration is in range [lo:hi] -func (p durationCheckerProvider) InRange(lo, hi time.Duration) DurationChecker { +func (p DurationCheckerProvider) InRange(lo, hi time.Duration) check.Checker[time.Duration] { pass := func(got time.Duration) bool { return p.inrange(got, lo, hi) } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explain(label, fmt.Sprintf("in range [%vms:%vms]", p.ms(lo), p.ms(hi)), fmt.Sprintf("%vms", p.ms(got.(time.Duration))), ) } - return NewDurationChecker(pass, expl) + return check.NewChecker(pass, expl) } // OutRange checks the gotten time.Duration is not in range [lo:hi] -func (p durationCheckerProvider) OutRange(lo, hi time.Duration) DurationChecker { +func (p DurationCheckerProvider) OutRange(lo, hi time.Duration) check.Checker[time.Duration] { pass := func(got time.Duration) bool { return !p.inrange(got, lo, hi) } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explain(label, fmt.Sprintf("not in range [%vms:%vms]", p.ms(lo), p.ms(hi)), fmt.Sprintf("%vms", p.ms(got.(time.Duration))), ) } - return NewDurationChecker(pass, expl) + return check.NewChecker(pass, expl) } // Helpers -func (p durationCheckerProvider) inrange(d, lo, hi time.Duration) bool { +func (p DurationCheckerProvider) inrange(d, lo, hi time.Duration) bool { nsd, nslo, nshi := p.ns(d), p.ns(lo), p.ns(hi) return nslo <= nsd && nsd <= nshi } -func (durationCheckerProvider) ms(d time.Duration) int64 { +func (DurationCheckerProvider) ms(d time.Duration) int64 { return d.Milliseconds() } -func (durationCheckerProvider) ns(d time.Duration) int64 { +func (DurationCheckerProvider) ns(d time.Duration) int64 { return d.Nanoseconds() } diff --git a/internal/providers/providers_duration_test.go b/internal/providers/providers_duration_test.go new file mode 100644 index 0000000..d609f90 --- /dev/null +++ b/internal/providers/providers_duration_test.go @@ -0,0 +1,106 @@ +package providers_test + +import ( + "fmt" + "testing" + "time" + + "github.com/drykit-go/testx/internal/providers" +) + +func TestDurationCheckerProvider(t *testing.T) { + checkDuration := providers.DurationCheckerProvider{} + + const ( + d = 1 * time.Second + less = d - time.Millisecond + more = d + time.Millisecond + moremore = more + time.Millisecond + ) + + ms := func(d time.Duration) int64 { + return d.Milliseconds() + } + + t.Run("Under pass", func(t *testing.T) { + c := checkDuration.Under(more) + assertPassChecker(t, "Duration.Under", c, d) + }) + + t.Run("Under fail", func(t *testing.T) { + c := checkDuration.Under(less) + assertFailChecker(t, "Duration.Under", c, d, makeExpl( + fmt.Sprintf("under %dms", ms(less)), + fmt.Sprintf("%dms", ms(d)), + )) + + c = checkDuration.Under(d) + assertFailChecker(t, "Duration.Under", c, d, makeExpl( + fmt.Sprintf("under %dms", ms(d)), + fmt.Sprintf("%dms", ms(d)), + )) + }) + + t.Run("Over pass", func(t *testing.T) { + c := checkDuration.Over(less) + assertPassChecker(t, "Duration.Over", c, d) + }) + + t.Run("Over fail", func(t *testing.T) { + c := checkDuration.Over(more) + assertFailChecker(t, "Duration.Over", c, d, makeExpl( + fmt.Sprintf("over %dms", ms(more)), + fmt.Sprintf("%dms", ms(d)), + )) + + c = checkDuration.Over(d) + assertFailChecker(t, "Duration.Over", c, d, makeExpl( + fmt.Sprintf("over %dms", ms(d)), + fmt.Sprintf("%dms", ms(d)), + )) + }) + + t.Run("InRange pass", func(t *testing.T) { + c := checkDuration.InRange(less, more) + assertPassChecker(t, "Duration.InRange", c, d) + + c = checkDuration.InRange(d, d) + assertPassChecker(t, "Duration.InRange", c, d) + }) + + t.Run("InRange fail", func(t *testing.T) { + c := checkDuration.InRange(more, moremore) + assertFailChecker(t, "Duration.InRange", c, d, makeExpl( + fmt.Sprintf("in range [%dms:%dms]", ms(more), ms(moremore)), + fmt.Sprintf("%dms", ms(d)), + )) + + c = checkDuration.InRange(more, less) + assertFailChecker(t, "Duration.InRange", c, d, makeExpl( + fmt.Sprintf("in range [%dms:%dms]", ms(more), ms(less)), + fmt.Sprintf("%dms", ms(d)), + )) + }) + + t.Run("OutRange pass", func(t *testing.T) { + c := checkDuration.OutRange(more, moremore) + assertPassChecker(t, "Duration.OutRange", c, d) + + c = checkDuration.OutRange(more, less) + assertPassChecker(t, "Duration.OutRange", c, d) + }) + + t.Run("OutRange fail", func(t *testing.T) { + c := checkDuration.OutRange(less, more) + assertFailChecker(t, "Duration.OutRange", c, d, makeExpl( + fmt.Sprintf("not in range [%dms:%dms]", ms(less), ms(more)), + fmt.Sprintf("%dms", ms(d)), + )) + + c = checkDuration.OutRange(d, d) + assertFailChecker(t, "Duration.OutRange", c, d, makeExpl( + fmt.Sprintf("not in range [%dms:%dms]", ms(d), ms(d)), + fmt.Sprintf("%dms", ms(d)), + )) + }) +} diff --git a/check/providers_httpheader.go b/internal/providers/providers_httpheader.go similarity index 55% rename from check/providers_httpheader.go rename to internal/providers/providers_httpheader.go index 330d7cd..76c0510 100644 --- a/check/providers_httpheader.go +++ b/internal/providers/providers_httpheader.go @@ -1,58 +1,60 @@ -package check +package providers import ( "fmt" "net/http" + + check "github.com/drykit-go/testx/internal/checktypes" ) -// httpHeaderCheckerProvider provides checks on type http.Header. -type httpHeaderCheckerProvider struct{ baseCheckerProvider } +// HTTPHeaderCheckerProvider provides checks on type http.Header. +type HTTPHeaderCheckerProvider struct{ baseCheckerProvider } // HasKey checks the gotten http.Header has a specific key set. // The corresponding value is ignored, meaning an empty value // for that key passes the check. -func (p httpHeaderCheckerProvider) HasKey(key string) HTTPHeaderChecker { +func (p HTTPHeaderCheckerProvider) HasKey(key string) check.Checker[http.Header] { pass := func(got http.Header) bool { return p.hasKey(got, key) } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explain(label, `to have key "`+key+`"`, got) } - return NewHTTPHeaderChecker(pass, expl) + return check.NewChecker(pass, expl) } // HasNotKey checks the gotten http.Header does not have // a specific key set. -func (p httpHeaderCheckerProvider) HasNotKey(key string) HTTPHeaderChecker { +func (p HTTPHeaderCheckerProvider) HasNotKey(key string) check.Checker[http.Header] { pass := func(got http.Header) bool { return !p.hasKey(got, key) } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explainNot(label, `to have key "`+key+`"`, got) } - return NewHTTPHeaderChecker(pass, expl) + return check.NewChecker(pass, expl) } // HasValue checks the gotten http.Header has any value equal to val. // It only compares the first result for each key. -func (p httpHeaderCheckerProvider) HasValue(val string) HTTPHeaderChecker { +func (p HTTPHeaderCheckerProvider) HasValue(val string) check.Checker[http.Header] { pass := func(got http.Header) bool { return p.hasValue(got, val) } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explain(label, "to have value "+val, got) } - return NewHTTPHeaderChecker(pass, expl) + return check.NewChecker(pass, expl) } // HasNotValue checks the gotten http.Header does not have a value equal to val. // It only compares the first result for each key. -func (p httpHeaderCheckerProvider) HasNotValue(val string) HTTPHeaderChecker { +func (p HTTPHeaderCheckerProvider) HasNotValue(val string) check.Checker[http.Header] { pass := func(got http.Header) bool { return !p.hasValue(got, val) } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explainNot(label, "to have value "+val, got) } - return NewHTTPHeaderChecker(pass, expl) + return check.NewChecker(pass, expl) } // CheckValue checks the gotten http.Header has a value for the matching key -// that passes the given StringChecker. +// that passes the given Checker[string]. // It only checks the first result for the given key. -func (p httpHeaderCheckerProvider) CheckValue(key string, c StringChecker) HTTPHeaderChecker { +func (p HTTPHeaderCheckerProvider) CheckValue(key string, c check.Checker[string]) check.Checker[http.Header] { var val string pass := func(got http.Header) bool { v, ok := p.get(got, key) @@ -62,18 +64,18 @@ func (p httpHeaderCheckerProvider) CheckValue(key string, c StringChecker) HTTPH val = v return c.Pass(v) } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explainCheck(label, - fmt.Sprintf(`value for key "%s" to pass StringChecker`, key), + fmt.Sprintf(`value for key "%s" to pass Checker[string]`, key), c.Explain(`http.Header["`+key+`"]`, val), ) } - return NewHTTPHeaderChecker(pass, expl) + return check.NewChecker(pass, expl) } // Helpers -func (httpHeaderCheckerProvider) get(h http.Header, key string) (string, bool) { +func (HTTPHeaderCheckerProvider) get(h http.Header, key string) (string, bool) { values, ok := h[key] if !ok || len(values) == 0 { return "", false @@ -81,12 +83,12 @@ func (httpHeaderCheckerProvider) get(h http.Header, key string) (string, bool) { return values[0], true } -func (httpHeaderCheckerProvider) hasKey(h http.Header, key string) bool { +func (HTTPHeaderCheckerProvider) hasKey(h http.Header, key string) bool { _, ok := h[key] return ok } -func (httpHeaderCheckerProvider) hasValue(h http.Header, val string) bool { +func (HTTPHeaderCheckerProvider) hasValue(h http.Header, val string) bool { for _, values := range h { if len(values) == 0 { continue diff --git a/internal/providers/providers_httpheader_test.go b/internal/providers/providers_httpheader_test.go new file mode 100644 index 0000000..21483c7 --- /dev/null +++ b/internal/providers/providers_httpheader_test.go @@ -0,0 +1,96 @@ +package providers_test + +import ( + "fmt" + "net/http" + "testing" + + "github.com/drykit-go/testx/check" + "github.com/drykit-go/testx/internal/providers" +) + +func TestHTTPHeaderCheckerProvider(t *testing.T) { + checkHTTPHeader := providers.HTTPHeaderCheckerProvider{} + + h := http.Header{ + "Content-Length": []string{"42"}, + "API_KEY": []string{"secret0", "secret1"}, + } + hstr := fmt.Sprint(h) + + t.Run("HasKey pass", func(t *testing.T) { + c := checkHTTPHeader.HasKey("API_KEY") + assertPassChecker(t, "HTTPHeader.HasKey", c, h) + }) + + t.Run("HasKey fail", func(t *testing.T) { + c := checkHTTPHeader.HasKey("password") + assertFailChecker(t, "HTTPHeader.HasKey", c, h, + makeExpl(`to have key "password"`, hstr), + ) + }) + + t.Run("HasNotKey pass", func(t *testing.T) { + c := checkHTTPHeader.HasNotKey("password") + assertPassChecker(t, "HTTPHeader.HasNotKey", c, h) + }) + + t.Run("HasNotKey fail", func(t *testing.T) { + c := checkHTTPHeader.HasNotKey("API_KEY") + assertFailChecker(t, "HTTPHeader.HasNotKey", c, h, + makeExpl(`not to have key "API_KEY"`, hstr), + ) + }) + + t.Run("HasValue pass", func(t *testing.T) { + c := checkHTTPHeader.HasValue("42") + assertPassChecker(t, "HTTPHeader.HasValue", c, h) + c = checkHTTPHeader.HasValue("secret0") + assertPassChecker(t, "HTTPHeader.HasValue", c, h) + }) + + t.Run("HasValue fail", func(t *testing.T) { + c := checkHTTPHeader.HasValue("secret42") + assertFailChecker(t, "HTTPHeader.HasValue", c, h, + makeExpl(`to have value secret42`, hstr), + ) + + c = checkHTTPHeader.HasValue("secret1") + assertFailChecker(t, "HTTPHeader.HasValue", c, h, + makeExpl(`to have value secret1`, hstr), + ) + }) + + t.Run("HasNotValue pass", func(t *testing.T) { + c := checkHTTPHeader.HasNotValue("secret42") + assertPassChecker(t, "HTTPHeader.HasNotValue", c, h) + }) + + t.Run("HasNotValue fail", func(t *testing.T) { + c := checkHTTPHeader.HasNotValue("42") + assertFailChecker(t, "HTTPHeader.HasNotValue", c, h, + makeExpl(`not to have value 42`, hstr), + ) + + c = checkHTTPHeader.HasNotValue("secret0") + assertFailChecker(t, "HTTPHeader.HasNotValue", c, h, + makeExpl(`not to have value secret0`, hstr), + ) + }) + + t.Run("CheckValue pass", func(t *testing.T) { + c := checkHTTPHeader.CheckValue("API_KEY", check.String.Is("secret0")) + assertPassChecker(t, "HTTPHeader.CheckValue", c, h) + }) + + t.Run("CheckValue fail", func(t *testing.T) { + c := checkHTTPHeader.CheckValue("API_KEY", check.String.Not("secret0")) + assertFailChecker(t, "HTTPHeader.CheckValue", c, h, makeExpl( + `value for key "API_KEY" to pass Checker[string]`, + `explanation: http.Header["API_KEY"]:`+"\n"+makeExpl( + "not secret0", + "secret0", + ), + )) + }) +} diff --git a/internal/providers/providers_httprequest.go b/internal/providers/providers_httprequest.go new file mode 100644 index 0000000..ac38cf5 --- /dev/null +++ b/internal/providers/providers_httprequest.go @@ -0,0 +1,72 @@ +package providers + +import ( + "context" + "net/http" + + check "github.com/drykit-go/testx/internal/checktypes" + "github.com/drykit-go/testx/internal/ioutil" +) + +// HTTPRequestCheckerProvider provides checks on type *http.Request. +type HTTPRequestCheckerProvider struct{ baseHTTPCheckerProvider } + +// ContentLength checks the gotten *http.Request ContentLength passes +// the input Checker[int]. +func (p HTTPRequestCheckerProvider) ContentLength(c check.Checker[int]) check.Checker[*http.Request] { + var clen int + pass := func(got *http.Request) bool { + clen = int(got.ContentLength) + return c.Pass(clen) + } + expl := func(label string, got any) string { + return p.explainContentLengthFunc(c, func() int { return clen })(label, got) + } + return check.NewChecker(pass, expl) +} + +// Header checks the gotten *http.Request Header passes +// the input Checker[http.Header]. +func (p HTTPRequestCheckerProvider) Header(c check.Checker[http.Header]) check.Checker[*http.Request] { + var header http.Header + pass := func(got *http.Request) bool { + header = got.Header + return c.Pass(header) + } + expl := func(label string, got any) string { + return p.explainHeaderFunc(c, func() http.Header { return header })(label, got) + } + return check.NewChecker(pass, expl) +} + +// Body checks the gotten *http.Request Body passes the input Checker[[]byte]. +// It should be used only once on a same *http.Request as it closes its body +// after reading it. +func (p HTTPRequestCheckerProvider) Body(c check.Checker[[]byte]) check.Checker[*http.Request] { + var body []byte + pass := func(got *http.Request) bool { + body = ioutil.NopRead(&got.Body) + return c.Pass(body) + } + expl := func(label string, got any) string { + return p.explainBodyFunc(c, func() []byte { return body })(label, got) + } + return check.NewChecker(pass, expl) +} + +// Context checks the gotten *http.Request Context passes +// the input Checker[context.Context]. +func (p HTTPRequestCheckerProvider) Context(c check.Checker[context.Context]) check.Checker[*http.Request] { + var ctx context.Context + pass := func(got *http.Request) bool { + ctx = got.Context() + return c.Pass(ctx) + } + expl := func(label string, got any) string { + return p.explainCheck(label, + "context to pass Checker[context.Context]", + c.Explain("context", ctx), + ) + } + return check.NewChecker(pass, expl) +} diff --git a/internal/providers/providers_httprequest_test.go b/internal/providers/providers_httprequest_test.go new file mode 100644 index 0000000..584aa80 --- /dev/null +++ b/internal/providers/providers_httprequest_test.go @@ -0,0 +1,103 @@ +package providers_test + +import ( + "bytes" + "context" + "encoding/json" + "fmt" + "net/http" + "testing" + + "github.com/drykit-go/testx/check" + "github.com/drykit-go/testx/internal/providers" +) + +func TestHTTPRequestCheckerProvider(t *testing.T) { + checkHTTPRequest := providers.HTTPRequestCheckerProvider{} + + newCtx := func(key, val any) context.Context { + return context.WithValue(context.Background(), key, val) + } + newReq := func() *http.Request { + ctx := newCtx("userID", 42) + body, _ := json.Marshal(map[string]any{"answer": 42}) + r, _ := http.NewRequestWithContext(ctx, "GET", "/endpoint?id=42", bytes.NewReader(body)) + r.Header.Set("Content-Type", "application/json") + return r + } + + var ( + expContentLength = 13 + expBody = []byte(`{"answer":42}`) + expCtxKey = "userID" + expCtxVal = 42 + ) + + t.Run("ContentLength pass", func(t *testing.T) { + c := checkHTTPRequest.ContentLength(check.Int.Is(expContentLength)) + assertPassChecker(t, "HTTPRequest.ContentLength", c, newReq()) + }) + + t.Run("ContentLength fail", func(t *testing.T) { + c := checkHTTPRequest.ContentLength(check.Int.Not(expContentLength)) + assertFailChecker(t, "HTTPRequest.ContentLength", c, newReq(), makeExpl( + "content length to pass Checker[int]", + fmt.Sprintf( + "explanation: content length:\nexp not %d\ngot %d", + expContentLength, expContentLength, + ), + )) + }) + + t.Run("Header pass", func(t *testing.T) { + c := checkHTTPRequest.Header(check.HTTPHeader.HasKey("Content-Type")) + assertPassChecker(t, "HTTPRequest.Header", c, newReq()) + }) + + t.Run("Header fail", func(t *testing.T) { + c := checkHTTPRequest.Header(check.HTTPHeader.HasNotKey("Content-Type")) + r := newReq() + assertFailChecker(t, "HTTPRequest.Header", c, r, makeExpl( + "header to pass Checker[http.Header]", + fmt.Sprintf( + "explanation: http.Header:\nexp not to have key \"Content-Type\"\ngot %v", + r.Header, + ), + )) + }) + + t.Run("Body pass", func(t *testing.T) { + c := checkHTTPRequest.Body(check.Bytes.Is(expBody)) + assertPassChecker(t, "HTTPRequest.Body", c, newReq()) + }) + + t.Run("Body fail", func(t *testing.T) { + c := checkHTTPRequest.Body(check.Bytes.Not(expBody)) + assertFailChecker(t, "HTTPRequest.Body", c, newReq(), makeExpl( + "body to pass Checker[[]byte]", + "explanation: bytes:\n"+makeExpl( + "not "+fmt.Sprint(expBody), + fmt.Sprint(expBody), + ), + )) + }) + + t.Run("Context pass", func(t *testing.T) { + c := checkHTTPRequest.Context(check.Context.Value(expCtxKey, check.Value[any]().Is(expCtxVal))) + assertPassChecker(t, "HTTPRequest.Context", c, newReq()) + }) + + t.Run("Context fail", func(t *testing.T) { + c := checkHTTPRequest.Context(check.Context.Value(expCtxKey, check.Value[any]().Not(expCtxVal))) + assertFailChecker(t, "HTTPRequest.Context", c, newReq(), makeExpl( + "context to pass Checker[context.Context]", + "explanation: context:\n"+makeExpl( + "value for key userID to pass Checker[any]", + "explanation: value:\n"+makeExpl( + "not 42", + "42", + ), + ), + )) + }) +} diff --git a/internal/providers/providers_httpresponse.go b/internal/providers/providers_httpresponse.go new file mode 100644 index 0000000..9342767 --- /dev/null +++ b/internal/providers/providers_httpresponse.go @@ -0,0 +1,88 @@ +package providers + +import ( + "net/http" + + check "github.com/drykit-go/testx/internal/checktypes" + "github.com/drykit-go/testx/internal/ioutil" +) + +// HTTPResponseCheckerProvider provides checks on type *http.Response. +type HTTPResponseCheckerProvider struct{ baseHTTPCheckerProvider } + +// StatusCode checks the gotten *http.Response StatusCode passes +// the input Checker[int]. +func (p HTTPResponseCheckerProvider) StatusCode(c check.Checker[int]) check.Checker[*http.Response] { + var code int + pass := func(got *http.Response) bool { + code = got.StatusCode + return c.Pass(code) + } + expl := func(label string, _ any) string { + return p.explainCheck(label, + "status code to pass Checker[int]", + c.Explain("status code", code), + ) + } + return check.NewChecker(pass, expl) +} + +// Status checks the gotten *http.Response Status passes +// the input Checker[string]. +func (p HTTPResponseCheckerProvider) Status(c check.Checker[string]) check.Checker[*http.Response] { + var status string + pass := func(got *http.Response) bool { + status = got.Status + return c.Pass(status) + } + expl := func(label string, _ any) string { + return p.explainCheck(label, + "status to pass Checker[string]", + c.Explain("status", status), + ) + } + return check.NewChecker(pass, expl) +} + +// ContentLength checks the gotten *http.Response ContentLength passes +// the input Checker[int]. +func (p HTTPResponseCheckerProvider) ContentLength(c check.Checker[int]) check.Checker[*http.Response] { + var clen int + pass := func(got *http.Response) bool { + clen = int(got.ContentLength) + return c.Pass(clen) + } + expl := func(label string, got any) string { + return p.explainContentLengthFunc(c, func() int { return clen })(label, got) + } + return check.NewChecker(pass, expl) +} + +// Header checks the gotten *http.Response Header passes +// the input Checker[http.Header]. +func (p HTTPResponseCheckerProvider) Header(c check.Checker[http.Header]) check.Checker[*http.Response] { + var header http.Header + pass := func(got *http.Response) bool { + header = got.Header + return c.Pass(header) + } + expl := func(label string, got any) string { + return p.explainHeaderFunc(c, func() http.Header { return header })(label, got) + } + return check.NewChecker(pass, expl) +} + +// Body checks the gotten *http.Response Body passes the input Checker[[]byte]. +// It should be used only once on a same *http.Response as it closes its body +// after reading it. +func (p HTTPResponseCheckerProvider) Body(c check.Checker[[]byte]) check.Checker[*http.Response] { + var body []byte + pass := func(got *http.Response) bool { + body = ioutil.NopRead(&got.Body) + return c.Pass(body) + } + expl := func(label string, got any) string { + return p.explainBodyFunc(c, func() []byte { return body })(label, got) + } + return check.NewChecker(pass, expl) +} diff --git a/internal/providers/providers_httpresponse_test.go b/internal/providers/providers_httpresponse_test.go new file mode 100644 index 0000000..bf3d43f --- /dev/null +++ b/internal/providers/providers_httpresponse_test.go @@ -0,0 +1,123 @@ +package providers_test + +import ( + "encoding/json" + "fmt" + "net/http" + "net/http/httptest" + "testing" + + "github.com/drykit-go/testx/check" + "github.com/drykit-go/testx/internal/providers" +) + +//nolint:bodyclose +func TestHTTPResponseCheckerProvider(t *testing.T) { + checkHTTPResponse := providers.HTTPResponseCheckerProvider{} + + newResp := func() *http.Response { + rr := httptest.NewRecorder() + rq := httptest.NewRequest("GET", "/", nil) + body, _ := json.Marshal(map[string]any{"answer": 42}) + clen := len(body) + + func(w http.ResponseWriter, _ *http.Request) { + w.WriteHeader(http.StatusTeapot) + w.Header().Set("Content-Type", "application/json") + w.Write(body) + }(rr, rq) + + resp := rr.Result() + resp.Header = rr.Header() + resp.ContentLength = int64(clen) + return resp + } + + var ( + expStatusCode = 418 + expStatus = "418 I'm a teapot" + expContentLength = 13 + expBody = []byte(`{"answer":42}`) + ) + + t.Run("StatusCode pass", func(t *testing.T) { + c := checkHTTPResponse.StatusCode(check.Int.Is(expStatusCode)) + assertPassChecker(t, "HTTPResponse.StatusCode", c, newResp()) + }) + + t.Run("StatusCode fail", func(t *testing.T) { + c := checkHTTPResponse.StatusCode(check.Int.Not(expStatusCode)) + assertFailChecker(t, "HTTPResponse.StatusCode", c, newResp(), makeExpl( + "status code to pass Checker[int]", + "explanation: status code:\n"+makeExpl( + "not "+fmt.Sprint(expStatusCode), + fmt.Sprint(expStatusCode), + ), + )) + }) + + t.Run("Status pass", func(t *testing.T) { + c := checkHTTPResponse.Status(check.String.Is(expStatus)) + assertPassChecker(t, "HTTPResponse.Status", c, newResp()) + }) + + t.Run("Status fail", func(t *testing.T) { + c := checkHTTPResponse.Status(check.String.Not(expStatus)) + assertFailChecker(t, "HTTPResponse.Status", c, newResp(), makeExpl( + "status to pass Checker[string]", + "explanation: status:\n"+makeExpl( + "not "+expStatus, + expStatus, + ), + )) + }) + + t.Run("ContentLength pass", func(t *testing.T) { + c := checkHTTPResponse.ContentLength(check.Int.Is(expContentLength)) + assertPassChecker(t, "HTTPResponse.ContentLength", c, newResp()) + }) + + t.Run("ContentLength fail", func(t *testing.T) { + c := checkHTTPResponse.ContentLength(check.Int.Not(expContentLength)) + assertFailChecker(t, "HTTPResponse.ContentLength", c, newResp(), makeExpl( + "content length to pass Checker[int]", + "explanation: content length:\n"+makeExpl( + "not "+fmt.Sprint(expContentLength), + fmt.Sprint(expContentLength), + ), + )) + }) + + t.Run("Header pass", func(t *testing.T) { + c := checkHTTPResponse.Header(check.HTTPHeader.HasKey("Content-Type")) + assertPassChecker(t, "HTTPResponse.Header", c, newResp()) + }) + + t.Run("Header fail", func(t *testing.T) { + c := checkHTTPResponse.Header(check.HTTPHeader.HasNotKey("Content-Type")) + resp := newResp() + assertFailChecker(t, "HTTPResponse.Header", c, resp, makeExpl( + "header to pass Checker[http.Header]", + "explanation: http.Header:\n"+makeExpl( + `not to have key "Content-Type"`, + fmt.Sprint(resp.Header), + ), + )) + }) + + t.Run("Body pass", func(t *testing.T) { + c := checkHTTPResponse.Body(check.Bytes.Is(expBody)) + assertPassChecker(t, "HTTPResponse.Body", c, newResp()) + }) + + t.Run("Body fail", func(t *testing.T) { + c := checkHTTPResponse.Body(check.Bytes.Not(expBody)) + assertFailChecker(t, "HTTPResponse.Body", c, newResp(), makeExpl( + "body to pass Checker[[]byte]", + "explanation: bytes:\n"+makeExpl( + "not "+fmt.Sprint(expBody), + fmt.Sprint(expBody), + ), + )) + }) +} diff --git a/check/providers_map.go b/internal/providers/providers_map.go similarity index 56% rename from check/providers_map.go rename to internal/providers/providers_map.go index 4467453..f39d9e7 100644 --- a/check/providers_map.go +++ b/internal/providers/providers_map.go @@ -1,4 +1,4 @@ -package check +package providers import ( "fmt" @@ -7,33 +7,34 @@ import ( "github.com/drykit-go/cond" + check "github.com/drykit-go/testx/internal/checktypes" "github.com/drykit-go/testx/internal/reflectutil" ) -// mapCheckerProvider provides checks on kind map. -type mapCheckerProvider struct{ valueCheckerProvider } +// MapCheckerProvider provides checks on kind map. +type MapCheckerProvider[K comparable, V any] struct{ ValueCheckerProvider[map[K]V] } -// Len checks the gotten map passes the given IntChecker. -func (p mapCheckerProvider) Len(c IntChecker) ValueChecker { +// Len checks the gotten map passes the given Checker[int]. +func (p MapCheckerProvider[K, V]) Len(c check.Checker[int]) check.Checker[map[K]V] { var gotlen int - pass := func(got interface{}) bool { + pass := func(got map[K]V) bool { reflectutil.MustBeOfKind(got, reflect.Map) gotlen = reflect.ValueOf(got).Len() return c.Pass(gotlen) } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explainCheck(label, - "length to pass IntChecker", + "length to pass Checker[int]", c.Explain("length", gotlen), ) } - return NewValueChecker(pass, expl) + return check.NewChecker(pass, expl) } // HasKeys checks the gotten map has the given keys set. -func (p mapCheckerProvider) HasKeys(keys ...interface{}) ValueChecker { +func (p MapCheckerProvider[K, V]) HasKeys(keys ...K) check.Checker[map[K]V] { var missing []string - pass := func(got interface{}) bool { + pass := func(got map[K]V) bool { reflectutil.MustBeOfKind(got, reflect.Map) for _, expk := range keys { if _, found := p.get(got, expk); !found { @@ -42,16 +43,16 @@ func (p mapCheckerProvider) HasKeys(keys ...interface{}) ValueChecker { } return len(missing) == 0 } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explain(label, "to have keys "+p.formatList(missing), got) } - return NewValueChecker(pass, expl) + return check.NewChecker(pass, expl) } // HasNotKeys checks the gotten map has the given keys set. -func (p mapCheckerProvider) HasNotKeys(keys ...interface{}) ValueChecker { +func (p MapCheckerProvider[K, V]) HasNotKeys(keys ...K) check.Checker[map[K]V] { var badkeys []string - pass := func(got interface{}) bool { + pass := func(got map[K]V) bool { reflectutil.MustBeOfKind(got, reflect.Map) for _, expk := range keys { if _, found := p.get(got, expk); found { @@ -60,16 +61,16 @@ func (p mapCheckerProvider) HasNotKeys(keys ...interface{}) ValueChecker { } return len(badkeys) == 0 } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explainNot(label, "to have keys "+p.formatList(badkeys), got) } - return NewValueChecker(pass, expl) + return check.NewChecker(pass, expl) } // HasValues checks the gotten map has the given values set. -func (p mapCheckerProvider) HasValues(values ...interface{}) ValueChecker { +func (p MapCheckerProvider[K, V]) HasValues(values ...V) check.Checker[map[K]V] { var missing []string - pass := func(got interface{}) bool { + pass := func(got map[K]V) bool { reflectutil.MustBeOfKind(got, reflect.Map) for _, expv := range values { if !p.hasValue(got, expv) { @@ -78,16 +79,16 @@ func (p mapCheckerProvider) HasValues(values ...interface{}) ValueChecker { } return len(missing) == 0 } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explain(label, "to have values "+p.formatList(missing), got) } - return NewValueChecker(pass, expl) + return check.NewChecker(pass, expl) } // HasNotValues checks the gotten map has not the given values set. -func (p mapCheckerProvider) HasNotValues(values ...interface{}) ValueChecker { +func (p MapCheckerProvider[K, V]) HasNotValues(values ...V) check.Checker[map[K]V] { var badvalues []string - pass := func(got interface{}) bool { + pass := func(got map[K]V) bool { reflectutil.MustBeOfKind(got, reflect.Map) for _, badv := range values { if p.hasValue(got, badv) { @@ -96,24 +97,24 @@ func (p mapCheckerProvider) HasNotValues(values ...interface{}) ValueChecker { } return len(badvalues) == 0 } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explainNot(label, "to have values "+p.formatList(badvalues), got) } - return NewValueChecker(pass, expl) + return check.NewChecker(pass, expl) } // CheckValues checks the gotten map's values corresponding to the given keys // pass the given checker. A key not found is considered a fail. // If len(keys) == 0, the check is made on all map values. -func (p mapCheckerProvider) CheckValues(c ValueChecker, keys ...interface{}) ValueChecker { //nolint: gocognit // TODO: refactor +func (p MapCheckerProvider[K, V]) CheckValues(c check.Checker[V], keys ...K) check.Checker[map[K]V] { //nolint: gocognit // TODO: refactor var badentries []string allKeys := len(keys) == 0 - pass := func(got interface{}) bool { + pass := func(got map[K]V) bool { reflectutil.MustBeOfKind(got, reflect.Map) if allKeys { - p.walk(got, func(gotk, gotv interface{}) { + p.walk(got, func(gotk K, gotv V) { if !c.Pass(gotv) { - badentries = append(badentries, fmt.Sprintf("%s:%v", gotk, gotv)) + badentries = append(badentries, fmt.Sprintf("%v:%v", gotk, gotv)) } }) sort.Strings(badentries) @@ -121,35 +122,41 @@ func (p mapCheckerProvider) CheckValues(c ValueChecker, keys ...interface{}) Val for _, expk := range keys { gotv, ok := p.get(got, expk) if !ok || !c.Pass(gotv) { - badentries = append(badentries, fmt.Sprintf("%s:%v", expk, gotv)) + badentries = append(badentries, fmt.Sprintf("%v:%v", expk, gotv)) } } } return len(badentries) == 0 } - expl := func(label string, _ interface{}) string { + expl := func(label string, _ any) string { checkedKeys := cond.String("all keys", fmt.Sprintf("keys %v", keys), allKeys) return p.explainCheck(label, - fmt.Sprintf("values for %s to pass ValueChecker", checkedKeys), + fmt.Sprintf("values for %s to pass Checker[V]", checkedKeys), c.Explain("values", p.formatList(badentries)), ) } - return NewValueChecker(pass, expl) + return check.NewChecker(pass, expl) } // get returns gotmap[key] and a bool representing whether a match is found. -func (p mapCheckerProvider) get(gotmap, key interface{}) (interface{}, bool) { +func (p MapCheckerProvider[K, V]) get(gotmap map[K]V, key K) (V, bool) { iter := reflect.ValueOf(gotmap).MapRange() for iter.Next() { if k := iter.Key().Interface(); p.deq(k, key) { - return iter.Value().Interface(), true + v, ok := iter.Value().Interface().(V) + if !ok { + var vnil V + return vnil, true + } + return v, true } } - return nil, false + var vnil V + return vnil, false } // hasValue returns true if gotmap matches the specified value. -func (p mapCheckerProvider) hasValue(gotmap, value interface{}) bool { +func (p MapCheckerProvider[K, V]) hasValue(gotmap map[K]V, value V) bool { iter := reflect.ValueOf(gotmap).MapRange() for iter.Next() { if gotv := iter.Value().Interface(); p.deq(gotv, value) { @@ -159,12 +166,20 @@ func (p mapCheckerProvider) hasValue(gotmap, value interface{}) bool { return false } -func (mapCheckerProvider) walk(gotmap interface{}, f func(k, v interface{})) { +func (MapCheckerProvider[K, V]) walk(gotmap map[K]V, f func(k K, v V)) { vmap := reflect.ValueOf(gotmap) iter := vmap.MapRange() for iter.Next() { - k := iter.Key().Interface() - v := iter.Value().Interface() + var knil K + k, ok := iter.Key().Interface().(K) + if !ok { + k = knil + } + var vnil V + v, ok := iter.Value().Interface().(V) + if !ok { + v = vnil + } f(k, v) } } diff --git a/internal/providers/providers_map_test.go b/internal/providers/providers_map_test.go new file mode 100644 index 0000000..7b70cd5 --- /dev/null +++ b/internal/providers/providers_map_test.go @@ -0,0 +1,122 @@ +package providers_test + +import ( + "fmt" + "testing" + + "github.com/drykit-go/testx/check" + "github.com/drykit-go/testx/internal/providers" +) + +func TestMapCheckerProvider(t *testing.T) { + checkMap := providers.MapCheckerProvider[string, any]{} + + m := map[string]any{ + "name": "Marcel Patulacci", + "age": 42, + "friends": []string{"Robert Robichet", "Jean-Pierre Avidol"}, + } + + t.Run("Len pass", func(t *testing.T) { + c := checkMap.Len(check.Int.Is(3)) + assertPassChecker(t, "Map.Len", c, m) + }) + + t.Run("Len fail", func(t *testing.T) { + c := checkMap.Len(check.Int.Not(3)) + assertFailChecker(t, "Map.Len", c, m, makeExpl( + "length to pass Checker[int]", + "explanation: length:\n"+makeExpl("not 3", "3"), + )) + }) + + t.Run("HasKeys pass", func(t *testing.T) { + c := checkMap.HasKeys("name", "friends") + assertPassChecker(t, "Map.HasKeys", c, m) + }) + + t.Run("HasKeys fail", func(t *testing.T) { + c := checkMap.HasKeys("name", "hello", "bad") + assertFailChecker(t, "Map.HasKeys", c, m, makeExpl( + "to have keys [hello, bad]", + fmt.Sprint(m), + )) + }) + + t.Run("HasNotKeys pass", func(t *testing.T) { + c := checkMap.HasNotKeys("hello", "42") + assertPassChecker(t, "Map.HasNotKeys", c, m) + }) + + t.Run("HasNotKeys fail", func(t *testing.T) { + c := checkMap.HasNotKeys("name", "hello", "age") + assertFailChecker(t, "Map.HasNotKeys", c, m, makeExpl( + "not to have keys [name, age]", + fmt.Sprint(m), + )) + }) + + t.Run("HasValues pass", func(t *testing.T) { + c := checkMap.HasValues(42, []string{"Robert Robichet", "Jean-Pierre Avidol"}) + assertPassChecker(t, "Map.HasValues", c, m) + }) + + t.Run("HasValues fail", func(t *testing.T) { + c := checkMap.HasValues(42, "hello", true) + assertFailChecker(t, "Map.HasValues", c, m, makeExpl( + "to have values [hello, true]", + fmt.Sprint(m), + )) + }) + + t.Run("HasNotValues pass", func(t *testing.T) { + c := checkMap.HasNotValues("hello", -1) + assertPassChecker(t, "Map.HasNotValues", c, m) + }) + + t.Run("HasNotValues fail", func(t *testing.T) { + c := checkMap.HasNotValues(42, "hi", []string{"Robert Robichet", "Jean-Pierre Avidol"}) + assertFailChecker(t, "Map.HasNotValues", c, m, makeExpl( + "not to have values [42, [Robert Robichet Jean-Pierre Avidol]]", + fmt.Sprint(m), + )) + }) + + t.Run("CheckValues pass", func(t *testing.T) { + // keys subset + c := checkMap.CheckValues( + check.Wrap[int](check.Int.InRange(41, 43)), + "age", + ) + assertPassChecker(t, "Map.CheckValues", c, m) + + // all keys + c = checkMap.CheckValues(check.Value[any]().Not(0)) + assertPassChecker(t, "Map.CheckValues", c, m) + }) + + t.Run("CheckValues fail", func(t *testing.T) { + // keys subset + c := checkMap.CheckValues( + check.Wrap[int](check.Int.OutRange(41, 43)), + "age", "badkey", + ) + assertFailChecker(t, "Map.CheckValues", c, m, makeExpl( + "values for keys [age badkey] to pass Checker[V]", + "explanation: values:\n"+makeExpl( + "not in range [41:43]", + "[age:42, badkey:]", + ), + )) + + // all keys + c = checkMap.CheckValues(check.Value[any]().Is("Marcel Patulacci")) + assertFailChecker(t, "Map.CheckValues", c, m, makeExpl( + "values for all keys to pass Checker[V]", + "explanation: values:\n"+makeExpl( + "Marcel Patulacci", + "[age:42, friends:[Robert Robichet Jean-Pierre Avidol]]", + ), + )) + }) +} diff --git a/internal/providers/providers_number.go b/internal/providers/providers_number.go new file mode 100644 index 0000000..9244480 --- /dev/null +++ b/internal/providers/providers_number.go @@ -0,0 +1,106 @@ +package providers + +import ( + "fmt" + + check "github.com/drykit-go/testx/internal/checktypes" +) + +// FIXME: The interface for this type can't be properly generated yet. +// For the moment it is hardcoded in the template file located at +// internal/gen/templates/providers.gotmpl. +// As a consequence, changes made in this file won't update the generated +// interface automatically: the template mentionned above must be updated +// manually. + +// NumberCheckerProvider provides checks on numeric types. +type NumberCheckerProvider[T check.Numeric] struct{ baseCheckerProvider } + +// Is checks the gotten Number is equal to the target. +func (p NumberCheckerProvider[T]) Is(tar T) check.Checker[T] { + pass := func(got T) bool { return got == tar } + expl := func(label string, got any) string { + return p.explain(label, tar, got) + } + return check.NewChecker(pass, expl) +} + +// Not checks the gotten Number is not equal to the target. +func (p NumberCheckerProvider[T]) Not(values ...T) check.Checker[T] { + var match T + pass := func(got T) bool { + for _, v := range values { + if got == v { + match = v + return false + } + } + return true + } + expl := func(label string, got any) string { + return p.explainNot(label, match, got) + } + return check.NewChecker(pass, expl) +} + +// InRange checks the gotten Number is in the closed interval [lo:hi]. +func (p NumberCheckerProvider[T]) InRange(lo, hi T) check.Checker[T] { + pass := func(got T) bool { return p.inrange(got, lo, hi) } + expl := func(label string, got any) string { + return p.explain(label, fmt.Sprintf("in range [%v:%v]", lo, hi), got) + } + return check.NewChecker(pass, expl) +} + +// OutRange checks the gotten Number is not in the closed interval [lo:hi]. +func (p NumberCheckerProvider[T]) OutRange(lo, hi T) check.Checker[T] { + pass := func(got T) bool { return !p.inrange(got, lo, hi) } + expl := func(label string, got any) string { + return p.explainNot(label, fmt.Sprintf("in range [%v:%v]", lo, hi), got) + } + return check.NewChecker(pass, expl) +} + +// GT checks the gotten Number is greater than the target. +func (p NumberCheckerProvider[T]) GT(tar T) check.Checker[T] { + pass := func(got T) bool { return !p.lte(got, tar) } + expl := func(label string, got any) string { + return p.explain(label, fmt.Sprintf("> %v", tar), got) + } + return check.NewChecker(pass, expl) +} + +// GTE checks the gotten Number is greater or equal to the target. +func (p NumberCheckerProvider[T]) GTE(tar T) check.Checker[T] { + pass := func(got T) bool { return !p.lt(got, tar) } + expl := func(label string, got any) string { + return p.explain(label, fmt.Sprintf(">= %v", tar), got) + } + return check.NewChecker(pass, expl) +} + +// LT checks the gotten Number is lesser than the target. +func (p NumberCheckerProvider[T]) LT(tar T) check.Checker[T] { + pass := func(got T) bool { return p.lt(got, tar) } + expl := func(label string, got any) string { + return p.explain(label, fmt.Sprintf("< %v", tar), got) + } + return check.NewChecker(pass, expl) +} + +// LTE checks the gotten Number is lesser or equal to the target. +func (p NumberCheckerProvider[T]) LTE(tar T) check.Checker[T] { + pass := func(got T) bool { return p.lte(got, tar) } + expl := func(label string, got any) string { + return p.explain(label, fmt.Sprintf("<= %v", tar), got) + } + return check.NewChecker(pass, expl) +} + +// Helpers + +func (NumberCheckerProvider[T]) lt(a, b T) bool { return a < b } +func (NumberCheckerProvider[T]) lte(a, b T) bool { return a <= b } +func (p NumberCheckerProvider[T]) inrange(n, lo, hi T) bool { + return !p.lt(n, lo) && p.lte(n, hi) +} diff --git a/internal/providers/providers_number_test.go b/internal/providers/providers_number_test.go new file mode 100644 index 0000000..351c6a3 --- /dev/null +++ b/internal/providers/providers_number_test.go @@ -0,0 +1,135 @@ +package providers_test + +import ( + "fmt" + "testing" + + "github.com/drykit-go/testx/internal/providers" +) + +func TestNumberCheckerProvider(t *testing.T) { + checkFloat64 := providers.NumberCheckerProvider[float64]{} + + const ( + n = 42. + inf = n - 1 + sup = n + 1 + ) + var ( + nstr = fmt.Sprint(n) + infstr = fmt.Sprint(inf) + supstr = fmt.Sprint(sup) + ) + + t.Run("Is pass", func(t *testing.T) { + c := checkFloat64.Is(n) + assertPassChecker(t, "Number.Is", c, n) + }) + + t.Run("Is fail", func(t *testing.T) { + c := checkFloat64.Is(inf) + assertFailChecker(t, "Number.Is", c, n, makeExpl(infstr, nstr)) + }) + + t.Run("Not pass", func(t *testing.T) { + c := checkFloat64.Not(-1, 314, -n) + assertPassChecker(t, "Number.Not", c, n) + }) + + t.Run("Not fail", func(t *testing.T) { + c := checkFloat64.Not(-1, 314, n, 1618) + assertFailChecker(t, "Number.Not", c, n, makeExpl("not "+nstr, nstr)) + }) + + t.Run("LT pass", func(t *testing.T) { + c := checkFloat64.LT(sup) + assertPassChecker(t, "Number.LT", c, n) + }) + + t.Run("LT fail", func(t *testing.T) { + c := checkFloat64.LT(inf) + assertFailChecker(t, "Number.LT", c, n, makeExpl("< "+infstr, nstr)) + c = checkFloat64.LT(n) + assertFailChecker(t, "Number.LT", c, n, makeExpl("< "+nstr, nstr)) + }) + + t.Run("LTE pass", func(t *testing.T) { + c := checkFloat64.LTE(sup) + assertPassChecker(t, "Number.LTE", c, n) + c = checkFloat64.LTE(n) + assertPassChecker(t, "Number.LTE", c, n) + }) + + t.Run("LTE fail", func(t *testing.T) { + c := checkFloat64.LTE(inf) + assertFailChecker(t, "Number.LTE", c, n, makeExpl("<= "+infstr, nstr)) + }) + + t.Run("GT pass", func(t *testing.T) { + c := checkFloat64.GT(inf) + assertPassChecker(t, "Number.GT", c, n) + }) + + t.Run("GT fail", func(t *testing.T) { + c := checkFloat64.GT(sup) + assertFailChecker(t, "Number.GT", c, n, makeExpl("> "+supstr, nstr)) + c = checkFloat64.GT(n) + assertFailChecker(t, "Number.GT", c, n, makeExpl("> "+nstr, nstr)) + }) + + t.Run("GTE pass", func(t *testing.T) { + c := checkFloat64.GTE(inf) + assertPassChecker(t, "Number.GTE", c, n) + c = checkFloat64.GTE(n) + assertPassChecker(t, "Number.GTE", c, n) + }) + + t.Run("GTE fail", func(t *testing.T) { + c := checkFloat64.GTE(sup) + assertFailChecker(t, "Number.GTE", c, n, makeExpl(">= "+supstr, nstr)) + }) + + t.Run("InRange pass", func(t *testing.T) { + c := checkFloat64.InRange(inf, sup) + assertPassChecker(t, "Number.InRange", c, n) + + c = checkFloat64.InRange(n, n) + assertPassChecker(t, "Number.InRange", c, n) + }) + + t.Run("InRange fail", func(t *testing.T) { + c := checkFloat64.InRange(sup, sup+1) + assertFailChecker(t, "Number.InRange", c, n, makeExpl( + fmt.Sprintf("in range [%v:%v]", sup, sup+1), + nstr, + )) + + c = checkFloat64.InRange(sup, inf) + assertFailChecker(t, "Number.InRange", c, n, makeExpl( + fmt.Sprintf("in range [%v:%v]", sup, inf), + nstr, + )) + }) + + t.Run("OutRange pass", func(t *testing.T) { + c := checkFloat64.OutRange(sup, sup+1) + assertPassChecker(t, "Number.OutRange", c, n) + + c = checkFloat64.OutRange(sup, inf) + assertPassChecker(t, "Number.OutRange", c, n) + }) + + t.Run("OutRange fail", func(t *testing.T) { + c := checkFloat64.OutRange(inf, sup) + assertFailChecker(t, "Number.OutRange", c, n, makeExpl( + fmt.Sprintf("not in range [%v:%v]", inf, sup), + nstr, + )) + + c = checkFloat64.OutRange(n, n) + assertFailChecker(t, "Number.OutRange", c, n, makeExpl( + fmt.Sprintf("not in range [%v:%v]", n, n), + nstr, + )) + }) +} diff --git a/check/providers_slice.go b/internal/providers/providers_slice.go similarity index 52% rename from check/providers_slice.go rename to internal/providers/providers_slice.go index e7f7fb2..3d56b47 100644 --- a/check/providers_slice.go +++ b/internal/providers/providers_slice.go @@ -1,53 +1,54 @@ -package check +package providers import ( "fmt" "reflect" + check "github.com/drykit-go/testx/internal/checktypes" "github.com/drykit-go/testx/internal/reflectutil" ) -// sliceCheckerProvider provides checks on kind slice. -type sliceCheckerProvider struct{ valueCheckerProvider } +// SliceCheckerProvider provides checks on kind slice. +type SliceCheckerProvider[Elem any] struct{ ValueCheckerProvider[[]Elem] } -// Len checks the length of the gotten slice passes the given IntChecker. -func (p sliceCheckerProvider) Len(c IntChecker) ValueChecker { +// Len checks the length of the gotten slice passes the given Checker[int]. +func (p SliceCheckerProvider[Elem]) Len(c check.Checker[int]) check.Checker[[]Elem] { var gotlen int - pass := func(got interface{}) bool { + pass := func(got []Elem) bool { reflectutil.MustBeOfKind(got, reflect.Slice) gotlen = reflect.ValueOf(got).Len() return c.Pass(gotlen) } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explainCheck(label, - "length to pass IntChecker", + "length to pass Checker[int]", c.Explain("length", gotlen), ) } - return NewValueChecker(pass, expl) + return check.NewChecker(pass, expl) } -// Cap checks the capacity of the gotten slice passes the given IntChecker. -func (p sliceCheckerProvider) Cap(c IntChecker) ValueChecker { +// Cap checks the capacity of the gotten slice passes the given Checker[int]. +func (p SliceCheckerProvider[Elem]) Cap(c check.Checker[int]) check.Checker[[]Elem] { var gotcap int - pass := func(got interface{}) bool { + pass := func(got []Elem) bool { reflectutil.MustBeOfKind(got, reflect.Slice) gotcap = reflect.ValueOf(got).Cap() return c.Pass(gotcap) } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explainCheck(label, - "capacity to pass IntChecker", + "capacity to pass Checker[int]", c.Explain("capacity", gotcap), ) } - return NewValueChecker(pass, expl) + return check.NewChecker(pass, expl) } // HasValues checks the gotten slice has the given values set. -func (p sliceCheckerProvider) HasValues(values ...interface{}) ValueChecker { +func (p SliceCheckerProvider[Elem]) HasValues(values ...Elem) check.Checker[[]Elem] { var missing []string - pass := func(got interface{}) bool { + pass := func(got []Elem) bool { reflectutil.MustBeOfKind(got, reflect.Slice) for _, expv := range values { if !p.hasValue(got, expv) { @@ -56,19 +57,19 @@ func (p sliceCheckerProvider) HasValues(values ...interface{}) ValueChecker { } return len(missing) == 0 } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explain(label, "to have values "+p.formatList(missing), got, ) } - return NewValueChecker(pass, expl) + return check.NewChecker(pass, expl) } // HasNotValues checks the gotten slice has not the given values set. -func (p sliceCheckerProvider) HasNotValues(values ...interface{}) ValueChecker { +func (p SliceCheckerProvider[Elem]) HasNotValues(values ...Elem) check.Checker[[]Elem] { var badvalues []string - pass := func(got interface{}) bool { + pass := func(got []Elem) bool { reflectutil.MustBeOfKind(got, reflect.Slice) for _, badv := range values { if p.hasValue(got, badv) { @@ -77,54 +78,58 @@ func (p sliceCheckerProvider) HasNotValues(values ...interface{}) ValueChecker { } return len(badvalues) == 0 } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explainNot(label, "to have values "+p.formatList(badvalues), got, ) } - return NewValueChecker(pass, expl) + return check.NewChecker(pass, expl) } -// CheckValues checks the values of the gotten slice pass the given ValueChecker. +// CheckValues checks the values of the gotten slice passes +// the given Checker[Elem]. // If a filterFunc is provided, the values not passing it are ignored. -func (p sliceCheckerProvider) CheckValues(c ValueChecker, filters ...func(i int, v interface{}) bool) ValueChecker { +func (p SliceCheckerProvider[Elem]) CheckValues( + c check.Checker[Elem], + filters ...func(i int, v Elem) bool, +) check.Checker[[]Elem] { var badvalues []string - pass := func(got interface{}) bool { + pass := func(got []Elem) bool { reflectutil.MustBeOfKind(got, reflect.Slice) - p.walk(got, filters, func(i int, v interface{}) { + p.walk(got, filters, func(i int, v Elem) { if !c.Pass(v) { badvalues = append(badvalues, fmt.Sprintf("%d:%v", i, v)) } }) return len(badvalues) == 0 } - expl := func(label string, _ interface{}) string { + expl := func(label string, _ any) string { return p.explainCheck(label, - "values to pass ValueChecker", + "values to pass Checker[Elem]", c.Explain("values", p.formatList(badvalues)), ) } - return NewValueChecker(pass, expl) + return check.NewChecker(pass, expl) } // Helpers // hasValue returns true if slice has a value equal to expv. -func (p sliceCheckerProvider) hasValue(slice, expv interface{}) bool { - return p.walkUntil(slice, nil, func(_ int, v interface{}) bool { +func (p SliceCheckerProvider[Elem]) hasValue(slice []Elem, expv Elem) bool { + return p.walkUntil(slice, nil, func(_ int, v Elem) bool { return p.deq(v, expv) }) } // walk iterates over a slice until the end is reached. // It calls f(i, v) each iteration if (i, v) pass the given filters. -func (p sliceCheckerProvider) walk( - slice interface{}, - filters []func(int, interface{}) bool, - f func(i int, v interface{}), +func (p SliceCheckerProvider[Elem]) walk( + slice []Elem, + filters []func(int, Elem) bool, + f func(i int, v Elem), ) { - p.walkUntil(slice, filters, func(i int, v interface{}) bool { + p.walkUntil(slice, filters, func(i int, v Elem) bool { f(i, v) return false }) @@ -133,15 +138,15 @@ func (p sliceCheckerProvider) walk( // walksUntil behaves like walk excepts it returns early if the stop func // returns true for the current iteration. In returns true if it was stopped // early, false otherwise. -func (p sliceCheckerProvider) walkUntil( - slice interface{}, - filters []func(int, interface{}) bool, - stop func(int, interface{}) bool, +func (p SliceCheckerProvider[Elem]) walkUntil( + slice []Elem, + filters []func(int, Elem) bool, + stop func(int, Elem) bool, ) bool { vslice := reflect.ValueOf(slice) l := vslice.Len() for i := 0; i < l; i++ { - v := vslice.Index(i).Interface() + v := vslice.Index(i).Interface().(Elem) filter := p.mergeFilters(filters...) passed := filter(i, v) if passed && stop(i, v) { @@ -152,13 +157,13 @@ func (p sliceCheckerProvider) walkUntil( } // mergeFilters combinates several filtering funcs into one. -func (p sliceCheckerProvider) mergeFilters( - filters ...func(int, interface{}) bool, -) func(int, interface{}) bool { +func (p SliceCheckerProvider[Elem]) mergeFilters( + filters ...func(int, Elem) bool, +) func(int, Elem) bool { if len(filters) == 0 { - return func(int, interface{}) bool { return true } + return func(int, Elem) bool { return true } } - return func(i int, v interface{}) bool { + return func(i int, v Elem) bool { curr := filters[0] next := p.mergeFilters(filters[1:]...) return curr(i, v) && next(i, v) diff --git a/internal/providers/providers_slice_test.go b/internal/providers/providers_slice_test.go new file mode 100644 index 0000000..d3efab4 --- /dev/null +++ b/internal/providers/providers_slice_test.go @@ -0,0 +1,86 @@ +package providers_test + +import ( + "fmt" + "testing" + + "github.com/drykit-go/testx/check" + "github.com/drykit-go/testx/internal/providers" +) + +func TestSliceCheckerProvider(t *testing.T) { + checkSlice := providers.SliceCheckerProvider[any]{} + + s := []any{"hello", 42, "Marcel Patulacci", []float32{3.14}} + + t.Run("Len pass", func(t *testing.T) { + c := checkSlice.Len(check.Int.Is(4)) + assertPassChecker(t, "Slice.Len", c, s) + }) + + t.Run("Len fail", func(t *testing.T) { + c := checkSlice.Len(check.Int.Not(4)) + assertFailChecker(t, "Slice.Len", c, s, makeExpl( + "length to pass Checker[int]", + "explanation: length:\n"+makeExpl("not 4", "4"), + )) + }) + + t.Run("Cap pass", func(t *testing.T) { + c := checkSlice.Cap(check.Int.Is(4)) + assertPassChecker(t, "Slice.Cap", c, s) + }) + + t.Run("Cap fail", func(t *testing.T) { + c := checkSlice.Cap(check.Int.Not(4)) + assertFailChecker(t, "Slice.Cap", c, s, makeExpl( + "capacity to pass Checker[int]", + "explanation: capacity:\n"+makeExpl("not 4", "4"), + )) + }) + + t.Run("HasValues pass", func(t *testing.T) { + c := checkSlice.HasValues("hello", 42, []float32{3.14}) + assertPassChecker(t, "Slice.HasValues", c, s) + }) + + t.Run("HasValues fail", func(t *testing.T) { + c := checkSlice.HasValues([]float64{3.14}) + assertFailChecker(t, "Slice.HasValues", c, s, makeExpl( + "to have values [[3.14]]", + fmt.Sprint(s), + )) + }) + + t.Run("HasNotValues pass", func(t *testing.T) { + c := checkSlice.HasNotValues("hi", -1, []float64{3.14}) + assertPassChecker(t, "Slice.HasNotValues", c, s) + }) + + t.Run("HasNotValues fail", func(t *testing.T) { + c := checkSlice.HasNotValues("hi", -1, []float32{3.14}) + assertFailChecker(t, "Slice.HasNotValues", c, s, makeExpl( + "not to have values [[3.14]]", + fmt.Sprint(s), + )) + }) + + t.Run("CheckValues pass", func(t *testing.T) { + c := checkSlice.CheckValues( + check.Wrap[int](check.Int.InRange(41, 43)), + func(_ int, v any) bool { _, ok := v.(int); return ok }, + ) + assertPassChecker(t, "Slice.CheckValues", c, s) + }) + + t.Run("CheckValues fail", func(t *testing.T) { + c := checkSlice.CheckValues( + check.Wrap[int](check.Int.OutRange(41, 43)), + func(_ int, v any) bool { _, ok := v.(int); return ok }, + ) + assertFailChecker(t, "Slice.CheckValues", c, s, makeExpl( + "values to pass Checker[Elem]", + "explanation: values:\n"+makeExpl("not in range [41:43]", "[1:42]"), + )) + }) +} diff --git a/check/providers_string.go b/internal/providers/providers_string.go similarity index 50% rename from check/providers_string.go rename to internal/providers/providers_string.go index 817541a..8412b8b 100644 --- a/check/providers_string.go +++ b/internal/providers/providers_string.go @@ -1,25 +1,27 @@ -package check +package providers import ( "fmt" "regexp" "strings" + + check "github.com/drykit-go/testx/internal/checktypes" ) -// stringCheckerProvider provides checks on type string. -type stringCheckerProvider struct{ baseCheckerProvider } +// StringCheckerProvider provides checks on type string. +type StringCheckerProvider struct{ baseCheckerProvider } // Is checks the gotten string is equal to the target. -func (p stringCheckerProvider) Is(tar string) StringChecker { +func (p StringCheckerProvider) Is(tar string) check.Checker[string] { pass := func(got string) bool { return got == tar } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explain(label, tar, got) } - return NewStringChecker(pass, expl) + return check.NewChecker(pass, expl) } // Not checks the gotten string is not equal to the target. -func (p stringCheckerProvider) Not(values ...string) StringChecker { +func (p StringCheckerProvider) Not(values ...string) check.Checker[string] { var match string pass := func(got string) bool { for _, v := range values { @@ -30,63 +32,63 @@ func (p stringCheckerProvider) Not(values ...string) StringChecker { } return true } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explainNot(label, match, got) } - return NewStringChecker(pass, expl) + return check.NewChecker(pass, expl) } -// Len checks the gotten string's length passes the given IntChecker. -func (p stringCheckerProvider) Len(c IntChecker) StringChecker { +// Len checks the gotten string's length passes the given Checker[int]. +func (p StringCheckerProvider) Len(c check.Checker[int]) check.Checker[string] { pass := func(got string) bool { return c.Pass(len(got)) } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explainCheck(label, - "length to pass IntChecker", + "length to pass Checker[int]", c.Explain("length", len(got.(string))), ) } - return NewStringChecker(pass, expl) + return check.NewChecker(pass, expl) } // Match checks the gotten string matches the given regexp. -func (p stringCheckerProvider) Match(rgx *regexp.Regexp) StringChecker { +func (p StringCheckerProvider) Match(rgx *regexp.Regexp) check.Checker[string] { pass := func(got string) bool { return rgx.MatchString(got) } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explain(label, fmt.Sprintf("to match regexp %s", rgx.String()), got, ) } - return NewStringChecker(pass, expl) + return check.NewChecker(pass, expl) } // NotMatch checks the gotten string do not match the given regexp. -func (p stringCheckerProvider) NotMatch(rgx *regexp.Regexp) StringChecker { +func (p StringCheckerProvider) NotMatch(rgx *regexp.Regexp) check.Checker[string] { pass := func(got string) bool { return !rgx.MatchString(got) } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explainNot(label, fmt.Sprintf("to match regexp %s", rgx.String()), got, ) } - return NewStringChecker(pass, expl) + return check.NewChecker(pass, expl) } // Contains checks the gotten string contains the target substring. -func (p stringCheckerProvider) Contains(sub string) StringChecker { +func (p StringCheckerProvider) Contains(sub string) check.Checker[string] { pass := func(got string) bool { return strings.Contains(got, sub) } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explain(label, "to contain substring "+sub, got) } - return NewStringChecker(pass, expl) + return check.NewChecker(pass, expl) } // NotContains checks the gotten string do not contain the target // substring. -func (p stringCheckerProvider) NotContains(sub string) StringChecker { +func (p StringCheckerProvider) NotContains(sub string) check.Checker[string] { pass := func(got string) bool { return !strings.Contains(got, sub) } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explainNot(label, "to contain substring "+sub, got) } - return NewStringChecker(pass, expl) + return check.NewChecker(pass, expl) } diff --git a/internal/providers/providers_string_test.go b/internal/providers/providers_string_test.go new file mode 100644 index 0000000..5097d80 --- /dev/null +++ b/internal/providers/providers_string_test.go @@ -0,0 +1,118 @@ +package providers_test + +import ( + "fmt" + "regexp" + "testing" + + "github.com/drykit-go/testx/check" + "github.com/drykit-go/testx/internal/providers" +) + +func TestStringCheckerProvider(t *testing.T) { + checkString := providers.StringCheckerProvider{} + + const ( + s = "sator arepo tenet opera rotas" + sub = "tenet" + exp = s + "." + ) + + t.Run("Is pass", func(t *testing.T) { + c := checkString.Is(s) + assertPassChecker(t, "String.Is", c, s) + }) + + t.Run("Is fail", func(t *testing.T) { + c := checkString.Is(exp) + assertFailChecker(t, "String.Is", c, s, makeExpl(exp, s)) + }) + + t.Run("Not pass", func(t *testing.T) { + c := checkString.Not("hello", sub, exp) + assertPassChecker(t, "String.Not", c, s) + }) + + t.Run("Not fail", func(t *testing.T) { + c := checkString.Not("hello", sub, s, exp) + assertFailChecker(t, "String.Not", c, s, makeExpl("not "+s, s)) + }) + + t.Run("Len pass", func(t *testing.T) { + c := checkString.Len(check.Int.Is(len(s))) + assertPassChecker(t, "String.Len", c, s) + }) + + t.Run("Len fail", func(t *testing.T) { + gotlen := len(s) + explen := gotlen + 1 + c := checkString.Len(check.Int.Is(explen)) + assertFailChecker(t, "String.Len", c, s, makeExpl( + "length to pass Checker[int]", + "explanation: length:\n"+makeExpl( + fmt.Sprint(explen), + fmt.Sprint(gotlen), + ), + )) + }) + + t.Run("Match pass", func(t *testing.T) { + c := checkString.Match(regexp.MustCompile(`(?i)\sTENET\s`)) + assertPassChecker(t, "String.Match", c, s) + }) + + t.Run("Match fail", func(t *testing.T) { + r := regexp.MustCompile(`\sTENET\s`) + c := checkString.Match(r) + assertFailChecker(t, "String.Match", c, s, + makeExpl("to match regexp "+r.String(), s), + ) + }) + + t.Run("NotMatch pass", func(t *testing.T) { + c := checkString.NotMatch(regexp.MustCompile(`\sTENET\s`)) + assertPassChecker(t, "String.NotMatch", c, s) + }) + + t.Run("NotMatch fail", func(t *testing.T) { + r := regexp.MustCompile(`(?i)\sTENET\s`) + c := checkString.NotMatch(r) + assertFailChecker(t, "String.NotMatch", c, s, makeExpl( + "not to match regexp "+r.String(), + s, + )) + }) + + t.Run("Contains pass", func(t *testing.T) { + c := checkString.Contains(sub) + assertPassChecker(t, "String.Contains", c, s) + c = checkString.Contains(s) + assertPassChecker(t, "String.Contains", c, s) + }) + + t.Run("Contains fail", func(t *testing.T) { + c := checkString.Contains(exp) + assertFailChecker(t, "String.Contains", c, s, makeExpl( + "to contain substring "+exp, + s, + )) + }) + + t.Run("NotContains pass", func(t *testing.T) { + c := checkString.NotContains(exp) + assertPassChecker(t, "String.NotContains", c, s) + }) + + t.Run("NotContains fail", func(t *testing.T) { + c := checkString.NotContains(sub) + assertFailChecker(t, "String.NotContains", c, s, makeExpl( + "not to contain substring "+sub, + s, + )) + c = checkString.NotContains(s) + assertFailChecker(t, "String.NotContains", c, s, makeExpl( + "not to contain substring "+s, + s, + )) + }) +} diff --git a/check/providers_struct.go b/internal/providers/providers_struct.go similarity index 56% rename from check/providers_struct.go rename to internal/providers/providers_struct.go index 16c3f66..da5c6f5 100644 --- a/check/providers_struct.go +++ b/internal/providers/providers_struct.go @@ -1,62 +1,63 @@ -package check +package providers import ( "fmt" "reflect" "strings" + check "github.com/drykit-go/testx/internal/checktypes" "github.com/drykit-go/testx/internal/reflectutil" ) -// structCheckerProvider provides checks on kind struct. -type structCheckerProvider struct{ valueCheckerProvider } +// StructCheckerProvider provides checks on kind struct. +type StructCheckerProvider struct{ ValueCheckerProvider[any] } // FieldsEqual checks all given fields equal the exp value. // It panics if the fields do not exist or are not exported, // or if the tested value is not a struct. -func (p structCheckerProvider) FieldsEqual(exp interface{}, fields []string) ValueChecker { +func (p StructCheckerProvider) FieldsEqual(exp any, fields []string) check.Checker[any] { var bads []string - pass := func(got interface{}) bool { + pass := func(got any) bool { reflectutil.MustBeOfKind(got, reflect.Struct) - bads = p.badFields(got, fields, func(k string, v interface{}) bool { + bads = p.badFields(got, fields, func(k string, v any) bool { return p.deq(v, exp) }) return len(bads) == 0 } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explain(label, fmt.Sprintf("fields [%s] to equal %v", p.formatFields(fields), exp), strings.Join(bads, ", "), ) } - return NewValueChecker(pass, expl) + return check.NewChecker(pass, expl) } -// CheckFields checks all given fields pass the ValueChecker. +// CheckFields checks all given fields pass the Checker[any]. // It panics if the fields do not exist or are not exported, // or if the tested value is not a struct. -func (p structCheckerProvider) CheckFields(c ValueChecker, fields []string) ValueChecker { +func (p StructCheckerProvider) CheckFields(c check.Checker[any], fields []string) check.Checker[any] { var bads []string - pass := func(got interface{}) bool { + pass := func(got any) bool { reflectutil.MustBeOfKind(got, reflect.Struct) - bads = p.badFields(got, fields, func(k string, v interface{}) bool { + bads = p.badFields(got, fields, func(k string, v any) bool { return c.Pass(v) }) return len(bads) == 0 } - expl := func(label string, got interface{}) string { + expl := func(label string, got any) string { return p.explainCheck(label, - fmt.Sprintf("fields [%s] to pass ValueChecker", p.formatFields(fields)), + fmt.Sprintf("fields [%s] to pass Checker[any]", p.formatFields(fields)), c.Explain("fields", strings.Join(bads, ", ")), ) } - return NewValueChecker(pass, expl) + return check.NewChecker(pass, expl) } -func (p structCheckerProvider) badFields( - gotstruct interface{}, +func (p StructCheckerProvider) badFields( + gotstruct any, fields []string, - pass func(k string, v interface{}) bool, + pass func(k string, v any) bool, ) (bads []string) { vstruct := reflect.ValueOf(gotstruct) for _, k := range fields { @@ -69,7 +70,7 @@ func (p structCheckerProvider) badFields( return } -func (structCheckerProvider) formatFields(fields []string) string { +func (StructCheckerProvider) formatFields(fields []string) string { n := len(fields) var b strings.Builder for i, f := range fields { diff --git a/internal/providers/providers_struct_test.go b/internal/providers/providers_struct_test.go new file mode 100644 index 0000000..ac079cf --- /dev/null +++ b/internal/providers/providers_struct_test.go @@ -0,0 +1,59 @@ +package providers_test + +import ( + "fmt" + "testing" + + "github.com/drykit-go/testx/check" + "github.com/drykit-go/testx/internal/providers" +) + +type structTest struct { + A, B, X, Y int +} + +func TestStructCheckerProvider(t *testing.T) { + checkStruct := providers.StructCheckerProvider{} + + const ( + vAB = 10 + vXY = 20 + ) + s := structTest{A: vAB, B: vAB, X: vXY, Y: vXY} + // FIXME: remove forced conversion + itf := func(v structTest) any { + return v + } + + t.Run("FieldsEqual pass", func(t *testing.T) { + c := checkStruct.FieldsEqual(vAB, []string{"A", "B"}) + assertPassChecker(t, "Struct.FieldsEqual", c, itf(s)) + }) + + t.Run("FieldsEqual fail", func(t *testing.T) { + c := checkStruct.FieldsEqual(vAB, []string{"A", "B", "X", "Y"}) + assertFailChecker(t, "Struct.FieldsEqual", c, itf(s), makeExpl( + fmt.Sprintf("fields [.A, .B, .X, .Y] to equal %v", vAB), + fmt.Sprintf(".X=%v, .Y=%v", vXY, vXY), + )) + }) + + t.Run("CheckFields pass", func(t *testing.T) { + c := checkStruct.CheckFields( + check.Wrap[int](check.Int.LT(vAB+1)), + []string{"A", "B"}, + ) + assertPassChecker(t, "Struct.CheckFields", c, itf(s)) + }) + + t.Run("CheckFields fail", func(t *testing.T) { + c := checkStruct.CheckFields( + check.Wrap[int](check.Int.LT(vAB+1)), + []string{"A", "B", "X", "Y"}, + ) + assertFailChecker(t, "Struct.CheckFields", c, itf(s), makeExpl( + "fields [.A, .B, .X, .Y] to pass Checker[any]", + "explanation: fields:\n"+makeExpl("< 11", ".X=20, .Y=20"), + )) + }) +} diff --git a/internal/providers/providers_test.go b/internal/providers/providers_test.go new file mode 100644 index 0000000..81d40a2 --- /dev/null +++ b/internal/providers/providers_test.go @@ -0,0 +1,63 @@ +package providers_test + +import ( + "fmt" + "testing" + + check "github.com/drykit-go/testx/internal/checktypes" +) + +func assertPassChecker[T any]( + t *testing.T, + methodName string, + c check.Checker[T], + in T, +) { + t.Helper() + if !c.Pass(in) { + failCheckerTest(t, true, methodName, c.Explain("value", in)) + } +} + +func assertFailChecker[T any]( + t *testing.T, + methodName string, + c check.Checker[T], + in T, + expexpl string, +) { + t.Helper() + if c.Pass(in) { + failCheckerTest(t, false, methodName, c.Explain("value", in)) + } + assertGoodExplain(t, c, in, expexpl) +} + +func assertGoodExplain[T any]( + t *testing.T, + // FIXME: check.Explainer2[T] not working: + // type check.Checker[bool] of c does not match check.Explainer2[T] (cannot infer T)compilerErrorCode(135) + c check.Checker[T], + in T, + expexpl string, +) { + t.Helper() + gotexpl := c.Explain("label", in) + expexpl = "label:\n" + expexpl + if gotexpl != expexpl { + t.Errorf("bad Explain output:\nexp \"%s\"\ngot \"%s\"", expexpl, gotexpl) + } +} + +func failCheckerTest(t *testing.T, expPass bool, name, expl string) { + t.Helper() + passOrFail := "PASS" + if !expPass { + passOrFail = "FAIL" + } + t.Errorf("\n❌ exp %s to %s, explain:\n%s", name, passOrFail, expl) +} + +func makeExpl(expstr, gotstr string) string { + return fmt.Sprintf("exp %s\ngot %s", expstr, gotstr) +} diff --git a/internal/providers/providers_value.go b/internal/providers/providers_value.go new file mode 100644 index 0000000..f08b813 --- /dev/null +++ b/internal/providers/providers_value.go @@ -0,0 +1,88 @@ +package providers + +import ( + "fmt" + + check "github.com/drykit-go/testx/internal/checktypes" + "github.com/drykit-go/testx/internal/reflectutil" +) + +// ValueCheckerProvider provides generic checks on any type. +type ValueCheckerProvider[T any] struct{ baseCheckerProvider } + +// Custom checks the gotten value passes the given PassFunc. +// The description should give information about the expected value, +// as it outputs in format "exp " in case of failure. +func (p ValueCheckerProvider[T]) Custom(desc string, f check.PassFunc[T]) check.Checker[T] { + expl := func(label string, got any) string { + return p.explain(label, desc, got) + } + return check.NewChecker(f, expl) +} + +// Is checks the gotten value is equal to the target. +func (p ValueCheckerProvider[T]) Is(tar T) check.Checker[T] { + pass := func(got T) bool { return p.deq(got, tar) } + expl := func(label string, got any) string { + return p.explain(label, tar, got) + } + return check.NewChecker(pass, expl) +} + +// Not checks the gotten value is not equal to the target. +func (p ValueCheckerProvider[T]) Not(values ...T) check.Checker[T] { + var match T + pass := func(got T) bool { + for _, v := range values { + if p.deq(got, v) { + match = v + return false + } + } + return true + } + expl := func(label string, got any) string { + return p.explainNot(label, match, got) + } + return check.NewChecker(pass, expl) +} + +// IsZero checks the gotten value is a zero value, indicating it might not +// have been initialized. +func (p ValueCheckerProvider[T]) IsZero() check.Checker[T] { + pass := func(got T) bool { + return reflectutil.IsZero(got) + } + expl := func(label string, got any) string { + return p.explain(label, "to be a zero value", got) + } + return check.NewChecker(pass, expl) +} + +// NotZero checks the gotten struct contains at least 1 non-zero value, +// meaning it has been initialized. +func (p ValueCheckerProvider[T]) NotZero() check.Checker[T] { + pass := func(got T) bool { return !reflectutil.IsZero(got) } + expl := func(label string, got any) string { + return p.explainNot(label, "to be a zero value", got) + } + return check.NewChecker(pass, expl) +} + +// SameJSON checks the gotten value and the target value +// produce the same JSON, ignoring formatting and keys order. +// It panics if any error occurs in the marshaling process. +func (p ValueCheckerProvider[T]) SameJSON(tar any) check.Checker[T] { + var gotDec T + var tarDec any + pass := func(got T) bool { + return p.sameJSONProduced(got, tar, &gotDec, &tarDec) + } + expl := func(label string, got any) string { + return p.explain(label, + fmt.Sprintf("json data: %v", tarDec), + fmt.Sprintf("json data: %v", gotDec), + ) + } + return check.NewChecker(pass, expl) +} diff --git a/internal/providers/providers_value_test.go b/internal/providers/providers_value_test.go new file mode 100644 index 0000000..d5f451c --- /dev/null +++ b/internal/providers/providers_value_test.go @@ -0,0 +1,122 @@ +package providers_test + +import ( + "fmt" + "testing" + + "github.com/drykit-go/testx/internal/providers" +) + +func TestValueCheckerProvider(t *testing.T) { + checkValue := providers.ValueCheckerProvider[any]{} + + type Thing struct { + Name string + } + + var ( + vorig = Thing{"hi"} + vsame = Thing{"hi"} + vzero = Thing{} + badval = Thing{"hello"} + badtyp = struct{ Name string }{"hi"} + + emptyMap map[int]bool + emptySlice []float32 + + zeros = []any{0, "", 0i + 0, vzero, emptyMap, emptySlice} + nozeros = []any{1, "hi", 0i + 1, vorig, map[int]bool{}, []float32{}} + ) + + itf := func(v any) any { + return v + } + + t.Run("Is pass", func(t *testing.T) { + c := checkValue.Is(vsame) + assertPassChecker(t, "Value.Is", c, itf(vorig)) + }) + + t.Run("Is fail", func(t *testing.T) { + c := checkValue.Is(badval) + assertFailChecker(t, "Value.Is", c, itf(vorig), makeExpl("{hello}", "{hi}")) + }) + + t.Run("Not pass", func(t *testing.T) { + c := checkValue.Not(badval, badtyp) + assertPassChecker(t, "Value.Not", c, itf(vorig)) + }) + + t.Run("Not fail", func(t *testing.T) { + c := checkValue.Not(badval, vsame, badtyp) + assertFailChecker(t, "Value.Not", c, itf(vorig), makeExpl("not {hi}", "{hi}")) + }) + + t.Run("IsZero pass", func(t *testing.T) { + c := checkValue.IsZero() + for _, z := range zeros { + assertPassChecker(t, "Value.IsZero", c, z) + } + }) + + t.Run("IsZero fail", func(t *testing.T) { + c := checkValue.IsZero() + for _, nz := range nozeros { + assertFailChecker(t, "Value.IsZero", c, nz, makeExpl( + "to be a zero value", + fmt.Sprint(nz), + )) + } + }) + + t.Run("NotZero pass", func(t *testing.T) { + c := checkValue.NotZero() + for _, nz := range nozeros { + assertPassChecker(t, "Value.NotZero", c, nz) + } + }) + + t.Run("NotZero fail", func(t *testing.T) { + c := checkValue.NotZero() + for _, z := range zeros { + assertFailChecker(t, "Value.NotZero", c, z, makeExpl( + "not to be a zero value", + fmt.Sprint(z), + )) + } + }) + + isEvenInt := func(n any) bool { + nint, ok := n.(int) + return ok && nint&1 == 0 + } + + t.Run("Custom pass", func(t *testing.T) { + c := checkValue.Custom("", isEvenInt) + assertPassChecker(t, "Value.Custom", c, 42) + }) + + t.Run("Custom fail", func(t *testing.T) { + c := checkValue.Custom("even int", isEvenInt) + assertFailChecker(t, "Value.Custom", c, -1, makeExpl("even int", "-1")) + }) + + t.Run("SameJSON pass", func(t *testing.T) { + mapequiv := map[string]any{ + "Name": "hi", + } + c := checkValue.SameJSON(mapequiv) + assertPassChecker(t, "Value.SameJSON", c, itf(vorig)) + }) + + t.Run("SameJSON fail", func(t *testing.T) { + mapdiff := map[string]any{ + "Name": "bad", + } + c := checkValue.SameJSON(mapdiff) + assertFailChecker(t, "Value.SameJSON", c, itf(vorig), makeExpl( + "json data: map[Name:bad]", + "json data: map[Name:hi]", + )) + }) +} diff --git a/internal/reflectutil/func.go b/internal/reflectutil/func.go index 804bba3..3c1f845 100644 --- a/internal/reflectutil/func.go +++ b/internal/reflectutil/func.go @@ -14,7 +14,7 @@ func IsFunc(v reflect.Value) bool { // FuncName returns the name of the given func prefixed with // the name of the package it is from. It panics if f is not a func. -func FuncName(fn interface{}) string { +func FuncName(fn any) string { return funcName(reflect.ValueOf(fn)) } @@ -38,13 +38,13 @@ type Func struct { // Call calls Func's underlying func with given args and returns the results // as a slice of empty interfaces. -func (f *Func) Call(args []interface{}) []interface{} { +func (f *Func) Call(args []any) []any { return UnwrapValues(f.Value.Call(WrapValues(args))) } // NewFunc returns a *Func from the given func input, or a non-nil error // if fn's kind is not reflect.Func.' -func NewFunc(fn interface{}) (*Func, error) { +func NewFunc(fn any) (*Func, error) { fval := reflect.ValueOf(fn) if !IsFunc(fval) { return nil, fmt.Errorf("%w: got %v", ErrNotAFunc, fn) diff --git a/internal/reflectutil/func_test.go b/internal/reflectutil/func_test.go index db45c27..29c65aa 100644 --- a/internal/reflectutil/func_test.go +++ b/internal/reflectutil/func_test.go @@ -69,7 +69,7 @@ func TestNewFunc(t *testing.T) { func TestFunc_Call(t *testing.T) { f, _ := reflectutil.NewFunc(ValidFunc) - if got, exp := f.Call([]interface{}{42})[0], 42; got != exp { + if got, exp := f.Call([]any{42})[0], 42; got != exp { t.Errorf("exp %v, got %v", exp, got) } } diff --git a/internal/reflectutil/reflectutil.go b/internal/reflectutil/reflectutil.go index 5ae8876..91571b8 100644 --- a/internal/reflectutil/reflectutil.go +++ b/internal/reflectutil/reflectutil.go @@ -9,18 +9,18 @@ import ( const AnyKind reflect.Kind = 27 // IsZero returns true if v is a zero value. -func IsZero(v interface{}) bool { +func IsZero(v any) bool { return reflect.ValueOf(v).IsZero() } // CallUnwrap calls fn with args and returns the output values -// as []interface{}. -func CallUnwrap(fval reflect.Value, args []interface{}) (output []interface{}) { +// as []any. +func CallUnwrap(fval reflect.Value, args []any) (output []any) { return UnwrapValues(fval.Call(WrapValues(args))) } // WrapValues wraps the input values into reflect.Values. -func WrapValues(values []interface{}) (wrapped []reflect.Value) { +func WrapValues(values []any) (wrapped []reflect.Value) { wrapped = make([]reflect.Value, len(values)) for i, v := range values { wrapped[i] = reflect.ValueOf(v) @@ -29,8 +29,8 @@ func WrapValues(values []interface{}) (wrapped []reflect.Value) { } // UnwrapValues unwraps reflect.Values to empty interfaces. -func UnwrapValues(wrapped []reflect.Value) (values []interface{}) { - values = make([]interface{}, len(wrapped)) +func UnwrapValues(wrapped []reflect.Value) (values []any) { + values = make([]any, len(wrapped)) for i, w := range wrapped { values[i] = w.Interface() } @@ -38,7 +38,7 @@ func UnwrapValues(wrapped []reflect.Value) (values []interface{}) { } // MustBeOfKind panics if v's kind is not exp. -func MustBeOfKind(v interface{}, exp reflect.Kind) { +func MustBeOfKind(v any, exp reflect.Kind) { mustBeOfKind(reflect.ValueOf(v), exp) } diff --git a/internal/reflectutil/reflectutil_test.go b/internal/reflectutil/reflectutil_test.go index 53c222e..33bc8a1 100644 --- a/internal/reflectutil/reflectutil_test.go +++ b/internal/reflectutil/reflectutil_test.go @@ -10,9 +10,9 @@ import ( func TestIsZero(t *testing.T) { t.Run("zeros", func(t *testing.T) { - var zeroMap map[string]interface{} + var zeroMap map[string]any var zeroSlice []int - zeros := []interface{}{ + zeros := []any{ 0, "", 0i + 0, zeroMap, zeroSlice, struct{ n int }{n: 0}, } @@ -24,7 +24,7 @@ func TestIsZero(t *testing.T) { }) t.Run("non zeros", func(t *testing.T) { - nozeros := []interface{}{ + nozeros := []any{ 1, "hi", 0i + 1, map[int]bool{}, []float32{}, struct{ n int }{n: -1}, } @@ -41,8 +41,8 @@ func TestCallUnwrap(t *testing.T) { return y, x } fval := reflect.ValueOf(swap) - got := reflectutil.CallUnwrap(fval, []interface{}{-1., 1.}) - exp := []interface{}{1., -1.} + got := reflectutil.CallUnwrap(fval, []any{-1., 1.}) + exp := []any{1., -1.} if !reflect.DeepEqual(got, exp) { t.Errorf("unexpected output: exp %v, got %v", exp, got) } @@ -51,9 +51,9 @@ func TestCallUnwrap(t *testing.T) { func TestMustBeOfKind(t *testing.T) { t.Run("bad kind", func(t *testing.T) { const kind = reflect.Int8 - badValues := []interface{}{"hi", 1, true, []int8{1}} + badValues := []any{"hi", 1, true, []int8{1}} for _, v := range badValues { - func(v interface{}) { + func(v any) { defer testutil.AssertPanicMessage(t, "expect kind int8, got "+reflect.ValueOf(v).Kind().String(), ) @@ -64,7 +64,7 @@ func TestMustBeOfKind(t *testing.T) { t.Run("good kind", func(_ *testing.T) { for _, tc := range []struct { - val interface{} + val any exp reflect.Kind }{ {val: 42, exp: reflect.Int}, diff --git a/internal/testutil/testutil.go b/internal/testutil/testutil.go index 9b94f94..d48840c 100644 --- a/internal/testutil/testutil.go +++ b/internal/testutil/testutil.go @@ -31,7 +31,7 @@ func AssertPanic(t *testing.T) { assertPanicked(t, r, "", false) } -func assertPanicked(t *testing.T, rec interface{}, msg string, checkmsg bool) { +func assertPanicked(t *testing.T, rec any, msg string, checkmsg bool) { t.Helper() if rec == nil { t.Error("expected to panic but did not") diff --git a/runner.go b/runner.go index 061bf39..c59911f 100644 --- a/runner.go +++ b/runner.go @@ -7,14 +7,14 @@ import ( ) type ( - gottype interface{} + gottype any getfunc func() gottype baseCheck struct { get getfunc getLabel func() string label string - checker check.ValueChecker + checker check.Checker[any] } ) @@ -26,7 +26,7 @@ func (r *baseRunner) addCheck(bc baseCheck) { r.checks = append(r.checks, bc) } -func (r *baseRunner) addChecks(label string, get getfunc, checkers []check.ValueChecker) { +func (r *baseRunner) addChecks(label string, get getfunc, checkers []check.Checker[any]) { for _, c := range checkers { r.addCheck(baseCheck{label: label, get: get, checker: c}) } @@ -59,7 +59,7 @@ func (r *baseRunner) dryRun() baseResults { return res } -func (r *baseRunner) explainCheck(bc baseCheck, got interface{}, passed bool) string { +func (r *baseRunner) explainCheck(bc baseCheck, got any, passed bool) string { if passed { return "" } diff --git a/runner_httphandler.go b/runner_httphandler.go index f70fc94..93c47ce 100644 --- a/runner_httphandler.go +++ b/runner_httphandler.go @@ -7,7 +7,6 @@ import ( "time" "github.com/drykit-go/testx/check" - "github.com/drykit-go/testx/checkconv" "github.com/drykit-go/testx/internal/httpconv" "github.com/drykit-go/testx/internal/ioutil" ) @@ -28,34 +27,34 @@ func (r *httpHandlerRunner) WithRequest(request *http.Request) HTTPHandlerRunner } } -func (r *httpHandlerRunner) Duration(checkers ...check.DurationChecker) HTTPHandlerRunner { +func (r *httpHandlerRunner) Duration(checkers ...check.Checker[time.Duration]) HTTPHandlerRunner { for _, c := range checkers { r.addCheck(baseCheck{ label: "handling duration", get: func() gottype { return r.got.duration }, - checker: checkconv.FromDuration(c), + checker: check.Wrap(c), }) } return r } -func (r *httpHandlerRunner) Request(checkers ...check.HTTPRequestChecker) HTTPHandlerRunner { +func (r *httpHandlerRunner) Request(checkers ...check.Checker[*http.Request]) HTTPHandlerRunner { for _, c := range checkers { r.addCheck(baseCheck{ label: "http request", get: func() gottype { return r.got.request }, - checker: checkconv.FromHTTPRequest(c), + checker: check.Wrap(c), }) } return r } -func (r *httpHandlerRunner) Response(checkers ...check.HTTPResponseChecker) HTTPHandlerRunner { +func (r *httpHandlerRunner) Response(checkers ...check.Checker[*http.Response]) HTTPHandlerRunner { for _, c := range checkers { r.addCheck(baseCheck{ label: "http response", get: func() gottype { return r.got.response }, - checker: checkconv.FromHTTPResponse(c), + checker: check.Wrap(c), }) } return r diff --git a/runner_httphandler_test.go b/runner_httphandler_test.go index 9a0abf6..fd74a37 100644 --- a/runner_httphandler_test.go +++ b/runner_httphandler_test.go @@ -13,7 +13,7 @@ import ( func TestHTTPHandlerRunner(t *testing.T) { hf := func(w http.ResponseWriter, _ *http.Request) { - b, _ := json.Marshal(map[string]interface{}{"message": "Hello, World!"}) + b, _ := json.Marshal(map[string]any{"message": "Hello, World!"}) w.WriteHeader(200) w.Write(b) } @@ -74,8 +74,8 @@ func TestHTTPHandlerRunner(t *testing.T) { nFailed: 2, nChecks: 3, checks: []testx.CheckResult{ - {Passed: false, Reason: "http request:\nexp context to pass ContextChecker\ngot explanation: context:\nexp to have keys [abc]\ngot keys not set"}, - {Passed: false, Reason: "http response:\nexp status code to pass IntChecker\ngot explanation: status code:\nexp -1\ngot 200"}, + {Passed: false, Reason: "http request:\nexp context to pass Checker[context.Context]\ngot explanation: context:\nexp to have keys [abc]\ngot keys not set"}, + {Passed: false, Reason: "http response:\nexp status code to pass Checker[int]\ngot explanation: status code:\nexp -1\ngot 200"}, {Passed: true, Reason: ""}, }, }, diff --git a/runner_table.go b/runner_table.go index c5b3837..efabc84 100644 --- a/runner_table.go +++ b/runner_table.go @@ -7,43 +7,36 @@ import ( "testing" "github.com/drykit-go/cond" + "github.com/drykit-go/slices" "github.com/drykit-go/testx/check" "github.com/drykit-go/testx/internal/fmtexpl" "github.com/drykit-go/testx/internal/reflectutil" ) -var _ TableRunner = (*tableRunner)(nil) - // Case represents a Table test case. It must be provided values for -// Case.In, and Case.Exp or Case.Not or Case.Pass at least. -type Case struct { +// Case.In at least. +type Case[In, Exp any] struct { // Lab is the label of the current case to be printed if the current // case fails. Lab string // In is the input value injected in the tested func. - In interface{} + In In // Exp is the value expected to be returned when calling the tested func. - // If Case.Exp == nil (zero value), no check is added. This is a necessary - // behavior if one wants to use Case.Pass or Case.Not but not Case.Exp. - // To specifically check for a nil value, use ExpNil. - // - // testx.Table(myFunc, nil).Cases([]testx.Case{ - // {In: 123, Pass: checkers}, // Exp == nil, no Exp check added - // {In: 123}, // Exp == nil, no Exp check added - // {In: 123, Exp: nil}, // Exp == nil, no Exp check added - // {In: 123, Exp: testx.ExpNil}, // Exp == ExpNil, expect nil value - // }) - Exp interface{} + // It is ignored if Case.Not or Case.Pass is not empty. + // Otherwise Case.Exp is always evaluated even if not set. + Exp Exp // Not is a slice of values expected not to be returned by the tested func. - Not []interface{} + // If set, Case.Exp is ignored. + Not []Exp - // Pass is a slice of check.ValueChecker that the return value of the + // Pass is a slice of checkers that the return value of the // tested func is expected to pass. - Pass []check.ValueChecker + // If set, Case.Exp is ignored. + Pass []check.Checker[Exp] } // TableConfig is configuration object for TableRunner. @@ -85,10 +78,10 @@ type TableConfig struct { FixedArgs Args } -// Args is an alias to []interface{}. -type Args []interface{} +// Args is an alias to []any. +type Args []any -func (args Args) replaceAt(pos int, arg interface{}) Args { +func (args Args) replaceAt(pos int, arg any) Args { if pos >= len(args) { log.Panic("Args.replaceAt(i, v): i is out of range") } @@ -107,28 +100,28 @@ func (args Args) String() string { return b.String() } -type tableRunner struct { +type tableRunner[In, Exp any] struct { baseRunner config TableConfig - get func(in interface{}) gottype + get func(in In) Exp rfunc *reflectutil.Func args Args } -func (r *tableRunner) Run(t *testing.T) { +func (r *tableRunner[In, Exp]) Run(t *testing.T) { t.Helper() cond.PanicOnErr(r.setGetFunc()) r.run(t) } -func (r *tableRunner) DryRun() TableResulter { +func (r *tableRunner[In, Exp]) DryRun() TableResulter { cond.PanicOnErr(r.setGetFunc()) return tableResults{baseResults: r.dryRun()} } -func (r *tableRunner) setGetFunc() error { +func (r *tableRunner[In, Exp]) setGetFunc() error { if err := r.validateConfig(); err != nil { return err } @@ -138,15 +131,20 @@ func (r *tableRunner) setGetFunc() error { return err } - r.get = func(in interface{}) gottype { + r.get = func(in In) Exp { pin, pout := r.config.InPos, r.config.OutPos r.args = args.replaceAt(pin, in) - return r.rfunc.Call(r.args)[pout] + out, ok := r.rfunc.Call(r.args)[pout].(Exp) + if !ok { + var vnil Exp + return vnil + } + return out } return nil } -func (r *tableRunner) Cases(cases []Case) TableRunner { +func (r *tableRunner[In, Exp]) Cases(cases []Case[In, Exp]) TableRunner[In, Exp] { for i, tc := range cases { i, tc := i, tc @@ -156,7 +154,7 @@ func (r *tableRunner) Cases(cases []Case) TableRunner { return fmtexpl.TableCaseLabel(r.rfunc.Name, i, tc.Lab, r.args) } - addCaseCheck := func(c check.ValueChecker) { + addCaseCheck := func(c check.Checker[any]) { r.addCheck(baseCheck{ get: get, getLabel: getLabel, @@ -165,31 +163,34 @@ func (r *tableRunner) Cases(cases []Case) TableRunner { }) } - // add Case.Exp check - if tc.Exp != nil { - exp := cond.Value(nil, tc.Exp, tc.Exp == ExpNil) - addCaseCheck(check.Value.Is(exp)) - } + hasNotChecks := len(tc.Not) != 0 + hasPassChecks := len(tc.Pass) != 0 + hasExpCheck := !hasNotChecks && !hasPassChecks // add Case.Not checks - if len(tc.Not) != 0 { - addCaseCheck(check.Value.Not(tc.Not...)) + if hasNotChecks { + addCaseCheck(check.Value[any]().Not(slices.AsAny(tc.Not)...)) } // add Case.Pass checks - if len(tc.Pass) != 0 { - r.addChecks(tc.Lab, get, tc.Pass) + if hasPassChecks { + r.addChecks(tc.Lab, get, check.WrapMany(tc.Pass...)) + } + + // add Case.Exp checks + if hasExpCheck { + addCaseCheck(check.Value[any]().Is(tc.Exp)) } } return r } -func (r *tableRunner) Config(cfg TableConfig) TableRunner { +func (r *tableRunner[In, Exp]) Config(cfg TableConfig) TableRunner[In, Exp] { r.config = cfg return r } -func (r *tableRunner) setRfunc(in interface{}) error { +func (r *tableRunner[In, Exp]) setRfunc(in any) error { rfunc, err := reflectutil.NewFunc(in) if err != nil { return fmt.Errorf("Table(func): %w", err) @@ -205,7 +206,7 @@ func (r *tableRunner) setRfunc(in interface{}) error { return nil } -func (r *tableRunner) validateConfig() error { +func (r *tableRunner[In, Exp]) validateConfig() error { validPos := func(pos, max int) bool { return pos >= 0 && pos < max } ftyp := r.rfunc.Value.Type() if pin, nin := r.config.InPos, ftyp.NumIn(); !validPos(pin, nin) { @@ -217,7 +218,7 @@ func (r *tableRunner) validateConfig() error { return nil } -func (r *tableRunner) makeFixedArgs(rfunc *reflectutil.Func, cfg TableConfig) (Args, error) { +func (r *tableRunner[In, Exp]) makeFixedArgs(rfunc *reflectutil.Func, cfg TableConfig) (Args, error) { nparams := rfunc.Value.Type().NumIn() nargs := len(cfg.FixedArgs) @@ -240,8 +241,8 @@ func (r *tableRunner) makeFixedArgs(rfunc *reflectutil.Func, cfg TableConfig) (A } } -func newTableRunner(testedFunc interface{}) TableRunner { - r := &tableRunner{} +func newTableRunner[In, Exp any](testedFunc any) TableRunner[In, Exp] { + r := &tableRunner[In, Exp]{} cond.PanicOnErr(r.setRfunc(testedFunc)) return r } @@ -277,12 +278,3 @@ func (res tableResults) PassedLabel(label string) bool { func (res tableResults) FailedLabel(label string) bool { return !res.PassedLabel(label) } - -/* - ExpNil -*/ - -type expNil int - -// ExpNil is a special value for Case.Exp that sets the expected value to nil. -const ExpNil expNil = 0 diff --git a/runner_table_test.go b/runner_table_test.go index 7697460..b025ea0 100644 --- a/runner_table_test.go +++ b/runner_table_test.go @@ -9,12 +9,11 @@ import ( "github.com/drykit-go/testx" "github.com/drykit-go/testx/check" - "github.com/drykit-go/testx/checkconv" ) // Tests -var expFixedArgs = map[string]interface{}{ +var expFixedArgs = map[string]any{ "a0": []byte("arg0"), "a2": map[rune][][]float64{'π': {[]float64{3.14}}}, } @@ -22,7 +21,7 @@ var expFixedArgs = map[string]interface{}{ // TestTableRunner ensures testx.Table behaves correctly, in particular // when dealing with functions with multiple inputs and outputs. func TestTableRunner(t *testing.T) { - cases := []testx.Case{ + cases := []testx.Case[int, bool]{ {In: 42, Exp: true}, {In: 99, Exp: false, Lab: "odd number"}, } @@ -35,161 +34,138 @@ func TestTableRunner(t *testing.T) { a0, a2 := expFixedArgs["a0"], expFixedArgs["a2"] t.Run("single in single out", func(t *testing.T) { - testx.Table(evenSingle).Cases(cases).Run(t) + testx.Table[int, bool](evenSingle).Cases(cases).Run(t) }) t.Run("single in multiple out", func(t *testing.T) { - testx.Table(evenMultipleOut).Config(testx.TableConfig{ + testx.Table[int, bool](evenMultipleOut).Config(testx.TableConfig{ OutPos: outPos, - }). - Cases(cases). - Run(t) + }).Cases(cases).Run(t) }) t.Run("multiple in single out", func(t *testing.T) { - testx.Table(evenMultipleIn).Config(testx.TableConfig{ + testx.Table[int, bool](evenMultipleIn).Config(testx.TableConfig{ InPos: inPos, - FixedArgs: []interface{}{a0, a2}, // len(FixedArgs) == nparams-1 - }). - Cases(cases). - Run(t) + FixedArgs: []any{a0, a2}, // len(FixedArgs) == nparams-1 + }).Cases(cases).Run(t) }) t.Run("multiple in multiple out", func(t *testing.T) { - testx.Table(evenMultipleInOut).Config(testx.TableConfig{ + testx.Table[int, bool](evenMultipleInOut).Config(testx.TableConfig{ InPos: inPos, OutPos: outPos, - FixedArgs: []interface{}{0: a0, 2: a2}, // len(FixedArgs) == nparams - }). - Cases(cases). - Run(t) - }) - - t.Run("using check.IntChecker", func(t *testing.T) { - testx.Table(double). - Cases([]testx.Case{ - {In: 21, Pass: checkconv.AssertMany(check.Int.Is(42))}, - {In: -4, Pass: checkconv.AssertMany(check.Int.InRange(-10, 0))}, - }). - Run(t) + FixedArgs: []any{0: a0, 2: a2}, // len(FixedArgs) == nparams + }).Cases(cases).Run(t) }) +} - t.Run("expect nil value", func(t *testing.T) { - runner := testx.Table(func(wantnil bool) interface{} { - if wantnil { - return nil - } - return 0 - }).Cases([]testx.Case{ - {In: false, Exp: 0}, - {In: true}, // Exp == nil, no check added - {In: true, Exp: testx.ExpNil}, // expect nil value - }) +func TestTableRunner_Cases(t *testing.T) { + f := func(int) int { return 42 } - runner.Run(t) + t.Run("Case.Not overrides Case.Exp", func(t *testing.T) { + res := testx.Table[int, int](f).Cases([]testx.Case[int, int]{ + {In: 0, Exp: -1, Not: []int{1, 2}}, + }).DryRun() - if n := runner.DryRun().NChecks(); n != 2 { - t.Errorf("exp 2 checks, got %d", n) + if n := res.NChecks(); n != 1 { + t.Errorf("exp 1 check, got %d", n) + } + if res.Failed() { + t.Error("exp to pass, failed") } }) - t.Run("Case.Not checks", func(t *testing.T) { - results := testx.Table(func(n int) int { return n }). - Cases([]testx.Case{ - {In: 0, Not: []interface{}{-1, 1}}, // pass - {In: 0, Not: []interface{}{0}}, // fail - }). - DryRun() + t.Run("Case.Pass overrides Case.Exp", func(t *testing.T) { + res := testx.Table[int, int](f).Cases([]testx.Case[int, int]{ + {In: 0, Exp: -1, Pass: []check.Checker[int]{check.Int.InRange(41, 43)}}, + }).DryRun() - if nc := results.NChecks(); nc != 2 { - t.Errorf("exp 2 checks, got %d", nc) - } - if results.FailedAt(0) { - t.Error("exp Case 0 to pass, got fail") + if n := res.NChecks(); n != 1 { + t.Errorf("exp 1 check, got %d", n) } - if results.PassedAt(1) { - t.Error("exp Case 1 to fail, got pass") + if res.Failed() { + t.Error("exp to pass, failed") } }) - t.Run("test case labels", func(t *testing.T) { - results := testx.Table(divide).Config(testx.TableConfig{ - InPos: 1, - OutPos: 1, - FixedArgs: testx.Args{42.0}, - }).Cases([]testx.Case{ - {In: 0.0, Exp: testx.ExpNil, Lab: "zeroth case"}, // fail - {In: 0.0, Exp: testx.ExpNil, Lab: "first case"}, // fail + t.Run("Case.Exp used if Case.Not and Case.Pass not set", func(t *testing.T) { + res := testx.Table[int, int](f).Cases([]testx.Case[int, int]{ + {In: 0, Exp: 42}, }).DryRun() - expLabels := []string{ - `Table.Cases[0] "zeroth case" testx_test.divide(42, 0)`, - `Table.Cases[1] "first case" testx_test.divide(42, 0)`, + if n := res.NChecks(); n != 1 { + t.Errorf("exp 1 check, got %d", n) } - - for i, c := range results.Checks() { - got := c.Reason - exp := expLabels[i] - if !strings.HasPrefix(got, exp) { - t.Errorf("bad label output\nexp %s\ngot %s", got, exp) - } + if res.Failed() { + t.Error("exp to pass, failed") } }) -} -func TestExpNil(t *testing.T) { - t.Run("Exp=ExpNil expects nil", func(t *testing.T) { - f := func(int) interface{} { return nil } - res := testx.Table(f).Cases([]testx.Case{ - {In: 0, Exp: testx.ExpNil}, + t.Run("Case.Exp used if no value set", func(t *testing.T) { + res := testx.Table[int, int](f).Cases([]testx.Case[int, int]{ + {}, }).DryRun() if n := res.NChecks(); n != 1 { t.Errorf("exp 1 check, got %d", n) } - if res.Failed() { - t.Error("nil did not pass Case.Exp == ExpNil") + if expl := res.Checks()[0].Reason; !strings.Contains(expl, "exp 0\ngot 42") { + t.Error("got unexpected explain:\n" + expl) } }) - t.Run("Exp=ExpNil does not expect 0", func(t *testing.T) { - f := func(int) int { return 0 } - res := testx.Table(f).Cases([]testx.Case{ - {In: 0, Exp: testx.ExpNil}, + t.Run("Case.Exp == nil", func(t *testing.T) { + res := testx.Table[bool, any](func(expnil bool) any { + if expnil { + return nil + } + return 0 + }).Cases([]testx.Case[bool, any]{ + {In: false, Exp: 0}, + {In: true, Exp: nil}, // expect nil + {In: true}, // expect nil }).DryRun() - if n := res.NChecks(); n != 1 { - t.Errorf("exp 1 check, got %d", n) + if n := res.NChecks(); n != 3 { + t.Errorf("exp 3 checks, got %d", n) } - if res.Passed() { - t.Error("0 did pass Case.Exp == ExpNil") + if res.Failed() { + t.Error("exp to pass, failed") } }) - t.Run("Exp=0 does not expect nil", func(t *testing.T) { - f := func(int) interface{} { return nil } - res := testx.Table(f).Cases([]testx.Case{ - {In: 0, Exp: 0}, + t.Run("Case.Lab", func(t *testing.T) { + results := testx.Table[float64, error](divide).Config(testx.TableConfig{ + InPos: 1, + OutPos: 1, + FixedArgs: testx.Args{42.0}, + }).Cases([]testx.Case[float64, error]{ + {In: 0.0, Exp: nil, Lab: "zeroth case"}, // fail + {In: 0.0, Exp: nil, Lab: "first case"}, // fail }).DryRun() - if n := res.NChecks(); n != 1 { - t.Errorf("exp 1 check, got %d", n) + expLabelPrefixes := []string{ + `Table.Cases[0] "zeroth case" testx_test.divide(42, 0)`, + `Table.Cases[1] "first case" testx_test.divide(42, 0)`, } - if res.Passed() { - t.Error("nil did pass Case.Exp == 0") + + for i, c := range results.Checks() { + got := c.Reason + exp := expLabelPrefixes[i] + if !strings.HasPrefix(got, exp) { + t.Errorf("bad label output\nexp %s\ngot %s", got, exp) + } } }) } func TestTableRunnerResults(t *testing.T) { t.Run("pass", func(t *testing.T) { - res := testx. - Table(evenSingle). - Cases([]testx.Case{ + res := testx.Table[int, bool](evenSingle). + Cases([]testx.Case[int, bool]{ {In: 10, Exp: true, Lab: "even number"}, {In: 11, Exp: false, Lab: "odd number"}, - }). - DryRun() + }).DryRun() exp := tableResults{ baseResults: baseResults{ @@ -213,14 +189,12 @@ func TestTableRunnerResults(t *testing.T) { }) t.Run("fail", func(t *testing.T) { - res := testx. - Table(evenSingle). - Cases([]testx.Case{ + res := testx.Table[int, bool](evenSingle). + Cases([]testx.Case[int, bool]{ {In: 10, Exp: true, Lab: "even number"}, // pass {In: -1, Exp: true, Lab: "odd number"}, // fail {In: -1, Exp: true}, // fail - }). - DryRun() + }).DryRun() exp := tableResults{ baseResults: baseResults{ @@ -251,7 +225,7 @@ func evenSingle(a1 int) bool { return a1&1 == 0 } -func evenMultipleOut(a1 int) (string, interface{}, bool, int) { +func evenMultipleOut(a1 int) (string, any, bool, int) { return "", struct{}{}, evenSingle(a1), -1 } @@ -260,7 +234,7 @@ func evenMultipleIn(a0 []byte, a1 int, a2 map[rune][][]float64) bool { return evenSingle(a1) } -func evenMultipleInOut(a0 []byte, a1 int, a2 map[rune][][]float64) (string, interface{}, bool, int) { +func evenMultipleInOut(a0 []byte, a1 int, a2 map[rune][][]float64) (string, any, bool, int) { panicOnUnexpectedArgs(a0, a2) return evenMultipleOut(a1) } diff --git a/runner_test.go b/runner_test.go index a962d13..bd22b85 100644 --- a/runner_test.go +++ b/runner_test.go @@ -32,8 +32,8 @@ func assertEqualBaseResults(t *testing.T, res testx.Resulter, exp baseResults) { // Validate remaining fields for _, fv := range []struct { lab string - got interface{} - exp interface{} + got any + exp any }{ {lab: "passed", got: got.passed, exp: exp.passed}, {lab: "failed", got: got.failed, exp: exp.failed}, @@ -74,7 +74,7 @@ func failWithErrors(t *testing.T, label string, errs ...string) { t.Errorf("bad results: %s\n%s", label, strings.Join(errs, "\n")) } -func failBadResults(t *testing.T, label string, got, exp interface{}) { +func failBadResults(t *testing.T, label string, got, exp any) { t.Helper() t.Errorf("bad results: %s\nexp %#v\ngot %#v", label, exp, got) } diff --git a/runner_value.go b/runner_value.go index 34b446b..f8dba03 100644 --- a/runner_value.go +++ b/runner_value.go @@ -6,40 +6,45 @@ import ( "github.com/drykit-go/testx/check" ) -var _ ValueRunner = (*valueRunner)(nil) +var _ ValueRunner[any] = (*valueRunner[any])(nil) -type valueRunner struct { +type valueRunner[T any] struct { baseRunner - value interface{} + value T } -func (r *valueRunner) Run(t *testing.T) { +func (r *valueRunner[T]) Run(t *testing.T) { t.Helper() r.run(t) } -func (r *valueRunner) DryRun() Resulter { +func (r *valueRunner[T]) DryRun() Resulter { return r.dryRun() } -func (r *valueRunner) Exp(value interface{}) ValueRunner { - r.addValueCheck(check.Value.Is(value)) +func (r *valueRunner[T]) Exp(value T) ValueRunner[T] { + r.addValueCheck(check.Value[any]().Is(value)) return r } -func (r *valueRunner) Not(values ...interface{}) ValueRunner { - r.addValueCheck(check.Value.Not(values...)) +func (r *valueRunner[T]) Not(values ...T) ValueRunner[T] { + // TODO: find a way to cast properly + valuesitf := []any{} + for _, v := range values { + valuesitf = append(valuesitf, v) + } + r.addValueCheck(check.Value[any]().Not(valuesitf...)) return r } -func (r *valueRunner) Pass(checkers ...check.ValueChecker) ValueRunner { +func (r *valueRunner[T]) Pass(checkers ...check.Checker[T]) ValueRunner[T] { for _, c := range checkers { - r.addValueCheck(c) + r.addValueCheck(check.Wrap(c)) } return r } -func (r *valueRunner) addValueCheck(c check.ValueChecker) { +func (r *valueRunner[T]) addValueCheck(c check.Checker[any]) { r.addCheck(baseCheck{ label: "value", get: func() gottype { return r.value }, @@ -47,6 +52,6 @@ func (r *valueRunner) addValueCheck(c check.ValueChecker) { }) } -func newValueRunner(v interface{}) ValueRunner { - return &valueRunner{value: v} +func newValueRunner[T any](v T) ValueRunner[T] { + return &valueRunner[T]{value: v} } diff --git a/runner_value_test.go b/runner_value_test.go index ec971e3..fac93f4 100644 --- a/runner_value_test.go +++ b/runner_value_test.go @@ -5,27 +5,27 @@ import ( "github.com/drykit-go/testx" "github.com/drykit-go/testx/check" - "github.com/drykit-go/testx/checkconv" ) func TestValueRunner(t *testing.T) { t.Run("should pass", func(t *testing.T) { res := testx.Value(42). Exp(42). - Not(3, "hello"). - Pass(checkconv.FromInt(check.Int.InRange(41, 43))). + Not(3, -1). + Pass(check.Int.InRange(41, 43), check.Int.GT(10)). DryRun() exp := baseResults{ passed: true, failed: false, - nPassed: 3, + nPassed: 4, nFailed: 0, - nChecks: 3, + nChecks: 4, checks: []testx.CheckResult{ {Passed: true, Reason: ""}, {Passed: true, Reason: ""}, {Passed: true, Reason: ""}, + {Passed: true, Reason: ""}, }, } @@ -37,7 +37,7 @@ func TestValueRunner(t *testing.T) { Exp(99). Not(99). Not(99, 42). - Pass(checkconv.FromInt(check.Int.LT(10))). + Pass(check.Int.LT(10)). DryRun() exp := baseResults{ diff --git a/testx.go b/testx.go index 84cf3ac..2c495f4 100644 --- a/testx.go +++ b/testx.go @@ -23,31 +23,31 @@ type Runner interface { } // ValueRunner provides methods to perform tests on a single value. -type ValueRunner interface { +type ValueRunner[T any] interface { Runner // DryRun returns a Resulter to access test results // without running *testing.T. DryRun() Resulter // Exp adds an equality check on the tested value. - Exp(value interface{}) ValueRunner + Exp(value T) ValueRunner[T] // Not adds inequality checks on the tested value. - Not(values ...interface{}) ValueRunner + Not(values ...T) ValueRunner[T] // Pass adds checkers on the tested value. - Pass(checkers ...check.ValueChecker) ValueRunner + Pass(checkers ...check.Checker[T]) ValueRunner[T] } // TableRunner provides methods to run a series of test cases // on a single function. -type TableRunner interface { +type TableRunner[In, Exp any] interface { Runner // DryRun returns a TableResulter to access test results // without running *testing.T. DryRun() TableResulter // Config sets configures the TableRunner for functions of multiple // parameters or multiple return values. - Config(cfg TableConfig) TableRunner + Config(cfg TableConfig) TableRunner[In, Exp] // Cases adds test cases to be run on the tested func. - Cases(cases []Case) TableRunner + Cases(cases []Case[In, Exp]) TableRunner[In, Exp] } // HTTPHandlerRunner provides methods to run tests on http handlers @@ -63,11 +63,11 @@ type HTTPHandlerRunner interface { WithRequest(*http.Request) HTTPHandlerRunner // Request adds checkers on the resulting request, // after the last middleware is called and before the handler is called. - Request(...check.HTTPRequestChecker) HTTPHandlerRunner + Request(...check.Checker[*http.Request]) HTTPHandlerRunner // Response adds checkers on the written response. - Response(...check.HTTPResponseChecker) HTTPHandlerRunner + Response(...check.Checker[*http.Response]) HTTPHandlerRunner // Duration adds checkers on the handler's execution time; - Duration(...check.DurationChecker) HTTPHandlerRunner + Duration(...check.Checker[time.Duration]) HTTPHandlerRunner } /* @@ -139,7 +139,7 @@ func (cr CheckResult) String() string { */ // Value returns a ValueRunner to run tests on a single value. -func Value(v interface{}) ValueRunner { +func Value[T any](v T) ValueRunner[T] { return newValueRunner(v) } @@ -170,6 +170,6 @@ func HTTPHandlerFunc( // Table returns a TableRunner to run test cases on a func. By default, // it works with funcs having a single input and output value. // Use TableRunner.Config to configure it for a more complex functions. -func Table(testedFunc interface{}) TableRunner { - return newTableRunner(testedFunc) +func Table[In, Exp any](testedFunc any) TableRunner[In, Exp] { + return newTableRunner[In, Exp](testedFunc) }