Enum EntryRef 

pub enum EntryRef {
    Path(PathBuf),
    Id(CarettaId),
    Title(String),
}

A reference to a journal entry — a filesystem path, a CarettaId, or a title.

This is the canonical input type for commands that operate on a single entry (show, fix, remove, etc.). Parse raw CLI user input with EntryRef::parse, then resolve it to a concrete PathBuf via [ops::resolve_entry].

Syntax (CLI)

Input form	Resolved as
@abc1234	Id(CarettaId)
path/to/file.md	Path(...)
./relative.md	Path(...)
~/absolute.md	Path(...)
anything_else	Title(...)

The @ prefix is required for IDs to avoid ambiguity with titles that happen to be 7 alphanumeric characters. If the part after @ cannot be parsed as a valid CarettaId, the @ is treated as part of the string and the usual path/title heuristics apply.

Variants

Path(PathBuf)

A filesystem path to the entry file.

Id(CarettaId)

A fully-parsed CarettaId (the @ prefix has been stripped and validated).

Title(String)

An exact entry title (case-sensitive).

Implementations

impl EntryRef

pub fn parse(s: &str) -> Self

Classify a raw CLI string as a path, an ID, or a title.

• Starts with @ and the remainder parses as a CarettaId → EntryRef::Id.
• Contains / or \, starts with . or ~, or ends with .md → EntryRef::Path.
• Anything else (including @foo where foo is not a valid CarettaId) → EntryRef::Title.

Trait Implementations

impl Clone for EntryRef

fn clone(&self) -> EntryRef

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EntryRef

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for EntryRef

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&str> for EntryRef

fn from(s: &str) -> Self

Converts to this type from the input type.

impl From<String> for EntryRef

fn from(s: String) -> Self

Converts to this type from the input type.

impl JsonSchema for EntryRef

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.