cargo-referendum

Crates.iocargo-referendum
lib.rscargo-referendum
version0.1.1
sourcesrc
created_at2021-06-25 20:44:25.069776
updated_at2021-06-25 21:05:04.697007
descriptionDifferential testing tool for unit tests
homepage
repositoryhttps://github.com/cwlittle/referendum
max_upload_size
id414979
size34,576
(cwlittle)

documentation

README

referendum

Referendum is a differential testing framework for Rust. It enables the observation of non-deterministic compiler behavior in the context of a project's unit tests.

Prerequisites

Referedum uses rustup to manage Rust toolkits used in differential testing.

In order to install and configure rustup, visit the rustup webpage for more information.

Each toolkit used by referendum must be pre-installed through rustup.

To check the status of installed toolkits:

rustup show

To install specific toolkits:

rustup install nightly-YYYY-MM-DD

Referendum is not meant to replace cargo test. Therefore, before runnning referendum, ensure that cargo test builds and runs successfully. Cargo test does not necessarily need to yield an entire suite of passing tests for referendum to effectively measure non-deterministic behavior.

Usage

To install:

cargo install cargo-referendum

To run:

cargo referendum -- <toolkit_name> <toolkit_name> <toolkit_name>
Commit count: 47

cargo fmt