Awesome Open Source
Awesome Open Source


NPM downloads npm Build Status Coverage Status license github-issues stars forks

Flexible and fluent interface for searching the file system


npm install --save filehound



The example below prints all of the files in a directory that have the .json file extension:

const FileHound = require('filehound');

const files = FileHound.create()



For more examples and API details, see API documentation


npm test

To generate a test coverage report:

npm run coverage


  • If you're unsure if a feature would make a good addition, you can always create an issue first.
  • We aim for 100% test coverage. Please write tests for any new functionality or changes.
  • Any API changes should be fully documented.
  • Make sure your code meets our linting standards. Run npm run lint to check your code.
  • Maintain the existing coding style. There are some settings in .jsbeautifyrc to help.
  • Be mindful of others when making suggestions and/or code reviewing.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
javascript (63,988
promise (188
filesystem (172
file (121
fluent-interface (17

Find Open Source By Browsing 7,000 Topics Across 59 Categories