78 lines
3.4 KiB
Rust
78 lines
3.4 KiB
Rust
//! Endor 对象、数值、已验证代码和存储的公共 API；compiler/core 和宿主都从这里导入。
|
|
//! 不包含 VM 指令求值器；数值精确运算使用 num_* 依赖，句柄/计数/载荷修改仍封装在本 crate。
|
|
//! 下方示例由文档测试调用：创建拥有根、读写属性，最后 release，不把复制句柄误当新增根。
|
|
//!
|
|
//! ```
|
|
//! use objects::{ObjectStore, Value};
|
|
//! let mut store = ObjectStore::new()?;
|
|
//! let object = store.new_object()?;
|
|
//! store.set_attr(object, "name", Value::Text("Endor".into()))?;
|
|
//! assert_eq!(store.get_attr(object, "name")?, Value::Text("Endor".into()));
|
|
//! store.release(object)?;
|
|
//! assert_eq!(store.object_count(), 0);
|
|
//! # Ok::<(), objects::VmError>(())
|
|
//! ```
|
|
|
|
// 内部内置载荷：字符串、字典、函数、闭包槽和异常。
|
|
mod builtins;
|
|
// 内部变更通知结构，消费者据此失效缓存。
|
|
mod changes;
|
|
// 代码布局和构造校验，不执行代码。
|
|
mod code;
|
|
// 各层共享错误，避免对象层依赖 VM。
|
|
mod error;
|
|
// 私有堆：代际身份、根/边计数、只读追踪和回收。
|
|
mod heap;
|
|
// 指令协议及字节编解码，供编译器和执行器共用。
|
|
mod instruction;
|
|
// 宿主回调契约、上下文和结果根移交。
|
|
mod native;
|
|
// 无损数值表示和受预算约束的精确运算。
|
|
mod number;
|
|
// 直接值、载荷协议及公共对象实体。
|
|
mod object;
|
|
// 受控对象操作门面，宿主可独立于 VM 使用。
|
|
mod store;
|
|
// 字典/Cell/函数等内置载荷的 Store 扩展。
|
|
mod store_builtins;
|
|
// 名义类型、能力、字段注解及子模块中的契约/效果分析。
|
|
mod types;
|
|
|
|
// 向宿主公开内置载荷，分配和修改仍经 Store。
|
|
pub use builtins::{
|
|
EndorBaseExceptionObject, EndorCellObject, EndorDictObject, EndorFunctionObject,
|
|
EndorStringObject, EndorTracebackEntry,
|
|
};
|
|
// 向缓存消费者公开借用变更通知，不提供对象拥有根。
|
|
pub use changes::{ChangeBatch, ChangeKey, ObjectChange};
|
|
// 编译器构造与 VM 共享执行数据需要的代码 API。
|
|
pub use code::{CodeLayout, EndorCode, EndorCodeObject, SourceSignature};
|
|
// 调用者结构化匹配的统一错误。
|
|
pub use error::VmError;
|
|
// 只公开句柄和读取观察结果，不导出可变 Heap。
|
|
pub use heap::{ObjectRef, ReadAccess, ReadDependency, ReadSet, TrackedReads, WeakObjectRef};
|
|
// 编译器/宿主组装指令，执行器读取解码结果。
|
|
pub use instruction::{DecodedInstruction, Instruction, Opcode};
|
|
// 宿主实现原生函数并声明参数、返回值和效果。
|
|
pub use native::{
|
|
CallArity, CallEffect, CallSignature, CallType, ContextNativeFunction, NativeCallable,
|
|
NativeContext, NativeResult,
|
|
};
|
|
// 编译器字面量、VM 算术和宿主显式转换共用数值 API。
|
|
pub use number::{
|
|
ArithmeticOp, EndorDecimal, EndorInteger, EndorNumber, EndorNumberObject, EndorRational,
|
|
EndorReal,
|
|
};
|
|
// 宿主实现载荷及等待协议，保留旧原生函数别名兼容。
|
|
pub use object::{
|
|
AwaitPoll, CompareOp, EndorNativeCall, EndorNativeFunctionObject, EndorObject, NativeCall,
|
|
NativeFunction, ObjectHeader, ObjectPayload, Record, Value,
|
|
};
|
|
// 独立存储的主要入口，VM 也持有同一门面。
|
|
pub use store::ObjectStore;
|
|
// 宿主注册类型/能力，执行器检查构造和调用契约。
|
|
pub use types::{
|
|
AnnotationType, ClassField, EndorTraitObject, EndorTypeObject, MethodRequirement, RootTypes,
|
|
TypeConstructor, TypedMethodRequirement,
|
|
};
|