Skip to main content

AsyncGuardAdapter

chio_guards::external

Struct AsyncGuardAdapter

pub struct AsyncGuardAdapter<E: ExternalGuard + ?Sized> { /* private fields */ }

Expand description

Adapter that composes circuit breaker + token bucket + TTL cache + retry on top of an ExternalGuard.

Flow of a single evaluate call:

Check the circuit breaker. If open, return CircuitOpenVerdict without calling the inner guard.
Check the cache. On hit, return the cached verdict without calling the inner guard.
Check the token bucket. If empty, return RateLimitedVerdict. Rate-limited calls do not increment the circuit breaker.
Call the inner guard via retry_with_jitter.
Record success/failure on the breaker. On success, cache the verdict.

Implementations§

impl<E: ExternalGuard + ?Sized> AsyncGuardAdapter<E>

pub fn builder(inner: Arc<E>) -> AsyncGuardAdapterBuilder<E>

Start a builder with defaults.

pub fn name(&self) -> &str

Name of the wrapped guard.

pub fn config(&self) -> &AsyncGuardAdapterConfig

Effective configuration.

pub fn circuit_state(&self) -> CircuitState

Inspect the circuit breaker state (primarily for tests and metrics).

pub async fn evaluate(&self, ctx: &GuardCallContext) -> Verdict

Evaluate the request end-to-end.

Auto Trait Implementations§

impl<E> !Freeze for AsyncGuardAdapter<E>

impl<E> !RefUnwindSafe for AsyncGuardAdapter<E>

impl<E> Send for AsyncGuardAdapter<E>
where E: ?Sized,

impl<E> Sync for AsyncGuardAdapter<E>
where E: ?Sized,

impl<E> Unpin for AsyncGuardAdapter<E>
where E: ?Sized,

impl<E> UnsafeUnpin for AsyncGuardAdapter<E>
where E: ?Sized,

impl<E> !UnwindSafe for AsyncGuardAdapter<E>

Blanket Implementations§

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

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

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

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

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

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

Mutably borrows from an owned value. Read more

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T> Instrument for T

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

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

fn in_current_span(self) -> Instrumented<Self>

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

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

fn into(self) -> U

Calls U::from(self).

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

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

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more

impl<T> Same for T

type Output = T

Should always be Self

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

type Error = Infallible

The type returned in the event of a conversion error.

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

Performs the conversion.

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

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

The type returned in the event of a conversion error.

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

Performs the conversion.

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

fn vzip(self) -> V

impl<T> WithSubscriber for T

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

fn with_current_subscriber(self) -> WithDispatch<Self>

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