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

use std::fmt::Write as _;

use super::super::*;

/// Render the deterministic deprecations aggregate page (#889). Lists every
/// deprecated symbol grouped by file; renders a clear "none found" line when
/// empty. Never degrades.
pub(crate) fn render_deprecations_doc(doc: &DeprecationsDoc) -> String {
    let mut out = frontmatter_with_degradation_without_ranges(
        "Deprecations",
        "code_deprecations",
        &[],
        &doc.degraded_sources,
    );
    out.push_str("# Deprecations\n\n");
    out.push_str(
        "This page is derived deterministically from a source scan of the documented files \
         — no LLM. A symbol is listed when a `#[deprecated]` attribute or a `DEPRECATED` \
         doc-comment sits directly above its definition (or in its docstring). Each row is the \
         symbol that carries the marker, where it lives, and the recorded reason.\n\n",
    );

    if doc.symbols.is_empty() {
        out.push_str("No deprecated symbols found.\n");
        return out;
    }

    // Group by file in the already-sorted order.
    let mut current_file: Option<&str> = None;
    for symbol in &doc.symbols {
        if current_file != Some(symbol.file.as_str()) {
            if current_file.is_some() {
                out.push('\n');
            }
            let _ = writeln!(out, "## {}\n", file_wikilink(&symbol.file));
            write_markdown_table_header(&mut out, &["Symbol", "Kind", "Location", "Reason"]);
            current_file = Some(symbol.file.as_str());
        }
        let location = format!("{}:{}", symbol.file, symbol.line);
        let reason = if symbol.reason.is_empty() {
            "deprecated".to_string()
        } else {
            symbol.reason.clone()
        };
        write_markdown_table_row(
            &mut out,
            [
                inline_code(&symbol.name),
                symbol.kind.clone(),
                inline_code(&location),
                reason,
            ],
        );
    }
    out.push('\n');
    out
}