README
¶
Testutil Directory
The x/nutil/testutil directory is not a Cosmos SDK module itself. It is a collection of test utilities for testing the other x/modules.
For app-backed tests, prefer the helpers in testapp for app and context setup.
Use table-driven tests or testify suites for structure, and use the block
helpers in testapp/block.go when tests need to advance block height or time.
Documentation
¶
Overview ¶
Package nullify provides methods to init nil values structs for test assertion.
Index ¶
- Constants
- Variables
- func AssertEventPresent(events sdk.Events, eventType string) error
- func AssertEventsPresent(events sdk.Events, eventTypes []string) (err error)
- func BlankContext(storeKeyName string) sdk.Context
- func EventHasAttributeValue(abciEvent sdk.Event, key string, want string) error
- func Fill(x any) any
- func FilterNewEvents(beforeEvents, afterEvents sdk.Events) sdk.Events
- func FindAbciEventsOfType(events []abci.Event, eventType string) []abci.Event
- func FindEventsOfType(events sdk.Events, eventType string) []sdk.Event
- func GetPackageDir() (string, error)
- func GovModuleAddr() sdk.AccAddress
- func NewAccAddress() sdk.AccAddress
- func NewPrivKey() (*secp256k1.PrivKey, sdk.AccAddress)
- func PrivKeyAddressPairs(n int) (keys []cryptotypes.PrivKey, addrs []sdk.AccAddress)
- func RandLetters(n int) string
- func RequireContainsTypedEvent(t require.TestingT, ctx sdk.Context, event proto.Message)
- func RequireNotHasTypedEvent(t require.TestingT, ctx sdk.Context, event proto.Message)
- func RunFunctionTestSuite(s *suite.Suite, testCases []FunctionTestCase)
- func RunFunctionTests(t *testing.T, testCases []FunctionTestCase)
- func SetupClientCtx(t *testing.T) context.Context
- type FunctionTestCase
- type FunctionTestCases
- type LogRoutingSuite
- type TypeLatin
Constants ¶
const ( ADDR_GUARD_CREAM = "nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl" ADDR_SUDO_ROOT = "nibi1qqx5reauy4glpskmppy88pz25qp2py5yxvpxdt" )
Variables ¶
var Latin = TypeLatin{
Letters: "abcdefghijklmnopqrstuvwxyz",
CapLetters: "ABCDEFGHIJKLMNOPQRSTUVWXYZ",
Numbers: "0123456789",
}
Functions ¶
func AssertEventPresent ¶
AssertEventPresent: Errors if the given event type is not present in events
func AssertEventsPresent ¶
AssertEventsPresent: Errors if the given event types are not present in events
func BlankContext ¶
func EventHasAttributeValue ¶
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 ¶
Fill analyze all struct fields and slices with reflection and initialize the nil and empty slices, structs, and pointers.
func FilterNewEvents ¶
FilterNewEvents returns only the new events from afterEvents that were not present in beforeEvents
func FindAbciEventsOfType ¶
FindAbciEventsOfType searches through events to find types you care about.
func FindEventsOfType ¶
FindEventsOfType searches through events to find types you care about.
func GetPackageDir ¶
GetPackageDir: Returns the absolute path of the Golang package that calls this function.
func GovModuleAddr ¶
func GovModuleAddr() sdk.AccAddress
func NewAccAddress ¶ added in v2.14.0
func NewAccAddress() sdk.AccAddress
NewAccAddress returns a sample address (sdk.NewAccAddress) created using secp256k1. Note that NewAccAddress().String() can be used to get a string representation.
func NewPrivKey ¶ added in v2.14.0
func NewPrivKey() (*secp256k1.PrivKey, sdk.AccAddress)
NewPrivKey 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 RandLetters ¶
func RequireNotHasTypedEvent ¶
RequireNotHasTypedEvent: Error if an event type matches the proto.Message name
func RunFunctionTestSuite ¶
func RunFunctionTestSuite(s *suite.Suite, testCases []FunctionTestCase)
func RunFunctionTests ¶
func RunFunctionTests(t *testing.T, testCases []FunctionTestCase)
Types ¶
type FunctionTestCase ¶
type FunctionTestCase struct {
Name string
Test func()
}
type FunctionTestCases ¶
type FunctionTestCases = []FunctionTestCase
type LogRoutingSuite ¶
LogRoutingSuite routes standard library log output through the active testify suite's testing.T, so log.Print* calls show up with `go test -v`.
Embed this suite in tests that need routed log output. If the embedding suite defines its own SetupSuite, testify will call that method instead of the embedded one, so the suite must call s.LogRoutingSuite.SetupSuite() itself.
func (*LogRoutingSuite) SetupSuite ¶
func (s *LogRoutingSuite) SetupSuite()
SetupSuite configures the global standard library logger to write through the suite. Call this explicitly from user-defined SetupSuite methods on suites that embed LogRoutingSuite.
Source Files
Directories