utils

Documentation

Index

• Constants
• func ArrayElements(inter *interpreter.Interpreter, array *interpreter.ArrayValue) []interpreter.Value
• func AssertEqualWithDiff(t *testing.T, expected, actual any)
• func AssertValueSlicesEqual(t testing.TB, inter *interpreter.Interpreter, ...) bool
• func AssertValuesEqual(t testing.TB, interpreter *interpreter.Interpreter, ...) bool
• func DeploymentTransaction(name string, contract []byte) []byte
• func DictionaryKeyValues(inter *interpreter.Interpreter, dict *interpreter.DictionaryValue) []interpreter.Value
• func RemovalTransaction(name string) []byte
• func RequireError(t *testing.T, err error)
• func RequireValuesEqual(t testing.TB, inter *interpreter.Interpreter, ...)
• func UpdateTransaction(name string, contract []byte) []byte
• func ValuesAreEqual(inter *interpreter.Interpreter, expected, actual interpreter.Value) bool
• type DictionaryEntry
  • func DictionaryEntries[K, V any](inter *interpreter.Interpreter, dict *interpreter.DictionaryValue, ...) ([]DictionaryEntry[K, V], bool)
• type OccurrenceMatcher
  • func (matcher *OccurrenceMatcher) Match(actual any) bool

Constants

const ImportedLocation = common.StringLocation("imported")

ImportedLocation is used as the default location for imported programs in tests.

const TestLocation = common.StringLocation("test")

TestLocation is used as the default location for programs in tests.

Functions

func ArrayElements

func ArrayElements(inter *interpreter.Interpreter, array *interpreter.ArrayValue) []interpreter.Value

func AssertEqualWithDiff

func AssertEqualWithDiff(t *testing.T, expected, actual any)

AssertEqualWithDiff asserts that two objects are equal.

If the objects are not equal, this function prints a human-readable diff.

func AssertValueSlicesEqual

func AssertValueSlicesEqual(t testing.TB, inter *interpreter.Interpreter, expected, actual []interpreter.Value) bool

func AssertValuesEqual

func AssertValuesEqual(t testing.TB, interpreter *interpreter.Interpreter, expected, actual interpreter.Value) bool

func DeploymentTransaction

func DeploymentTransaction(name string, contract []byte) []byte

func DictionaryKeyValues

func DictionaryKeyValues(inter *interpreter.Interpreter, dict *interpreter.DictionaryValue) []interpreter.Value

func RemovalTransaction

func RemovalTransaction(name string) []byte

func RequireError

func RequireError(t *testing.T, err error)

RequireError is a wrapper around require.Error which also ensures that the error message, the secondary message (if any), and the error notes' (if any) messages can be successfully produced

func RequireValuesEqual

func RequireValuesEqual(t testing.TB, inter *interpreter.Interpreter, expected, actual interpreter.Value)

func UpdateTransaction

func UpdateTransaction(name string, contract []byte) []byte

func ValuesAreEqual

func ValuesAreEqual(inter *interpreter.Interpreter, expected, actual interpreter.Value) bool

Types

type DictionaryEntry

type DictionaryEntry[K, V any] struct {
	Key   K
	Value V
}

func DictionaryEntries

func DictionaryEntries[K, V any](
	inter *interpreter.Interpreter,
	dict *interpreter.DictionaryValue,
	fromKey func(interpreter.Value) (K, bool),
	fromVal func(interpreter.Value) (V, bool),
) ([]DictionaryEntry[K, V], bool)

DictionaryEntries is similar to DictionaryKeyValues, attempting to map untyped Values to concrete values using the provided morphisms. If a conversion fails, then this function returns (nil, false). Useful in contexts when Cadence values need to be extracted into their go counterparts.

type OccurrenceMatcher

type OccurrenceMatcher struct {
	OriginStartPos  *sema.Position
	OriginEndPos    *sema.Position
	StartPos        sema.Position
	EndPos          sema.Position
	DeclarationKind common.DeclarationKind
}

func (*OccurrenceMatcher) Match

func (matcher *OccurrenceMatcher) Match(actual any) bool