Struct Storage 

pub struct Storage { /* private fields */ }

Storage subsystem representation.

At the moment, the storage subsystem is backed by a single drive, so this type is a wrapper for the Drive type.

Implementations

impl Storage

pub fn register_scheme(&mut self, scheme: &str, factory: Box<dyn DriveFactory>)

Registers a new drive factory to handle the scheme. Must not have previously been registered and the scheme must be in lowercase.

pub fn has_scheme(&self, scheme: &str) -> bool

Returns true if the scheme is already registered.

pub fn make_canonical(&self, raw_location: &str) -> Result<String>

Converts a raw_location, which needn’t exist, to its canonical form.

pub fn make_canonical_with_extension( &self, raw_location: &str, extension: &str, ) -> Result<String>

Converts a raw_location, which needn’t exist but must represent a file (not a directory), to its canonical form.

If extension is not empty, adds it to the location if it didn’t not yet have nay.

pub fn mount(&mut self, name: &str, uri: &str) -> Result<()>

Instantiates and attaches a new drive with name that points to uri.

The name must be valid and must not yet have been registered.

pub fn unmount(&mut self, name: &str) -> Result<()>

Detaches an existing drive named name.

The drive name must exist, cannot be the current drive, and cannot be the last mounted drive.

pub fn mounted(&self) -> BTreeMap<&str, &str>

Returns information about the mounted drives as a mapping of drive names to the URIs that were used to mount them.

pub fn cd(&mut self, location: &str) -> Result<()>

Changes the current location.

Given that we currently do not support directories, the location can only be of the forms DRIVE: or DRIVE:/.

pub fn cwd(&self) -> String

Returns the current location, used to resolve relative paths.

pub async fn delete(&mut self, raw_location: &str) -> Result<()>

Deletes the program given by raw_location.

pub async fn enumerate(&self, raw_location: &str) -> Result<DriveFiles>

Returns a sorted list of the entries in raw_location and their metadata.

pub async fn get(&self, raw_location: &str) -> Result<Vec<u8>>

Loads the contents of the program given by raw_location.

pub async fn get_acls(&self, raw_location: &str) -> Result<FileAcls>

Gets the ACLs of the file raw_location.

pub async fn put(&mut self, raw_location: &str, content: &[u8]) -> Result<()>

Saves the in-memory program given by content into raw_location.

pub async fn update_acls( &mut self, raw_location: &str, add: &FileAcls, remove: &FileAcls, ) -> Result<()>

Updates the ACLs of the file raw_location by extending them with the contents of add and removing the existing entries listed in remove.

pub fn system_path(&self, raw_location: &str) -> Result<Option<PathBuf>>

Gets the system-addressable path of raw_location, if any.

pub async fn copy(&mut self, raw_src: &str, raw_dest: &str) -> Result<()>

Copies file src to dest.

Trait Implementations

impl Default for Storage

fn default() -> Self

Creates a new storage subsytem backed by an in-memory drive.