🧩 模块#

Bookshelf ​采用模块化设计理念,​将实现统一功能的特性归入独立的、带命名空间的单独模块。



📖 关键概念#

通用概念#

捆绑包

一组打包在一起用于分发的模块。

依赖项

其他模块正常运行所依赖的模块。依赖项必须被加载才能让依赖它的模块正常工作。

特性

一个面向用户的、用于完成特定任务的元素。特性通常表现为函数标签,但也可以包括战利品表、结构、谓词等。

模块

在同一命名空间内服务于特定目的的相关特性的集合。

弱依赖项

可选的依赖项,存在时可以增强功能,但对主模块的正常运行不是必需的。

特殊参数#

on_*

指定在特定事件发生时由特性执行的命令。

run

指定由特性执行的命令,通常是立即执行。

with

指定可选参数。

特殊函数#

*_ata

缩写自“as to at”。这些函数接受两个位置:一个通过位置参数给出(如 positionedat),另一个来自执行者的位置。