@ainc/fs 0.1.16 → 0.1.18

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2021 edonet <edonet@163.com>
+Copyright (c) 2028 absock@163.com
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,50 +1,26 @@
-# @ainc/fs
-file system
+# @ainc/esb
+Let's do something nice with @ainc/esb!
 
 ## Install
 ``` shell
-$ yarn add @ainc/fs
+$ yarn global add @ainc/esb
 ```
 
 ## Usage
-``` javascript
-import * as fs from '@ainc/fs';
+``` shell
+$ esb -p ./src
 ```
 
-## API
-* homedir(): string;
-* cwd(...args: string[]): string;
-* stat(file: string): Stats | null;
-* lstat(file: string): Stats | null;
-* dirname(dir: string): string;
-* filename(file: string): string;
-* basename(file: string, ext?: string): string
-* extname(file: string): string;
-* readFile(path: string): string;
-* writeFile(path: string, content: string | Buffer): void;
-* unlink(path: string): boolean;
-* symlink(src: string, dest: string, options?: Options): void;
-* copy(src: string, dest: string, options?: Options): void;
-* isDirectory(file: string): boolean;
-* indir(dir: string, file: string): boolean;
-* indir(dir: string): (file: string) => boolean;
-* mkdir(dir: string): string;
-* rmdir(dir: string): boolean;
-* readdir(dir: string): State[]
-* cpdir(src: string, dist: string, handler: Handler): string[];
-* mapdir<T>(dir: string, handler: Handler<T>): T[];
-* usedir(...basedir: string[]): (...args: string[]) => string;
-* supdir<T>(dir: string, handler: Handler<T>): T | undefined;
-* resolve(dir: string | string[], options?: Options): Asset[];
-* relative(from: string, to: string): string;
-* find(name: string, dir = '.', options?: Options): string[];
-* finddir(name: string, dir = '.', options: Options): string[];
-* findFile(name: string, dir = '.', options?: Options): string[];
-* json(file: string): object | null;
-* json(file: string, data: object): object | null;
-* parseJSON<T>(source: string, options?: Options): T;
-* resolveFile(file: string, options?: Options): void | string;
-* resolveAlias(options: Options): ResolvePath;
-* isAbsolutePath(source: string): boolean;
-* isRelativePath(source: string): boolean;
-* includePaths(paths: string[]): (source: string) => boolean;
+## VS Code
+``` json
+{
+  "name": "Launch Script",
+  "type": "node",
+  "request": "launch",
+  "autoAttachChildProcesses": true,
+  "runtimeExecutable": "esb",
+  "args": [
+    "${file}"
+  ]
+}
+```

package/dist/findUp.d.ts

@@ -0,0 +1,6 @@
+/**
+ *****************************************
+ * 向上查找
+ *****************************************
+ */
+export declare function findUp<T>(from: string, handler: (path: string) => T | undefined): T | undefined;

package/dist/findUp.js

@@ -0,0 +1,35 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2023-12-31 09:32:31
+ *****************************************
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findUp = findUp;
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+const node_path_1 = require("node:path");
+/**
+ *****************************************
+ * 向上查找
+ *****************************************
+ */
+function findUp(from, handler) {
+    let latest = '';
+    let current = from;
+    // 遍历目录
+    while (current !== latest) {
+        const result = handler(current);
+        // 存在结果
+        if (result !== undefined) {
+            return result;
+        }
+        // 获取上级目录
+        latest = current;
+        current = (0, node_path_1.dirname)(current);
+    }
+}

package/dist/index.d.ts

@@ -1,44 +1,13 @@
 /**
  *****************************************
- * 抛出模块
+ * 导出接口
  *****************************************
  */
-export { homedir } from './homedir';
-export { cwd } from './cwd';
-export { realpath } from './realpath';
-export { dirname } from './dirname';
-export { filename } from './filename';
-export { basename } from './basename';
-export { extname } from './extname';
 export { stat } from './stat';
-export { lstat } from './lstat';
-export { isDirectory } from './isDirectory';
-export { indir } from './indir';
-export { json } from './json';
-export { jsonc } from './jsonc';
-export { parseJSON } from './parseJSON';
-export { copy } from './copy';
-export { cpdir } from './cpdir';
-export { find } from './find';
+export { isRelative, relative } from './relative';
+export { resolveFile } from './resolveFile';
 export { readFile } from './readFile';
-export { readline } from './readline';
-export { readStream } from './readStream';
-export { writeFile } from './writeFile';
-export { writeStream } from './writeStream';
-export { findFile } from './findFile';
-export { resolve } from './resolve';
-export { relative } from './relative';
-export { unlink } from './unlink';
-export { readdir } from './readdir';
-export { mkdir } from './mkdir';
-export { finddir } from './finddir';
-export { rmdir } from './rmdir';
-export { mapdir } from './mapdir';
-export { symlink } from './symlink';
-export { usedir } from './usedir';
-export { supdir } from './supdir';
-export { resolvePath } from './resolvePath';
-export { includePaths } from './includePaths';
-export { isAbsolutePath } from './isAbsolutePath';
-export { isRelativePath } from './isRelativePath';
-//# sourceMappingURL=index.d.ts.map
+export { rm } from './rm';
+export { lookup } from './lookup';
+export { findUp } from './findUp';
+export { json, jsonc } from './jsonc';

package/dist/index.js

@@ -1,91 +1,32 @@
 /**
  *****************************************
  * Created by edonet@163.com
- * Created on 2019-11-07 15:59:39
+ * Created on 2023-12-31 09:11:10
  *****************************************
  */
 'use strict';
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isRelativePath = exports.isAbsolutePath = exports.includePaths = exports.resolvePath = exports.supdir = exports.usedir = exports.symlink = exports.mapdir = exports.rmdir = exports.finddir = exports.mkdir = exports.readdir = exports.unlink = exports.relative = exports.resolve = exports.findFile = exports.writeStream = exports.writeFile = exports.readStream = exports.readline = exports.readFile = exports.find = exports.cpdir = exports.copy = exports.parseJSON = exports.jsonc = exports.json = exports.indir = exports.isDirectory = exports.lstat = exports.stat = exports.extname = exports.basename = exports.filename = exports.dirname = exports.realpath = exports.cwd = exports.homedir = void 0;
+exports.jsonc = exports.json = exports.findUp = exports.lookup = exports.rm = exports.readFile = exports.resolveFile = exports.relative = exports.isRelative = exports.stat = void 0;
 /**
  *****************************************
- * 抛出模块
+ * 导出接口
  *****************************************
  */
-var homedir_1 = function () { var __exports = require("./homedir"); homedir_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "homedir", { enumerable: true, get: function () { return homedir_1().homedir; } });
-var cwd_1 = function () { var __exports = require("./cwd"); cwd_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "cwd", { enumerable: true, get: function () { return cwd_1().cwd; } });
-var realpath_1 = function () { var __exports = require("./realpath"); realpath_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "realpath", { enumerable: true, get: function () { return realpath_1().realpath; } });
-var dirname_1 = function () { var __exports = require("./dirname"); dirname_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "dirname", { enumerable: true, get: function () { return dirname_1().dirname; } });
-var filename_1 = function () { var __exports = require("./filename"); filename_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "filename", { enumerable: true, get: function () { return filename_1().filename; } });
-var basename_1 = function () { var __exports = require("./basename"); basename_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "basename", { enumerable: true, get: function () { return basename_1().basename; } });
-var extname_1 = function () { var __exports = require("./extname"); extname_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "extname", { enumerable: true, get: function () { return extname_1().extname; } });
-var stat_1 = function () { var __exports = require("./stat"); stat_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "stat", { enumerable: true, get: function () { return stat_1().stat; } });
-var lstat_1 = function () { var __exports = require("./lstat"); lstat_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "lstat", { enumerable: true, get: function () { return lstat_1().lstat; } });
-var isDirectory_1 = function () { var __exports = require("./isDirectory"); isDirectory_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "isDirectory", { enumerable: true, get: function () { return isDirectory_1().isDirectory; } });
-var indir_1 = function () { var __exports = require("./indir"); indir_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "indir", { enumerable: true, get: function () { return indir_1().indir; } });
-var json_1 = function () { var __exports = require("./json"); json_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "json", { enumerable: true, get: function () { return json_1().json; } });
-var jsonc_1 = function () { var __exports = require("./jsonc"); jsonc_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "jsonc", { enumerable: true, get: function () { return jsonc_1().jsonc; } });
-var parseJSON_1 = function () { var __exports = require("./parseJSON"); parseJSON_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "parseJSON", { enumerable: true, get: function () { return parseJSON_1().parseJSON; } });
-var copy_1 = function () { var __exports = require("./copy"); copy_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "copy", { enumerable: true, get: function () { return copy_1().copy; } });
-var cpdir_1 = function () { var __exports = require("./cpdir"); cpdir_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "cpdir", { enumerable: true, get: function () { return cpdir_1().cpdir; } });
-var find_1 = function () { var __exports = require("./find"); find_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "find", { enumerable: true, get: function () { return find_1().find; } });
-var readFile_1 = function () { var __exports = require("./readFile"); readFile_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "readFile", { enumerable: true, get: function () { return readFile_1().readFile; } });
-var readline_1 = function () { var __exports = require("./readline"); readline_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "readline", { enumerable: true, get: function () { return readline_1().readline; } });
-var readStream_1 = function () { var __exports = require("./readStream"); readStream_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "readStream", { enumerable: true, get: function () { return readStream_1().readStream; } });
-var writeFile_1 = function () { var __exports = require("./writeFile"); writeFile_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "writeFile", { enumerable: true, get: function () { return writeFile_1().writeFile; } });
-var writeStream_1 = function () { var __exports = require("./writeStream"); writeStream_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "writeStream", { enumerable: true, get: function () { return writeStream_1().writeStream; } });
-var findFile_1 = function () { var __exports = require("./findFile"); findFile_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "findFile", { enumerable: true, get: function () { return findFile_1().findFile; } });
-var resolve_1 = function () { var __exports = require("./resolve"); resolve_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "resolve", { enumerable: true, get: function () { return resolve_1().resolve; } });
-var relative_1 = function () { var __exports = require("./relative"); relative_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "relative", { enumerable: true, get: function () { return relative_1().relative; } });
-var unlink_1 = function () { var __exports = require("./unlink"); unlink_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "unlink", { enumerable: true, get: function () { return unlink_1().unlink; } });
-var readdir_1 = function () { var __exports = require("./readdir"); readdir_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "readdir", { enumerable: true, get: function () { return readdir_1().readdir; } });
-var mkdir_1 = function () { var __exports = require("./mkdir"); mkdir_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "mkdir", { enumerable: true, get: function () { return mkdir_1().mkdir; } });
-var finddir_1 = function () { var __exports = require("./finddir"); finddir_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "finddir", { enumerable: true, get: function () { return finddir_1().finddir; } });
-var rmdir_1 = function () { var __exports = require("./rmdir"); rmdir_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "rmdir", { enumerable: true, get: function () { return rmdir_1().rmdir; } });
-var mapdir_1 = function () { var __exports = require("./mapdir"); mapdir_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "mapdir", { enumerable: true, get: function () { return mapdir_1().mapdir; } });
-var symlink_1 = function () { var __exports = require("./symlink"); symlink_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "symlink", { enumerable: true, get: function () { return symlink_1().symlink; } });
-var usedir_1 = function () { var __exports = require("./usedir"); usedir_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "usedir", { enumerable: true, get: function () { return usedir_1().usedir; } });
-var supdir_1 = function () { var __exports = require("./supdir"); supdir_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "supdir", { enumerable: true, get: function () { return supdir_1().supdir; } });
-var resolvePath_1 = function () { var __exports = require("./resolvePath"); resolvePath_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "resolvePath", { enumerable: true, get: function () { return resolvePath_1().resolvePath; } });
-var includePaths_1 = function () { var __exports = require("./includePaths"); includePaths_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "includePaths", { enumerable: true, get: function () { return includePaths_1().includePaths; } });
-var isAbsolutePath_1 = function () { var __exports = require("./isAbsolutePath"); isAbsolutePath_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "isAbsolutePath", { enumerable: true, get: function () { return isAbsolutePath_1().isAbsolutePath; } });
-var isRelativePath_1 = function () { var __exports = require("./isRelativePath"); isRelativePath_1 = function () { return __exports; }; return __exports; };
-Object.defineProperty(exports, "isRelativePath", { enumerable: true, get: function () { return isRelativePath_1().isRelativePath; } });
-//# sourceMappingURL=index.js.map
+var stat_1 = require("./stat");
+Object.defineProperty(exports, "stat", { enumerable: true, get: function () { return stat_1.stat; } });
+var relative_1 = require("./relative");
+Object.defineProperty(exports, "isRelative", { enumerable: true, get: function () { return relative_1.isRelative; } });
+Object.defineProperty(exports, "relative", { enumerable: true, get: function () { return relative_1.relative; } });
+var resolveFile_1 = require("./resolveFile");
+Object.defineProperty(exports, "resolveFile", { enumerable: true, get: function () { return resolveFile_1.resolveFile; } });
+var readFile_1 = require("./readFile");
+Object.defineProperty(exports, "readFile", { enumerable: true, get: function () { return readFile_1.readFile; } });
+var rm_1 = require("./rm");
+Object.defineProperty(exports, "rm", { enumerable: true, get: function () { return rm_1.rm; } });
+var lookup_1 = require("./lookup");
+Object.defineProperty(exports, "lookup", { enumerable: true, get: function () { return lookup_1.lookup; } });
+var findUp_1 = require("./findUp");
+Object.defineProperty(exports, "findUp", { enumerable: true, get: function () { return findUp_1.findUp; } });
+var jsonc_1 = require("./jsonc");
+Object.defineProperty(exports, "json", { enumerable: true, get: function () { return jsonc_1.json; } });
+Object.defineProperty(exports, "jsonc", { enumerable: true, get: function () { return jsonc_1.jsonc; } });

package/dist/jsonc.d.ts

@@ -1,28 +1,12 @@
 /**
  *****************************************
- * 数据接口
+ * 解析 JSON
  *****************************************
  */
-interface Data {
-    [key: string]: unknown;
-}
+export declare function json<T>(content: string): T;
 /**
  *****************************************
- * 解析内容
+ * 解析 JSONC
  *****************************************
  */
-declare function parse<T = Data>(content: string): T | null;
-/**
- *****************************************
- * 读取/写入【jsonc】文件
- *****************************************
- */
-declare function jsonc<T = Data>(path: string): T | null;
-declare function jsonc<T = Data>(path: string, data: T): T;
-/**
- *****************************************
- * 抛出接口
- *****************************************
- */
-export { jsonc, parse };
-//# sourceMappingURL=jsonc.d.ts.map
+export declare function jsonc<T>(content: string): T;

package/dist/jsonc.js

@@ -1,50 +1,32 @@
 /**
  *****************************************
  * Created by edonet@163.com
- * Created on 2019-11-07 21:27:52
+ * Created on 2023-12-31 10:16:56
  *****************************************
  */
 'use strict';
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parse = exports.jsonc = void 0;
+exports.json = json;
+exports.jsonc = jsonc;
 /**
  *****************************************
  * 加载依赖
  *****************************************
  */
-const stat_1 = require("./stat");
-const readFile_1 = require("./readFile");
-const writeFile_1 = require("./writeFile");
-const stripComments_1 = require("./helpers/stripComments");
+const stripComments_1 = require("./utils/stripComments");
 /**
  *****************************************
- * 解析内容
+ * 解析 JSON
  *****************************************
  */
-function parse(content) {
-    // 格式化内容
-    content = (0, stripComments_1.stripComments)(content);
-    // 打印输出
-    // console.log(content);
-    // 解析文件
-    return content ? JSON.parse(content) : null;
+function json(content) {
+    return JSON.parse(content);
 }
-exports.parse = parse;
-function jsonc(...args) {
-    const [name, data] = args;
-    // 读写数据
-    if (args.length > 1) {
-        (0, writeFile_1.writeFile)(name, JSON.stringify(data));
-    }
-    else {
-        const stats = (0, stat_1.stat)(name);
-        // 解析文件
-        if (stats && stats.isFile()) {
-            return parse((0, readFile_1.readFile)(stats.path));
-        }
-    }
-    // 返回数据
-    return data || null;
+/**
+ *****************************************
+ * 解析 JSONC
+ *****************************************
+ */
+function jsonc(content) {
+    return JSON.parse((0, stripComments_1.stripComments)(content));
 }
-exports.jsonc = jsonc;
-//# sourceMappingURL=jsonc.js.map

package/dist/lookup.d.ts

@@ -0,0 +1,18 @@
+/**
+ *****************************************
+ * 查找选项
+ *****************************************
+ */
+interface Options<T> {
+    from?: string;
+    cache?: Map<string, T>;
+    extensions?: string[];
+    readFile?(path: string): T;
+}
+/**
+ *****************************************
+ * 向上查找
+ *****************************************
+ */
+export declare function lookup<T = string>(name: string, options?: Options<T>): T | undefined;
+export {};

package/dist/lookup.js

@@ -0,0 +1,63 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2023-12-31 10:38:51
+ *****************************************
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lookup = lookup;
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+const node_path_1 = require("node:path");
+const resolveFile_1 = require("./resolveFile");
+/**
+ *****************************************
+ * 向上查找
+ *****************************************
+ */
+function lookup(name, options = {}) {
+    const from = options.from ? (0, node_path_1.resolve)(options.from) : process.cwd();
+    // 解析目标
+    return resolveDir(from, name, options);
+}
+/**
+ *****************************************
+ * 解析目录文件
+ *****************************************
+ */
+function resolveDir(from, name, options) {
+    const { cache, extensions, readFile } = options;
+    const id = (0, node_path_1.resolve)(from, name);
+    // 存在缓存
+    if (cache && cache.has(id)) {
+        return cache.get(id);
+    }
+    // 获取文件状态
+    const path = (0, resolveFile_1.resolveFile)(id, extensions);
+    // 加载配置
+    const result = path ?
+        readFile ? readFile(path) : path :
+        resolveParent(from, name, options);
+    // 添加缓存
+    cache && cache.set(id, result);
+    // 返回配置
+    return result;
+}
+/**
+ *****************************************
+ * 加载配置
+ *****************************************
+ */
+function resolveParent(from, name, options) {
+    const parent = (0, node_path_1.dirname)(from);
+    // 到达根目录
+    if (parent === from) {
+        return;
+    }
+    // 加载配置
+    return resolveDir(parent, name, options);
+}

package/dist/readFile.d.ts

@@ -1,30 +1,6 @@
-/**
- *****************************************
- * 编码类型
- *****************************************
- */
-declare type Encoding = 'ascii' | 'utf8' | 'utf-8' | 'utf16le' | 'ucs2' | 'ucs-2' | 'base64' | 'latin1' | 'binary' | 'hex';
-/**
- *****************************************
- * 配置
- *****************************************
- */
-interface Options {
-    encoding?: Encoding;
-    flag?: string;
-}
 /**
  *****************************************
  * 读取文件
  *****************************************
  */
-declare function readFile(path: string): string;
-declare function readFile(path: string, encoding: Encoding): string;
-declare function readFile(path: string, options: Options): string;
-/**
- *****************************************
- *
- *****************************************
- */
-export { readFile };
-//# sourceMappingURL=readFile.d.ts.map
+export declare function readFile(path: string): string;

package/dist/readFile.js

@@ -1,27 +1,23 @@
 /**
  *****************************************
  * Created by edonet@163.com
- * Created on 2019-11-07 16:27:01
+ * Created on 2023-12-31 10:20:08
  *****************************************
  */
 'use strict';
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.readFile = void 0;
+exports.readFile = readFile;
 /**
  *****************************************
  * 加载依赖
  *****************************************
  */
-const fs = require("fs");
-const stat_1 = require("./stat");
-function readFile(path, encoding) {
-    let stats = (0, stat_1.stat)(path);
-    // 存在文件
-    if (stats && !stats.isDirectory()) {
-        return fs.readFileSync(path, encoding || 'utf8');
-    }
-    // 返回空
-    return '';
+const node_fs_1 = require("node:fs");
+/**
+ *****************************************
+ * 读取文件
+ *****************************************
+ */
+function readFile(path) {
+    return (0, node_fs_1.readFileSync)(path, 'utf8');
 }
-exports.readFile = readFile;
-//# sourceMappingURL=readFile.js.map

package/dist/relative.d.ts

@@ -1,7 +1,18 @@
+/**
+ *****************************************
+ * 判断是否为相对路径
+ *****************************************
+ */
+export declare function isRelative(id: string): boolean;
+/**
+ *****************************************
+ * 获取相对路径
+ *****************************************
+ */
+export declare const relativeFrom: (from: string, to: string) => string;
 /**
  *****************************************
  * 获取相对路径
  *****************************************
  */
 export declare function relative(from: string, to: string): string;
-//# sourceMappingURL=relative.d.ts.map