coding_agent_tools 0.4.0

Coding agent tools (CLI + MCP). First tool: ls.
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
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145

#![expect(clippy::unwrap_used)]
#![expect(clippy::undocumented_unsafe_blocks)]

use coding_agent_tools::CodingAgentTools;
use serial_test::serial;
use tempfile::TempDir;

#[tokio::test]
#[serial]
async fn ls_works_with_tilde_home_override() {
    let td = TempDir::new().unwrap();
    // Canonicalize to resolve symlinks (e.g., /var -> /private/var on macOS)
    let home = td.path().canonicalize().unwrap();

    // SAFETY: serialized test ensures no concurrent env mutations
    unsafe {
        std::env::set_var("__CAT_HOME_FOR_TESTS", &home);
    }

    let tools = CodingAgentTools::new();
    let out = tools
        .ls(Some("~".into()), None, None, None, Some(true))
        .await
        .unwrap();
    assert!(out.root.starts_with(home.to_string_lossy().as_ref()));

    // Cleanup override
    unsafe {
        std::env::remove_var("__CAT_HOME_FOR_TESTS");
    }
}

#[tokio::test]
#[serial]
async fn ls_works_with_tilde_slash_home_override() {
    let td = TempDir::new().unwrap();
    // Canonicalize to resolve symlinks (e.g., /var -> /private/var on macOS)
    let home = td.path().canonicalize().unwrap();
    std::fs::create_dir_all(home.join("subdir")).unwrap();

    unsafe {
        std::env::set_var("__CAT_HOME_FOR_TESTS", &home);
    }

    let tools = CodingAgentTools::new();
    let out = tools
        .ls(Some("~/".into()), None, None, None, Some(true))
        .await
        .unwrap();
    assert!(out.root.starts_with(home.to_string_lossy().as_ref()));

    unsafe {
        std::env::remove_var("__CAT_HOME_FOR_TESTS");
    }
}

#[tokio::test]
#[serial]
async fn search_glob_accepts_tilde_root() {
    let td = TempDir::new().unwrap();
    let home = td.path().to_path_buf();
    std::fs::create_dir_all(home.join("sub")).unwrap();

    unsafe {
        std::env::set_var("__CAT_HOME_FOR_TESTS", &home);
    }

    let tools = CodingAgentTools::new();
    let res = tools
        .search_glob(
            "**/*".into(),
            Some("~".into()),
            None,
            Some(true),
            None,
            Some(10),
            Some(0),
        )
        .await;
    assert!(res.is_ok());

    unsafe {
        std::env::remove_var("__CAT_HOME_FOR_TESTS");
    }
}

#[tokio::test]
#[serial]
async fn search_grep_accepts_tilde_root() {
    let td = TempDir::new().unwrap();
    let home = td.path().to_path_buf();
    std::fs::write(home.join("test.txt"), "hello world").unwrap();

    unsafe {
        std::env::set_var("__CAT_HOME_FOR_TESTS", &home);
    }

    let tools = CodingAgentTools::new();
    let res = tools
        .search_grep(
            "hello".into(),
            Some("~".into()),
            None,
            None,
            None,
            Some(true),
            None,
            None,
            None,
            None,
            None,
            None,
            None,
            Some(10),
            Some(0),
        )
        .await;
    assert!(res.is_ok());

    unsafe {
        std::env::remove_var("__CAT_HOME_FOR_TESTS");
    }
}

#[tokio::test]
#[serial]
async fn tilde_expansion_error_when_home_unavailable() {
    unsafe {
        std::env::set_var("__CAT_FORCE_HOME_NONE", "1");
    }

    let tools = CodingAgentTools::new();
    let res = tools.ls(Some("~".into()), None, None, None, None).await;

    unsafe {
        std::env::remove_var("__CAT_FORCE_HOME_NONE");
    }

    assert!(res.is_err());
    let err_msg = res.unwrap_err().to_string();
    assert!(
        err_msg.contains("Could not determine home directory"),
        "Expected home directory error, got: {err_msg}"
    );
}