mm_expand 2.3.4 → 2.3.5

package/lib/file.js

@@ -6,7 +6,8 @@ const {
   statSync,
   readdirSync,
   mkdirSync,
-  unlinkSync
+  unlinkSync,
+  promises: fsp
 } = require('fs');
 const {
   join,
@@ -135,6 +136,7 @@ function fullname(file, dir) {
 class File extends Base {
   /**
    * 构造函数，用于初始化文件类
+   * @param config
    */
   constructor(config) {
     super(config);
@@ -171,6 +173,75 @@ File.prototype.getAll = function (dir, keyword, keyword_dir) {
   return list;
 };
 
+/**
+ * 搜索目录下所有文件
+ * @param {string} dir 目录地址
+ * @param {string} keyword 搜索关键词
+ * @param {string} keyword_dir 目录搜素关键词
+ * @returns {Array} 文件路径数组
+ */
+File.prototype.getAll = function (dir, keyword, keyword_dir) {
+  // 文件数组
+  var list = [];
+
+  // 目录数组
+  var dirs = [];
+  // 获取相关目录
+  eachDir(dirs, dir.fullname(), keyword_dir);
+  var len = dirs.length;
+  for (var i = 0; i < len; i++) {
+    getFile(list, dirs[i], keyword);
+  }
+  return list;
+};
+
+/**
+ * 搜索目录下所有文件（异步并行极速版）
+ * @param {string} dir 目录地址
+ * @param {string} keyword 搜索关键词
+ * @param {string} keyword_dir 目录搜素关键词
+ * @returns {Array} 文件路径数组
+ */
+File.prototype.getAllAsync = async function (dir, keyword, keyword_dir) {
+  var root_dir = dir.fullname();
+  var matchedDirs = [];
+
+  // 使用独立 eachDirAsync 并行收集匹配的目录
+  await eachDirAsync(matchedDirs, root_dir, keyword_dir);
+
+  /**
+   * 异步获取目录下的匹配文件
+   * @param {string} directory 目录路径
+   * @returns {Array} 文件路径数组
+   */
+  async function getFileAsync(directory) {
+    var items;
+    try {
+      items = await fsp.readdir(directory, { with_file_types: true });
+    } catch {
+      return [];
+    }
+
+    var files = [];
+    for (var i = 0; i < items.length; i++) {
+      var item = items[i];
+      if (item.isFile() && (!keyword || item.name.has(keyword))) {
+        files.push(join(directory, item.name));
+      }
+    }
+    return files;
+  }
+
+  // 没有匹配的子目录时，直接搜索根目录
+  if (matchedDirs.length === 0) {
+    return await getFileAsync(root_dir);
+  }
+
+  // 并行处理所有匹配目录的文件收集
+  var file_lists = await Promise.all(matchedDirs.map(getFileAsync));
+  return file_lists.flat();
+};
+
 /**
  * 获取当前目录下所有文件
  * @param {string} dir 目录地址
@@ -218,11 +289,9 @@ File.prototype.save = function (file, data, encode) {
   if (data === undefined || data === null) {
     throw new Error('data参数不能为空');
   }
-  if (!encode) {
-    encode = 'utf-8';
-  }
+  var enc = encode || 'utf-8';
   try {
-    writeFileSync(file, data, encode);
+    writeFileSync(file, data, enc);
     return true;
   } catch (e) {
     this.log('error', '保存文件失败：', e);
@@ -289,10 +358,8 @@ File.prototype.exists = function (file) {
  * @returns {string} 文件内容
  */
 File.prototype.read = function (file, encode) {
-  if (!encode) {
-    encode = 'utf-8';
-  }
-  return this.load(file, encode);
+  var enc = encode || 'utf-8';
+  return this.load(file, enc);
 };
 
 /**
@@ -333,6 +400,40 @@ function eachDir(list, dir, keyword) {
     }
   }
 }
+/**
+ * 异步并行搜索目录下所有目录
+ * @param {Array} list 结果路径数组
+ * @param {string} dir 目录地址
+ * @param {string} keyword 搜索关键词
+ */
+async function eachDirAsync(list, dir, keyword) {
+  var items;
+  try {
+    items = await fsp.readdir(dir, { with_file_types: true });
+  } catch {
+    return;
+  }
+
+  var subDirs = [];
+  for (var i = 0; i < items.length; i++) {
+    var item = items[i];
+    if (item.isDirectory()) {
+      var full_path = join(dir, item.name);
+      if (!keyword || item.name.has(keyword)) {
+        list.push(full_path);
+      }
+      subDirs.push(full_path);
+    }
+  }
+
+  // 并行遍历所有子目录
+  if (subDirs.length > 0) {
+    await Promise.all(subDirs.map((d) => {
+      return eachDirAsync(list, d, keyword);
+    }));
+  }
+}
+
 /**
  * 获取当前目录下所有目录
  * @param {Array} list 结果路径数组
@@ -386,6 +487,7 @@ function getFile(list, dir, keyword) {
 class Dir extends Base {
   /**
    *
+   * @param config
    */
   constructor(config) {
     super(config);
@@ -412,6 +514,18 @@ Dir.prototype.getAll = function (dir, keyword) {
   return list;
 };
 
+/**
+ * 搜索目录下所有目录（异步并行极速版）
+ * @param {string} dir 目录地址
+ * @param {string} keyword 搜索关键词
+ * @returns {Array} 目录路径数组
+ */
+Dir.prototype.getAllAsync = async function (dir, keyword) {
+  var list = [];
+  await eachDirAsync(list, this.fullname(dir), keyword);
+  return list;
+};
+
 /**
  * 搜索当前目录下所有目录
  * @param {string} dir 目录地址
@@ -597,10 +711,8 @@ String.prototype.saveJson = function (obj, format = true, space = 2) {
 String.prototype.loadText = function (encode) {
   var file = this.fullname();
   if (existsSync(file)) {
-    if (!encode) {
-      encode = 'utf-8';
-    }
-    return readFileSync(file, encode);
+    var enc = encode || 'utf-8';
+    return readFileSync(file, enc);
   } else {
     return undefined;
   }
@@ -660,7 +772,7 @@ String.prototype.hasFile = function (file) {
  * @param {string} file 当前路径
  */
 String.prototype.delFile = function (file) {
-  unlinkSync(this.fullname(file), function (e) { });
+  unlinkSync(this.fullname(file), (e) => { });
 };
 
 /**

package/lib/global.js

@@ -9,7 +9,7 @@ Map.prototype.del = Map.prototype.delete;
 Set.prototype.del = Set.prototype.delete;
 
 /**
- * @description 延迟执行（休眠）
+ * 延迟执行（休眠）
  * @param {number} milliSeconds 毫秒
  * @param milli_seconds
  * @param {object} obj 判断对象或函数
@@ -72,14 +72,12 @@ function sleepWithFunc(end_time, func) {
 }
 
 /**
- * @description 测试函数执行速度
+ * 测试函数执行速度
  * @param {Function()} func 测试的函数
  * @param {number} times = [value] 测试次数
  */
-function speed(func, times) {
-  if (!times) {
-    times = 1000000;
-  }
+function speed(func, _times) {
+  var times = _times || 1000000;
   var t1 = (new Date()).valueOf();
   for (var i = 0; i < times; i++) {
     func();
@@ -110,10 +108,10 @@ if (!global.$) {
       scope: 'sys'
     },
     /**
-       * @description 字典，用于查询变量替换名
-       * @property {string} session_id session的ID
-       * @property {string} user_id 用户的ID，用于数据库时查询用户唯一标识
-       */
+     * 字典，用于查询变量替换名
+     * @property {string} session_id session的ID
+     * @property {string} user_id 用户的ID，用于数据库时查询用户唯一标识
+     */
     dict: {
       session_id: 'mm:uuid',
       user_id: 'user_id',
@@ -130,19 +128,19 @@ if (!global.$) {
   });
 
   /**
-     * 运行代码
-     * @param {string} code 代码字符串
-     * @param {object} cm 上下文参数
-     * @returns {string} 返回运行结果
-     */
+   * 运行代码
+   * @param {string} code 代码字符串
+   * @param {object} cm 上下文参数
+   * @returns {string} 返回运行结果
+   */
   $.runCode = async function (code, cm) {
     var script = `async function runCode() {
-			var body;
-			
-			${code}
-			
-			return body;
-		}`;
+      var body;
+
+      ${code}
+
+      return body;
+    }`;
     eval(script);
     var func = eval('runCode');
     var result = await func();
@@ -150,11 +148,11 @@ if (!global.$) {
   };
 
   /**
-     * 运行脚本
-     * @param {string} file 文件路径
-     * @param {object} cm common公共对象
-     * @returns {string} 返回运行结果
-     */
+   * 运行脚本
+   * @param {string} file 文件路径
+   * @param {object} cm common公共对象
+   * @returns {string} 返回运行结果
+   */
   $.runScript = async function (file, cm) {
     if (file.hasFile()) {
       return await $.runCode(file.loadText(), cm);
@@ -164,17 +162,17 @@ if (!global.$) {
   };
 
   /**
-     * 加载模块
-     * @param {string} file 文件路径
-     */
+   * 加载模块
+   * @param {string} file 文件路径
+   */
   $.load = function (file) {
     return require(file);
   };
 
   /**
-     * 卸载模块
-     * @param {string} file 文件路径
-     */
+   * 卸载模块
+   * @param {string} file 文件路径
+   */
   $.unload = function (file) {
     var f = require.resolve(file);
     delete require.cache[f];
@@ -182,33 +180,33 @@ if (!global.$) {
   };
 
   /**
-     * 重载模块
-     * @param {string} file 文件路径
-     */
+   * 重载模块
+   * @param {string} file 文件路径
+   */
   $.reload = function (file) {
     var f = $.unload(file);
     return $.load(f);
   };
 
   /**
-     * 获取对象详细信息
-     * @param {object} obj 对象
-     * @returns {string} 对象详细信息
-     */
+   * 获取对象详细信息
+   * @param {object} obj 对象
+   * @returns {string} 对象详细信息
+   */
   $.info = function (obj) {
     const { inspect } = require('util');
     return inspect(obj, {
-      showHidden: false,
+      show_hidden: false,
       depth: null
     });
   };
 
   /**
-     * 判断基本类型是否相等
-     * @param {*} source 被判断对象
-     * @param {*} target 用作判断的对象
-     * @returns {boolean} 相等返回true，否则返回false
-     */
+   * 判断基本类型是否相等
+   * @param {*} source 被判断对象
+   * @param {*} target 用作判断的对象
+   * @returns {boolean} 相等返回true，否则返回false
+   */
   function compareBasic(source, target) {
     var type = typeof (source);
     if (type !== typeof (target)) {
@@ -224,13 +222,13 @@ if (!global.$) {
   }
 
   /**
-     * 判断数组是否相似
-     * @param {Array} source 被判断数组
-     * @param {Array} target 用作判断的数组
-     * @param {boolean} exact 是否完全相同
-     * @param {number} depth 递归深度
-     * @returns {boolean} 相似返回true，否则返回false
-     */
+   * 判断数组是否相似
+   * @param {Array} source 被判断数组
+   * @param {Array} target 用作判断的数组
+   * @param {boolean} exact 是否完全相同
+   * @param {number} depth 递归深度
+   * @returns {boolean} 相似返回true，否则返回false
+   */
   function compareArray(source, target, exact, depth) {
     var length = source.length;
     if (exact && length !== target.length) {
@@ -280,7 +278,7 @@ if (!global.$) {
     }
 
     // 先判断基本类型
-    var basic_result = compareBasic(source, target);
+    compareBasic(source, target);
     if (basic_result !== null) {
       return basic_result;
     }

package/lib/lang.js

@@ -24,10 +24,10 @@ class Lang extends Base {
 
     // 复数规则配置
     this.rules = {
-      'en': function (count) {
+      en(count) {
         return count === 1 ? 0 : 1;
       },
-      'zh_cn': function () {
+      zhCn() {
         return 0;
       }
     };
@@ -310,7 +310,7 @@ Lang.prototype.tc = function (key, count, ...param) {
  * @param {string} [format='YYYY-MM-DD'] - 格式
  * @returns {string} 格式化后的日期字符串
  */
-Lang.prototype.formatDate = function (dt, format) {
+Lang.prototype.formatDate = function (dt, _format) {
   // 参数校验
   if (!dt) {
     throw new TypeError('date不能为空');
@@ -321,7 +321,7 @@ Lang.prototype.formatDate = function (dt, format) {
     throw new TypeError('无效的日期');
   }
 
-  format = format || 'YYYY-MM-DD';
+  var format = _format || 'YYYY-MM-DD';
   var year = d.getFullYear();
   var month = String(d.getMonth() + 1).padStart(2, '0');
   var day = String(d.getDate()).padStart(2, '0');
@@ -348,23 +348,23 @@ Lang.prototype.formatDate = function (dt, format) {
  * @param {string} [opt.thousandsSeparator] - 千位分隔符
  * @returns {string} 格式化后的数字字符串
  */
-Lang.prototype.formatNumber = function (num, opt) {
+Lang.prototype.formatNumber = function (num, _opt) {
   // 参数校验
   if (typeof num !== 'number' || isNaN(num)) {
     throw new TypeError('num必须是有效的数字');
   }
 
-  opt = opt || {};
+  var opt = _opt || {};
   var decimals = typeof opt.decimals === 'number' ? opt.decimals : 2;
 
   // 获取语言特定的分隔符
-  var decimal_separator = opt.decimalSeparator || '.';
-  var thousands_separator = opt.thousandsSeparator || ',';
+  var decimal_sepa = opt.decimalSeparator || '.';
+  var thou_sepa = opt.thousandsSeparator || ',';
 
   // 格式化数字
   var parts = num.toFixed(decimals).split('.');
-  parts[0] = parts[0].replace(/\B(?=(\d{3})+(?!\d))/g, thousands_separator);
-  return parts.join(decimal_separator);
+  parts[0] = parts[0].replace(/\B(?=(\d{3})+(?!\d))/g, thou_sepa);
+  return parts.join(decimal_sepa);
 };
 
 /**

package/lib/logger.js

@@ -22,8 +22,8 @@ class Logger extends Event {
   #logger = console;
 
   /**
-     * 构造函数
-     */
+   * 构造函数
+   */
   constructor() {
     super();
     /**

package/lib/number.js

@@ -1,6 +1,6 @@
 /* == 数字原型函数 == */
 /**
- * @description 去尾法
+ * 去尾法
  * @param {number} len 保留长度
  * @returns {number} 数值
  */
@@ -9,7 +9,7 @@ Number.prototype.toFloor = function (len) {
   return Math.floor(this * n) / n;
 };
 /**
- * @description 进一法
+ * 进一法
  * @param {number} len 保留长度
  * @returns {number} 数值
  */
@@ -18,7 +18,7 @@ Number.prototype.toCeil = function (len) {
   return Math.ceil(this * n) / n;
 };
 /**
- * @description 四舍五入法
+ * 四舍五入法
  * @param {number} len 保留长度
  * @returns {number} 数值
  */
@@ -28,7 +28,7 @@ Number.prototype.toRound = function (len) {
 };
 
 /**
- * @description 转为时间类型
+ * 转为时间类型
  * @returns {Date} 时间对象
  */
 Number.prototype.toTime = function () {
@@ -36,7 +36,7 @@ Number.prototype.toTime = function () {
 };
 
 /**
- * @description 转为时间戳
+ * 转为时间戳
  * @returns {number} 返回时间戳
  */
 Number.prototype.toTimestamp = function () {
@@ -44,7 +44,7 @@ Number.prototype.toTimestamp = function () {
 };
 
 /**
- * @description 转为时间
+ * 转为时间
  * @param {string} format 时间格式
  * @returns {string} 时间字符串
  */
@@ -53,7 +53,7 @@ Number.prototype.toTimeStr = function (format = 'yyyy-MM-dd hh:mm:ss') {
 };
 
 /**
- * @description 随机数生成
+ * 随机数生成
  * @param {number} min 最小值
  * @returns {number} 返回随机数值
  */
@@ -62,7 +62,7 @@ Number.prototype.random = function (min = 1) {
 };
 
 /**
- * @description 随机数范围生成
+ * 随机数范围生成
  * @param {number} margin 上下幅度
  * @returns {number} 返回范围随机数值
  */
@@ -73,8 +73,8 @@ Number.prototype.randomRange = function (margin = 5) {
 };
 
 /**
- * @description 导出Number原型扩展
+ * 导出Number原型扩展
  */
 module.exports = {
   Number
-};
+};