Enum BlobTarget 

pub enum BlobTarget {
    Artifact {
        id: String,
    },
    Tree {
        root: ContentHash,
    },
    Store {
        algo: String,
        hash: ContentHash,
    },
}

What a blob command addresses: RFC 07 §2’s three shapes, each validated.

There is deliberately no String constructor for the content-addressed tiers — a tree or store address is a ContentHash or it does not exist. RFC 07 §2.3 revoked the caller-chosen tree name (tree/nightly) in v1.7, and the generated builders have refused to spell one ever since; this type refuses for the same reason, at the point where an operator’s typing enters the system.

Variants

Artifact

Tier-1: a named artifact, whose endpoints live under it (RFC 07 §2.2).

Fields

id: String

Tree

Tier-2: a directory index, keyed by its own root (RFC 07 §2.3).

Fields

root: ContentHash

Store

Tier-2: one content-addressed chunk (RFC 07 §2.4).

Fields

algo: String

hash: ContentHash

Implementations

impl BlobTarget

pub fn parse(spec: &str) -> Result<BlobTarget>

Parse the one spelling both frontends accept:

<id>  |  artifact/<id>  |  tree/<hex>  |  store/<algo>/<hex>

A bare id is Tier-1, because that is the tier an operator has an id for: Tier-2 addresses are hashes, and nobody types one from memory.

An id that is not a valid RFC 03 §2 plain chunk is refused with the citation rather than lowercased. A canonical ULID is uppercase Crockford base32 and a key chunk has no uppercase spelling (RFC 07 §2.2 as amended in v1.11) — but silently rewriting the caller’s id would mean probing for something they did not ask for and reporting holders of it, which is worse than refusing.

pub fn tier(&self) -> BlobTier

pub fn probe_prefix(&self) -> BlobProbePrefix

The *-origin probe prefix (RFC 07 §2.5) — the only wildcard form that exists for this plane, and not a Key.

pub fn key_at(&self, origin: &Origin) -> Result<Key>

This target’s concrete key under one origin — the only fetchable form.

For Tier-1 that is the artifact’s base key, which the endpoint tails of RFC 07 §2.2 hang off; for Tier-2 the key is the object.

pub fn prefix_at(&self, origin: &Origin) -> Key

The tier prefix under one origin: v1/<origin>/@blob/<tier>. This is what the reference client’s endpoint helpers append to.

pub fn spelling(&self) -> String

The canonical spelling, which round-trips through parse.

Trait Implementations

impl Clone for BlobTarget

fn clone(&self) -> BlobTarget

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BlobTarget

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

Formats the value using the given formatter.

impl Eq for BlobTarget

impl PartialEq for BlobTarget

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for BlobTarget