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.

Errors

Returns ProjectPathError when path is not a valid project-relative path.

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.

Errors

Returns ProjectPathError when path is not a valid project-relative path.

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.

Errors

Returns ProjectPathError when path is not a valid project-relative path.

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 Eq for DependencyId

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 StructuralPartialEq for DependencyId