[][src]Crate test

🔬 This is a nightly-only experimental API. (test)

Support code for rustc's built in unit-test and micro-benchmarking framework.

Almost all user code will only be interested in Bencher and black_box. All other interactions (such as writing tests and benchmarks themselves) should be done via the #[test] and #[bench] attributes.

See the Testing Chapter of the book for more details.

Re-exports

pub use libtest::DynTestFn;
pub use libtest::DynTestName;
pub use libtest::StaticBenchFn;
pub use libtest::StaticTestFn;
pub use libtest::StaticTestName;
pub use libtest::TrFailed;
pub use libtest::TrFailedMsg;
pub use libtest::TrIgnored;
pub use libtest::TrOk;

Structs

BencherExperimental

Manager of the benchmarking runs.

MetricExperimental
MetricMapExperimental
OptionsExperimental

In case we want to add other options as well, just add them in this struct.

SummaryExperimental

Extracted collection of all the summary statistics of a sample set.

TestDescExperimental
TestDescAndFnExperimental
TestOptsExperimental

Enums

RunIgnoredExperimental
ShouldPanicExperimental
TestNameExperimental
TestResultExperimental

Functions

assert_test_resultExperimental

Invoked when unit tests terminate. Should panic if the unit Tests is considered a failure. By default, invokes report() and checks for a 0 result.

black_boxExperimental

A function that is opaque to the optimizer, to allow benchmarks to pretend to use outputs to assist in avoiding dead-code elimination.

filter_testsExperimental
parse_optsExperimental
run_testExperimental
test_mainExperimental
test_main_staticExperimental