docs(tests): clarify compiler scenarios and capability helper ownership

This commit is contained in:
2026-11-15 19:54:49 +08:00
parent 4f6d2eec7f
commit 66f9e0764c
4 changed files with 23 additions and 13 deletions
+4
View File
@@ -325,6 +325,7 @@ fn declared_field_checks_cover_construction_inheritance_writes_and_gc() {
.unwrap();
vm.release(roots.object).unwrap();
vm.release(roots.type_type).unwrap();
// 一次模块声明建立继承字段、名义对象字段及未知注解三种约束,真正的构造/写入在后面分别触发。
execute(
&mut vm,
globals,
@@ -336,6 +337,7 @@ class Unknown { value: Missing }
"#,
ParseMode::Module,
);
// 每份交互源码只提交一条语句:先登记 Child 实例,再让 Holder 的字段持有同一实例。
// Interactive intentionally accepts one complete statement per source unit.
execute(
&mut vm,
@@ -381,6 +383,7 @@ class Unknown { value: Missing }
assert!(vm.del_attr(value, "count").is_err());
vm.set_attr(value, "count", Value::Number(10.into()))
.unwrap();
// 用同名新类替换全局 Base,旧 value 的名义类型图仍保留最初的 Base 身份。
execute(&mut vm, globals, "class Base {}", ParseMode::Interactive);
// 其他名义类型名称在声明环境中动态解析;Base 重定义后 Holder 的字段约束应按新身份检查。
// Other nominal names resolve dynamically in the declaring environment.
@@ -446,6 +449,7 @@ class Seed: Link {}
vm.set_attr(seed, "next", Value::Object(seed)).unwrap();
vm.dict_set(globals, Value::Text("old".into()), Value::Object(seed))
.unwrap();
// 新 Link 采用不同字段布局,只替换环境绑定;seed 及其 next 的原声明身份应不受影响。
execute(
&mut vm,
globals,
+3 -3
View File
@@ -33,7 +33,7 @@ fn module(vm: &mut Vm, compiled: &CompiledCode) -> (ObjectRef, ObjectRef) {
/// 测试按名称从环境借用函数句柄;不 retain,调用者须保持 globals 或其他拥有图存活。
fn function(vm: &Vm, globals: ObjectRef, name: &str) -> ObjectRef {
// 环境键命中必须是函数对象;这里只借用,不新取得外部根。
// 环境键必须命中对象句柄;此辅助函数不再下转型证明函数类别,实际可调用性由后续 VM 调用验证。
let Some(Value::Object(function)) = vm.dict_get(globals, &Value::Text(name.into())).unwrap()
else {
panic!("missing function {name}")
@@ -357,7 +357,7 @@ fn argument_and_recursion_failures_unwind_vm_frames_and_keep_traceback() {
}
#[test]
/// 由 Rust 测试框架调用:编译选项只声明合法名字,不注入 VM 值;空环境执行仍报告 NameNotFound。
/// 由 Rust 测试框架调用:编译选项只登记可见名字,不注入 VM 值;空环境执行仍报告 NameNotFound。
fn declared_host_names_are_checked_again_at_runtime() {
// 当前用例的源码或带来源快照,下面按指定模式解析/编译。
let source = EndorReader::from_text("<host>", "missing");
@@ -669,7 +669,7 @@ fn source_control_flow_and_exact_arithmetic_execute_real_bytecode() {
fn control_flow_definite_initialization_large_jumps_and_loop_budgets() {
// 拼接较长 if/while 体,迫使条件出口和回边跨越扩展编码距离。
let mut body = String::from("function main(): Number { i=0 while i<2 { if i==0 {");
// 重复运行同一函数三次,每次归还结果,以对象数验证代码复用。
// 追加三百条不改变 i 的赋值,仅增大跳转跨越的代码宽度;真正的循环推进在后面单独追加。
for _ in 0..300 {
body.push_str("i=i+0 ");
}
+6 -5
View File
@@ -1,5 +1,6 @@
//! 测试框架调用的内置值/载荷集成回归,通过公开 Vm API 验证 objects 与执行器协议一致。
//! 各场景区分 Rust 表示相等、语言数值/内容比较、外部拥有根和容器内部强边。
//! 部分场景只核对局部协议并以 VM 析构收尾;显式释放/环回收场景另检查句柄失效、计数或空堆。
use endor_core::{
CodeLayout, CompareOp, EndorBaseExceptionObject, EndorCode, EndorDictObject,
@@ -52,7 +53,7 @@ fn numbers_preserve_large_digits_decimal_scale_exponents_and_fraction_parts() {
}
#[test]
/// 验证 IEEE 位保真、零真值、复数显示及未实现数值 hash/比较的明确拒绝。
/// 验证 IEEE 位保真、零真值、复数显示,以及数值 hash/复数比较的明确拒绝;实数数学比较另有实现。
fn number_objects_preserve_ieee_bits_and_reject_undefined_numeric_operations() {
// 每个测试建立独立 VM;句柄所有权由 API 决定,不依赖复制值自动 retain。
let mut vm = Vm::new().unwrap();
@@ -258,7 +259,7 @@ fn container_cycles_and_duplicate_edges_are_collected() {
fn functions_retain_globals_constants_defaults_and_shared_closure_cells() {
// 每个测试建立独立 VM;句柄所有权由 API 决定,不依赖复制值自动 retain。
let mut vm = Vm::new().unwrap();
// 准备函数环境;本场景可故意使用非字典以测试种类校验。
// 合法字典环境由两函数共同持有,稍后再反向保存第一个函数形成待回收的环境环。
let globals = vm.new_dict().unwrap();
// 常量初始有测试根,代码常量表和默认值还会独立拥有强边。
let constant = vm.new_string("constant").unwrap();
@@ -300,7 +301,7 @@ fn functions_retain_globals_constants_defaults_and_shared_closure_cells() {
vm.release(code).unwrap();
// 常量原测试根归还,其余代码/默认值边仍保持存活。
vm.release(constant).unwrap();
// 归还 Cell 原根,闭包或字典边仍可持有它,最后无根环交给 GC。
// 两函数都已保存同一捕获 Cell,归还测试根后更新仍通过这两条内部边保持合法。
vm.release(cell).unwrap();
vm.cell_set(cell, text("updated")).unwrap();
// 逐个读取两个函数捕获的同一 Cell,必须观察相同更新。
@@ -325,7 +326,7 @@ fn functions_retain_globals_constants_defaults_and_shared_closure_cells() {
fn malformed_function_environments_are_rejected_without_retaining_any_edges() {
// 每个测试建立独立 VM;句柄所有权由 API 决定,不依赖复制值自动 retain。
let mut vm = Vm::new().unwrap();
// 准备函数环境;本场景可故意使用非字典以测试种类校验。
// 故意以普通 Record 冒充全局字典,第一次函数构造应在保留边之前拒绝。
let globals = vm.new_object().unwrap();
// 最小装载常量并返回的逻辑指令,用于只改变环境或闭包布局的错误测试。
let instructions = [
@@ -356,7 +357,7 @@ fn malformed_function_environments_are_rejected_without_retaining_any_edges() {
.unwrap();
// 托管代码对象有一份根,函数载荷还会额外持有代码边。
let code = vm.new_code(code).unwrap();
// 准备函数环境;本场景可故意使用非字典以测试种类校验。
// 第二次改用合法字典环境,只保留“代码需要一个自由 Cell、实传零个”的错误。
let globals = vm.new_dict().unwrap();
assert!(
vm.new_function("bad", code, globals, vec![], vec![])
+10 -5
View File
@@ -27,11 +27,15 @@ fn capability(
/// 测试辅助:构造先写 globals.ran=42 再返回给定常量的源码方法,附 owner 与类型注解。
fn source(
vm: &mut Vm,
/// 含 Current 注解名称的字典,包装载荷通过 captures 持边。
// 借用源码函数的全局环境,new_function 为它建立内部边;体执行时向其中写 ran。
globals: ObjectRef,
// 附入 SourceSignature 的声明类名,运行时结合实际接收者解析 owner 类型。
owner: &str,
// 含显式 self 的参数注解列表,长度同时决定参数和局部槽数量。
types: &[&str],
// 返回注解文本,调用/契约检查时解析,不在本辅助函数绑定为类型句柄。
returns: &str,
// 体写 ran 后返回的常量;对象变体在代码分配后由常量表内部边持有。
value: Value,
) -> ObjectRef {
// 手工代码提供可观察 ran 副作用,参数/局部布局按类型列表一一对应。
@@ -59,7 +63,7 @@ fn source(
.unwrap();
// 分配代码后常量成为内部强边,函数将持有代码引用。
let code = vm.new_code(code).unwrap();
// 分配源码/原生函数拥有根,完整签名与显式 captures 各自报告托管引用。
// 分配源码函数根,载荷分别持有代码和 globals;这里没有默认值或自由 Cell,也不使用原生 captures。
let function = vm
.new_function("check", code, globals, vec![], vec![])
.unwrap();
@@ -75,7 +79,7 @@ impl NativeCallable for Native {
fn signature(&self) -> Option<CallSignature> {
Some(self.0.clone())
}
/// 原生测试入口;Native 返回直接整数,RebindThenReturn 先重绑定环境再返回借用对象。
/// VM 原生分派调用,忽略已由签名检查的实参,只返回直接整数,不访问环境或分配对象。
fn invoke(&self, _: &mut NativeContext<'_>, _: &[Value]) -> Result<NativeResult, VmError> {
Ok(NativeResult::Return(Value::Number(7.into())))
}
@@ -293,6 +297,7 @@ fn typed_trait_definitions_trace_their_signature_types_without_hidden_roots() {
}
#[derive(Debug)]
/// 最后一项回归的宿主实现:包装器显式 captures 保活这些句柄,体内重绑定会使外层返回能力失效。
struct RebindThenReturn {
/// 自身直接返回约束仍满足 Model,但外层能力返回约束需更严格重验 Feature。
signature: CallSignature,
@@ -308,7 +313,7 @@ impl NativeCallable for RebindThenReturn {
fn signature(&self) -> Option<CallSignature> {
Some(self.signature.clone())
}
/// 原生测试入口;Native 返回直接整数,RebindThenReturn 先重绑定环境再返回借用对象。
/// VM 原生分派调用,先通过上下文重绑定 Current,再借用返回 Model 实例以触发外层能力重验。
fn invoke(&self, cx: &mut NativeContext<'_>, _: &[Value]) -> Result<NativeResult, VmError> {
// 函数体把 Current 重绑定为无关 Other,主动使返回 Model 的 Feature 契约失效。
cx.dict_set(
@@ -342,7 +347,7 @@ fn actual_trait_returns_revalidate_capabilities_after_body_side_effects_and_rest
let model = vm
.new_type("Model", roots.object, TypeConstructor::Record)
.unwrap();
// 源码方法注解在此环境解析,同时 ran 标志观测函数体是否进入。
// 源码方法的 Current 注解在此字典动态解析;本场景只检查该方法契约,不执行其写 ran 的体。
let globals = vm.new_dict().unwrap();
vm.dict_set(
globals,