benchmark

This skill allows you to run performance benchmarks for the project.

1. Python Benchmarks

Run the Python-side benchmarks using pytest.

pytest -m bench -q

2. Rust Benchmarks (Standard)

Run the standard Rust core benchmarks.

cargo bench -p backtester-core

3. Rust Benchmarks (Custom Configuration)

Run Rust benchmarks with custom parameters using the helper script. This allows you to tune the number of symbols, ticks per symbol, and batch window size.

# Run with default 'heavy' settings (8 symbols, 500k ticks)
./.agent/skills/benchmark/scripts/run_custom_bench.sh

You can also set environment variables manually if you prefer:

BACKTEST_BENCH_NSYMBOLS=8 \
BACKTEST_BENCH_TICKS_PER_SYMBOL=500000 \
cargo bench -p backtester-core --bench bench_core

4. Profile-Guided Optimization (PGO)

To build and benchmark with PGO (Linux/macOS). Note: This process is time-consuming as it runs a full build-profile-rebuild pipeline.

make pgo