Skip to content

testing.md

Latest commit

 

History

History
48 lines (39 loc) · 1.62 KB

testing.md

File metadata and controls

48 lines (39 loc) · 1.62 KB
Raw

Testing

Running Tests

./quicktest.sh -m "not fuzzing"          # standard test run (-nauto by default via setup.cfg)
./quicktest.sh tests/unit/               # unit tests only
./quicktest.sh tests/functional/         # functional tests only
./quicktest.sh tests/unit/compiler/venom/ # venom unit tests
./quicktest.sh --hevm -m hevm            # hevm-based tests (needs hevm in PATH)

quicktest.sh wraps pytest with -q -s --instafail -x (bail on first failure).

Test Organization

tests/
├── unit/           # isolated component tests
│   ├── ast/
│   ├── semantics/
│   ├── compiler/
│   │   └── venom/  # venom pass & analysis tests
│   ├── cli/
│   └── ...
├── functional/     # end-to-end compilation & execution
│   ├── builtins/
│   ├── codegen/
│   ├── grammar/
│   ├── syntax/
│   └── venom/
├── conftest.py     # shared fixtures
├── evm_backends/   # EVM execution backends for tests
└── venom_utils.py  # helpers for venom tests

Key Fixtures & Helpers

  • tests/conftest.py — main fixtures (compiler invocation, EVM backends)
  • tests/evm_backends/ — pluggable EVM execution (pyevm, pyrevm)
  • tests/venom_utils.py — helpers for constructing Venom IR in tests

Writing Tests

  • Functional tests typically compile a Vyper snippet and execute it against an EVM backend
  • Venom unit tests construct IR programmatically, run passes, and assert on the result
  • Use pytest.mark.fuzzing for slow/fuzz tests (skipped in quick runs)
  • Use pytest.mark.hevm for hevm-specific tests