Struct Coordinate 

pub struct Coordinate {
    pub scope: Scope,
    pub environment: EnvSegment,
    pub component: String,
    pub key: String,
    pub half: KeyHalf,
}

A parsed, canonical secret coordinate. Carries only the address — never a value (I6: the command line carries the coordinate, the value enters separately as a crate::SecretValue).

Fields

scope: Scope

Override scope.

environment: EnvSegment

Environment segment (literal or ${ENV}).

component: String

Component segment.

key: String

Key segment.

half: KeyHalf

Keypair half selector (#public/#private). KeyHalf::Unspecified for a plain coordinate; meaningful only for the Keypair modality.

Implementations

impl Coordinate

pub fn canonical_path(&self) -> Result<String, CoreError>

The canonical storage path <env>/<component>/<key> — the address a secret is filed under on disk. The scope selector is a resolution concern (which vault to read), never stored, so it is excluded here: secret:prod/db/pw and secret://global/prod/db/pw map to the same path in whichever vault is chosen.

Fails for an unresolved ${ENV} placeholder — placeholders are substituted at resolution time (L4); only concrete coordinates are storable.

pub fn with_env(&self, env: &str) -> Coordinate

Substitute the ${ENV} placeholder with a concrete environment, for resolution at launch (spec §4.2/§4.3). A coordinate whose environment is already literal is returned unchanged; only the Placeholder is replaced.

pub fn storage_id(&self) -> Result<String, CoreError>

The opaque on-disk record id: lowercase-hex BLAKE3(canonical_path) (ADR-0001 §A.1). Hashing the coordinate keeps the address off disk as a filename while giving an O(1) point lookup. Inherits the placeholder rejection from Coordinate::canonical_path.

Trait Implementations

impl Clone for Coordinate

fn clone(&self) -> Coordinate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Coordinate

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

Formats the value using the given formatter.

impl Display for Coordinate

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

Formats the value using the given formatter.

impl Eq for Coordinate

impl FromStr for Coordinate

type Err = CoreError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl PartialEq for Coordinate

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