Struct Version 

pub struct Version {
    pub language: Language,
    pub requires: BTreeSet<String>,
    pub budget: Option<u64>,
    pub source: String,
}

One immutable version: the content a digest names.

Fields

language: Language

Its language.

requires: BTreeSet<String>

The capability it declares it needs, its language’s included.

budget: Option<u64>

The store time budget it declares, in milliseconds (budget= at publish), or None for the store’s base. Part of the content, so a republish that changes it is a new version (see crate::authority::effective_budget for what a run gets).

source: String

The source text.

Implementations

impl Version

pub fn canonical(&self) -> Vec<u8>

The bytes the digest is taken over:

ikigai-script/1\n
language <language>\n
requires <scope>\n        (one line per scope, sorted)
budget <milliseconds>\n   (only when it declares one)
\n
<source>

A scope contains no whitespace and the source comes last, so the framing is unambiguous without escaping anything. A version declaring no budget frames exactly as one did before budget existed, so every digest already stored is unchanged.

pub fn digest(&self) -> String

The version’s name: sha256: and 64 lowercase hex digits over canonical.

use ikigai_script::model::{Language, Version};
let v = Version {
    language: Language::Lisp,
    requires: ["urn:cap:lisp".to_string()].into_iter().collect(),
    budget: None,
    source: "(+ 1 2)".to_string(),
};
let digest = v.digest();
assert!(digest.starts_with("sha256:"));
assert_eq!(digest.len(), "sha256:".len() + 64);
assert!(digest["sha256:".len()..].bytes().all(|b| b.is_ascii_hexdigit() && !b.is_ascii_uppercase()));
// Content-addressed: the same content is the same version.
assert_eq!(digest, v.clone().digest());
// A declared budget is content too.
let budgeted = Version { budget: Some(900), ..v.clone() };
assert_ne!(budgeted.digest(), digest);

pub fn document(&self, name: &str) -> VersionDocument

The JSON face of this version under name.

Trait Implementations

impl Clone for Version

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Version

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

Formats the value using the given formatter.

impl Eq for Version

impl PartialEq for Version

fn eq(&self, other: &Self) -> bool

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Version