Struct Attempt 

#[non_exhaustive]
pub struct Attempt<'a> {
    pub failures: u32,
    pub error: Option<&'a (dyn Error + 'static)>,
    pub rebuilding: Rebuilding,
}

The state a ReconnectPolicy decides on.

Non-exhaustive: it gains fields as the backend learns to report more, and an existing policy keeps compiling.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

failures: u32

Consecutive failures so far, resetting on every success.

0 on the first attempt after a drop, when nothing has failed yet: a policy that returns Duration::ZERO for 0 retries immediately, which is what BackoffPolicy does, because a failover is often complete by the time the client notices.

error: Option<&'a (dyn Error + 'static)>

What failed last, or None when failures is 0.

Deliberately a plain std::error::Error rather than a concrete type: the two Rebuilding cases fail with different error types, and a policy that wants the detail can downcast_ref to lapin::Error or queuey_core::Error. Most policies only read failures.

rebuilding: Rebuilding

Which of the two things is being rebuilt.

Implementations

impl<'a> Attempt<'a>

pub fn first(rebuilding: Rebuilding) -> Self

An attempt that has not failed yet.

The backend builds these; they are public so you can unit-test a ReconnectPolicy of your own. This type is #[non_exhaustive], so these constructors are the only way to make one.

pub fn after( rebuilding: Rebuilding, failures: u32, error: &'a (dyn Error + 'static), ) -> Self

An attempt after failures consecutive failures, the last being error.

Trait Implementations

impl<'a> Clone for Attempt<'a>

fn clone(&self) -> Attempt<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for Attempt<'a>

impl<'a> Debug for Attempt<'a>

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

Formats the value using the given formatter.