Struct Target

pub(crate) struct Target<'r> {
    pub(crate) dir: &'r CheckedDir,
    pub(crate) rel_fname: &'r Path,
}

Common arguments to load/store operations

Fields

dir: &'r CheckedDir

Directory

rel_fname: &'r Path

Filename relative to dir

Might be a leafname; must be relative Should include the .json extension.

Implementations

impl Target<'_>

pub(crate) fn load<D: DeserializeOwned>(&self) -> Result<Option<D>, ErrorSource>

Load and deserialize a D from the file specified by self

Returns None if the file doesn’t exist.

pub(crate) fn store<S: Serialize>(&self, val: &S) -> Result<(), ErrorSource>

Serialise and store an S to the file specified by self

Concurrent readers (using load) will see either the old data, or the new data, not corruption or a mixture.

Likewise, if something fails, the old data will remain. (But, we do not use fsync.)

It is a serious bug to make several concurrent calls to store for the same file. That might result in corrupted files.

See [fs_mistrust::CheckedDir::write_and_replace] for more details about the semantics.

pub(crate) fn delete(&self) -> Result<(), ErrorSource>

Delete the file specified by self

Trait Implementations

impl<'r> Display for Target<'r>

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

Formats the value using the given formatter.