Struct FsVolume

pub struct FsVolume {
    name: String,
    intermediate_directories: BTreeSet<PathBuf>,
    metadata_files: BTreeSet<PathBuf>,
    mapped_directories: BTreeSet<PathBuf>,
    base_dir: PathBuf,
    walker_factory: WalkBuilderFactory,
}

A lazily loaded volume in a Wasmer package.

Note that it is the package resolver’s role to interpret a package’s filesystem mappings. A volume contains directories as they were when the package was published.

Fields

name: String

Name of the volume

intermediate_directories: BTreeSet<PathBuf>

A pre-computed set of intermediate directories that are needed to allow access to the whitelisted files and directories.

metadata_files: BTreeSet<PathBuf>

Specific files that this volume has access to.

mapped_directories: BTreeSet<PathBuf>

Directories that allow the user to access anything inside them.

base_dir: PathBuf

The base directory all [PathSegments] will be resolved relative to.

walker_factory: WalkBuilderFactory

The walker builder factory to use when reading directories.

Implementations

impl FsVolume

pub(crate) const METADATA: &'static str = "metadata"

The name of the volume used to store metadata files.

pub(crate) fn new_metadata( manifest: &Manifest, base_dir: impl Into<PathBuf>, ) -> Result<Self, Error>

Create a new metadata volume.

pub(crate) fn new_assets( manifest: &Manifest, base_dir: &Path, walker_factory: WalkBuilderFactory, ) -> Result<BTreeMap<String, Self>, Error>

pub(crate) fn new_with_intermediate_dirs( name: String, base_dir: PathBuf, whitelisted_files: BTreeSet<PathBuf>, whitelisted_directories: BTreeSet<PathBuf>, walker_factory: WalkBuilderFactory, ) -> Self

pub(crate) fn new( name: String, base_dir: PathBuf, whitelisted_files: BTreeSet<PathBuf>, whitelisted_directories: BTreeSet<PathBuf>, walker_factory: WalkBuilderFactory, ) -> Self

fn is_accessible(&self, path: &Path) -> bool

fn resolve(&self, path: &PathSegments) -> Option<PathBuf>

pub fn name(&self) -> &str

Returns the name of the volume

pub fn read_file(&self, path: &PathSegments) -> Option<OwnedBuffer>

Read a file from the volume.

pub fn read_dir( &self, path: &PathSegments, ) -> Option<Vec<(PathSegment, Option<[u8; 32]>, Metadata)>>

Read the contents of a directory.

pub fn metadata(&self, path: &PathSegments) -> Option<Metadata>

Get the metadata for a particular item.

pub(crate) fn as_directory_tree( &self, strictness: Strictness, ) -> Result<Directory<'_>, Error>

Trait Implementations

impl AbstractVolume for FsVolume

fn read_file( &self, path: &PathSegments, ) -> Option<(OwnedBuffer, Option<[u8; 32]>)>

Returnes the contents of the file associated with path and optionally, its hash

fn read_dir( &self, path: &PathSegments, ) -> Option<Vec<(PathSegment, Option<[u8; 32]>, Metadata)>>

Returns the entries of path

fn metadata(&self, path: &PathSegments) -> Option<Metadata>

Returns the metadata of the entry associated with path

impl Debug for FsVolume

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

Formats the value using the given formatter.

impl WasmerPackageVolume for FsVolume

fn as_directory_tree( &self, strictness: Strictness, ) -> Result<Directory<'_>, Error>

Serialize the volume as a [webc::v3::write::Directory].

fn as_volume(self: Arc<Self>) -> Arc<dyn AbstractVolume + Send + Sync + 'static>