| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306 |
- import { readdir, readdirSync, realpath, realpathSync, stat, statSync } from "fs";
- import { isAbsolute, posix, resolve } from "path";
- import { fileURLToPath } from "url";
- import { fdir } from "fdir";
- import picomatch from "picomatch";
- //#region src/utils.ts
- const isReadonlyArray = Array.isArray;
- const BACKSLASHES = /\\/g;
- const isWin = process.platform === "win32";
- const ONLY_PARENT_DIRECTORIES = /^(\/?\.\.)+$/;
- function getPartialMatcher(patterns, options = {}) {
- const patternsCount = patterns.length;
- const patternsParts = Array(patternsCount);
- const matchers = Array(patternsCount);
- let i, j;
- for (i = 0; i < patternsCount; i++) {
- const parts = splitPattern(patterns[i]);
- patternsParts[i] = parts;
- const partsCount = parts.length;
- const partMatchers = Array(partsCount);
- for (j = 0; j < partsCount; j++) partMatchers[j] = picomatch(parts[j], options);
- matchers[i] = partMatchers;
- }
- return (input) => {
- const inputParts = input.split("/");
- if (inputParts[0] === ".." && ONLY_PARENT_DIRECTORIES.test(input)) return true;
- for (i = 0; i < patternsCount; i++) {
- const patternParts = patternsParts[i];
- const matcher = matchers[i];
- const inputPatternCount = inputParts.length;
- const minParts = Math.min(inputPatternCount, patternParts.length);
- j = 0;
- while (j < minParts) {
- const part = patternParts[j];
- if (part.includes("/")) return true;
- if (!matcher[j](inputParts[j])) break;
- if (!options.noglobstar && part === "**") return true;
- j++;
- }
- if (j === inputPatternCount) return true;
- }
- return false;
- };
- }
- /* node:coverage ignore next 2 */
- const WIN32_ROOT_DIR = /^[A-Z]:\/$/i;
- const isRoot = isWin ? (p) => WIN32_ROOT_DIR.test(p) : (p) => p === "/";
- function buildFormat(cwd, root, absolute) {
- if (cwd === root || root.startsWith(`${cwd}/`)) {
- if (absolute) {
- const start = cwd.length + +!isRoot(cwd);
- return (p, isDir) => p.slice(start, isDir ? -1 : void 0) || ".";
- }
- const prefix = root.slice(cwd.length + 1);
- if (prefix) return (p, isDir) => {
- if (p === ".") return prefix;
- const result = `${prefix}/${p}`;
- return isDir ? result.slice(0, -1) : result;
- };
- return (p, isDir) => isDir && p !== "." ? p.slice(0, -1) : p;
- }
- if (absolute) return (p) => posix.relative(cwd, p) || ".";
- return (p) => posix.relative(cwd, `${root}/${p}`) || ".";
- }
- function buildRelative(cwd, root) {
- if (root.startsWith(`${cwd}/`)) {
- const prefix = root.slice(cwd.length + 1);
- return (p) => `${prefix}/${p}`;
- }
- return (p) => {
- const result = posix.relative(cwd, `${root}/${p}`);
- return p[p.length - 1] === "/" && result !== "" ? `${result}/` : result || ".";
- };
- }
- const splitPatternOptions = { parts: true };
- function splitPattern(path) {
- var _result$parts;
- const result = picomatch.scan(path, splitPatternOptions);
- return ((_result$parts = result.parts) === null || _result$parts === void 0 ? void 0 : _result$parts.length) ? result.parts : [path];
- }
- const ESCAPED_WIN32_BACKSLASHES = /\\(?![()[\]{}!+@])/g;
- function convertPosixPathToPattern(path) {
- return escapePosixPath(path);
- }
- function convertWin32PathToPattern(path) {
- return escapeWin32Path(path).replace(ESCAPED_WIN32_BACKSLASHES, "/");
- }
- /**
- * Converts a path to a pattern depending on the platform.
- * Identical to {@link escapePath} on POSIX systems.
- * @see {@link https://superchupu.dev/tinyglobby/documentation#convertPathToPattern}
- */
- /* node:coverage ignore next 3 */
- const convertPathToPattern = isWin ? convertWin32PathToPattern : convertPosixPathToPattern;
- const POSIX_UNESCAPED_GLOB_SYMBOLS = /(?<!\\)([()[\]{}*?|]|^!|[!+@](?=\()|\\(?![()[\]{}!*+?@|]))/g;
- const WIN32_UNESCAPED_GLOB_SYMBOLS = /(?<!\\)([()[\]{}]|^!|[!+@](?=\())/g;
- const escapePosixPath = (path) => path.replace(POSIX_UNESCAPED_GLOB_SYMBOLS, "\\$&");
- const escapeWin32Path = (path) => path.replace(WIN32_UNESCAPED_GLOB_SYMBOLS, "\\$&");
- /**
- * Escapes a path's special characters depending on the platform.
- * @see {@link https://superchupu.dev/tinyglobby/documentation#escapePath}
- */
- /* node:coverage ignore next */
- const escapePath = isWin ? escapeWin32Path : escapePosixPath;
- /**
- * Checks if a pattern has dynamic parts.
- *
- * Has a few minor differences with [`fast-glob`](https://github.com/mrmlnc/fast-glob) for better accuracy:
- *
- * - Doesn't necessarily return `false` on patterns that include `\`.
- * - Returns `true` if the pattern includes parentheses, regardless of them representing one single pattern or not.
- * - Returns `true` for unfinished glob extensions i.e. `(h`, `+(h`.
- * - Returns `true` for unfinished brace expansions as long as they include `,` or `..`.
- *
- * @see {@link https://superchupu.dev/tinyglobby/documentation#isDynamicPattern}
- */
- function isDynamicPattern(pattern, options) {
- if ((options === null || options === void 0 ? void 0 : options.caseSensitiveMatch) === false) return true;
- const scan = picomatch.scan(pattern);
- return scan.isGlob || scan.negated;
- }
- function log(...tasks) {
- console.log(`[tinyglobby ${(/* @__PURE__ */ new Date()).toLocaleTimeString("es")}]`, ...tasks);
- }
- function ensureStringArray(value) {
- return typeof value === "string" ? [value] : value !== null && value !== void 0 ? value : [];
- }
- //#endregion
- //#region src/patterns.ts
- const PARENT_DIRECTORY = /^(\/?\.\.)+/;
- const ESCAPING_BACKSLASHES = /\\(?=[()[\]{}!*+?@|])/g;
- function normalizePattern(pattern, opts, props, isIgnore) {
- var _PARENT_DIRECTORY$exe;
- const cwd = opts.cwd;
- let result = pattern;
- if (pattern[pattern.length - 1] === "/") result = pattern.slice(0, -1);
- if (result[result.length - 1] !== "*" && opts.expandDirectories) result += "/**";
- const escapedCwd = escapePath(cwd);
- result = isAbsolute(result.replace(ESCAPING_BACKSLASHES, "")) ? posix.relative(escapedCwd, result) : posix.normalize(result);
- const parentDir = (_PARENT_DIRECTORY$exe = PARENT_DIRECTORY.exec(result)) === null || _PARENT_DIRECTORY$exe === void 0 ? void 0 : _PARENT_DIRECTORY$exe[0];
- const parts = splitPattern(result);
- if (parentDir) {
- const n = (parentDir.length + 1) / 3;
- let i = 0;
- const cwdParts = escapedCwd.split("/");
- while (i < n && parts[i + n] === cwdParts[cwdParts.length + i - n]) {
- result = result.slice(0, (n - i - 1) * 3) + result.slice((n - i) * 3 + parts[i + n].length + 1) || ".";
- i++;
- }
- const potentialRoot = posix.join(cwd, parentDir.slice(i * 3));
- if (potentialRoot[0] !== "." && props.root.length > potentialRoot.length) {
- props.root = potentialRoot;
- props.depthOffset = -n + i;
- }
- }
- if (!isIgnore && props.depthOffset >= 0) {
- var _props$commonPath;
- (_props$commonPath = props.commonPath) !== null && _props$commonPath !== void 0 || (props.commonPath = parts);
- const newCommonPath = [];
- const length = Math.min(props.commonPath.length, parts.length);
- for (let i = 0; i < length; i++) {
- const part = parts[i];
- if (part === "**" && !parts[i + 1]) {
- newCommonPath.pop();
- break;
- }
- if (i === parts.length - 1 || part !== props.commonPath[i] || isDynamicPattern(part)) break;
- newCommonPath.push(part);
- }
- props.depthOffset = newCommonPath.length;
- props.commonPath = newCommonPath;
- props.root = newCommonPath.length > 0 ? posix.join(cwd, ...newCommonPath) : cwd;
- }
- return result;
- }
- function processPatterns(options, patterns, props) {
- const matchPatterns = [];
- const ignorePatterns = [];
- for (const pattern of options.ignore) {
- if (!pattern) continue;
- if (pattern[0] !== "!" || pattern[1] === "(") ignorePatterns.push(normalizePattern(pattern, options, props, true));
- }
- for (const pattern of patterns) {
- if (!pattern) continue;
- if (pattern[0] !== "!" || pattern[1] === "(") matchPatterns.push(normalizePattern(pattern, options, props, false));
- else if (pattern[1] !== "!" || pattern[2] === "(") ignorePatterns.push(normalizePattern(pattern.slice(1), options, props, true));
- }
- return {
- match: matchPatterns,
- ignore: ignorePatterns
- };
- }
- //#endregion
- //#region src/crawler.ts
- function buildCrawler(options, patterns) {
- const cwd = options.cwd;
- const props = {
- root: cwd,
- depthOffset: 0
- };
- const processed = processPatterns(options, patterns, props);
- if (options.debug) log("internal processing patterns:", processed);
- const { absolute, caseSensitiveMatch, debug, dot, followSymbolicLinks, onlyDirectories } = options;
- const root = props.root.replace(BACKSLASHES, "");
- const matchOptions = {
- dot,
- nobrace: options.braceExpansion === false,
- nocase: !caseSensitiveMatch,
- noextglob: options.extglob === false,
- noglobstar: options.globstar === false,
- posix: true
- };
- const matcher = picomatch(processed.match, matchOptions);
- const ignore = picomatch(processed.ignore, matchOptions);
- const partialMatcher = getPartialMatcher(processed.match, matchOptions);
- const format = buildFormat(cwd, root, absolute);
- const excludeFormatter = absolute ? format : buildFormat(cwd, root, true);
- const excludePredicate = (_, p) => {
- const relativePath = excludeFormatter(p, true);
- return relativePath !== "." && !partialMatcher(relativePath) || ignore(relativePath);
- };
- let maxDepth;
- if (options.deep !== void 0) maxDepth = Math.round(options.deep - props.depthOffset);
- const crawler = new fdir({
- filters: [debug ? (p, isDirectory) => {
- const path = format(p, isDirectory);
- const matches = matcher(path) && !ignore(path);
- if (matches) log(`matched ${path}`);
- return matches;
- } : (p, isDirectory) => {
- const path = format(p, isDirectory);
- return matcher(path) && !ignore(path);
- }],
- exclude: debug ? (_, p) => {
- const skipped = excludePredicate(_, p);
- log(`${skipped ? "skipped" : "crawling"} ${p}`);
- return skipped;
- } : excludePredicate,
- fs: options.fs,
- pathSeparator: "/",
- relativePaths: !absolute,
- resolvePaths: absolute,
- includeBasePath: absolute,
- resolveSymlinks: followSymbolicLinks,
- excludeSymlinks: !followSymbolicLinks,
- excludeFiles: onlyDirectories,
- includeDirs: onlyDirectories || !options.onlyFiles,
- maxDepth,
- signal: options.signal
- }).crawl(root);
- if (options.debug) log("internal properties:", {
- ...props,
- root
- });
- return [crawler, cwd !== root && !absolute && buildRelative(cwd, root)];
- }
- //#endregion
- //#region src/index.ts
- function formatPaths(paths, mapper) {
- if (mapper) for (let i = paths.length - 1; i >= 0; i--) paths[i] = mapper(paths[i]);
- return paths;
- }
- const defaultOptions = {
- caseSensitiveMatch: true,
- cwd: process.cwd(),
- debug: !!process.env.TINYGLOBBY_DEBUG,
- expandDirectories: true,
- followSymbolicLinks: true,
- onlyFiles: true
- };
- function getOptions(options) {
- const opts = {
- ...defaultOptions,
- ...options
- };
- opts.cwd = (opts.cwd instanceof URL ? fileURLToPath(opts.cwd) : resolve(opts.cwd)).replace(BACKSLASHES, "/");
- opts.ignore = ensureStringArray(opts.ignore);
- opts.fs && (opts.fs = {
- readdir: opts.fs.readdir || readdir,
- readdirSync: opts.fs.readdirSync || readdirSync,
- realpath: opts.fs.realpath || realpath,
- realpathSync: opts.fs.realpathSync || realpathSync,
- stat: opts.fs.stat || stat,
- statSync: opts.fs.statSync || statSync
- });
- if (opts.debug) log("globbing with options:", opts);
- return opts;
- }
- function getCrawler(globInput, inputOptions = {}) {
- var _ref;
- if (globInput && (inputOptions === null || inputOptions === void 0 ? void 0 : inputOptions.patterns)) throw new Error("Cannot pass patterns as both an argument and an option");
- const isModern = isReadonlyArray(globInput) || typeof globInput === "string";
- const patterns = ensureStringArray((_ref = isModern ? globInput : globInput.patterns) !== null && _ref !== void 0 ? _ref : "**/*");
- const options = getOptions(isModern ? inputOptions : globInput);
- return patterns.length > 0 ? buildCrawler(options, patterns) : [];
- }
- async function glob(globInput, options) {
- const [crawler, relative] = getCrawler(globInput, options);
- return crawler ? formatPaths(await crawler.withPromise(), relative) : [];
- }
- function globSync(globInput, options) {
- const [crawler, relative] = getCrawler(globInput, options);
- return crawler ? formatPaths(crawler.sync(), relative) : [];
- }
- //#endregion
- export { convertPathToPattern, escapePath, glob, globSync, isDynamicPattern };
|