atomwrite 0.1.1

Atomic file operations CLI for LLM agents — read, write, edit, search, replace with NDJSON output
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
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

// SPDX-License-Identifier: MIT OR Apache-2.0

mod common;

#[test]
fn rollback_restores_latest() {
    let dir = tempfile::tempdir().expect("tempdir");
    let file = common::create_test_file(dir.path(), "test.txt", "original content");
    let ws = dir.path().to_str().unwrap();

    // Create backup
    let output = common::atomwrite()
        .args(["--workspace", ws, "backup"])
        .arg(&file)
        .output()
        .expect("run");
    assert!(
        output.status.success(),
        "backup failed: {:?}",
        output.status
    );

    // Modify file via atomwrite (atomic rename preserves backup hardlink)
    let output = common::atomwrite()
        .args(["--workspace", ws, "write"])
        .arg(&file)
        .write_stdin("modified content")
        .output()
        .expect("run");
    assert!(output.status.success(), "write failed: {:?}", output.status);

    // Rollback
    let output = common::atomwrite()
        .args(["--workspace", ws, "rollback"])
        .arg(&file)
        .output()
        .expect("run");

    assert!(output.status.success(), "exit: {:?}", output.status);

    let events = common::parse_ndjson(&output.stdout);
    assert!(events.iter().any(|e| e["type"] == "rollback"));

    let content = std::fs::read_to_string(&file).unwrap();
    assert_eq!(content, "original content");
}

#[test]
fn rollback_dry_run_does_not_modify() {
    let dir = tempfile::tempdir().expect("tempdir");
    let file = common::create_test_file(dir.path(), "test.txt", "original");
    let ws = dir.path().to_str().unwrap();

    let output = common::atomwrite()
        .args(["--workspace", ws, "backup"])
        .arg(&file)
        .output()
        .expect("run");
    assert!(
        output.status.success(),
        "backup failed: {:?}",
        output.status
    );

    let output = common::atomwrite()
        .args(["--workspace", ws, "write"])
        .arg(&file)
        .write_stdin("changed")
        .output()
        .expect("run");
    assert!(output.status.success(), "write failed: {:?}", output.status);

    let output = common::atomwrite()
        .args(["--workspace", ws, "rollback", "--dry-run"])
        .arg(&file)
        .output()
        .expect("run");

    assert!(output.status.success(), "exit: {:?}", output.status);

    let content = std::fs::read_to_string(&file).unwrap();
    assert_eq!(content, "changed", "dry-run should not modify");
}

#[test]
fn rollback_no_backup_exits_4() {
    let dir = tempfile::tempdir().expect("tempdir");
    let file = common::create_test_file(dir.path(), "test.txt", "hello");
    let ws = dir.path().to_str().unwrap();

    let output = common::atomwrite()
        .args(["--workspace", ws, "rollback"])
        .arg(&file)
        .output()
        .expect("run");

    assert_eq!(output.status.code(), Some(4));
}