atomwrite 0.1.34

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
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127

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

mod common;

use serde_json::Value;

#[test]
fn clap_error_edit_missing_value_has_suggestion() {
    let dir = tempfile::tempdir().expect("tempdir");
    let path = common::create_test_file(dir.path(), "target.txt", "hello\n");

    let output = common::atomwrite()
        .args(["--workspace", dir.path().to_str().unwrap(), "edit", "--old"])
        .arg(&path)
        .output()
        .expect("run");

    assert_eq!(output.status.code(), Some(2), "expected exit 2");

    let stdout = String::from_utf8_lossy(&output.stdout);
    let json: Value = serde_json::from_str(stdout.trim()).expect("valid JSON");
    assert_eq!(json["code"], "ARGUMENT_PARSE_ERROR");
    let suggestion = json["suggestion"].as_str().unwrap_or("");
    assert!(
        suggestion.contains("--old-file"),
        "suggestion should mention --old-file, got: {suggestion}"
    );
}

#[test]
fn clap_error_conflicts_with_old_file_has_suggestion() {
    let dir = tempfile::tempdir().expect("tempdir");
    let path = common::create_test_file(dir.path(), "target.txt", "hello\n");
    let old_file = common::create_test_file(dir.path(), "old.txt", "hello");

    let output = common::atomwrite()
        .args([
            "--workspace",
            dir.path().to_str().unwrap(),
            "edit",
            "--old",
            "hello",
            "--old-file",
        ])
        .arg(&old_file)
        .arg(&path)
        .output()
        .expect("run");

    assert_eq!(output.status.code(), Some(2), "expected exit 2");

    let stdout = String::from_utf8_lossy(&output.stdout);
    let json: Value = serde_json::from_str(stdout.trim()).expect("valid JSON");
    assert_eq!(json["code"], "ARGUMENT_PARSE_ERROR");
    let suggestion = json["suggestion"].as_str().unwrap_or("");
    assert!(
        suggestion.contains("--old-file"),
        "suggestion should mention --old-file, got: {suggestion}"
    );
}

#[test]
fn clap_error_envelope_structure_complete() {
    let output = common::atomwrite()
        .args(["--workspace", "/tmp", "edit"])
        .output()
        .expect("run");

    assert_eq!(output.status.code(), Some(2), "expected exit 2");

    let stdout = String::from_utf8_lossy(&output.stdout);
    let json: Value = serde_json::from_str(stdout.trim()).expect("valid JSON");

    assert_eq!(json["error"], true);
    assert_eq!(json["code"], "ARGUMENT_PARSE_ERROR");
    assert_eq!(json["exit"], 2);
    assert!(json["message"].is_string());
    assert_eq!(json["error_class"], "permanent");
    assert_eq!(json["retryable"], false);
}

#[test]
fn clap_error_non_edit_no_old_file_suggestion() {
    let output = common::atomwrite()
        .args(["--workspace", "/tmp", "search"])
        .output()
        .expect("run");

    assert_eq!(output.status.code(), Some(2), "expected exit 2");

    let stdout = String::from_utf8_lossy(&output.stdout);
    let json: Value = serde_json::from_str(stdout.trim()).expect("valid JSON");
    assert_eq!(json["code"], "ARGUMENT_PARSE_ERROR");

    let suggestion = json["suggestion"].as_str().unwrap_or("");
    assert!(
        !suggestion.contains("--old-file"),
        "search error should NOT mention --old-file, got: {suggestion}"
    );
}

#[test]
fn clap_error_unknown_flag_in_non_edit_no_false_positive() {
    let dir = tempfile::tempdir().expect("tempdir");

    let output = common::atomwrite()
        .args([
            "--workspace",
            dir.path().to_str().unwrap(),
            "hash",
            "--nonexistent-flag",
        ])
        .output()
        .expect("run");

    assert_eq!(output.status.code(), Some(2), "expected exit 2");

    let stdout = String::from_utf8_lossy(&output.stdout);
    let json: Value = serde_json::from_str(stdout.trim()).expect("valid JSON");
    assert_eq!(json["code"], "ARGUMENT_PARSE_ERROR");

    let suggestion = json["suggestion"].as_str().unwrap_or("");
    assert!(
        !suggestion.contains("--old-file"),
        "hash error with unknown flag should NOT mention --old-file, got: {suggestion}"
    );
}