Struct LocalTarget 

pub struct LocalTarget { /* private fields */ }

A directory as a backup target: for tests, or a mounted volume.

Each object is written to a temporary file, flushed, and renamed into place. Before a manifest is installed, the directories that gained objects are synced and the drive is flushed once (FlushMethod::platform_default), so the objects are durable before the manifest that names them.

Implementations

impl LocalTarget

pub fn new(root: impl AsRef<Path>) -> Result<Self>

pub fn without_sync(self) -> Self

Skips flushes: survives a process crash, not power loss (tests).

pub fn root(&self) -> &Path

Trait Implementations

impl Target for LocalTarget

fn put(&self, name: &str, bytes: &[u8]) -> Result<()>

fn get(&self, name: &str) -> Result<Option<Vec<u8>>>

None if there is no such object.

fn list(&self, prefix: &str) -> Result<Vec<String>>

Every object name starting with prefix, sorted. The manifest is not an object.

fn delete(&self, name: &str) -> Result<()>

Removing a missing object succeeds.

fn put_manifest(&self, bytes: &[u8]) -> Result<()>

fn get_manifest(&self) -> Result<Option<Vec<u8>>>

fn describe(&self) -> String

For messages: where the target is.

fn cleanup(&self) -> Result<()>

Removes debris of interrupted writes. Called with no writes running.