benchmark.md

Benchmarking

TechScript provides benchmarking utilities to measure execution performance and track speed regressions.

---

🏗️ Writing Benchmarks

Use the benchmark module to run functions and measure elapsed times:

use benchmark
# Define a function to benchmark
do compute_factorial()
val = 1
for i in 1..100000
val = val * i
end
end
# Run the benchmark: benchmark.run(name, iterations, function)
benchmark.run("Factorial loop 100k", 100, compute_factorial)

---

🚀 Running Benchmarks

Execute your benchmark script:

tech run perf.txs

Output:

Benchmark: Factorial loop 100k
Iterations: 100
Mean execution time: 2.15 ms
Min time: 2.01 ms
Max time: 2.45 ms

---

📊 System Benchmarking Command

You can also benchmark standard code snippets directly from the CLI:

tech benchmark "say 10 + 10" --iterations 1000

This runs the VM in isolation to output microsecond-accurate telemetry statistics.