Struct git_lock::File

pub struct File { /* fields omitted */ }

Locks a resource to eventually be overwritten with the content of this file.

Dropping the file without committing will delete it, leaving the underlying resource unchanged.

Implementations

impl File

pub fn acquire_to_update_resource(
    at_path: impl AsRef<Path>,
    mode: Fail,
    boundary_directory: Option<PathBuf>
) -> Result<File, Error>

Create a writable lock file with failure mode whose content will eventually overwrite the given resource at_path.

If boundary_directory is given, non-existing directories will be created automatically and removed in the case of a rollback. Otherwise the containing directory is expected to exist, even though the resource doesn’t have to.

impl File

pub fn with_mut<T>(
    &mut self,
    f: impl FnOnce(&mut File) -> Result<T>
) -> Result<T>

Obtain a mutable reference to the write handle and call f(out) with it.

pub fn commit(self) -> Result<()>

Commit the changes written to this lock file and overwrite the original resource atomically, returning the resource path on success.

If a file is not committed, it will be deleted on drop or on signal.

Trait Implementations

impl Debug for File

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

Formats the value using the given formatter.