@zwa73/utils 1.0.235 → 1.0.240

package/dist/UtilClass/index.d.ts

@@ -1,3 +1,3 @@
 export * from './Hbs';
-export type { PromoseQueueOption, DListMiddleNode, DListHeadNode, DListTailNode, DListNode, DListMaybeNode, BridgeInterface } from "@zwa73/js-utils";
-export { Stream, Spool, SmartCache, PromiseQueue, Piper, DLinkedList, Bridge } from "@zwa73/js-utils";
+export type { PromoseQueueOption, EventData, DListMiddleNode, DListHeadNode, DListTailNode, DListNode, DListMaybeNode, BridgeInterface } from "@zwa73/js-utils";
+export { Stream, Spool, SmartCache, PromiseQueue, Piper, EventSystem, DLinkedList, Bridge } from "@zwa73/js-utils";

package/dist/UtilClass/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Bridge = exports.DLinkedList = exports.Piper = exports.PromiseQueue = exports.SmartCache = exports.Spool = exports.Stream = void 0;
+exports.Bridge = exports.DLinkedList = exports.EventSystem = exports.Piper = exports.PromiseQueue = exports.SmartCache = exports.Spool = exports.Stream = void 0;
 __exportStar(require("./Hbs"), exports);
 var js_utils_1 = require("@zwa73/js-utils");
 Object.defineProperty(exports, "Stream", { enumerable: true, get: function () { return js_utils_1.Stream; } });
@@ -22,6 +22,7 @@ Object.defineProperty(exports, "Spool", { enumerable: true, get: function () { r
 Object.defineProperty(exports, "SmartCache", { enumerable: true, get: function () { return js_utils_1.SmartCache; } });
 Object.defineProperty(exports, "PromiseQueue", { enumerable: true, get: function () { return js_utils_1.PromiseQueue; } });
 Object.defineProperty(exports, "Piper", { enumerable: true, get: function () { return js_utils_1.Piper; } });
+Object.defineProperty(exports, "EventSystem", { enumerable: true, get: function () { return js_utils_1.EventSystem; } });
 Object.defineProperty(exports, "DLinkedList", { enumerable: true, get: function () { return js_utils_1.DLinkedList; } });
 Object.defineProperty(exports, "Bridge", { enumerable: true, get: function () { return js_utils_1.Bridge; } });
 //#endregion

package/dist/UtilFileTools.d.ts

@@ -47,6 +47,11 @@ type WriteJsonFileOpt = Partial<{
     compressThreshold: number;
     /**不自动修改扩展名为json */
     forceExt: boolean;
+    /**检查重复, 避免重复写入
+     * 只在第一次尝试写入时读取一次文件内容, 后续将会使用缓存判断是否重复
+     * 若是其他进程改动了文件内容, 将无法检测到
+     */
+    checkDuplicate: boolean;
 }>;
 /**文件工具 */
 export declare namespace UtilFT {
@@ -129,8 +134,10 @@ export declare namespace UtilFT {
      * @param opt.compress          - 使用紧凑风格 将会用/\uF121\uF122\uF123.+\uF121\uF122\uF123/作为特殊标记, 原始文本内若出现相同格式将会产生错误
      * @param opt.forceExt          - 不自动修改扩展名为json
      * @param opt.compressThreshold - 紧凑风格 压缩阈值 默认100
+     * @param opt.checkDuplicate    - 检查重复输出 避免重复输出
+     * @returns 是否完成写入, 出错或检出重复均会返回false
      */
-    function writeJSONFile(filePath: string, token: JToken, opt?: WriteJsonFileOpt): Promise<void>;
+    function writeJSONFile(filePath: string, token: JToken, opt?: WriteJsonFileOpt): Promise<boolean>;
     /**保证路径为某个风格
      * @param filePath - 输入路径
      * @param style    - 目标风格 undefined 时不改变

package/dist/UtilFileTools.js

@@ -188,6 +188,7 @@ var UtilFT;
         }
     }
     UtilFT.loadJSONFile = loadJSONFile;
+    const writeJSONFileDupMap = {};
     /**写入JSON文件
      * @async
      * @param filePath - 文件路径
@@ -196,6 +197,8 @@ var UtilFT;
      * @param opt.compress          - 使用紧凑风格 将会用/\uF121\uF122\uF123.+\uF121\uF122\uF123/作为特殊标记, 原始文本内若出现相同格式将会产生错误
      * @param opt.forceExt          - 不自动修改扩展名为json
      * @param opt.compressThreshold - 紧凑风格 压缩阈值 默认100
+     * @param opt.checkDuplicate    - 检查重复输出 避免重复输出
+     * @returns 是否完成写入, 出错或检出重复均会返回false
      */
     async function writeJSONFile(filePath, token, opt) {
         const str = UtilFunctions_1.UtilFunc.stringifyJToken(token, opt);
@@ -204,13 +207,24 @@ var UtilFT;
         // 判断文件路径是否存在 不存在则创建
         if (!(await pathExists(filePath)))
             await createPath(filePath);
+        // 检查内容是否重复
+        if (opt?.checkDuplicate) {
+            if (writeJSONFileDupMap[filePath] === undefined)
+                writeJSONFileDupMap[filePath] = await fs.promises.readFile(filePath, 'utf-8');
+            if (writeJSONFileDupMap[filePath] == str)
+                return false;
+            else
+                writeJSONFileDupMap[filePath] = str;
+        }
         // 写入文件
         try {
             await fs.promises.writeFile(filePath, str);
             UtilLogger_1.SLogger.verbose(`${filePath} writeJSONFile 成功`);
+            return true;
         }
         catch (err) {
             UtilLogger_1.SLogger.error(`${filePath} writeJSONFile 错误`, err);
+            return false;
         }
     }
     UtilFT.writeJSONFile = writeJSONFile;

package/dist/UtilFunctions.d.ts

@@ -11,6 +11,8 @@ type ExecOpt = Partial<{
     nodeModules: string;
     /**工作路径 */
     cwd: string;
+    /**额外环境变量 */
+    env: string;
 }>;
 /**常用函数 */
 declare class _UtilFunc {
@@ -34,6 +36,7 @@ declare class _UtilFunc {
      * @param opt.errlvl       - 错误的日志等级
      * @param opt.nodeModules  - nodeModules文件夹路径
      * @param opt.cwd          - 执行目录
+     * @param opt.env          - 额外环境变量
      */
     static exec(command: string, opt?: ExecOpt): Promise<{
         stdout: string;
@@ -42,5 +45,5 @@ declare class _UtilFunc {
     /**获取当前公网ipv4 */
     static getPublicIpv4(): Promise<string>;
 }
-export declare const UtilFunc: import("@zwa73/modular-mixer").ComposedClass<typeof _UtilFunc, typeof JsFunc, "__jsUtils", "match" | "failed" | "success" | "prototype" | "genUUID" | "range" | "getTime" | "initField" | "initObject" | "afterward" | "sleep" | "getNeverResolvedPromise" | "retryPromise" | "timelimitPromise" | "mapEntries" | "eachField" | "stringifyJToken" | "assertType" | "assertLiteral" | "deepClone" | "isSafeNumber" | "dedent" | "throwError" | "getFuncLoc" | "cachePool" | "memoize" | "asyncize" | "lazyFunction" | "splitToChunk" | "mergeFromChunk" | "structEqual" | "concurrent" | "dynamicImport" | "outcome" | "isStatus" | "eitherize" | "parseSrtTime" | "formatSrtTime" | "parseSrt" | "createSrt" | "ivk" | "s2l" | "l2s">;
+export declare const UtilFunc: import("@zwa73/modular-mixer").ComposedClass<typeof _UtilFunc, typeof JsFunc, "__jsUtils", "match" | "failed" | "success" | "prototype" | "genUUID" | "range" | "getTime" | "initField" | "initObject" | "afterward" | "sleep" | "getNeverResolvedPromise" | "retryPromise" | "timelimitPromise" | "mapEntries" | "eachField" | "stringifyJToken" | "assertType" | "assertLiteral" | "deepClone" | "isSafeNumber" | "dedent" | "throwError" | "getFuncLoc" | "cachePool" | "memoize" | "asyncize" | "lazyFunction" | "splitToChunk" | "mergeFromChunk" | "structEqual" | "concurrent" | "dynamicImport" | "createInjectable" | "outcome" | "isStatus" | "eitherize" | "parseSrtTime" | "formatSrtTime" | "parseSrt" | "createSrt" | "ivk" | "s2l" | "l2s">;
 export type UtilFunc = typeof UtilFunc;

package/dist/UtilFunctions.js

@@ -72,11 +72,12 @@ class _UtilFunc {
      * @param opt.errlvl       - 错误的日志等级
      * @param opt.nodeModules  - nodeModules文件夹路径
      * @param opt.cwd          - 执行目录
+     * @param opt.env          - 额外环境变量
      */
     static async exec(command, opt) {
         return new Promise(async (resolve, reject) => {
             // 创建一个新的环境变量对象，并将项目的 node_modules/.bin 目录添加到 PATH 环境变量中
-            const env = Object.create(process.env);
+            const env = Object.assign(Object.create(process.env), opt?.env ?? {});
             const penv = opt?.nodeModules
                 ? path_1.default.join(UtilFileTools_1.UtilFT.currosizePath(opt.nodeModules), '.bin')
                 : UtilFileTools_1.UtilFT.currosizePath(await exports.UtilFunc.memoize(UtilFileTools_1.UtilFT.findNodeModulesDir)(process.cwd(), '.bin') ?? '');

package/dist/UtilInterfaces.d.ts

@@ -1 +1 @@
-export type { JToken, JValue, JArray, JObject, IJData, AnyFunc, Keyable, PartialOption, ProperSubset, ProperSubsetCheck, IncludeCheck, UnionCheck, Literal, LiteralCheck, AllExtends, AssignObject, Writeable, Inverted, FixedLengthTuple, Increment, RangeTuple, AnyString, UnionToIntersection, ExclusiveRecord, ExclusiveJObject, PromiseStatus, StatusVerifyFn, Await, FuncPropNames, ExtendThen, RequiredOnly, WithPrefix, Outcome, Either, Matchable, MatchableFlag, ExtractOutcome, ExtractMatchable, NeedInit, PRecord, MPromise, SPromise, SMPromise, NotPromise, AnyRecord, MReturnType, CmtTuple, Flasy, SrtSegment, ILogger, LogLevel, Asyncize } from "@zwa73/js-utils";
+export type { JToken, JValue, JArray, JObject, IJData, AnyFunc, Keyable, DeepReadonly, PartialOption, ProperSubset, ProperSubsetCheck, IncludeCheck, UnionCheck, Literal, LiteralCheck, AllExtends, AssignObject, Writeable, Inverted, FixedLengthTuple, Increment, RangeTuple, AnyString, UnionToIntersection, ExclusiveRecord, ExclusiveJObject, PromiseStatus, StatusVerifyFn, Await, FuncPropNames, ExtendThen, RequiredOnly, WithPrefix, Outcome, Either, Matchable, MatchableFlag, ExtractOutcome, ExtractMatchable, NeedInit, PRecord, MPromise, SPromise, SMPromise, NotPromise, AnyRecord, MReturnType, CmtTuple, Flasy, SrtSegment, ILogger, LogLevel, Asyncize } from "@zwa73/js-utils";

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zwa73/utils",
-	"version": "1.0.235",
+	"version": "1.0.240",
 	"description": "my utils",
 	"main": "dist/index.js",
 	"scripts": {