Struct PinnedRelease 

pub struct PinnedRelease {
    pub version: String,
    pub build_id: String,
    pub sha256: HashMap<Platform, String>,
}

A concrete hyperd release pinned to a specific version and build, with optional per-platform SHA-256 checksums.

The “built-in” pin shipped with the crate lives in hyperd-bootstrap/hyperd-version.toml and is available via PinnedRelease::builtin. Callers can override it by loading an external TOML file (see PinnedRelease::from_toml_file) or by passing a literal TOML string to PinnedRelease::from_toml_str.

Fields

version: String

Upstream release version (for example, "0.0.24457").

build_id: String

Upstream build identifier suffix (for example, "rc36858b6").

sha256: HashMap<Platform, String>

Expected SHA-256 digests keyed by platform. Empty strings are treated as “no digest” so that partially-filled tables skip verification for the missing targets instead of failing outright.

Implementations

impl PinnedRelease

pub fn builtin() -> Self

Returns the PinnedRelease baked into the crate at build time.

Panics

Panics if the shipped hyperd-version.toml fails to parse. This is treated as a programmer error — the file is validated by the build script and release CI.

pub fn from_toml_str(s: &str) -> Result<Self, Error>

Parses a PinnedRelease from an in-memory TOML string.

Errors

Returns Error::TomlParse if the text is not valid TOML or the document does not match the PinnedRelease schema.

pub fn from_toml_file(path: &Path) -> Result<Self, Error>

Loads a PinnedRelease from a TOML file on disk.

Errors

Returns Error::Io if the file cannot be read, or Error::TomlParse if the content is not a valid PinnedRelease.

pub fn sha256_for(&self, platform: Platform) -> Option<&str>

Returns the expected SHA-256 digest for platform, or None if the release metadata does not pin a digest for that platform. Empty strings (common in pre-release metadata) are treated as absent.

pub fn version_tag(&self) -> String

Returns the full Hyper release tag — version.build_id — used in download URLs and install directory names.

Trait Implementations

impl Clone for PinnedRelease

fn clone(&self) -> PinnedRelease

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PinnedRelease

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PinnedRelease

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for PinnedRelease

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.