Struct Container

pub struct Container { /* private fields */ }

A version-agnostic read-only WEBC container.

A Container provides a high-level interface for reading and manipulating WEBC container files. It supports multiple versions of WEBC container formats and abstracts the underlying differences between them.

Implementations

impl Container

pub fn from_disk(path: impl AsRef<Path>) -> Result<Self, ContainerError>

Load a Container from disk.

Where possible, this will try to use a memory-mapped implementation to reduce memory usage.

pub fn from_bytes(bytes: impl Into<Bytes>) -> Result<Self, ContainerError>

Load a Container from bytes in memory.

pub fn version(&self) -> Version

Get the underlying webc version

pub fn manifest(&self) -> &Manifest

Get the Container’s manifest.

pub fn webc_hash(&self) -> Option<[u8; 32]>

Get the Container’s webc hash

pub fn atoms(&self) -> BTreeMap<String, OwnedBuffer>

Get all atoms stored in the container as a map.

pub fn get_atom(&self, name: &str) -> Option<OwnedBuffer>

Get an atom with the given name.

Returns None if the atom does not exist in the container.

This operation is pretty cheap, typically just a dictionary lookup followed by reference count bump and some index math.

pub fn volumes(&self) -> BTreeMap<String, Volume>

Get all volumes stored in the container.

pub fn get_volume(&self, name: &str) -> Option<Volume>

Get a volume with the given name.

Returns None if the volume does not exist in the container.

pub fn downcast_ref<T>(&self) -> Option<&T>

where T: 'static,

Downcast the Container a concrete implementation.

pub fn downcast<T>(self) -> Result<Arc<T>, Self>

where T: 'static,

Downcast the Container a concrete implementation, returning the original Container if the cast fails.

pub fn unpack( &self, out_dir: &Path, overwrite: bool, ) -> Result<(), ContainerError>

Unpack the container into a directory.

This will create a directory at out_dir and populate it with the the contents of each volume and the manifest.

If the output directory already exists and is not empty, the operation will fail, unless overwrite is set to true.

pub fn validate(&self) -> Result<(), Error>

Validates an [AbstractWebc]

Trait Implementations

impl Clone for Container

fn clone(&self) -> Container

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Container

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

Formats the value using the given formatter.

impl From<OwnedReader> for Container

Available on crate feature v2 only.

fn from(value: OwnedReader) -> Self

Converts to this type from the input type.

impl From<OwnedReader> for Container

Available on crate feature v3 only.

fn from(value: OwnedReader) -> Self

Converts to this type from the input type.

impl From<Package> for Container

Available on crate feature package only.

fn from(value: Package) -> Self

Converts to this type from the input type.

impl From<WebCMmap> for Container

Available on crate feature v1 only.

fn from(value: WebCMmap) -> Self

Converts to this type from the input type.

impl From<WebCOwned> for Container

Available on crate feature v1 only.

fn from(value: WebCOwned) -> Self

Converts to this type from the input type.