Enum RefLocation 

#[non_exhaustive]
pub enum RefLocation {
    PathComponent,
    QueryParameter,
}

Names where a ref or rev is rendered in a FlakeRef.

RefLocation is a routing tag, not a presence flag: a FlakeRef whose kind has no ref and no rev still carries a RefLocation saying where one would be written if it were set. The “no ref or rev” state is encoded by ref_ == None && rev == None on the kind, so a RefLocation::None variant would be redundant and is therefore unrepresentable.

Default is PathComponent because that is the canonical form for the ref-bearing kinds (GitForge, Indirect); the parser flips this to QueryParameter when the value arrived via ?ref= / ?rev=, preserving the round-trip shape.

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.

PathComponent

Rendered in the path component, e.g. github:owner/repo/<value>.

QueryParameter

Rendered as a query parameter, e.g. ?ref=<value> or ?rev=<value>.

Trait Implementations

impl Clone for RefLocation

fn clone(&self) -> RefLocation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RefLocation

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

Formats the value using the given formatter.

impl Default for RefLocation

fn default() -> RefLocation

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RefLocation

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for RefLocation

fn eq(&self, other: &RefLocation) -> 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 Serialize for RefLocation

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for RefLocation

impl Eq for RefLocation

impl StructuralPartialEq for RefLocation