agent-rules-tool 0.1.0-rc.2

Lint and migrate agent rules per agent-rules-spec
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

//! Atomic file writes used by migrate output.

use crate::error::Error;
use std::path::Path;
use tokio::fs;

/// Write `content` to `path`, creating parent directories as needed.
///
/// When the file already exists and `force` is false, returns
/// [`WriteOutcome::Skipped`] without modifying the file.
pub async fn write_file_atomic(
    path: &Path,
    content: &str,
    force: bool,
) -> Result<WriteOutcome, Error> {
    if path.exists() && !force {
        return Ok(WriteOutcome::Skipped);
    }

    if let Some(parent) = path.parent() {
        fs::create_dir_all(parent).await?;
    }

    let temp_path = path.with_extension("tmp");
    fs::write(&temp_path, content).await?;
    fs::rename(&temp_path, path).await?;
    Ok(WriteOutcome::Written)
}

/// Result of [`write_file_atomic`].
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum WriteOutcome {
    /// File was written (or overwritten when `force` is true).
    Written,
    /// File already existed and `force` was false.
    Skipped,
}