Alexander Peters 6b20ef7388

docs: system test tutorial (#20812 )

Co-authored-by: Julien Robert <julien@rbrt.fr>

2024-09-05 04:24:03 +00:00

1.3 KiB

Raw Blame History

Testing

Test framework for system tests. Starts and interacts with a (multi node) blockchain in Go. Supports

CLI
Servers
Events
RPC

Uses:

testify
gjson
sjson

Server and client side are executed on the host machine.

Developer

Test strategy

System tests cover the full stack via cli and a running (multi node) network. They are more expensive (in terms of time/ cpu) to run compared to unit or integration tests. Therefore, we focus on the critical path and do not cover every condition.

How to use

Read the getting_started.md guide to get started.

Execute a single test

go test -tags system_test -count=1 -v . --run TestStakeUnstake  -verbose

Test cli parameters

-verbose verbose output
-wait-time duration - time to wait for chain events (default 30s)
-nodes-count int - number of nodes in the cluster (default 4)

Port ranges

With n nodes:

26657 - 26657+n - RPC
1317 - 1317+n - API
9090 - 9090+n - GRPC
16656 - 16656+n - P2P

For example Node 3 listens on 26660 for RPC calls

Resources

gjson query syntax

Disclaimer

This is based on the system test framework in wasmd built by Confio.

1.3 KiB Raw Blame History