Testing

Running tests on go-ethereum

All commands (unless stated otherwise) are assumed to be run from $GOPATH/src/github.com/ethereumproject/go-ethereum. You should have the latest Go installed (>= 1.8).

Unit tests

See Travis or Coveralls for status.

Test the full codebase locally by changing to the repository directory and running

go test ./...

Integration tests

Integration tests for Go are included in the tests directory and can be run with standard go testing (i.e. go test). To run all the integration tests simply run:

go test ./tests/

Run a specific module with:

go test ./core/...

Or a specific test file:

go test ./core/config_test.go

Bats

Geth uses [sstephenson/bats: Bash Automated Testing System](sstephenson/bats: Bash Automated Testing System) to test command line integration.

Run the bats tests with:

cd $GOPATH/src/github.com/ethereumproject/go-ethereum
bats cmd/geth

Ethtest

Alternatively, there is a CLI application, ethtest who can be used to run these tests without Go. The binary can be built from ./cmd/ethtest and then run from anywhere (such as the root directory of the test files). Some examples:

Run all tests from current directory, looking in their respective sub directories for json files: ethtest

Run all VM json tests from ./VMTests/ directory ethtest --test "vm" --file "./VMTests/"

Run all tests in a cousin directory supplied by environment variable ETHEREUM_TEST_PATH="../../tests/files" ethtest --test "all"

Run a single transaction test ethtest --test "tx" --file "./TransactionTests/ttTransactionTest.json"

Flags:

   --test "all"		Test type (string): VMTests, TransactionTests, StateTests, BlockTests
   --file "."		Test file or directory. Directories are searched for .json files 1 level deep [$ETHEREUM_TEST_PATH]
   --continue		Continue running tests on error (true) or exit immediately (false)

VM

VM Test wiki

go test ./tests/vm_test.go

State

State Test wiki

go test ./tests/state_test.go

Transaction

Transaction Test wiki

go test ./tests/transaction_test.go

Blockchain

Blockchain Test wiki

go test ./tests/block_test.go

RPC

RPC Tests repo

1. Load test JSON with

   geth blocktest <pathToTheTestRepo>/BlockTests/bcRPC_API_Test.json RPC_API_Test rpc

2. Run rpc-tests (https://github.com/ethereumproject/rpc-tests#usage)