docs: align integration test comments with actual coverage

This commit is contained in:
2026-11-12 21:04:10 +08:00
parent fe8ffa1a78
commit 5e26994569
2 changed files with 16 additions and 10 deletions
+9 -6
View File
@@ -105,7 +105,7 @@ struct TestServer {
impl TestServer {
/// 发送带明确 Content-Length 的 UTF-8 文本请求,使用 Connection: close 读至响应结束。
/// 返回状态码、原始头和正文;10 秒超时使服务端死锁表现为测试失败而非无限等待。
/// 返回状态码、原始头和正文;连接后的 socket 读/写各设 10 秒超时,不是整个请求的统一截止时间。
fn request(&self, method: &str, path: &str, body: &str) -> (u16, String, String) {
// 不用直调 handle 代替传输,真实 socket 覆盖 HTTP 接收、正文流和响应编码。
let mut stream = TcpStream::connect(self.address).unwrap();
@@ -128,7 +128,7 @@ impl TestServer {
}
impl Drop for TestServer {
/// 解除服务端 accept 等待并等待线程结束,避免测试之间遗留监听线程。
/// 解除服务端 accept 等待并回收 HTTP 接收线程;此句柄不是 VM worker 的 JoinHandle。
fn drop(&mut self) {
self.server.unblock();
if let Some(api) = self.api.take() {
@@ -367,7 +367,7 @@ fn http_executes_real_endor_preserves_failed_updates_and_supports_delete() {
assert_eq!(status, 200);
assert!(headers.to_lowercase().contains("x-tessera-revision: 1"));
assert_eq!(source, example);
// 未定义名字触发编译诊断,422 必须保留第 1 行来源且不覆盖前面成功源。
// main 引用未定义名字使候选失败;422 必须保留第 1 行来源且不覆盖前面成功源,断言不区分编译/执行阶段。
let (status, _, body) =
client.request("PUT", route, "function main(): View { return missing }");
assert_eq!(status, 422, "{body}");
@@ -535,7 +535,8 @@ fn extracts_namespace_only_from_code_routes() {
}
#[test]
/// 对生成的指南做契约回归:保留代码 CRUD、可运行示例和当前地址,移除旧 export scene/display_list 暴露。
/// 对指南的关键文本做回归:保留 CRUD 标题、示例片段和当前地址,不出现旧 export scene/display_list 用语。
/// 这些 contains 断言不执行示例,也不证明指南中的全部接口、预算和调度描述都与实现一致。
fn guide_contains_only_code_crud_routes() {
// 只生成指南文本,不启动服务或执行内嵌示例;检查静态对外接口的关键用语。
let guide = agent_guide(&NamespaceState::default());
@@ -712,7 +713,8 @@ page.render(button)
tab_drop: None,
}
};
// 成对按下/释放同点走 source_hit 与真实 click 回调,不用直接调用 count.increment 代替命中。
// 发送一个 click 信封,point/press_point 同点供运行时校验按下与释放;没有模拟两次原生鼠标事件。
// 命中与回调仍走真实运行时,不用直接调用 count.increment 代替。
let response = client.request("POST", event_path, &serde_json::to_string(&input).unwrap());
assert_eq!(response.0, 200, "{}", response.2);
// 持久 Console 读取同一个按钮状态,证明 HTTP 事件进入当前 VM 且恰好执行一次。
@@ -1257,7 +1259,8 @@ page.render(Column(20,0,target))
screen_position: None,
}
};
// 模拟 relay 构造真正 Native 回执工作,等待有界确认;409 表示被安全拒绝/消费,也可得到 Ok 回执。
// 模拟 relay 构造真正 Native 回执工作;send 本身是同步阻塞入队,下面 5 秒只限制入队后的回执等待。
// 安全拒绝可能映为 Ok,必须结合后面的模型值断言判断旧输入没有执行。
let send_native = |input: crate::events::Input| {
// 只采样最新接受 epoch/name,不改输入自己捕获的 session/Mount,后者仍须由 worker 校验。
let state = namespace.read().unwrap();