|
| 1 | +#!/usr/bin/env python3 |
| 2 | +# /// script |
| 3 | +# requires-python = ">=3.9" |
| 4 | +# dependencies = [ |
| 5 | +# "pytest>=8.0", |
| 6 | +# "pytest-codspeed>=4.2.0", |
| 7 | +# ] |
| 8 | +# /// |
| 9 | + |
| 10 | +import argparse |
| 11 | +import os |
| 12 | +import subprocess |
| 13 | +from pathlib import Path |
| 14 | + |
| 15 | +import pytest |
| 16 | + |
| 17 | + |
| 18 | +class ValgrindRunner: |
| 19 | + """Run Valgrind with different configurations.""" |
| 20 | + |
| 21 | + def __init__( |
| 22 | + self, |
| 23 | + binary_path: str, |
| 24 | + valgrind_path: str = "valgrind", |
| 25 | + output_dir: str = "/tmp", |
| 26 | + ): |
| 27 | + """Initialize valgrind runner. |
| 28 | +
|
| 29 | + Args: |
| 30 | + binary_path: Path to the binary to profile |
| 31 | + valgrind_path: Path to valgrind executable |
| 32 | + output_dir: Directory for callgrind output files |
| 33 | + """ |
| 34 | + self.binary_path = Path(binary_path) |
| 35 | + self.valgrind_path = valgrind_path |
| 36 | + self.output_dir = Path(output_dir) |
| 37 | + self.output_dir.mkdir(parents=True, exist_ok=True) |
| 38 | + |
| 39 | + if not self.binary_path.exists(): |
| 40 | + raise FileNotFoundError(f"Binary not found: {self.binary_path}") |
| 41 | + |
| 42 | + # Verify valgrind is available |
| 43 | + result = subprocess.run( |
| 44 | + [self.valgrind_path, "--version"], |
| 45 | + capture_output=True, |
| 46 | + text=True, |
| 47 | + ) |
| 48 | + if result.returncode != 0: |
| 49 | + raise RuntimeError(f"Valgrind not found at: {self.valgrind_path}") |
| 50 | + self.valgrind_version = result.stdout.strip() |
| 51 | + |
| 52 | + def run_valgrind(self, *args: str) -> None: |
| 53 | + """Execute valgrind with given arguments. |
| 54 | +
|
| 55 | + Args: |
| 56 | + *args: Valgrind arguments |
| 57 | + """ |
| 58 | + callgrind_output = self.output_dir / f"callgrind.{os.getpid()}" |
| 59 | + |
| 60 | + cmd = [ |
| 61 | + self.valgrind_path, |
| 62 | + "--tool=callgrind", |
| 63 | + f"--callgrind-out-file={callgrind_output}", |
| 64 | + *args, |
| 65 | + str(self.binary_path), |
| 66 | + ] |
| 67 | + |
| 68 | + result = subprocess.run(executable=self.valgrind_path, args=cmd) |
| 69 | + if result.returncode != 0: |
| 70 | + raise RuntimeError( |
| 71 | + f"Valgrind execution failed with code {result.returncode}" |
| 72 | + ) |
| 73 | + |
| 74 | + # Clean up |
| 75 | + if callgrind_output.exists(): |
| 76 | + callgrind_output.unlink() |
| 77 | + |
| 78 | + |
| 79 | +@pytest.fixture |
| 80 | +def runner(request): |
| 81 | + """Fixture to provide runner instance to tests.""" |
| 82 | + return request.config._valgrind_runner |
| 83 | + |
| 84 | + |
| 85 | +def pytest_generate_tests(metafunc): |
| 86 | + """Parametrize tests with benchmark_id.""" |
| 87 | + if "benchmark_context" in metafunc.fixturenames: |
| 88 | + runner = getattr(metafunc.config, "_valgrind_runner", None) |
| 89 | + if not runner: |
| 90 | + metafunc.parametrize("benchmark_context", ["unknown"]) |
| 91 | + return |
| 92 | + |
| 93 | + benchmark_id = f"{runner.binary_path.stem}, {runner.valgrind_version}" |
| 94 | + metafunc.parametrize("benchmark_context", [benchmark_id], ids=[benchmark_id]) |
| 95 | + |
| 96 | + |
| 97 | +@pytest.mark.benchmark |
| 98 | +def test_baseline(runner, benchmark_context): |
| 99 | + if runner: |
| 100 | + runner.run_valgrind("--read-inline-info=no") |
| 101 | + |
| 102 | + |
| 103 | +@pytest.mark.benchmark |
| 104 | +def test_with_inline_info(runner, benchmark_context): |
| 105 | + if runner: |
| 106 | + runner.run_valgrind("--read-inline-info=yes") |
| 107 | + |
| 108 | + |
| 109 | +@pytest.mark.benchmark |
| 110 | +def test_full_inline(runner, benchmark_context): |
| 111 | + if runner: |
| 112 | + args = [ |
| 113 | + "--trace-children=yes", |
| 114 | + "--cache-sim=yes", |
| 115 | + "--I1=32768,8,64", |
| 116 | + "--D1=32768,8,64", |
| 117 | + "--LL=8388608,16,64", |
| 118 | + "--collect-systime=nsec", |
| 119 | + "--compress-strings=no", |
| 120 | + "--combine-dumps=yes", |
| 121 | + "--dump-line=no", |
| 122 | + "--read-inline-info=yes", |
| 123 | + ] |
| 124 | + runner.run_valgrind(*args) |
| 125 | + |
| 126 | + |
| 127 | +@pytest.mark.benchmark |
| 128 | +def test_full(runner, benchmark_context): |
| 129 | + if runner: |
| 130 | + args = [ |
| 131 | + "--trace-children=yes", |
| 132 | + "--cache-sim=yes", |
| 133 | + "--I1=32768,8,64", |
| 134 | + "--D1=32768,8,64", |
| 135 | + "--LL=8388608,16,64", |
| 136 | + "--collect-systime=nsec", |
| 137 | + "--compress-strings=no", |
| 138 | + "--combine-dumps=yes", |
| 139 | + "--dump-line=no", |
| 140 | + ] |
| 141 | + runner.run_valgrind(*args) |
| 142 | + |
| 143 | + |
| 144 | +def main(): |
| 145 | + parser = argparse.ArgumentParser( |
| 146 | + description="Benchmark Valgrind with pytest-codspeed", |
| 147 | + formatter_class=argparse.RawDescriptionHelpFormatter, |
| 148 | + epilog=""" |
| 149 | +Examples: |
| 150 | + # Run with default binary |
| 151 | + uv run bench.py --binary-path /path/to/binary |
| 152 | +
|
| 153 | + # Run with custom valgrind installation |
| 154 | + uv run bench.py --binary-path /path/to/binary --valgrind-path /usr/local/bin/valgrind |
| 155 | + """, |
| 156 | + ) |
| 157 | + |
| 158 | + parser.add_argument( |
| 159 | + "--binary-path", |
| 160 | + type=str, |
| 161 | + required=True, |
| 162 | + help="Path to the binary to profile", |
| 163 | + ) |
| 164 | + parser.add_argument( |
| 165 | + "--valgrind-path", |
| 166 | + type=str, |
| 167 | + default="valgrind", |
| 168 | + help="Path to valgrind executable (default: valgrind)", |
| 169 | + ) |
| 170 | + parser.add_argument( |
| 171 | + "--output-dir", |
| 172 | + type=str, |
| 173 | + default="/tmp", |
| 174 | + help="Directory for callgrind files (default: /tmp)", |
| 175 | + ) |
| 176 | + |
| 177 | + args = parser.parse_args() |
| 178 | + |
| 179 | + # Create runner instance |
| 180 | + runner = ValgrindRunner( |
| 181 | + binary_path=args.binary_path, |
| 182 | + valgrind_path=args.valgrind_path, |
| 183 | + output_dir=args.output_dir, |
| 184 | + ) |
| 185 | + print(f"Valgrind version: {runner.valgrind_version}") |
| 186 | + print(f"Binary: {args.binary_path}") |
| 187 | + |
| 188 | + # Plugin to pass runner to tests |
| 189 | + class RunnerPlugin: |
| 190 | + def pytest_configure(self, config): |
| 191 | + config._valgrind_runner = runner |
| 192 | + |
| 193 | + exit_code = pytest.main( |
| 194 | + [__file__, "-v", "--codspeed"], |
| 195 | + plugins=[RunnerPlugin()], |
| 196 | + ) |
| 197 | + if exit_code != 0 and exit_code != 5: |
| 198 | + print(f"Benchmark execution returned exit code: {exit_code}") |
| 199 | + |
| 200 | + |
| 201 | +if __name__ == "__main__": |
| 202 | + main() |
0 commit comments