SYNOPSIS

Testing utilities for the ethereumjs stack.

Uses the offical Ethereum Tests.

To fetch the latest tests:

cd [SUBMODULE_FOLDER]
git fetch --tags origin develop
git tag -l
git checkout tags/[RELEASE_VERSION]
cd ..
git add [SUBMODULE_FOLDER]
git commit -m "[MESSAGE_ON_TEST_RELEASE_UPDATE]"

Releases on npm are outdated, latest releases are only done as tagged versions on GitHub due to npm size constraints, use e.g. git+https://github.com/ethereumjs/ethereumjs-testing.git#[LATEST_TAG_VERSION] in your dependencies.

API

const testing = require('ethereumjs-testing')

testing.getTestsFromArgs(testType, onFile, args = {})

Reads tests of a certain test type from several folders and files

• testType - Type of the test (GeneralStateTests, BlockchainTests, VMTests)
• onFile - Function to run the tests (see example)
• args
  • forkConfig - Run tests for selected fork (BlockchainTests only)
  • dir - Only run tests from subdirectory
  • file - File filter to apply
  • excludeDir - Exclude directory filter to apply
  • test - Only run a single test case
  • testsPath - Path to the tests repository (without the tests dir)
  • skipTests - List of tests to skip
  • skipVM - List of VM tests to skip

testing.getTestFromSource(file, onFile)

Reads custom test from a relative path or file

• file - Relative path or filename
• onFile - Function to run the tests (see example)

testing.getSingleFile(file)

Reads a single test file

• file - Path to the file

Examples how to read tests with the API methods above can be found in the ./examples directory.