Divan

Comfy benchmarking for Rust projects, brought to you by Nikolai Vazquez.

§Sponsor

If you or your company find Divan valuable, consider sponsoring on GitHub or donating via PayPal. Sponsorships help me progress on what’s possible with benchmarking in Rust.

§Guide

A guide is being worked on. In the meantime, see:

• Announcement post
• “Proving Performance” FOSDEM talk

§Getting Started

1. Add the following to your project’s Cargo.toml:

   [dev-dependencies]
   divan = "0.1.13"
   
   [[bench]]
   name = "example"
   harness = false
   

2. Create a benchmarks file at benches/example.rs¹ with your benchmarking code:

   fn main() {
       // Run registered benchmarks.
       divan::main();
   }
   
   // Define a `fibonacci` function and register it for benchmarking.
   #[divan::bench]
   fn fibonacci() -> u64 {
       fn compute(n: u64) -> u64 {
           if n <= 1 {
               1
           } else {
               compute(n - 2) + compute(n - 1)
           }
       }
   
       compute(divan::black_box(10))
   }

3. Run your benchmarks with cargo bench:

   example       fastest  │ slowest │ median   │ mean     │ samples │ iters
   ╰─ f​ibonacci  196.1 ns │ 217 ns  │ 197.5 ns │ 198.1 ns │ 100     │ 3200
   

See #[divan::bench] for info on benchmark function registration.

§Examples

Practical example benchmarks can be found in the examples/benches directory. These can be benchmarked locally by running:

git clone https://github.com/nvzqz/divan.git
cd divan

cargo bench -q -p examples --all-features

More thorough usage examples can be found in the #[divan::bench] documentation.

§License

Like the Rust project, this library may be used under either the MIT License or Apache License (Version 2.0).