tinyglobby

A fast and minimal alternative to globby and fast-glob, meant to behave the same way.

Both globby and fast-glob present some behavior no other globbing lib has, which makes it hard to manually replace with something smaller and better.

This library uses only two subdependencies, compared to globby's 23 and fast-glob's 17.

Usage

import { glob, globSync } from 'tinyglobby';

await glob(['files/*.ts', '!**/*.d.ts'], { cwd: 'src' });
globSync('src/**/*.ts', { ignore: '**/*.d.ts' });

API

• glob(patterns: string | string[], options: GlobOptions): Promise<string[]>: Returns a promise with an array of matches.
• globSync(patterns: string | string[], options: GlobOptions): string[]: Returns an array of matches.
• convertPathToPattern(path: string): string: Converts a path to a pattern depending on the platform.
• escapePath(path: string): string: Escapes a path's special characters depending on the platform.
• isDynamicPattern(pattern: string, options?: GlobOptions): boolean: Checks if a pattern is dynamic.

Options

• absolute: Whether to return absolute paths. Defaults to false.
• caseSensitiveMatch: Whether to match in case-sensitive mode. Defaults to true.
• cwd: The current working directory in which to search. Defaults to process.cwd().
• debug: Enable debug logs. Useful for development purposes.
• dot: Whether to allow entries starting with a dot. Defaults to false.
• deep: Maximum depth of a directory. Defaults to Infinity.
• expandDirectories: Whether to expand directories. Disable to best match fast-glob. Defaults to true.
• followSymbolicLinks: Whether to traverse and include symbolic links. Defaults to true.
• globstar: Enables support for matching nested directories with globstars (**). If false, ** behaves exactly like *. Defaults to true.
• ignore: An array of glob patterns to ignore.
• onlyDirectories: Enable to only return directories. Disables onlyFiles if set. Defaults to false.
• onlyFiles: Enable to only return files. Defaults to true.
• signal: An AbortSignal to abort crawling the file system.

Used by

tinyglobby is downloaded many times by projects all around the world. Here's a partial list of notable projects that use it:

• vite
• pnpm
• node-gyp
• eslint-import-resolver-typescript
• vitest
• copy-webpack-plugin
• storybook
• ts-morph
• nx
• sort-package-json
• unimport
• tsup
• lerna
• cspell
• nuxt
• postcss-mixins
• astro
• unocss
• vitepress
• pkg-pr-new
• Your own project? Open an issue if you feel like this list is incomplete.