xyz-rust 0.4.9

One definition, three interfaces（CLI / HTTP / MCP）— a command toolkit for Rust
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

// 无参数/help 模式的总览输出：三种形态 + 内置参数提示 + 命令表
// （CLI 被禁用时隐藏命令表）。

use std::fmt::Write as _;
use std::io::Write;

use crate::config::Capabilities;
use crate::registry::Registry;

/// 原样输出自定义帮助块：末尾多余换行归一为单个换行，与后续内容自然
/// 分行；空块不输出。
pub fn write_block(w: &mut dyn Write, s: &str) -> std::io::Result<()> {
    if s.is_empty() {
        return Ok(());
    }
    writeln!(w, "{}", s.trim_end_matches('\n'))
}

pub fn print_overview(
    w: &mut dyn Write,
    reg: &Registry,
    words: &crate::dispatch::Words,
    shadowed: &std::collections::BTreeSet<String>,
    caps: Capabilities,
    help_before: &str,
    help_after: &str,
) -> std::io::Result<()> {
    // before 块直接写目标流；正文攒进 buf。
    write_block(w, help_before)?;
    let mut buf = String::new();
    let _ = writeln!(buf, "{}", crate::lang::t("overview.usage_line"));
    let mut cli_line = crate::lang::t("overview.cli_mode");
    if caps.no_cli {
        cli_line += &crate::lang::t("overview.disabled");
    } else if !crate::dispatch::cli_frontend_compiled() {
        cli_line += &crate::lang::t("overview.not_compiled");
    }
    let _ = writeln!(buf, "{cli_line}");
    // 模式行（spec §13.1）：被用户命令遮蔽的裸词不列出（其 xyz.<词>
    // 形式永不展示）；未遮蔽时按状态附禁用/未编译后缀。
    let http_state = if caps.no_http {
        crate::lang::t("overview.disabled")
    } else if !crate::dispatch::http_frontend_compiled() {
        crate::lang::t("overview.not_compiled")
    } else {
        String::new()
    };
    if !shadowed.contains(&words.serve) {
        let line = crate::lang::tf("overview.serve_mode", &[&words.serve]);
        let _ = writeln!(buf, "{line}{http_state}");
    }
    if !shadowed.contains(&words.http) {
        let line = crate::lang::tf("overview.http_mode", &[&words.http]);
        let _ = writeln!(buf, "{line}{http_state}");
    }
    if !shadowed.contains(&words.mcp) {
        let line = crate::lang::tf("overview.mcp_mode", &[&words.mcp]);
        let mcp_line = if caps.no_mcp {
            line + &crate::lang::t("overview.disabled")
        } else if !crate::dispatch::mcp_frontend_compiled() {
            line + &crate::lang::t("overview.not_compiled")
        } else {
            line
        };
        let _ = writeln!(buf, "{mcp_line}");
    }
    if !shadowed.contains(&words.help) {
        let line = crate::lang::tf("overview.help_mode", &[&words.help]);
        let _ = writeln!(buf, "{line}");
    }
    let _ = writeln!(buf, "{}", crate::lang::t("overview.builtins"));
    // CLI 被禁用时不生成子命令，总览也不再列出命令表。
    let names = reg.names();
    if names.is_empty() || caps.no_cli {
        write!(w, "{buf}")?;
        // 自定义 after 块在早退路径照打。
        return write_block(w, help_after);
    }
    let _ = writeln!(buf);
    let _ = writeln!(buf, "{}", crate::lang::t("overview.commands"));
    let width = names.iter().map(|n| n.len()).max().unwrap_or(0);
    for n in &names {
        let summary = reg.get(n).map(|e| e.summary.clone()).unwrap_or_default();
        let _ = writeln!(buf, "  {n:<width$}  {summary}");
    }
    write!(w, "{buf}")?;
    write_block(w, help_after)
}