31 releases

Uses old Rust 2015

0.4.4 Sep 19, 2024
0.4.3 Dec 28, 2023
0.4.2 Oct 9, 2023
0.4.1 Apr 12, 2023
0.0.9 Mar 15, 2015

#69 in Filesystem

Download history 109457/week @ 2024-08-21 99589/week @ 2024-08-28 104084/week @ 2024-09-04 102388/week @ 2024-09-11 84463/week @ 2024-09-18 90020/week @ 2024-09-25 90933/week @ 2024-10-02 85175/week @ 2024-10-09 81826/week @ 2024-10-16 74070/week @ 2024-10-23 74976/week @ 2024-10-30 82306/week @ 2024-11-06 71042/week @ 2024-11-13 62934/week @ 2024-11-20 52839/week @ 2024-11-27 53334/week @ 2024-12-04

258,785 downloads per month
Used in 59 crates (24 directly)

MIT license

16KB
240 lines

rust-atomicwrites

Build Status Windows build status

Atomic file-writes. Works on both POSIX and Windows.

The basic idea is to write to temporary files (in the same file system), and move them when done writing. This avoids the problem of two programs writing to the same file. For AllowOverwrite, rename is used. For DisallowOverwrite, link + unlink is used instead to raise errors when the target path already exists.

This is mostly a port of the same-named Python package.

Example

use atomicwrites::{AtomicFile,DisallowOverwrite};

let af = AtomicFile::new("foo", DisallowOverwrite);
af.write(|f| {
    f.write_all(b"HELLO")
})?;

Alternatives

  • tempfile has a persist method doing the same thing.

License

Licensed under MIT, see LICENSE.

Dependencies

~2–11MB
~132K SLoC