smart-glob

Smart glob that can ignore files

Usage no npm install needed!

<script type="module">
  import smartGlob from 'https://cdn.skypack.dev/smart-glob';
</script>

README

smart-glob

smart-glob exports 2 functions

  • globWithGit uses the git cache to search for files, the search time should be constant (around 40ms)
  • glob does a normal glob search, it also can ignore directories in the ignore field

Both functions are tested in unix and windows environments (in windows return paths with \\ delimiter unless alwaysReturnUnixPaths is provided)

In bump-version github action i reduced the glob search time form 50 seconds down to 13 seconds using glob and to 0.5 seconds using globWithGit

npm i smart-glob

Usage

import { glob, globWithGit } from 'smart-glob'

const paths = await globWithGit(path.resolve('./tests/**.ts'), {
    cwd: './someFolder',
    // ignore patterns in gitignore
    gitignore: true,
    // output paths are absolute paths
    absolute: true,
    // ignore certain directories
    ignoreGlobs: ['**/dir/**'],
})

const files = await glob('**', {
    gitignore: true, // add the ignore from the .gitignore in current path
    filesOnly: true,
    ignore: ['node_modules'],
})

Cli

npm i -g smart-glob
smart-glob './tests/**/*.tsx'

Benchmark

Here is a benchmark with other globs solutions run on this package folder ignoring the node_modules directory

You can find this benchmark in the /tests folder

benchmarks

tiny-glob: 360.615ms
    ✓ tiny-glob (361ms)
fast-glob: 14.863ms
    ✓ fast-glob
globby: 18.128ms
    ✓ globby
glob: 930.975ms
    ✓ glob (931ms)
smart-glob: 6.296ms
    ✓ smart-glob
smart-glob using git: 54.845ms
    ✓ smart-glob using git (55ms)