Struct dodo::Directory

pub struct Directory { /* fields omitted */ }

Storage backed by a folder.

Locking strategy

This storage does not have any entry locking mechanism.

Errors

All files in the folder are considered part of this storage. Thus, any unexpected event (denied permission, interrupted, …) in the folder will result in an error.

It is expected that the folder remains valid as long a the storage exists. Tempering with the folder in any way (deleting it, moving it, removing permissions, …) will result in an error.

Implementations

impl Directory

pub fn new<P>(path: P) -> Result<Self> where
    P: AsRef<Path>, 

Create a new directory storage, or open it if it already exist. Folders are created recursively if needed.

Examples

use dodo::prelude::*;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let directory = Directory::new(&path)?;
    Ok(())
}

Errors

This will return an error in the following situations :

• Folders didn’t exists, and storage wasn’t able to create it.
• Path points at a file, not a folder.
• Other IO specific errors (permission denied, invalid path, …).

Trait Implementations

impl Clone for Directory

fn clone(&self) -> Directory

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Directory

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

Formats the value using the given formatter.

impl Storage for Directory

type Read = FileReader

Reader.

type Write = FileWriter

Writer.

type Iterator = Iter

Iterator.

fn new(&mut self) -> Result<(Uuid, Self::Write)>

Create a new entry in this storage, returning his id and a writer.

fn read(&self, entry: Uuid) -> Result<Self::Read>

Provide a reader to an entry, if it exists.

fn write(&mut self, entry: Uuid) -> Result<Self::Write>

Provide a writer to an entry. If it exists, this writer overrides (and truncates) the bytes. If it doesn’t exists, a new entry is created.

fn overwrite(&mut self, entry: Uuid) -> Result<Self::Write>

Provide a writer to an entry, only if it exists. This writer override (and truncates) the bytes.

fn delete(&mut self, entry: Uuid) -> Result<bool>

Delete an entry.

fn clear(&mut self) -> Result<()>

Empties this storage.

fn iter(&self) -> Result<Self::Iterator>

Provide an iterator listing the entries currently in this storage.