From 5e269945697008ef15b164143e6e8895c30736f4 Mon Sep 17 00:00:00 2001 From: Codex Bot Date: Thu, 12 Nov 2026 21:04:10 +0800 Subject: [PATCH] docs: align integration test comments with actual coverage --- src/runtime/api/tests.rs | 15 +++++++++------ src/runtime/endor_host/manuscript_tests.rs | 11 +++++++---- 2 files changed, 16 insertions(+), 10 deletions(-) diff --git a/src/runtime/api/tests.rs b/src/runtime/api/tests.rs index e5ec622..11ac0e5 100644 --- a/src/runtime/api/tests.rs +++ b/src/runtime/api/tests.rs @@ -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(); diff --git a/src/runtime/endor_host/manuscript_tests.rs b/src/runtime/endor_host/manuscript_tests.rs index 478eefb..70a5c39 100644 --- a/src/runtime/endor_host/manuscript_tests.rs +++ b/src/runtime/endor_host/manuscript_tests.rs @@ -1,6 +1,7 @@ //! Rust 测试框架通过 endor_host 的真实 VM/发布帧接口验收 illustrated-manuscript Endor 示例。 //! 第一项检查指针驱动/火焰生命周期与基本像素,第二项检查 owner-scoped 动画任务、不同视口和绘制几何。 -//! write_png 仅在配置 TESSERA_MANUSCRIPT_SNAPSHOTS 时写图片;测试源码字符串与像素期望都是验收数据。 +//! write_png 无论是否配置快照目录都会软件光栅化并检查背景像素;配置目录后才另写 PNG。 +//! 图片是可选人工检查产物,没有读取参考图或做整图像素差分;测试源码字符串与像素期望都是验收数据。 use super::*; use crate::document::RenderCommand; @@ -115,7 +116,7 @@ fn illustrated_manuscript_is_driven_by_real_endor_source_and_pointer_events() { ); // 真正发布列表交软件渲染器,不从源模型的“将要绘制”对象构造另一份测试专用画面。 let list = document.display_list(1.).unwrap(); - // 预分配固定尺寸 RGB 像素,下面验证页面奶油背景确实进入最终合成结果。 + // 预分配固定尺寸 RGB 像素,下面只要求至少一个奶油背景像素,不据此证明完整图像或全部图层正确。 let mut pixels = vec![0; 1024 * 800]; crate::software_renderer::SoftwareRenderer::render(&list, &mut pixels, 1024, 800).unwrap(); assert!(pixels.contains(&0xf4eee0)); @@ -138,6 +139,7 @@ fn write_png(document: &RenderDocument, w: u32, h: u32, scale: f32, name: &str) // 软件渲染覆盖真实像素数组,断言并非只检查命令里有一条背景矩形。 let mut pixels = vec![0; w as usize * h as usize]; crate::software_renderer::SoftwareRenderer::render(&list, &mut pixels, w, h).unwrap(); + // 仅检查奶油背景像素超过 1000 个,不比较快照基线;喷火尺寸/方向另用实际源值断言。 assert!(pixels.iter().filter(|&&p| p == 0xf4eee0).count() > 1000); if let Ok(dir) = std::env::var("TESSERA_MANUSCRIPT_SNAPSHOTS") { // 未设置目录时不产生文件;有目录才创建编码器,快照输出是显式选择的测试附加产物。 @@ -183,7 +185,7 @@ fn manuscript_script_snapshots_and_owned_animation_lifecycle() { .unwrap(); // 真实 owner-scoped Task 调用源 tick,先比较时间字段确认计时器而非宿主演示循环在推进。 let before = execute(&mut session, &mut document, "dragon.time"); - // 等待超过示例定时截止时间,再在所属 VM poll,后台线程不会直接替程序改 time。 + // 等待 85ms 超过示例设定的 80ms 延时,再在所属 VM poll;实际调度可能更晚,sleep 不代表任务已经交付。 std::thread::sleep(std::time::Duration::from_millis(85)); if let Some(next) = session.poll_tasks().unwrap() { // 只接收调度后真正完整发布文档,不从任务内部未收敛草稿截屏。 @@ -287,7 +289,8 @@ fn manuscript_script_snapshots_and_owned_animation_lifecycle() { scale, if width > 500. { "fire" } else { "narrow-fire" }, ); - // Page 关闭须立即取消其 Mount 所有的任务;后续即使保留 dragon 对象也不能继续定时更新。 + // 示例 ui.after 的 owner 是 page;关闭 Page 会取消该任务,onUnmount 还会显式取消最近 timer。 + // 本例验证关闭后的最终 time,不单独区分 owner 清理与卸载钩子各自贡献的取消效果。 execute(&mut session, &mut document, "page.close()"); // 关闭时真实 time 是对照值,等待超过旧定时点再 poll 应完全不变。 let closed = execute(&mut session, &mut document, "dragon.time");