Struct ObjectId 

pub struct ObjectId(/* private fields */);

A kopia object id as it appears in manifests. Validated so a repository entry can never smuggle a flag onto the session argv.

kopia’s id space is wider than plain hex: content ids (k…/x…), indirect ids (Ix…), and section ids (S<start>,<length>,<base>) all appear in real manifests, and entry names carry through into ids that hold -, _ or .. The gate is therefore a deny-list, not an allow-list: the only threat is argv flag injection (the session never goes through a shell — SessionCmd::argv is exec’d directly), so a legitimate-but-unforeseen id form must not be rejected.

Implementations

impl ObjectId

pub fn parse(s: &str) -> Result<Self, InvalidObjectId>

Parse an object id read out of a repository manifest, rejecting only what could subvert the session’s argv or its logs: an empty string, a leading - (kopia would read the id as a flag), a / (a path, never an id), whitespace (argv word-splitting in anything that re-renders the command), and control/non-ASCII bytes (terminal escapes in error text). Everything else — commas, dashes, dots, underscores — is a shape kopia itself emits and passes through.

pub fn as_str(&self) -> &str

The validated id, for rendering onto argv.

Trait Implementations

impl Clone for ObjectId

fn clone(&self) -> ObjectId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ObjectId

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

Formats the value using the given formatter.

impl Eq for ObjectId

impl PartialEq for ObjectId

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