🔬This is a nightly-only experimental API. (
test)Expand description
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 self::bench::Bencher;- Experimental 
- pub use self::bench::black_box;- Experimental 
- pub use self::ColorConfig::*;- Experimental 
- pub use self::types::TestName::*;- Experimental 
- pub use NamePadding::*;- Experimental 
- pub use TestFn::*;- Experimental 
- pub use TestName::*;- Experimental 
Modules§
Structs§
- OptionsExperimental Options for the test run defined by the caller (instead of CLI arguments). In case we want to add other options as well, just add them in this struct.
- TestDesc Experimental 
- TestDesc AndFn Experimental 
- TestIdExperimental 
- TestOpts Experimental 
Enums§
- ColorConfig Experimental Whether should console output be colored or not
- NamePadding Experimental 
- OutputFormat Experimental Format of the test results output
- RunIgnoredExperimental Whether ignored test should be run or not
- ShouldPanic Experimental Whether test is expected to panic or not
- TestFnExperimental 
- TestName Experimental 
- TestType Experimental Type of the test according to the Rust book conventions.
Functions§
- assert_test_ result Experimental Invoked when unit tests terminate. ReturnsResult::Errif the test is considered a failure. By default, invokesreport()and checks for a0result.
- convert_benchmarks_ to_ tests Experimental 
- filter_tests Experimental 
- run_test Experimental 
- run_tests Experimental 
- run_tests_ console Experimental A simple console test runner. Runs provided tests reporting process and results to the stdout.
- test_main Experimental 
- test_main_ static Experimental A variant optimized for invocation with a static test vector. This will panic (intentionally) when fed any dynamic tests.
- test_main_ static_ abort Experimental A variant optimized for invocation with a static test vector. This will panic (intentionally) when fed any dynamic tests.