Struct Any 

pub struct Any(Box<dyn Erased>);

One container’s bytes, wherever they are.

Tuple Fields

0: Box<dyn Erased>

Implementations

impl Any

pub fn new(storage: impl Storage + 'static) -> Self

Trait Implementations

impl Debug for Any

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

Formats the value using the given formatter.

impl Storage for Any

fn name(&self) -> Name

What this container is called.

fn names(&self, at: &Entry) -> String

What a report calls at — a platform path where there is one. Not a promise that anything is there.

fn residency(&self) -> Residency

fn disk_path(&self) -> Option<&Path>

Where these bytes sit on a filesystem, for a shell that can name one. None for a storage that has no such thing.

fn read<'a>( &'a self, at: &'a Entry, ) -> impl Future<Output = Result<Option<Vec<u8>>>> + 'a

The bytes at at, or None where nothing is — which is not the same as a read that did not work.

fn exists<'a>( &'a self, at: &'a Entry, ) -> impl Future<Output = Result<bool>> + 'a

Whether anything stands at at. Separate from Self::read because a payload is filed under a content hash, so the answer is all a write needs — and reading a megabyte to learn it is already there is the one thing that would make every commit cost the artwork on the page.

fn write<'a>( &'a self, at: &'a Entry, bytes: &'a [u8], ) -> impl Future<Output = Result<()>> + 'a

Whole file or nothing: a reader caught mid-write sees the previous contents, never half of each.

fn append<'a>( &'a self, at: &'a Entry, bytes: &'a [u8], ) -> impl Future<Output = Result<()>> + 'a

Add bytes to the end of at, durably before returning.

fn truncate<'a>( &'a self, at: &'a Entry, len: u64, ) -> impl Future<Output = Result<()>> + 'a

fn list<'a>( &'a self, dir: &'a Entry, ) -> impl Future<Output = Result<Vec<String>>> + 'a

What dir holds, by name, in no particular order.

fn remove<'a>(&'a self, at: &'a Entry) -> impl Future<Output = Result<()>> + 'a

fn create_dir<'a>( &'a self, dir: &'a Entry, ) -> impl Future<Output = Result<()>> + 'a

Make dir a place entries can be written.

fn rename<'a>( &'a mut self, to: &'a Name, ) -> impl Future<Output = Result<()>> + 'a

Call this container something else, leaving everything in it where it is — which is what renaming the document means.

fn discard(&self) -> impl Future<Output = Result<()>> + '_

Remove the container itself. Only ever asked of one that has been emptied.

fn claim(&self, now: WallTime) -> impl Future<Output = Result<Claim>> + '_

Claim the right to write this container.

fn release(&self)

Give the lock back.