3 releases

0.1.2 Apr 3, 2025
0.1.1 Dec 12, 2024
0.1.0 Dec 12, 2024

#1109 in Filesystem

Download history 3/week @ 2025-01-22 42/week @ 2025-02-05 17/week @ 2025-02-12 20/week @ 2025-02-19 58/week @ 2025-02-26 32/week @ 2025-03-05 28/week @ 2025-03-12 25/week @ 2025-03-19 22/week @ 2025-03-26 208/week @ 2025-04-02 24/week @ 2025-04-09 25/week @ 2025-04-16 38/week @ 2025-04-23 7/week @ 2025-04-30 38/week @ 2025-05-07

110 downloads per month

MIT license

5KB
67 lines

A crate for safely writing files using an atomic write pattern.

This crate implements a safe file writing strategy that helps prevent file corruption in case of system crashes or power failures. It follows these steps:

  1. Creates parent directories if they don't exist
  2. Writes content to a temporary file
  3. Ensures the content is fully written to disk
  4. Atomically renames the temporary file to the target path

Examples

use safe_write::safe_write;

let content = b"Hello, World!";
safe_write("example.txt", content).expect("Failed to write file");

Platform-specific behavior

On Windows, if the target file exists, it will be explicitly removed before the rename operation since Windows doesn't support atomic file replacement.

Dependencies

~84KB