test

name	test
description	Runs tests for the GenVM project. Use after making code changes to verify correctness.

Running Tests

GenVM uses ya-test-runner for all tests. Before running tests, ensure the project is built (see /build skill).

Quick Start

Run all tests:

nix develop .#mock-tests --command ya-test-runner run

Run release tests (stable integration):

nix develop .#mock-tests --command ya-test-runner run --filter-tag "$(cat tests/presets/release.txt)"

Run a specific test:

nix develop .#mock-tests --command ya-test-runner run --filter-name 'test_name'

ya-test-runner Commands

Run Tests

ya-test-runner run [OPTIONS]

Options:

Flag	Description
--filter-name REGEX	Filter tests by name regex
--filter-tag EXPR	Filter tests by tags (e.g., stable & !slow)
--filter-continue FILE	Re-run only tests from a continue file
--fail-fast	Stop execution after first failure
--coverage	Enable coverage collection for Rust tests
--log-level LEVEL	Set log level (trace/debug/info/warning/error)

Show Information

# Show available tests
ya-test-runner show test

# Show execution plan
ya-test-runner show plan

# Show available services
ya-test-runner show services

# Show available tags
ya-test-runner show tags

Test Presets

Presets are tag expressions stored in tests/presets/:

Preset	Expression	Use Case
release.txt	integration & stable	CI release tests
rust.txt	rust | integration	Rust development
python.txt	python	Python SDK tests

Usage:

ya-test-runner --filter-tag "$(cat tests/presets/release.txt)" run

Test Categories

Integration Tests (tests/cases/)

End-to-end tests using jsonnet configuration. Services (manager, modules, webdriver) are started automatically.

nix develop .#mock-tests --command ya-test-runner run --filter-tag integration

Rust Tests

Cargo tests for Rust crates:

nix develop .#rust-test --command ya-test-runner run --filter-tag rust

With coverage:

nix develop .#rust-test --command ya-test-runner run --filter-tag rust --coverage

Python Tests

Tests for the Python standard library (genlayer-py-std):

nix develop .#mock-tests --command ya-test-runner run --filter-tag python

Or directly with pytest inside nix develop:

nix develop .#mock-tests --command bash -c "cd runners/genlayer-py-std && poetry run pytest tests/"

Coverage: pytest is configured with --cov and --cov-fail-under=75. Coverage scope includes genlayer.types, genlayer.calldata, genlayer.storage, genlayer.evm, genlayer._internal, and genlayer_embeddings. Must run inside nix develop for numpy-dependent tests and correct coverage resolution.

Webdriver Setup

For web-related tests (semi-stable/unstable), webdriver is started automatically by ya-test-runner. To manually start it:

bash modules/webdriver/build-and-run.sh

Precompile (Optional)

If WASM files or compilation changed, precompile to save test time:

./build/out/bin/genvm precompile

Re-running Failed Tests

When tests fail, ya-test-runner writes failed test names to build/test-artifacts/continue/<timestamp>-<random>. Re-run only failed tests:

# Use filename shown in failure summary
ya-test-runner run --filter-continue 20260123-143052-abc123

Quick Reference

What to test	Command
All tests	nix develop .#mock-tests --command ya-test-runner run
Release tests	nix develop .#mock-tests --command ya-test-runner run --filter-tag "$(cat tests/presets/release.txt)"
Rust tests	nix develop .#rust-test --command ya-test-runner run --filter-tag rust
Python (poetry)	nix develop .#mock-tests --command bash -c "cd runners/genlayer-py-std && poetry run pytest tests/"
Re-run failed	ya-test-runner run --filter-continue <file>
With debug logs	nix develop .#mock-tests --command ya-test-runner run --log-level debug
Show test list	nix develop .#mock-tests --command ya-test-runner show test