testing

Documentation

Overview

Package testing provides Gomega matchers for use with optional.Value values.

Index

• Variables
• func HaveValueEqualing[T any](arg T) types.GomegaMatcher
• func HaveValueMatching[T any](matcher types.GomegaMatcher) types.GomegaMatcher

Variables

var BeEmpty = gomega.BeEmpty

BeEmpty asserts that the tested value is an empty optional.Value with type T.

Functions

func HaveValueEqualing

func HaveValueEqualing[T any](arg T) types.GomegaMatcher

HaveValueEqualing checks wheter an optional.Value holds a value equal to the given value. Be careful when negating this matcher.

Expect(v).NotTo(HaveValueEqualing(3)) // !!! Fails when !v.Present _or_ when v.Get() != 3

More likely, you want to check that the optional.Value contains a value, and that the contained value is not equal to something. Use HaveValueMatching for that and negate the wrapped matcher. For example:

Expect(v).To(HaveValueMatching[int](Not(Equal(3))))

func HaveValueMatching

func HaveValueMatching[T any](matcher types.GomegaMatcher) types.GomegaMatcher

HaveValueMatching checks whether an optional.Value holds a value that matches the given matcher. Be careful when negating this matcher. You probably don't want to negate this matcher; doing so will cause it to pass either when the value is empty or when the wrapped matcher fails.

Expect(v).NotTo(HaveValueMatching[string](HaveLen(3))) // !!! Fails when !v.Present _or_ when len(v.Get()) != 3

If you want to check for an empty value, then use BeEmpty:

Expect(v).To(BeEmpty())

If you want to check that a value is present that doesn't match, then negate the wrapped matcher:

Expect(v).To(HaveValueMatching[string](Not(HaveLen(3))))