ralph-coder 0.2.1

An agentic code generation CLI powered by multiple LLM backends
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

/// Tests for load_files and explain_code tools.
use ralph::tools::file_tools::{explain_code, load_files, write_file};
use std::fs;
use tempfile::TempDir;

// ── load_files ────────────────────────────────────────────────────────────────

#[test]
fn load_files_returns_matching_contents() {
    let dir = TempDir::new().unwrap();
    write_file(&dir.path().join("a.rs"), "fn a() {}").unwrap();
    write_file(&dir.path().join("b.rs"), "fn b() {}").unwrap();
    write_file(&dir.path().join("c.txt"), "not rust").unwrap();

    let result = load_files("*.rs", dir.path()).unwrap();
    assert!(result.contains("fn a()"), "should include a.rs");
    assert!(result.contains("fn b()"), "should include b.rs");
    assert!(!result.contains("not rust"), "should exclude c.txt");
}

#[test]
fn load_files_includes_path_headers() {
    let dir = TempDir::new().unwrap();
    write_file(&dir.path().join("hello.rs"), "// hello").unwrap();

    let result = load_files("*.rs", dir.path()).unwrap();
    assert!(
        result.contains("=== hello.rs ==="),
        "should have a path header"
    );
}

#[test]
fn load_files_no_match_returns_message() {
    let dir = TempDir::new().unwrap();
    let result = load_files("*.nonexistent", dir.path()).unwrap();
    assert!(
        result.contains("No files matched"),
        "should report no matches"
    );
}

#[test]
fn load_files_nested_glob() {
    let dir = TempDir::new().unwrap();
    fs::create_dir_all(dir.path().join("src/sub")).unwrap();
    write_file(&dir.path().join("src/top.rs"), "// top").unwrap();
    write_file(&dir.path().join("src/sub/deep.rs"), "// deep").unwrap();

    let result = load_files("src/**/*.rs", dir.path()).unwrap();
    assert!(result.contains("// top"), "should include top.rs");
    assert!(result.contains("// deep"), "should include deep.rs");
}

// ── explain_code ──────────────────────────────────────────────────────────────

#[test]
fn explain_code_detects_rust_project() {
    let dir = TempDir::new().unwrap();
    write_file(
        &dir.path().join("Cargo.toml"),
        "[package]\nname = \"myapp\"\nversion = \"0.1.0\"\n",
    )
    .unwrap();
    fs::create_dir_all(dir.path().join("src")).unwrap();
    write_file(&dir.path().join("src/main.rs"), "fn main() {}").unwrap();

    let report = explain_code(dir.path()).unwrap();
    assert!(report.contains("Rust"), "should detect Rust project");
    assert!(report.contains("Cargo.toml"), "should mention Cargo.toml");
}

#[test]
fn explain_code_includes_directory_structure() {
    let dir = TempDir::new().unwrap();
    fs::create_dir_all(dir.path().join("src")).unwrap();
    write_file(&dir.path().join("src/lib.rs"), "// lib").unwrap();

    let report = explain_code(dir.path()).unwrap();
    assert!(
        report.contains("Directory Structure"),
        "should have directory section"
    );
    assert!(report.contains("src"), "should list src directory");
}

#[test]
fn explain_code_lists_entry_points() {
    let dir = TempDir::new().unwrap();
    fs::create_dir_all(dir.path().join("src")).unwrap();
    write_file(&dir.path().join("src/main.rs"), "fn main() {}").unwrap();
    write_file(&dir.path().join("src/lib.rs"), "// lib").unwrap();

    let report = explain_code(dir.path()).unwrap();
    assert!(
        report.contains("Entry Points"),
        "should have entry points section"
    );
    assert!(report.contains("src/main.rs"), "should list main.rs");
    assert!(report.contains("src/lib.rs"), "should list lib.rs");
}

#[test]
fn explain_code_includes_source_preview() {
    let dir = TempDir::new().unwrap();
    write_file(
        &dir.path().join("Cargo.toml"),
        "[package]\nname = \"test\"\n",
    )
    .unwrap();
    fs::create_dir_all(dir.path().join("src")).unwrap();
    write_file(
        &dir.path().join("src/main.rs"),
        "fn main() { println!(\"hi\"); }",
    )
    .unwrap();

    let report = explain_code(dir.path()).unwrap();
    assert!(
        report.contains("Source Files"),
        "should have source files section"
    );
    assert!(
        report.contains("fn main()"),
        "should preview source content"
    );
}

#[test]
fn explain_code_unknown_project_type() {
    let dir = TempDir::new().unwrap();
    write_file(&dir.path().join("README.txt"), "hello").unwrap();

    let report = explain_code(dir.path()).unwrap();
    assert!(
        report.contains("Unknown"),
        "should say unknown when no manifest found"
    );
}