Files
endorphin-tessera-gui/vendor/nexus/tests/tasks.rs
T

244 lines
8.4 KiB
Rust
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
//! 无 UI 的任务宿主回归:同键替换、资格变化和退出门闩必须由真实 VM/API 路径体现。
//! 测试不启动 GUI、文件读取或网络请求,宿主资格由普通对象属性提供。
use endor_core::{
CallArity, ContextNativeFunction, NativeCallable, NativeContext, NativeResult, ObjectRef,
ObjectStore, TypeConstructor, Value, Vm, VmError,
};
use endorphin_nexus_runtime::{
VmSession,
tasks::{self, Scheduler, TaskHost},
};
use std::sync::{
Arc,
atomic::{AtomicUsize, Ordering},
};
#[derive(Debug)]
/// 普通对象宿主只用属性保存作用域和资格,不知道 Block、Mount、Window 或 desktop。
struct PlainHost;
impl TaskHost for PlainHost {
/// 未提交过任务时返回 None;已有作用域必须是字典。
fn scope(&self, store: &ObjectStore, owner: ObjectRef) -> Result<Option<ObjectRef>, VmError> {
match store.get_attr(owner, "taskScope") {
Ok(Value::Object(scope)) => {
store.dict_items(scope)?;
Ok(Some(scope))
}
Err(VmError::AttributeNotFound(_)) => Ok(None),
Ok(_) => Err(VmError::InvalidArgument("invalid test scope")),
Err(error) => Err(error),
}
}
/// 由写屏障建立真实拥有边,测试结束时可交给 VM 正常回收。
fn install_scope(
&self,
cx: &mut NativeContext<'_>,
owner: ObjectRef,
scope: ObjectRef,
) -> Result<(), VmError> {
cx.set_attr(owner, "taskScope", Value::Object(scope))
}
/// 外部修改普通布尔字段即可撤销交付资格,不借用 Tessera 的任何模型。
fn eligible(
&self,
store: &ObjectStore,
owner: ObjectRef,
_context: ObjectRef,
) -> Result<bool, VmError> {
Ok(store.get_attr(owner, "eligible")? == Value::Bool(true))
}
/// 所有任务共享宿主注册的精确类型身份。
fn task_type(&self, store: &ObjectStore, context: ObjectRef) -> Result<ObjectRef, VmError> {
object(store.get_attr(context, "Task")?)
}
}
#[derive(Debug)]
/// VM 外的计数器观察真正回调次数,零参/Unit 契约与 after 要求一致。
struct Count(Arc<AtomicUsize>);
impl NativeCallable for Count {
/// 明确接受零个参数,不能依赖旧原生函数缺少元数据的兼容路径。
fn arity(&self) -> Option<CallArity> {
Some(CallArity::exact(0))
}
/// 每次真正执行递增一次,取消和状态查询不得触发它。
fn invoke(
&self,
_cx: &mut NativeContext<'_>,
_args: &[Value],
) -> Result<NativeResult, VmError> {
self.0.fetch_add(1, Ordering::SeqCst);
Ok(NativeResult::Return(Value::Nil))
}
}
/// 解码借用或拥有的对象值;此函数不改变根计数,调用方按来源管理拥有权。
fn object(value: Value) -> Result<ObjectRef, VmError> {
match value {
Value::Object(value) => Ok(value),
_ => Err(VmError::InvalidArgument("expected test object")),
}
}
/// 所有创建根交给 VmSession;api/context/owner 是会话根的借用身份。
fn setup() -> (
VmSession,
Scheduler,
ObjectRef,
ObjectRef,
ObjectRef,
Arc<AtomicUsize>,
) {
let mut runtime = VmSession::new().unwrap();
let types = runtime.vm_mut().bootstrap_types().unwrap();
runtime.keep_root(types.object);
runtime.keep_root(types.type_type);
let definition = runtime
.vm_mut()
.new_type("Task", types.object, TypeConstructor::Abstract)
.unwrap();
runtime.keep_root(definition);
let context = runtime.vm_mut().new_object().unwrap();
runtime.keep_root(context);
runtime
.vm_mut()
.set_attr(context, "Task", Value::Object(definition))
.unwrap();
let api = runtime.vm_mut().new_object().unwrap();
runtime.keep_root(api);
let owner = runtime.vm_mut().new_object().unwrap();
runtime.keep_root(owner);
runtime
.vm_mut()
.set_attr(owner, "eligible", Value::Bool(true))
.unwrap();
let calls = Arc::new(AtomicUsize::new(0));
let callback = runtime
.vm_mut()
.allocate(ContextNativeFunction::new(
"count",
Count(calls.clone()),
vec![],
))
.unwrap();
runtime.keep_root(callback);
let scheduler = runtime
.with_host(|vm, roots| tasks::install(vm, roots, api, context, Arc::new(PlainHost)))
.unwrap();
(runtime, scheduler, api, owner, callback, calls)
}
/// 通过安装的公开 API 创建零延时任务;返回根交给会话,避免旧 token 因替换而提前回收。
fn after(
runtime: &mut VmSession,
api: ObjectRef,
owner: ObjectRef,
callback: ObjectRef,
key: &str,
) -> ObjectRef {
let function = object(runtime.vm().get_attr(api, "after").unwrap()).unwrap();
let task = object(
runtime
.vm_mut()
.call(
function,
&[
Value::Object(owner),
Value::Text(key.into()),
Value::Number(0_i64.into()),
Value::Object(callback),
],
)
.unwrap(),
)
.unwrap();
runtime.keep_root(task);
task
}
/// 经真实类型方法绑定读取状态,不直接检查 Nexus 的私有 Task 载荷。
fn query(vm: &mut Vm, task: ObjectRef, name: &str) -> Value {
let bound = object(vm.bind_attr(task, name).unwrap()).unwrap();
let result = vm.call(bound, &[]);
vm.release(bound).unwrap();
result.unwrap()
}
#[test]
/// 替换旧 token 后只有新任务执行一次;终态 token 可继续查询,拥有字典已经清空。
fn same_key_replacement_only_delivers_the_new_identity() {
let (mut runtime, scheduler, api, owner, callback, calls) = setup();
let old = after(&mut runtime, api, owner, callback, "same");
let new = after(&mut runtime, api, owner, callback, "same");
assert_eq!(
query(runtime.vm_mut(), old, "status"),
Value::Text("cancelled".into())
);
// 取消被替换的旧 token 不得删除新任务的 owner/key 身份。
assert_eq!(query(runtime.vm_mut(), old, "cancel"), Value::Bool(false));
assert_eq!(query(runtime.vm_mut(), new, "active"), Value::Bool(true));
assert_eq!(scheduler.poll(runtime.vm_mut(), 64).unwrap(), 1);
assert_eq!(calls.load(Ordering::SeqCst), 1);
assert_eq!(
query(runtime.vm_mut(), new, "status"),
Value::Text("completed".into())
);
assert_eq!(query(runtime.vm_mut(), new, "result"), Value::Nil);
assert_eq!(scheduler.poll(runtime.vm_mut(), 64).unwrap(), 0);
let scope = PlainHost
.scope(runtime.vm().object_store(), owner)
.unwrap()
.unwrap();
assert!(
runtime
.vm()
.object_store()
.dict_items(scope)
.unwrap()
.is_empty()
);
scheduler.quiesce(runtime.vm_mut()).unwrap();
runtime.close().unwrap();
assert_eq!(runtime.vm().object_count(), 0);
}
#[test]
/// 交付前撤销资格阻止回调,轮询执行取消;退出门闩在重新取得资格后仍拒绝提交。
fn host_lifecycle_and_shutdown_prevent_late_delivery() {
let (mut runtime, scheduler, api, owner, callback, calls) = setup();
let task = after(&mut runtime, api, owner, callback, "late");
runtime
.vm_mut()
.set_attr(owner, "eligible", Value::Bool(false))
.unwrap();
assert_eq!(query(runtime.vm_mut(), task, "active"), Value::Bool(false));
assert_eq!(scheduler.poll(runtime.vm_mut(), 64).unwrap(), 1);
assert_eq!(
query(runtime.vm_mut(), task, "status"),
Value::Text("cancelled".into())
);
assert_eq!(calls.load(Ordering::SeqCst), 0);
scheduler.quiesce(runtime.vm_mut()).unwrap();
runtime
.vm_mut()
.set_attr(owner, "eligible", Value::Bool(true))
.unwrap();
let function = object(runtime.vm().get_attr(api, "after").unwrap()).unwrap();
assert!(
runtime
.vm_mut()
.call(
function,
&[
Value::Object(owner),
Value::Text("forbidden".into()),
Value::Number(0_i64.into()),
Value::Object(callback),
]
)
.is_err()
);
runtime.close().unwrap();
assert_eq!(runtime.vm().object_count(), 0);
}