@ainc/fs 0.1.15 → 0.1.17

package/src/includePaths.ts

@@ -1,62 +0,0 @@
-/**
- *****************************************
- * Created by edonet@163.com
- * Created on 2021-05-25 22:34:41
- *****************************************
- */
-'use strict';
-
-
-/**
- *****************************************
- * 加载依赖
- *****************************************
- */
-import { resolve, sep } from 'path';
-import { isAbsolutePath } from './isAbsolutePath';
-import { isRelativePath } from './isRelativePath';
-
-
-/**
- *****************************************
- * 解析路径别名
- *****************************************
- */
-export function includePaths(paths: string[]): (source: string) => boolean {
-    const rules = paths.map(value => {
-
-        // 处理相对路径
-        if (isRelativePath(value)) {
-            value = resolve(value);
-        }
-
-        // 处理组对目录
-        if (isAbsolutePath(value)) {
-            const prefix = value + sep;
-
-            // 添加匹配规则
-            return (source: string) => source === value || source.startsWith(prefix);
-        }
-
-        // 切分路径分段
-        const chunks = value.split('/');
-
-        // 生成匹配函数
-        return (source: string) => {
-            const list = source.split(sep);
-
-            // 匹配是否包含路径
-            for (let idx = 0, len = list.length - chunks.length + 1; idx < len; idx ++) {
-                if (chunks.every((chunk, offset) => chunk === list[idx + offset])) {
-                    return true;
-                }
-            }
-
-            // 匹配失败
-            return false;
-        };
-    });
-
-    // 返回匹配函数
-    return (source: string) => rules.some(rule => rule(source));
-}

package/src/index.ts

@@ -1,52 +0,0 @@
-/**
- *****************************************
- * Created by edonet@163.com
- * Created on 2019-11-07 15:59:39
- *****************************************
- */
-'use strict';
-
-
-/**
- *****************************************
- * 抛出模块
- *****************************************
- */
-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 { 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';

package/src/indir.ts

@@ -1,45 +0,0 @@
-/**
- *****************************************
- * Created by edonet@163.com
- * Created on 2021-03-20 22:17:38
- *****************************************
- */
-'use strict';
-
-
-/**
- *****************************************
- * 加载依赖
- *****************************************
- */
-import * as path from 'path';
-
-
-/**
- *****************************************
- * 判断是否在目录内
- *****************************************
- */
-function indir(dir: string): (file: string) => boolean;
-function indir(dir: string, file: string): boolean;
-function indir(dir: string, file?: string): boolean | ((file: string) => boolean) {
-
-    // 解析目录
-    dir = path.resolve(dir) + path.sep;
-
-    // 匹配文件
-    if (typeof file === 'string') {
-        return path.resolve(file).startsWith(dir);
-    }
-
-    // 返回匹配函数
-    return (file: string) => path.resolve(file).startsWith(dir);
-}
-
-
-/**
- *****************************************
- * 抛出接口
- *****************************************
- */
-export { indir };

package/src/isAbsolutePath.ts

@@ -1,25 +0,0 @@
-/**
- *****************************************
- * Created by edonet@163.com
- * Created on 2021-05-25 22:23:32
- *****************************************
- */
-'use strict';
-
-
-/**
- *****************************************
- * 加载依赖
- *****************************************
- */
-import * as path from 'path';
-
-
-/**
- *****************************************
- * 判断是否为绝对路径
- *****************************************
- */
-export function isAbsolutePath(source: string): boolean {
-    return path.isAbsolute(source);
-}

package/src/isDirectory.ts

@@ -1,28 +0,0 @@
-/**
- *****************************************
- * Created by edonet@163.com
- * Created on 2019-11-07 16:15:04
- *****************************************
- */
-'use strict';
-
-
-/**
- *****************************************
- * 加载依赖
- *****************************************
- */
-import { stat } from './stat';
-
-
-/**
- *****************************************
- * 判断是否为文件夹
- *****************************************
- */
-export function isDirectory(dir: string): ReturnType<typeof stat> {
-    const stats = stat(dir);
-
-    // 返回状态判断
-    return stats && stats.isDirectory() ? stats : null;
-}

package/src/isRelativePath.ts

@@ -1,52 +0,0 @@
-/**
- *****************************************
- * Created by edonet@163.com
- * Created on 2021-05-25 22:23:32
- *****************************************
- */
-'use strict';
-
-
-/**
- *****************************************
- * 加载依赖
- *****************************************
- */
-import { sep } from 'path';
-
-
-/**
- *****************************************
- * 判断是否为路径分隔符
- *****************************************
- */
-function isSep(ch: string): boolean {
-
-    // 模块相对标识
-    if (ch === '/' || ch === '') {
-        return true;
-    }
-
-    // 路径相对标识
-    return ch === sep;
-}
-
-
-/**
- *****************************************
- * 判断是否为相对路径
- *****************************************
- */
-export function isRelativePath(source: string): boolean {
-
-    // 非相对标识
-    if (source.charAt(0) !== '.') {
-        return false;
-    }
-
-    // 位1字符
-    const ch1 = source.charAt(1);
-
-    // 非相对路径
-    return ch1 === '.' ? isSep(source.charAt(2)) : isSep(ch1);
-}

package/src/json.ts

@@ -1,62 +0,0 @@
-/**
- *****************************************
- * Created by edonet@163.com
- * Created on 2019-11-07 21:27:52
- *****************************************
- */
-'use strict';
-
-
-/**
- *****************************************
- * 加载依赖
- *****************************************
- */
-import { stat } from './stat';
-import { readFile } from './readFile';
-import { writeFile } from './writeFile';
-import { stripBOM } from './helpers/stripBOM';
-
-
-/**
- *****************************************
- * 数据接口
- *****************************************
- */
-interface Data {
-    [key: string]: unknown;
-}
-
-
-/**
- *****************************************
- * 读取/写入【json】文件
- *****************************************
- */
-function json<T = Data>(path: string): T | null;
-function json<T = Data>(path: string, data: T): T;
-function json<T = Data>(...args: [string] | [string, T]): T | null {
-    const [name, data] = args;
-
-    // 读写数据
-    if (args.length > 1) {
-        writeFile(name, JSON.stringify(data));
-    } else {
-        const stats = stat(name);
-
-        if (stats && stats.isFile()) {
-            return JSON.parse(stripBOM(readFile(stats.path)));
-        }
-    }
-
-    // 返回数据
-    return data || null;
-}
-
-
-/**
- *****************************************
- * 抛出接口
- *****************************************
- */
-export { json };

package/src/jsonc.ts

@@ -1,70 +0,0 @@
-/**
- *****************************************
- * Created by edonet@163.com
- * Created on 2019-11-07 21:27:52
- *****************************************
- */
-'use strict';
-
-
-/**
- *****************************************
- * 加载依赖
- *****************************************
- */
-import { stat } from './stat';
-import { readFile } from './readFile';
-import { writeFile } from './writeFile';
-import { stripComments } from './helpers/stripComments';
-
-
-/**
- *****************************************
- * 数据接口
- *****************************************
- */
-interface Data {
-    [key: string]: unknown;
-}
-
-
-/**
- *****************************************
- * 读取/写入【jsonc】文件
- *****************************************
- */
-function jsonc<T = Data>(path: string): T | null;
-function jsonc<T = Data>(path: string, data: T): T;
-function jsonc<T = Data>(...args: [string] | [string, T]): T | null {
-    const [name, data] = args;
-
-    // 读写数据
-    if (args.length > 1) {
-        writeFile(name, JSON.stringify(data));
-    } else {
-        const stats = stat(name);
-
-        if (stats && stats.isFile()) {
-            const content = stripComments(readFile(stats.path));
-
-            // 空白文件
-            if (!content.trim()) {
-                return null;
-            }
-
-            // 解析文件
-            return JSON.parse(content);
-        }
-    }
-
-    // 返回数据
-    return data || null;
-}
-
-
-/**
- *****************************************
- * 抛出接口
- *****************************************
- */
-export { jsonc };

package/src/lstat.ts

@@ -1,40 +0,0 @@
-/**
- *****************************************
- * Created by edonet@163.com
- * Created on 2019-11-07 16:06:57
- *****************************************
- */
-'use strict';
-
-
-/**
- *****************************************
- * 加载依赖
- *****************************************
- */
-import * as fs from 'fs';
-import * as path from 'path';
-
-
-/**
- *****************************************
- * 状态
- *****************************************
- */
-interface State extends fs.Stats {
-    path: string;
-}
-
-
-/**
- *****************************************
- * 获取文件状态
- *****************************************
- */
-export function lstat(dir: string): State | null {
-    try {
-        return Object.assign(fs.lstatSync(dir), { path: path.resolve(dir) });
-    } catch (err) {
-        return null;
-    }
-}

package/src/mapdir.ts

@@ -1,59 +0,0 @@
-/**
- *****************************************
- * Created by edonet@163.com
- * Created on 2019-11-09 16:35:57
- *****************************************
- */
-'use strict';
-
-
-/**
- *****************************************
- * 加载依赖
- *****************************************
- */
-import * as fs from 'fs';
-import * as path from 'path';
-import { stat } from './stat';
-
-
-/**
- *****************************************
- * 遍历回调
- *****************************************
- */
-interface Handler<T> {
-    (path: string, stats: fs.Stats): T;
-}
-
-
-/**
- *****************************************
- * 遍历目录
- *****************************************
- */
-export function mapdir<T>(dir: string, handler: Handler<T>): T[] {
-    let stats = stat(dir),
-        result: T[] = [];
-
-    // 存在目录
-    if (stats) {
-        let dirname = stats.path,
-            ignore = ['node_modules', '.DS_Store'];
-
-        // 遍历子文件
-        if (stats.isDirectory()) {
-            fs.readdirSync(stats.path).forEach(name => {
-                if (!ignore.includes(name)) {
-                    result.push(...mapdir(path.join(dirname, name), handler));
-                }
-            });
-        }
-
-        // 执行回调
-        result.push(handler(dirname, stats));
-    }
-
-    // 返回结果
-    return result;
-}

package/src/mkdir.ts

@@ -1,43 +0,0 @@
-/**
- *****************************************
- * Created by edonet@163.com
- * Created on 2019-11-07 16:48:57
- *****************************************
- */
-'use strict';
-
-
-/**
- *****************************************
- * 加载依赖
- *****************************************
- */
-import * as fs from 'fs';
-import * as path from 'path';
-import { isDirectory } from './isDirectory';
-import { dirname } from './dirname';
-
-
-/**
- *****************************************
- * 创建目录
- *****************************************
- */
-export function mkdir(dir: string): string {
-
-    // 解析目录
-    dir = path.resolve(dir);
-
-    // 创建目录
-    if (!isDirectory(dir)) {
-
-        // 创建上级目录
-        mkdir(dirname(dir));
-
-        // 创建目录
-        fs.mkdirSync(dir);
-    }
-
-    // 返回目录
-    return dir;
-}

package/src/parseJSON.ts

@@ -1,40 +0,0 @@
-/**
- *****************************************
- * Created by edonet@163.com
- * Created on 2022-01-01 21:01:19
- *****************************************
- */
-'use strict';
-
-
-/**
- *****************************************
- * 加载依赖
- *****************************************
- */
-import { stripBOM } from './helpers/stripBOM';
-import { stripComments } from './helpers/stripComments';
-
-
-/**
- *****************************************
- * 选项
- *****************************************
- */
-interface Options {
-    comments?: boolean;
-}
-
-
-/**
- *****************************************
- * 解析【JSON】文件
- *****************************************
- */
-export function parseJSON<T>(content: string, options: Options = {}): T {
-    const normalized = options.comments ? stripComments(content) : stripBOM(content);
-    const source = normalized.trim();
-
-    // 解析内容
-    return source ? JSON.parse(source) : undefined;
-}

package/src/readFile.ts

@@ -1,64 +0,0 @@
-/**
- *****************************************
- * Created by edonet@163.com
- * Created on 2019-11-07 16:27:01
- *****************************************
- */
-'use strict';
-
-
-/**
- *****************************************
- * 加载依赖
- *****************************************
- */
-import * as fs from 'fs';
-import { stat } from './stat';
-
-
-/**
- *****************************************
- * 编码类型
- *****************************************
- */
-type Encoding = 'ascii' | 'utf8' | 'utf-8' | 'utf16le' | 'ucs2' | 'ucs-2' | 'base64' | 'latin1' | 'binary' | 'hex';
-
-
-/**
- *****************************************
- * 配置
- *****************************************
- */
-interface Options {
-    encoding?: Encoding;
-    flag?: string;
-}
-
-
-/**
- *****************************************
- * 读取文件
- *****************************************
- */
-function readFile(path: string): string;
-function readFile(path: string, encoding: Encoding): string;
-function readFile(path: string, options: Options): string;
-function readFile(path: string, encoding?: Encoding | Options): string {
-    let stats = stat(path);
-
-    // 存在文件
-    if (stats && !stats.isDirectory()) {
-        return fs.readFileSync(path, encoding as Encoding || 'utf8');
-    }
-
-    // 返回空
-    return '';
-}
-
-
-/**
- *****************************************
- *
- *****************************************
- */
-export { readFile };

package/src/readStream.ts

@@ -1,53 +0,0 @@
-/**
- *****************************************
- * Created by edonet@163.com
- * Created on 2021-05-22 11:41:18
- *****************************************
- */
-'use strict';
-
-
-/**
- *****************************************
- * 加载依赖
- *****************************************
- */
-import * as fs from 'fs';
-
-
-/**
- *****************************************
- * 配置
- *****************************************
- */
-export interface Options {
-    flags?: string | undefined;
-    encoding?: BufferEncoding | undefined;
-    fd?: number | undefined;
-    mode?: number | undefined;
-    autoClose?: boolean | undefined;
-    emitClose?: boolean | undefined;
-    start?: number | undefined;
-    end?: number | undefined;
-    highWaterMark?: number | undefined;
-}
-
-
-/**
- *****************************************
- * 创建可读流
- *****************************************
- */
-function readStream(path: string, encoding?: BufferEncoding): fs.ReadStream;
-function readStream(path: string, options?: Options): fs.ReadStream;
-function readStream(path: string, options?: BufferEncoding | Options): fs.ReadStream {
-    return fs.createReadStream(path, options);
-}
-
-
-/**
- *****************************************
- * 抛出接口
- *****************************************
- */
-export { readStream };