docs(tests): correct nominal and native contract scenario boundaries

This commit is contained in:
2026-11-15 20:00:13 +08:00
parent e44bcdce3e
commit 057228a0fd
3 changed files with 24 additions and 14 deletions
+10 -4
View File
@@ -10,10 +10,15 @@ use std::collections::BTreeMap;
/// 测试辅助,生成先写 globals.ran=42 再返回 result 的源码方法,附显式 owner/参数/返回注解。
fn source(
vm: &mut Vm,
// 借用全局字典,源码函数持环境边;副作用 ran 与动态注解名称都从这里观察。
globals: ObjectRef,
// 写入源码签名的方法所属类名,按接收者继承链解析该声明身份。
owner: &str,
// 含显式 self 的参数注解文本,也决定位置参数及局部槽数量。
parameters: &[&str],
// 返回注解文本,实际类型在注册/调用契约检查时解析。
returns: &str,
// 写 ran 后返回的常量;对象身份由托管代码常量边持有,不因 Value 移动自动 retain。
result: Value,
) -> ObjectRef {
// 手工指令保证源码体可观测,参数/局部槽按注解数量保持一致。
@@ -50,6 +55,7 @@ fn source(
function
}
/// 测试辅助,以给定基类构造只声明 check 方法、无自有字段的源码类。
/// base/function 均借用,成功返回新类拥有根并建立内部边;失败不消耗调用方持有的根。
fn class(
vm: &mut Vm,
name: &str,
@@ -300,7 +306,7 @@ fn global_rebinding_is_rechecked_before_the_source_body_and_recovers() {
"Actual",
Value::Object(result),
);
// 先创建当前合法后代,再对父方法提出可能使它失效的更新。
// 先创建当前合法后代;下面只重绑定其 Actual 注解名,不修改父方法或子方法载荷。
let child = class(&mut vm, "Child", base, child_fn).unwrap();
// 显式 self 为 Child 实例,调用时据其继承链解析各方法 own-class 注解。
let receiver = vm.new_object().unwrap();
@@ -487,7 +493,7 @@ fn unknown_forward_names_defer_until_call_without_entering_the_body() {
);
// 定义阶段允许未知名称的派生创建,实例调用时会重新核对。
let child = class(&mut vm, "Child", base, child_fn).unwrap();
// 实例提供实际接收者身份,绑定效果分析可据此查 helper,未绑定函数则未知。
// 显式 self 使用 Child 实例,让调用预检按其继承链解析 Base/Child,再检查仍未知的 Later。
let receiver = vm.new_object().unwrap();
vm.attach_type(receiver, child).unwrap();
assert!(matches!(
@@ -577,7 +583,7 @@ fn verified_source_read_only_effects_constrain_native_overrides() {
// 后代继承已证明只读的方法,候选原生覆盖不能扩大已知效果。
let child = vm.new_type("Child", base, TypeConstructor::Record).unwrap();
assert_eq!(vm.call_effect(source).unwrap(), Some(CallEffect::ReadOnly));
// 实例提供实际接收者身份,绑定效果分析可据此查 helper,未绑定函数则未知。
// 以 Child 实例创建绑定方法,核对绑定形式仍可证明只读;此处未绑定源码本身也已由白名单证明。
let receiver = vm.new_object().unwrap();
vm.attach_type(receiver, child).unwrap();
// 绑定对象拥有函数和实际接收者边,分析可用 receiver 区分实例方法/字段。
@@ -594,7 +600,7 @@ fn verified_source_read_only_effects_constrain_native_overrides() {
CallEffect::ReadOnly,
CallEffect::Delegated,
] {
// 函数持有其代码/全局边,效果查询从当前载荷及环境读取快照。
// 候选为原生包装器,仅签名引用类型形成 trace 边;效果查询读取其声明,不存在源码代码/全局字段。
let function = vm
.allocate(ContextNativeFunction::new(
"check",