Enum RouteDecision 

pub enum RouteDecision<'a> {
    Explicit {
        source: &'a str,
        reference: &'a str,
    },
    Prefix {
        source: &'a str,
        prefix: &'a str,
        settings: &'a BTreeMap<String, Value>,
    },
    Default {
        source: &'a str,
        fallback: Option<&'a str>,
    },
}

Outcome of resolving a path against a RouterConfig.

All variants borrow from the input config (lifetime 'a); the queried path is owned by the caller and is not copied into the decision. The caller computes the path-tail (path.strip_prefix (decision.prefix())) only when it needs to call into a source plugin.

Variants

Explicit

[secret."<path>"] matched — both the source and the backend-specific reference are user-supplied.

Fields

source: &'a str

Source name to dispatch to.

reference: &'a str

Backend-specific reference handed to the source’s get (e.g. op://Work/Acme Jira/credential).

Prefix

One of the [[route]] prefixes matched. The source plugin is responsible for joining settings with the path tail to produce its actual reference.

Fields

source: &'a str

Source name to dispatch to.

prefix: &'a str

The matched prefix verbatim (always ends with /).

settings: &'a BTreeMap<String, Value>

Source-specific extras from the [[route]] block (mount, vault, …). Pass-through to the source.

Default

No [secret] and no [[route]] matched — falls back to [default].source. The optional fallback hint lets the caller retry against [default].fallback when the primary reports is_available() == NotInstalled (per ADR-021 §2 step 3).

Fields

source: &'a str

[default].source.

fallback: Option<&'a str>

[default].fallback, if configured.

Implementations

impl<'a> RouteDecision<'a>

pub fn source(&self) -> &'a str

The source name selected for this path. Consumers that just want to know “who serves it?” don’t have to match on the variant.

Trait Implementations

impl<'a> Clone for RouteDecision<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for RouteDecision<'a>

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

Formats the value using the given formatter.

impl<'a> PartialEq for RouteDecision<'a>

fn eq(&self, other: &RouteDecision<'a>) -> 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<'a> StructuralPartialEq for RouteDecision<'a>