Struct endbasic_std::storage::Storage

pub struct Storage { /* fields omitted */ }

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 make_canonical(&self, raw_location: &str) -> Result<String>

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

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<String>

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: &str) -> 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.

Trait Implementations

impl Default for Storage

fn default() -> Self

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