Enum TemporalAxis

pub enum TemporalAxis {
    Present,
    Past,
    Future,
}

Represents the temporal axis in a UCXL address.

What: An enumeration of the three supported temporal positions – present, past, and future – each represented by a symbolic string in the address format.

How: The enum derives Debug, PartialEq, Eq, Clone, and Copy for ergonomic usage. Conversions to and from strings are provided via the FromStr and fmt::Display implementations.

Why: Temporal axes enable UCXL to refer to data at different points in time (e.g. versioned resources). The simple three‑state model matches the CHURUS architectural decision to keep addressing lightweight while still supporting historical and speculative queries.

Variants

Present

Present (“#”) – the current version of a resource.

Past

Past (“~~”) – a historical snapshot of a resource.

Future

Future (“^^”) – a speculative or planned version of a resource.

Trait Implementations

impl Clone for TemporalAxis

fn clone(&self) -> TemporalAxis

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TemporalAxis

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

Formats the value using the given formatter.

impl Display for TemporalAxis

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

Formats the temporal axis back to its string token.

What: Returns “#”, “~~” or “^^” depending on the variant.

How: Matches on self and writes the corresponding string to the formatter.

Why: Required for serialising a UCXLAddress back to its textual representation.

impl FromStr for TemporalAxis

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

Parses a temporal axis token from its textual representation.

What: Accepts “#”, “~~” or “^^” and maps them to the corresponding enum variant.

How: A simple match statement is used; an error string is returned for any unrecognised token.

Why: Centralises validation of temporal markers used throughout the address parsing logic, ensuring consistency.

type Err = String

The associated error which can be returned from parsing.

impl PartialEq for TemporalAxis

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

impl Eq for TemporalAxis

impl StructuralPartialEq for TemporalAxis