Enum RedirectExtensionsBehaviour 

#[non_exhaustive]
pub enum RedirectExtensionsBehaviour {
    Preserve,
    Fork,
    Drop,
}

Controls how request Extensions are carried over to redirected requests.

rama’s Extensions are an append-only, parent-chained store, so this mirrors the way retries and forks are modelled elsewhere in rama rather than the boolean toggle used by upstream tower-http.

Note that, regardless of the variant, a forwarded extension can be read by the redirect target (including cross-origin ones). Use Self::Drop when extensions may carry sensitive, origin-scoped data. Unlike upstream tower-http — whose default Standard policy clears extensions on a cross-origin hop — rama’s Extensions are append-only, so no policy (including FilterCredentials) can strip them; isolating origin-scoped data is solely this setting’s job, via Self::Drop.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Preserve

Share the original request’s extension store with redirected requests.

The redirected requests reference the same underlying store, so inserts made while following a redirect are visible to the original caller as well. This is the default.

Fork

Carry a fork of the request extensions to redirected requests.

The redirected request can read every extension the original request had, but its own inserts stay isolated and never leak back to the caller or accumulate across hops, which mirrors rama’s convention that retries/forks fork from the original request.

Drop

Drop all extensions on redirected requests; each starts with an empty store.

Trait Implementations

impl Clone for RedirectExtensionsBehaviour

fn clone(&self) -> RedirectExtensionsBehaviour

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for RedirectExtensionsBehaviour

impl Debug for RedirectExtensionsBehaviour

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

Formats the value using the given formatter.

impl Default for RedirectExtensionsBehaviour

fn default() -> RedirectExtensionsBehaviour

Returns the “default value” for a type.

impl Eq for RedirectExtensionsBehaviour

impl PartialEq for RedirectExtensionsBehaviour

fn eq(&self, other: &RedirectExtensionsBehaviour) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for RedirectExtensionsBehaviour