[][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 self::ColorConfig::*;
pub use NamePadding::*;
pub use TestName::*;
pub use TestFn::*;
pub use self::types::TestName::*;
pub use self::bench::Bencher;

Modules

benchExperimental

Benchmarking module.

statsExperimental
testExperimental

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.

TestDescExperimental
TestDescAndFnExperimental
TestOptsExperimental

Enums

ColorConfigExperimental

Whether should console output be colored or not

NamePaddingExperimental
OutputFormatExperimental

Format of the test results output

RunIgnoredExperimental

Whether ignored test should be runned or not

ShouldPanicExperimental

Whether test is expected to panic or not

TestFnExperimental
TestNameExperimental
TestTypeExperimental

Type of the test according to the rust book conventions.

Traits

TDynBenchFnExperimental

Represents a benchmark function.

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

An identity function that hints to the compiler to be maximally pessimistic about what black_box could do.

convert_benchmarks_to_testsExperimental
filter_testsExperimental
run_testExperimental
run_testsExperimental
run_tests_consoleExperimental

A simple console test runner. Runs provided tests reporting process and results to the stdout.

test_mainExperimental
test_main_staticExperimental

A variant optimized for invocation with a static test vector. This will panic (intentionally) when fed any dynamic tests.

test_main_static_abortExperimental

A variant optimized for invocation with a static test vector. This will panic (intentionally) when fed any dynamic tests.