gobby-code 1.3.3

Fast Rust CLI for Gobby's code index — AST-aware search, symbol navigation, and dependency graph
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

use super::support::*;
use super::*;

#[test]
fn codewiki_changes_baseline_persists_snapshot_without_degrading_on_missing_graph() {
    let project = tempfile::tempdir().expect("project tempdir");
    std::fs::create_dir_all(project.path().join("src")).expect("source dir");
    std::fs::write(project.path().join("src/lib.rs"), "pub struct Client;\n").expect("write lib");
    let out_dir = project.path().join("codewiki");
    let input = CodewikiInput {
        leading_chunks: std::collections::BTreeMap::new(),
        files: vec!["src/lib.rs".to_string()],
        graph_edges: Vec::new(),
        graph_availability: CodewikiGraphAvailability::Unavailable,
        symbols: vec![test_symbol(
            "src/lib.rs",
            "Client",
            "class",
            1,
            "pub struct Client;",
        )],
    };

    let snapshot = build_codewiki_index_snapshot(project.path(), &input).expect("snapshot");
    let changes = build_codewiki_changes_doc(None, &snapshot).expect("changes doc");
    assert!(changes.contains("baseline: true"));
    // Graph availability is informational only: a missing graph never degrades
    // the changes page, though neighborhood computation is still skipped.
    assert!(!changes.contains("degraded: true"));
    assert!(!changes.contains("graph-unavailable"));
    assert!(changes.contains("- Graph neighborhoods: unavailable"));
    assert!(changes.contains("No previous index snapshot was available."));
    assert!(!changes.contains("## Changed Graph Neighborhoods"));

    write_incremental_doc_set_with_snapshot(
        project.path(),
        &out_dir,
        &[BuiltDoc::healthy("code/_changes.md", changes)],
        Some(snapshot),
        "off",
        DocPruneScope::unscoped(),
    )
    .expect("write snapshot");
    let meta = read_codewiki_meta(&out_dir).expect("read meta");
    let persisted = meta.index_snapshot.expect("persisted snapshot");
    assert_eq!(persisted.files["src/lib.rs"].symbol_count, 1);
    assert!(persisted.files["src/lib.rs"].content_hash.len() >= 32);
}

#[test]
fn codewiki_changes_lists_index_diff_against_previous_snapshot() {
    let project = tempfile::tempdir().expect("project tempdir");
    std::fs::create_dir_all(project.path().join("src")).expect("source dir");
    std::fs::write(project.path().join("src/lib.rs"), "pub struct Client;\n").expect("write lib");
    std::fs::write(project.path().join("src/api.rs"), "pub fn serve() {}\n").expect("write api");

    let previous_symbols = vec![
        test_symbol("src/lib.rs", "Client", "class", 1, "pub struct Client;"),
        test_symbol("src/api.rs", "serve", "function", 1, "pub fn serve()"),
    ];
    let previous_input = CodewikiInput {
        leading_chunks: std::collections::BTreeMap::new(),
        files: vec!["src/lib.rs".to_string(), "src/api.rs".to_string()],
        graph_edges: vec![CodewikiGraphEdge::call(
            previous_symbols[0].id.clone(),
            previous_symbols[1].id.clone(),
        )],
        graph_availability: CodewikiGraphAvailability::Available,
        symbols: previous_symbols,
    };
    let previous =
        build_codewiki_index_snapshot(project.path(), &previous_input).expect("previous snapshot");

    std::fs::write(
        project.path().join("src/lib.rs"),
        "pub struct Client;\npub fn connect() {}\n",
    )
    .expect("modify lib");
    std::fs::remove_file(project.path().join("src/api.rs")).expect("remove api");
    std::fs::write(project.path().join("src/new.rs"), "pub fn start() {}\n").expect("write new");
    let current_symbols = vec![
        test_symbol("src/lib.rs", "Client", "class", 1, "pub struct Client;"),
        test_symbol("src/lib.rs", "connect", "function", 2, "pub fn connect()"),
        test_symbol("src/new.rs", "start", "function", 1, "pub fn start()"),
    ];
    let current_input = CodewikiInput {
        leading_chunks: std::collections::BTreeMap::new(),
        files: vec!["src/lib.rs".to_string(), "src/new.rs".to_string()],
        graph_edges: vec![CodewikiGraphEdge::call(
            current_symbols[0].id.clone(),
            current_symbols[1].id.clone(),
        )],
        graph_availability: CodewikiGraphAvailability::Available,
        symbols: current_symbols,
    };
    let current =
        build_codewiki_index_snapshot(project.path(), &current_input).expect("current snapshot");

    let changes = build_codewiki_changes_doc(Some(&previous), &current).expect("changes doc");
    assert!(changes.contains("baseline: false"));
    assert!(changes.contains("degraded: false"));
    assert!(changes.contains("- `src/new.rs`"));
    assert!(changes.contains("- `src/api.rs`"));
    assert!(changes.contains("- `src/lib.rs`"));
    assert!(changes.contains("`connect` function in `src/lib.rs`"));
    assert!(changes.contains("`start` function in `src/new.rs`"));
    assert!(changes.contains("`serve` function in `src/api.rs`"));
    assert!(changes.contains("## Changed Graph Neighborhoods"));
    assert!(changes.contains("`Client` class in `src/lib.rs`"));
}