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
//! 场景注册:`register_scenario!` 宏。
//!
//! 与旧 `scenario!` 宏不同,这里**业务代码外置**:使用者手写普通
//! `struct` + `impl Scenario`(真实代码,rust-analyzer 可完整分析,
//! 支持补全/跳转/诊断),`register_scenario!` 只负责生成 inventory 注册条目。
//!
//! 用法:
//! ```ignore
//! use memseek_test::{register_scenario, scenario::Scenario, RunMode, TaskIndex};
//!
//! struct HelloScenario;
//!
//! impl Scenario for HelloScenario {
//! type Ctx = AuthContext;
//! type Error = ctxlibs::http_client::HttpError;
//! type Output = ();
//! // 不需要预置数据时填 (),且无需实现 setup()
//! type Setup = ();
//!
//! // setup() 为可选预置阶段:默认每个并发任务执行一次(Task 粒度),
//! // 可产出(登录会话/预热客户端等)供各轮 run/validate 借用;
//! // 声明 const SETUP_MODE: SetupMode = SetupMode::Round 可改为每轮执行
//! async fn run(
//! ctx: &AuthContext,
//! _task: &TaskIndex,
//! _setup: &(),
//! ) -> Result<(), Self::Error> {
//! let resp = ctx.client.get("/hello").await?;
//! Ok(())
//! }
//!
//! // task 是框架分配的并发任务身份(task.index 可用于账号参数化,
//! // task.round 为全局运行编号, 每轮取号);
//! // validate() / name() / setup() 均有默认实现,按需覆盖即可;
//! // 覆盖 validate 时可接收 run 的产出(output)做业务断言;
//! // run 返回 Err 时该轮直接记为失败,不会进入 validate
//! }
//!
//! // 在模块底部注册。可选配置:
//! // name = "..." 覆盖匹配名(默认类型简单名)
//! // mode = RunMode::Times(n) | RunMode::Duration(d) 设置默认执行模式
//! register_scenario!(HelloScenario, mode = RunMode::Times(10000));
//! ```
//!
//! 并发由 Manager 统一管理(`ManagerConfig::new(concurrency)`)。
/// 注册一个已实现 `Scenario` 的场景类型,生成 inventory 注册条目。
///
/// 可选参数:
/// - `name = "..."`:覆盖匹配名(默认类型简单名);
/// - `mode = RunMode::Times(n)` / `RunMode::Duration(d)`:默认执行模式
/// (缺省为 `None`,由 Manager 的 `with_run_mode` 覆盖/决定)。
/// 可选参数 → `Option` 值(缺省为 `None`,给出则 `Some(expr)`)。