testutil

README

Testutil Directory

The x/common/testutil directory is not a cosmos-sdk module perse, but a collection of test utilities to make testing the other x/modules.

Documentation

Overview

Package nullify provides methods to init nil values structs for test assertion.

Index

• Variables
• func AccAddress() sdk.AccAddress
• func AssertEventsPresent(t *testing.T, events sdk.Events, eventsType []string)
• func BlankContext(storeKeyName string) sdk.Context
• func EventHasAttributeValue(abciEvent sdk.Event, key string, want string) error
• func Fill(x interface{}) interface{}
• func FilterNewEvents(beforeEvents, afterEvents sdk.Events) sdk.Events
• func PrivKey() (*secp256k1.PrivKey, sdk.AccAddress)
• func PrivKeyAddressPairs(n int) (keys []cryptotypes.PrivKey, addrs []sdk.AccAddress)
• func RandStringBytes(n int) string
• func RequireContainsTypedEvent(t require.TestingT, ctx sdk.Context, event proto.Message)
• func RequireHasTypedEvent(t require.TestingT, ctx sdk.Context, event proto.Message)
• func RequireNotHasTypedEvent(t require.TestingT, ctx sdk.Context, event proto.Message)
• func RunFunctionTests(t *testing.T, testCases []FunctionTestCase)
• func SetupClientCtx(t *testing.T) context.Context
• type FunctionTestCase
• type FunctionTestCases
• type TypeLatin

Variables

var Latin = TypeLatin{
	Letters:    "abcdefghijklmnopqrstuvwxyz",
	CapLetters: "ABCDEFGHIJKLMNOPQRSTUVWXYZ",
	Numbers:    "0123456789",
}

Functions

func AccAddress

func AccAddress() sdk.AccAddress

AccAddress returns a sample address (sdk.AccAddress) created using secp256k1. Note that AccAddress().String() can be used to get a string representation.

func AssertEventsPresent

func AssertEventsPresent(t *testing.T, events sdk.Events, eventsType []string)

AssertEventsPresent fails the test if the given eventsType are not present in the events

func BlankContext

func BlankContext(storeKeyName string) sdk.Context

func EventHasAttributeValue

func EventHasAttributeValue(abciEvent sdk.Event, key string, want string) error

EventHasAttributeValue parses the given ABCI event at a key to see if it matches (contains) the wanted value.

Args:

• abciEvent: The event under test
• key: The key for which we'll check the value
• want: The desired value

func Fill

func Fill(x interface{}) interface{}

Fill analyze all struct fields and slices with reflection and initialize the nil and empty slices, structs, and pointers.

func FilterNewEvents

func FilterNewEvents(beforeEvents, afterEvents sdk.Events) sdk.Events

FilterNewEvents returns only the new events from afterEvents that were not present in beforeEvents

func PrivKey

func PrivKey() (*secp256k1.PrivKey, sdk.AccAddress)

PrivKey returns a private key and corresponding on-chain address.

func PrivKeyAddressPairs

func PrivKeyAddressPairs(n int) (keys []cryptotypes.PrivKey, addrs []sdk.AccAddress)

PrivKeyAddressPairs generates (deterministically) a total of n private keys and addresses.

func RandStringBytes

func RandStringBytes(n int) string

func RequireContainsTypedEvent

func RequireContainsTypedEvent(t require.TestingT, ctx sdk.Context, event proto.Message)

func RequireHasTypedEvent

func RequireHasTypedEvent(t require.TestingT, ctx sdk.Context, event proto.Message)

func RequireNotHasTypedEvent

func RequireNotHasTypedEvent(t require.TestingT, ctx sdk.Context, event proto.Message)

func RunFunctionTests

func RunFunctionTests(t *testing.T, testCases []FunctionTestCase)

func SetupClientCtx

func SetupClientCtx(t *testing.T) context.Context

SetupClientCtx configures the client and server contexts and returns the resultant 'context.Context'. This is useful for executing CLI commands.

Types

type FunctionTestCase

type FunctionTestCase struct {
	Name string
	Test func()
}

type FunctionTestCases

type FunctionTestCases = []FunctionTestCase

type TypeLatin

type TypeLatin struct {
	Letters    string
	CapLetters string
	Numbers    string
}