Enum Target 

pub enum Target {
    Path(PathBuf),
    UnresolvedId(Id),
    AmbiguousAlias(String),
    External,
    Foreign {
        workspace: String,
        id: Id,
    },
}

The resolution of one link target against a workspace: a path, an ID the registry does not currently resolve, or an off-workspace reference.

Variants

Path(PathBuf)

A (normalized, workspace-relative) path.

UnresolvedId(Id)

An id:<id> reference with no live registry entry — unknown, tombstoned, or the workspace has no registry at all.

AmbiguousAlias(String)

A nominal (alias) reference whose name several documents claim, so it cannot be resolved to one. The String is the name as written.

External

A URL or mail address — never resolved against the workspace and never rewritten by moves.

Foreign

An id:<workspace>/<id> reference naming a document in another workspace — carried, never rewritten, and never reported broken.

prov stops here on purpose. Resolving this would require a map from a workspace name to a location, and that map is a property of the device doing the reading, not of the archive being read: the same reference resolves to a directory on one machine, a URL on another, and nothing at all on a third. So the library reports what was named and leaves where it lives to the host — prov-cli keeps a device-local peer map, diaryx resolves through its published ARK permalinks.

The shape that answer comes back in, and the check that makes it trustworthy, are crate::peer. Following one is a step a caller takes after this, never a deeper mode of it.

A reference qualified with this workspace’s own workspace_id is not foreign: it is resolved locally through the registry, so a document carrying one keeps working when it is copied into the workspace it names.

Fields

workspace: String

The workspace qualifier, exactly as written.

id: Id

The id within that workspace, exactly as written — never check-verified here (that workspace owns its id space, and may not be a prov workspace at all).

Trait Implementations

impl Clone for Target

fn clone(&self) -> Target

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Target

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

Formats the value using the given formatter.

impl Eq for Target

impl PartialEq for Target

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Target