Values
func Values(val any) TestDeep
Values is a smuggler operator. It takes a map and compares its
ordered values to val.
val can be a slice of items of the same type as the map values:
got := map[int]string{3: "c", 1: "a", 2: "b"}
td.Cmp(t, got, td.Values([]string{"a", "b", "c"})) // succeeds, values sorted
td.Cmp(t, got, td.Values([]string{"c", "a", "b"})) // fails as not sorted
as well as an other operator as Bag, for example, to test values in
an unsorted manner:
got := map[int]string{3: "c", 1: "a", 2: "b"}
td.Cmp(t, got, td.Values(td.Bag("c", "a", "b"))) // succeeds
See also Keys.
See also Values godoc.
Example
Base example
t := &testing.T{}
got := map[string]int{"foo": 1, "bar": 2, "zip": 3}
// Values tests values in an ordered manner
ok := td.Cmp(t, got, td.Values([]int{1, 2, 3}))
fmt.Println("All sorted values are found:", ok)
// If the expected values are not ordered, it fails
ok = td.Cmp(t, got, td.Values([]int{3, 1, 2}))
fmt.Println("All unsorted values are found:", ok)
// To circumvent that, one can use Bag operator
ok = td.Cmp(t, got, td.Values(td.Bag(3, 1, 2)))
fmt.Println("All unsorted values are found, with the help of Bag operator:", ok)
// Check that each value is between 1 and 3
ok = td.Cmp(t, got, td.Values(td.ArrayEach(td.Between(1, 3))))
fmt.Println("Each value is between 1 and 3:", ok)
// Output:
// All sorted values are found: true
// All unsorted values are found: false
// All unsorted values are found, with the help of Bag operator: true
// Each value is between 1 and 3: true
CmpValues shortcut
func CmpValues(t TestingT, got, val any, args ...any) bool
CmpValues is a shortcut for:
td.Cmp(t, got, td.Values(val), args...)
See above for details.
Returns true if the test is OK, false if it fails.
If t is a *T then its Config field is inherited.
args… are optional and allow to name the test. This name is
used in case of failure to qualify the test. If len(args) > 1 and
the first item of args is a string and contains a ‘%’ rune then
fmt.Fprintf is used to compose the name, else args are passed to
fmt.Fprint. Do not forget it is the name of the test, not the
reason of a potential failure.
See also CmpValues godoc.
Example
Base example
t := &testing.T{}
got := map[string]int{"foo": 1, "bar": 2, "zip": 3}
// Values tests values in an ordered manner
ok := td.CmpValues(t, got, []int{1, 2, 3})
fmt.Println("All sorted values are found:", ok)
// If the expected values are not ordered, it fails
ok = td.CmpValues(t, got, []int{3, 1, 2})
fmt.Println("All unsorted values are found:", ok)
// To circumvent that, one can use Bag operator
ok = td.CmpValues(t, got, td.Bag(3, 1, 2))
fmt.Println("All unsorted values are found, with the help of Bag operator:", ok)
// Check that each value is between 1 and 3
ok = td.CmpValues(t, got, td.ArrayEach(td.Between(1, 3)))
fmt.Println("Each value is between 1 and 3:", ok)
// Output:
// All sorted values are found: true
// All unsorted values are found: false
// All unsorted values are found, with the help of Bag operator: true
// Each value is between 1 and 3: true
T.Values shortcut
func (t *T) Values(got, val any, args ...any) bool
Values is a shortcut for:
t.Cmp(got, td.Values(val), args...)
See above for details.
Returns true if the test is OK, false if it fails.
args… are optional and allow to name the test. This name is
used in case of failure to qualify the test. If len(args) > 1 and
the first item of args is a string and contains a ‘%’ rune then
fmt.Fprintf is used to compose the name, else args are passed to
fmt.Fprint. Do not forget it is the name of the test, not the
reason of a potential failure.
See also T.Values godoc.
Example
Base example
t := td.NewT(&testing.T{})
got := map[string]int{"foo": 1, "bar": 2, "zip": 3}
// Values tests values in an ordered manner
ok := t.Values(got, []int{1, 2, 3})
fmt.Println("All sorted values are found:", ok)
// If the expected values are not ordered, it fails
ok = t.Values(got, []int{3, 1, 2})
fmt.Println("All unsorted values are found:", ok)
// To circumvent that, one can use Bag operator
ok = t.Values(got, td.Bag(3, 1, 2))
fmt.Println("All unsorted values are found, with the help of Bag operator:", ok)
// Check that each value is between 1 and 3
ok = t.Values(got, td.ArrayEach(td.Between(1, 3)))
fmt.Println("Each value is between 1 and 3:", ok)
// Output:
// All sorted values are found: true
// All unsorted values are found: false
// All unsorted values are found, with the help of Bag operator: true
// Each value is between 1 and 3: true