Struct Assertion

Source
pub struct Assertion { /* private fields */ }
Expand description

A specific set of criteria to enforce on matching spans.

Assertions represent both a span “matcher” – which controls which spans the criteria are applied to – and the criteria themselves, which define the behavior to assert against the matching spans.

§Matching behavior

As an Assertion can match multiple spans, care must be taken when building the Assertion to constrain the matcher correctly. For example, if you want to focus on a specific span, you would want to use match on the span name at a minimum, and potentially match on the span target if there were other spans with the same name in different modules. However, if you simply wanted to check if any spans under a specific module path were created – perhaps to assert that a particular codeflow is being exercised, but not assert how it’s being exercised – then only specifying the span target might suffice.

Implementations§

Source§

impl Assertion

Source

pub fn assert(&self)

Asserts that all criteria have been met.

Uses the “assert” macros from the standard library, so criterion which have not been met will cause a panic, similar to using the “assert” macros directly.

For a fallible assertion that can be called over and over without panicking, [try_assert] can be used instead.

Source

pub fn try_assert(&self) -> bool

Attempts to assert that all criteria have been met.

If any of the criteria have not yet been met, false will be returned. Otherwise, true will be returned.

If assertions should end your test immediately, assert can be used instead.

Trait Implementations§

Source§

impl Drop for Assertion

Source§

fn drop(&mut self)

Executes the destructor for this type. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more