Enum RequestTarget 

pub enum RequestTarget {
    Template {
        path: String,
        path_params: HashMap<String, String>,
        query: Vec<(String, String)>,
    },
    RawUrl(String),
}

Typed target for an HTTP request.

Either a template path with substitutable {name} segments plus an ordered query list (Template), or a fully-formed external URL that bypasses the auth matrix (RawUrl). The split is the v2.0.0 contract that lets the matrix validator reason about (method, path) without re-parsing already-rendered URLs.

Variants

Template

API path template — e.g. "/2/users/{id}/likes" — paired with path_params to substitute and a query vec whose insertion order is preserved on render.

Fields

path: String

Path template containing {name} segments to substitute. Must match the spec verbatim (the auth matrix is keyed on this string).

path_params: HashMap<String, String>

Map of {name} segments to caller-supplied values.

query: Vec<(String, String)>

Ordered query parameters. Each (key, value) pair is percent-encoded and joined with &; empty query produces no ? on render.

RawUrl(String)

Fully-formed URL — used by raw mode (xr <URL>) and by shortcuts whose path is intentionally outside the spec. The matrix validator short-circuits for RawUrl — the user accepted the contract by reaching for raw mode.

Trait Implementations

impl Clone for RequestTarget

fn clone(&self) -> RequestTarget

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RequestTarget

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

Formats the value using the given formatter.

impl Default for RequestTarget

fn default() -> Self

Returns the “default value” for a type.