blob: 9fac8a49106dea1941a002fdd75025055cbcd533 (
plain) (
blame)
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
|
<h1 align="center">将结果渲染</h1>
<p align="center">
使用 renderer 宏声明渲染器，将结果输出
</p>
现在，我们创建了 Dispatcher 和 Chain，也通过 `pack!` 产出了一个 Result 类型。最后一步：**把结果展示给用户**。
## `#[renderer]` 宏
跟 `#[chain]` 类似，`#[renderer]` 用于标记一个输出函数：
```rust
@@@pack!(ResultName = String);
#[renderer]
fn render_name(name: ResultName) {
r_println!("Hello, {}!", *name);
}
```
Renderer 接收 Chain 产出的结果，然后用 `r_println!` 输出。这个 `r_println!` 跟我们平常用的 `println!` 有什么区别？
## `r_println!` 和 `r_print!` 宏
`r_println!` 和 `r_print!` 是 Mingling 提供的打印宏，它们把内容写入 `RenderResult` 而不是直接输出到终端。这样做的好处是：
1. **RenderResult 持有退出码**——你可以设置程序以特定退出码结束
2. **方便测试**——可以捕获渲染结果做断言
3. **便于后处理**——你可以将结果捕获，统一进行文本后处理
> [!TIP]
> 如果只是简单打印，你可以先把它理解为 `println!` 的平替。用 `r_println!` 替换 `println!` 不会错。
## 完整的可运行程序
把三篇教程的内容合在一起，你的第一个 Mingling 程序就完整了：
```rust
// 1. 用 Dispatcher 声明命令
dispatcher!("greet", CMDGreet => EntryGreet);
// 2. 用 pack! 声明结果数据
pack!(ResultName = String);
// 3. 用 Chain 处理逻辑
#[chain]
fn handle_greet(args: EntryGreet) -> Next {
let name = args.inner
.first()
.cloned()
.unwrap_or_else(|| "World".to_string());
ResultName::new(name)
}
// 4. 用 Renderer 输出结果
#[renderer]
fn render_name(name: ResultName) {
r_println!("Hello, {}!", *name);
}
// 5. 在 main 函数内装配程序并运行
fn main() {
let mut program = ThisProgram::new();
program.with_dispatcher(CMDGreet);
program.exec_and_exit();
}
// 6. 使用 gen_program! 生成完整程序
gen_program!();
```
## 跑起来试试
```bash
~# cargo run -- greet Alice
```
```text
Hello, Alice!
```
试试不给参数：
```bash
~# cargo run -- greet
```
```text
Hello, World!
```
试试不存在的命令：
```bash
cargo run -- great
```
```text
# 什么也没输出！
```
## 补上 Fallback
`gen_program!()` 自动生成了一个 `ErrorDispatcherNotFound` 类型，包裹 `Vec<String>`——它存的是用户输入的那些没匹配到的命令。你只需要给它写一个 Renderer：
```rust
#[renderer]
fn render_dispatcher_not_found(err: ErrorDispatcherNotFound) {
if err.inner.is_empty() {
r_println!("Unknown command");
} else {
r_println!("Command not found: \"{}\"", err.inner.join(" "));
}
}
```
加上之后，再试试不存在的命令：
```bash
cargo run -- great
```
```text
Command not found: "great"
```
## 恭喜
你完成了第一个完整的 Mingling 程序！来回顾一下学到的东西：
| 概念 | 对应宏/函数 | 一句话 |
| -------- | ---------------- | -------------------------- |
| 声明命令 | `dispatcher!` | 告诉程序用户能输入什么 |
| 处理逻辑 | `#[chain]` | 收到参数后做什么 |
| 输出结果 | `#[renderer]` | 怎么把结果告诉用户 |
| 类型包装 | `pack!` | 给你的数据取个有意义的名字 |
| 程序入口 | `gen_program!()` | 自动生成管线的接线图 |
在真实项目中你还会用到资源注入、hook、补全、REPL 等高级功能，不过核心骨架永远不变：**Dispatcher → Chain → Renderer**。
<p align="center" style="font-size: 0.85em; color: gray;">
Written by @Weicao-CatilGrass
</p>
|
