Skip to content

Deeply lists a directory filtering files by given pattern(s)

License

Notifications You must be signed in to change notification settings

devtin/deep-list-dir

Repository files navigation

deep-list-dir

Deeply lists a directory filtering files by given pattern(s)

Version tests

This module recursively lists all files in given directory (including sub-folders) by early filtering the results using the given pattern which can be an array of minimatch expressions or RegExp.

It will return all matching results. minimatch negative patterns are used to explicitly exclude a path from being scan / returned.

Example

Take the following file structure:

<directory>
├── dir1
│   └── README.md
├── dir2
│   └── sub-dir2
│       ├── hi.txt
│       └── index.js
├── index.js
└── README.md

...and the following script:

const { deepListDir, deepListDirSync } = require('deep-list-dir')

deepListDir('<directory>',
  {
    pattern: ['*.md'], // minimatch or RegExp
    // base: '', set parent base to something different than given directory
    // minimatchOptions: { matchBase: true } // minimatch options
  }
).then(console.log)

Will output

[
  "dir1/README.md",
  "README.md"
]

A sync version is also provided:

console.log(deepListDirSync('<directory>', { pattern: '*.js'})) 

Output:

[
  "dir2/sub-dir2/index.js",
  "index.js"
]

License

MIT

© 2020-present Martin Rafael Gonzalez [email protected]

About

Deeply lists a directory filtering files by given pattern(s)

Resources

License

Stars

Watchers

Forks

Packages

No packages published