mm_machine 5.0.1 → 6.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +9 -2
- package/lib/manager.js +36 -17
- package/package.json +5 -3
package/README.md
CHANGED
|
@@ -498,9 +498,9 @@ mm_machine 模块系统基于以下核心设计理念:
|
|
|
498
498
|
|
|
499
499
|
`update(dir)` 完成后会对检索目录开启一次递归监听(经 mm_loader 的 `Loader.watch`,配置文件与 `.js` 脚本的变更按扩展名分流):
|
|
500
500
|
|
|
501
|
-
- 所有管理器默认共享 mm_loader 的同一个加载器实例(`loadAdmin(config.
|
|
501
|
+
- 所有管理器默认共享 mm_loader 的同一个加载器实例(`loadAdmin(config.load_scope || 'app')`),避免重复扫描、重复监听与重复加载
|
|
502
502
|
- 管理器把自己的清单文件名登记为加载器类型:类型键为文件名去掉 `.json` 后缀(`manager.json` → `manager`),已存在的类型不覆盖
|
|
503
|
-
- 需要独立加载器时,用 `
|
|
503
|
+
- 需要独立加载器时,用 `load_scope` 指定另一加载器名(一个名称对应一个目录,实例即 `Loader.<load_scope>`)
|
|
504
504
|
|
|
505
505
|
| 变更 | 模式要求 | 行为 |
|
|
506
506
|
| --- | --- | --- |
|
|
@@ -576,6 +576,13 @@ mm_machine 模块系统基于以下核心设计理念:
|
|
|
576
576
|
|
|
577
577
|
## 更新日志
|
|
578
578
|
|
|
579
|
+
### 6.0.0
|
|
580
|
+
|
|
581
|
+
- 加载器实例键改为 `load_scope`(即 `Loader.name`),不再拼接 `@目录`:同一应用目录共用一个加载器,其他目录请配置不同的 `load_scope`(如 `data`)。
|
|
582
|
+
- `_findFiles` 改为「扫描一次 + 按类型取切片」:先 `loader.ensureScanned()`,再从 `typeStore(type)` 读取加载器扫描根下的条目,按文件名与目标子目录过滤,多个管理器不再各自扫描。
|
|
583
|
+
- 依赖升级:`mm_loader ^7.0.0`、新增 `mm_scanner ^5.0.0` 与 `mm_store ^1.0.1`。
|
|
584
|
+
- 移除未使用的 `use_scope` 配置,加载器实例共享统一由 `load_scope` 控制。
|
|
585
|
+
|
|
579
586
|
### 5.0.1
|
|
580
587
|
|
|
581
588
|
- 配置加载依赖升级到 `mm_loader@^4.0.1`:该版本修复了 `load()` 在 JSON5 解析之外额外对整串 `{表达式}` 做模板字段求值的 BUG,现在 `load()` 只委托 `mm_helper.loadJson` 把配置读成对象,花括号内容一律原样保留。
|
package/lib/manager.js
CHANGED
|
@@ -2,6 +2,7 @@ const path = require('path');
|
|
|
2
2
|
const { Manager: Core } = require('mm_mod');
|
|
3
3
|
const { hasDir, hasFile, fullname, basename, dirname, string } = require('mm_helper');
|
|
4
4
|
const { loadAdmin } = require('mm_loader');
|
|
5
|
+
const { typeStore } = require('mm_scanner');
|
|
5
6
|
const { Mod, addMethods } = require('./mod.js');
|
|
6
7
|
const { Drive, MODE } = require('./drive.js');
|
|
7
8
|
const { resolveScriptFile, reloadScript } = require('./script_protocol.js');
|
|
@@ -16,6 +17,19 @@ function _normPath(file) {
|
|
|
16
17
|
return path.resolve(String(file)).toLowerCase();
|
|
17
18
|
}
|
|
18
19
|
|
|
20
|
+
/**
|
|
21
|
+
* 判断文件是否位于指定目录内(含子目录)
|
|
22
|
+
* @description 加载器按应用根目录扫描,管理器只处理自己目录范围内的清单
|
|
23
|
+
* @param {string} file 文件路径
|
|
24
|
+
* @param {string} dir 目录绝对路径
|
|
25
|
+
* @returns {boolean} 位于目录内返回 true
|
|
26
|
+
* @private
|
|
27
|
+
*/
|
|
28
|
+
function _inDir(file, dir) {
|
|
29
|
+
const rel = path.relative(dir, file);
|
|
30
|
+
return rel !== '' && !rel.startsWith('..') && !path.isAbsolute(rel);
|
|
31
|
+
}
|
|
32
|
+
|
|
19
33
|
/**
|
|
20
34
|
* 失效单个脚本文件的 require 缓存
|
|
21
35
|
* @description 文件不存在或从未加载时静默跳过
|
|
@@ -107,10 +121,10 @@ class Manager extends Core {
|
|
|
107
121
|
*/
|
|
108
122
|
scope: 'server',
|
|
109
123
|
/**
|
|
110
|
-
*
|
|
124
|
+
* 共享加载器作用域,取用 loadAdmin 实例时使用,缺省 'app'
|
|
111
125
|
* @type {string}
|
|
112
126
|
*/
|
|
113
|
-
|
|
127
|
+
load_scope: 'app',
|
|
114
128
|
/**
|
|
115
129
|
* 忽略目录数组
|
|
116
130
|
* @type {Array}
|
|
@@ -223,27 +237,27 @@ Manager.prototype.getTplDir = function () {
|
|
|
223
237
|
|
|
224
238
|
/**
|
|
225
239
|
* 获取配置加载器
|
|
226
|
-
* @description 直接取 mm_loader 实例池中的共享 Loader(键为
|
|
227
|
-
*
|
|
228
|
-
*
|
|
229
|
-
*
|
|
240
|
+
* @description 直接取 mm_loader 实例池中的共享 Loader(键为 load_scope,缺省 'app'),
|
|
241
|
+
* 同一加载器名天然是同一个实例,本管理器不再另存一份引用;
|
|
242
|
+
* 一个加载器只负责一个目录,多目录请为每个目录配置不同的 load_scope;
|
|
243
|
+
* load_scope 即加载器实例键(Loader.name),与内核创建的实例同名即共享。
|
|
230
244
|
* 并把本管理器清单类型登记进该实例:类型键为 filename 去掉 .json 后缀
|
|
231
245
|
* (manager.json → manager,与默认 app → app.json 同构),已存在的类型不覆盖;
|
|
232
246
|
* 脚本监听由 _watchDir 是否传 script_callback 决定(回调驱动),不再配置实例
|
|
233
|
-
* @param {string} [dir]
|
|
247
|
+
* @param {string} [dir] 检索目录,用于首次创建实例时确定扫描根目录,缺省回退 config.dir
|
|
234
248
|
* @returns {Loader} 配置加载器
|
|
235
249
|
* @private
|
|
236
250
|
*/
|
|
237
251
|
Manager.prototype._getLoader = function (dir) {
|
|
238
|
-
const scope = this.config.
|
|
252
|
+
const scope = this.config.load_scope || 'app';
|
|
239
253
|
const target = dir || this.config.dir || '';
|
|
240
254
|
const key = target ? path.resolve(target) : '';
|
|
241
|
-
const loader = loadAdmin(scope, { dir: key
|
|
255
|
+
const loader = loadAdmin(scope, key ? { dir: key } : {});
|
|
242
256
|
const filename = this.config.filename;
|
|
243
257
|
if (filename) {
|
|
244
258
|
const type = filename.replace(/\.json$/i, '');
|
|
245
259
|
if (type && !loader.config.resources[type]) {
|
|
246
|
-
loader.addType(type, filename
|
|
260
|
+
loader.addType(type, filename);
|
|
247
261
|
}
|
|
248
262
|
}
|
|
249
263
|
return loader;
|
|
@@ -565,6 +579,8 @@ Manager.prototype.update = async function (dir, clear = true) {
|
|
|
565
579
|
|
|
566
580
|
/**
|
|
567
581
|
* 检索目录下所有文件
|
|
582
|
+
* @description 扫描只做一次:加载器已扫描时直接复用类型 Store 中的分类结果,
|
|
583
|
+
* 再按管理器的清单文件名精确过滤,不再重复遍历目录
|
|
568
584
|
* @private
|
|
569
585
|
* @param {string} dir 目录路径
|
|
570
586
|
* @returns {Array} 文件路径数组
|
|
@@ -577,14 +593,17 @@ Manager.prototype._findFiles = async function (dir) {
|
|
|
577
593
|
if (!hasDir(dir)) {
|
|
578
594
|
return [];
|
|
579
595
|
}
|
|
580
|
-
|
|
581
|
-
// update 语义要求看到新增/删除的文件
|
|
582
|
-
let files = this._getLoader(dir).scan();
|
|
596
|
+
let loader = this._getLoader(dir).ensureScanned();
|
|
583
597
|
let filename = this.config.filename;
|
|
584
598
|
if (!filename) {
|
|
585
|
-
return files;
|
|
599
|
+
return loader.files;
|
|
586
600
|
}
|
|
587
|
-
|
|
601
|
+
let type = filename.replace(/\.json$/i, '');
|
|
602
|
+
let scope = path.resolve(dir);
|
|
603
|
+
return typeStore(type)
|
|
604
|
+
.list({ root: loader.config.dir })
|
|
605
|
+
.filter((one) => one.name === filename && _inDir(one.file, scope))
|
|
606
|
+
.map((one) => one.file);
|
|
588
607
|
};
|
|
589
608
|
|
|
590
609
|
// ==== 目录监听 ====
|
|
@@ -603,11 +622,11 @@ Manager.prototype._watchDir = function (dir) {
|
|
|
603
622
|
let hot = this._isScriptHot();
|
|
604
623
|
let loader = this._getLoader(dir);
|
|
605
624
|
let config_callback = (changes) => {
|
|
606
|
-
this._applyChanges(changes);
|
|
625
|
+
this._applyChanges(changes.filter((one) => _inDir(one.file, dir)));
|
|
607
626
|
};
|
|
608
627
|
let script_callback = hot
|
|
609
628
|
? (changes) => {
|
|
610
|
-
this._applyScriptChanges(changes);
|
|
629
|
+
this._applyScriptChanges(changes.filter((one) => _inDir(one.file, dir)));
|
|
611
630
|
}
|
|
612
631
|
: undefined;
|
|
613
632
|
let success = loader.watch(config_callback, script_callback);
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "mm_machine",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "6.0.0",
|
|
4
4
|
"description": "A flexible Node.js plugin mechanism system for dynamic loading, management and execution of modules. Supports hot reload, lifecycle management, and modern JavaScript features.",
|
|
5
5
|
"main": "index.js",
|
|
6
6
|
"scripts": {
|
|
@@ -25,7 +25,7 @@
|
|
|
25
25
|
"framework",
|
|
26
26
|
"mechanism"
|
|
27
27
|
],
|
|
28
|
-
"layer": "
|
|
28
|
+
"layer": "infrastructure",
|
|
29
29
|
"group": "runtime",
|
|
30
30
|
"author": "邱文武",
|
|
31
31
|
"license": "ISC",
|
|
@@ -42,8 +42,10 @@
|
|
|
42
42
|
"@prettier/sync": "^0.6.1",
|
|
43
43
|
"mm_config": "^2.5.3",
|
|
44
44
|
"mm_helper": "^1.0.3",
|
|
45
|
-
"mm_loader": "^
|
|
45
|
+
"mm_loader": "^7.0.0",
|
|
46
46
|
"mm_mod": "^1.0.6",
|
|
47
|
+
"mm_scanner": "^5.0.0",
|
|
48
|
+
"mm_store": "^1.0.1",
|
|
47
49
|
"mm_tpl": "^2.7.3"
|
|
48
50
|
},
|
|
49
51
|
"devDependencies": {
|