Enum DependencyId 

pub enum DependencyId {
    SourceFile(ProjectPath),
    Asset(ProjectPath),
    Bibliography(ProjectPath),
    Label(String),
}

A typed, deterministic identity for one build dependency.

Each variant carries the payload appropriate to its DependencyKind, so mismatched combinations cannot be constructed. File inputs use the canonical ProjectPath; labels use their name. The derived Eq/Ord/Hash make ids usable as keys in deterministic maps and sets; Display gives a stable kind:payload view for logs and debugging.

Examples

use mos_cache::{DependencyId, DependencyKind};

let bib = DependencyId::bibliography("./refs.bib")?;

assert_eq!(bib.kind(), DependencyKind::Bibliography);
assert_eq!(bib.to_string(), "bibliography:refs.bib");
assert_eq!(bib.path().map(|p| p.as_str()), Some("refs.bib"));

Variants

SourceFile(ProjectPath)

A .mos source file, identified by its canonical project path.

Asset(ProjectPath)

A referenced asset (such as an image), identified by its canonical path.

Bibliography(ProjectPath)

A bibliography input (such as a .bib file), by its canonical path.

Label(String)

A resolved label, identified by its reference name.

Implementations

impl DependencyId

pub fn source_file(path: impl AsRef<str>) -> Result<Self, ProjectPathError>

A .mos source-file dependency.

Examples

use mos_cache::DependencyId;

assert_eq!(DependencyId::source_file("a.mos")?.to_string(), "source:a.mos");

pub fn asset(path: impl AsRef<str>) -> Result<Self, ProjectPathError>

An asset dependency, such as an image.

Examples

use mos_cache::DependencyId;

assert_eq!(DependencyId::asset("logo.png")?.to_string(), "asset:logo.png");

pub fn bibliography(path: impl AsRef<str>) -> Result<Self, ProjectPathError>

A bibliography-input dependency, such as a .bib file.

Examples

use mos_cache::DependencyId;

assert_eq!(DependencyId::bibliography("refs.bib")?.to_string(), "bibliography:refs.bib");

pub fn label(name: impl Into<String>) -> Self

A label dependency.

Examples

use mos_cache::DependencyId;

assert_eq!(DependencyId::label("eq-1").to_string(), "label:eq-1");

pub const fn kind(&self) -> DependencyKind

The DependencyKind this id belongs to.

Examples

use mos_cache::{DependencyId, DependencyKind};

assert_eq!(DependencyId::asset("x.png")?.kind(), DependencyKind::Asset);

pub const fn path(&self) -> Option<&ProjectPath>

The canonical path of a file-backed dependency, or None for labels.

Covers the SourceFile, Asset, and Bibliography variants uniformly.

Examples

use mos_cache::DependencyId;

assert_eq!(DependencyId::asset("logo.png")?.path().map(|p| p.as_str()), Some("logo.png"));
assert_eq!(DependencyId::label("eq-1").path(), None);

Trait Implementations

impl Clone for DependencyId

fn clone(&self) -> DependencyId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DependencyId

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

Formats the value using the given formatter.

impl Display for DependencyId

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

Renders a stable kind:payload view. Equality and hashing use the exact payloads, which this string faithfully reflects for file paths (already canonical) and labels.

impl Hash for DependencyId

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for DependencyId

fn cmp(&self, other: &DependencyId) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for DependencyId

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

fn partial_cmp(&self, other: &DependencyId) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Eq for DependencyId

impl StructuralPartialEq for DependencyId