Struct Trace 

pub struct Trace { /* private fields */ }

Available on crate feature tracing only.

Decorator that enables tracing for tests.

Examples

use test_casing::{decorate, decorators::Trace};

// Tracing output configuration. Allows to specify the default log directives
// (can be overridden by the `RUST_LOG` env var in the runtime), and to configure
// more concise or pretty output.
static TRACE: Trace = Trace::new("info,test_crate=trace").pretty();

#[decorate(TRACE)]
#[test]
fn some_test() {
    // Test logic...
    tracing::info!("logging event");
}

Implementations

impl Trace

pub const fn new(directives: &'static str) -> Self

Creates a decorator with the specified directives. The directives can be overridden by the RUST_LOG env variable in runtime.

pub const fn pretty(self) -> Self

Enables pretty formatting for the tracing events.

pub const fn global(self) -> Self

Sets up the tracing subscriber globally (vs the default thread-local setup). This is only beneficial for multithreaded tests, and may have undesired side effects.

pub fn create_subscriber(self) -> impl Subscriber + for<'a> LookupSpan<'a>

Creates a subscriber based on the configured params. This is useful in order to reuse Trace logic in more complex decorators (e.g., ones that capture tracing spans / events).

Trait Implementations

impl Clone for Trace

fn clone(&self) -> Trace

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Trace

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<R> DecorateTest<R> for Trace

fn decorate_and_test<F: TestFn<R>>(&'static self, test_fn: F) -> R

Decorates the provided test function and runs the test.

impl Copy for Trace