Dice_box allows one to check expected build time (makespan length) of a given Rust project with different Cargo scheduling algoritms. That is mostly motivated by a want and need to test out different scheduling algorithms without having to run the builds (which should make iteration on new algorithms quicker). However, it should also give you an idea of an expected build speedup and scalability with different # of CPU cores.
To run Dice_box on your project, you need 2 files:
- Build timings of your project:
cargo +nightly build --timings=json - Unit graph of your project:
cargo +nightly build --unit-graphwhich can then be passed into a Dice_box:dice_box timings.json unit_graph.json
It is also possible to control parallelism of a build with -n option; this affects the results of Dice_box, not it's speed of execution (which should generally be quick-enough). It simulates a build of a given crate with N threads, where N defaults to 10.
Another option is --timings, which outputs timings similar to those of cargo (though it skips the timings table at the bottom and does not track the unlocked units/meta units).
The project contains significant parts of Rust's package manager (Cargo) with modifications, most notable one being a DependencyQueue and --timings support.
This project is licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or https://opensource.org/licenses/MIT)
at your option.