Struct Pack 

pub struct Pack { /* private fields */ }

A parsed, digest-verified pack.

Constructed by Pack::load, Pack::from_bytes, or once for the whole process by embedded. Every span was bounds- and boundary-checked at construction, so the accessors on Provider and Operation cannot fail.

Implementations

impl Pack

pub fn load(path: impl AsRef<Path>) -> Result<Pack, Error>

Read and verify a pack at path — the constructor for a host loading a newer catalogue than it was built with. Refuses a wrong format version, schema version or digest before serving any record.

Errors

Error::Io when the file cannot be read; otherwise everything from_bytes refuses.

pub fn from_bytes(bytes: Vec<u8>) -> Result<Pack, Error>

Verify and parse a pack from bytes already in hand.

Errors

Every Error variant except Error::Io; see each variant for what it refuses.

pub fn schema_version(&self) -> u32

The document schema version the pack carries.

pub fn digest(&self) -> &str

The verified content digest, as lowercase hex — the pack’s identity, usable as a cache key.

pub fn providers(&self) -> impl ExactSizeIterator<Item = Provider<'_>>

Every provider in the pack, in id order.

pub fn provider(&self, id: &str) -> Option<Provider<'_>>

One provider by id.

pub fn operations(&self) -> impl ExactSizeIterator<Item = Operation<'_>>

Every operation in the pack, in id order.

pub fn operation(&self, id: &str) -> Option<Operation<'_>>

One operation by id.

pub fn operations_of<'s>( &'s self, provider: &str, ) -> impl Iterator<Item = Operation<'s>> + 's

Every operation of one provider, in id order. An unknown provider yields nothing, exactly as the legacy catalogue’s operations_of does.

Trait Implementations

impl Debug for Pack

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

The identity and the shape, never the 9-MB payload: a {:?} in a log must not print the catalogue at an operator.