applies a glob pattern to a set of files *after* excluding specific subfolders
Last updated 2 years ago by arobson .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install globulesce 
SYNC missed versions from official npm registry.


Need a list of files matching a set of glob patterns? Need to exclude certain subfolders? Need it fast? Try globulesce! It's as fast as its name is gross.

Build Status Coverage Status

Fully async, promise based API.


###( path, match, ignore, { options } )

path the directory to start scanning in (this is inclusive).

match a glob string or an array of glob strings to match files against.

ignore a directory or list of directories to ignore. This defaults to [ '.git', 'node_modules' ]. If you'd like those folders included, provide an empty array.

options a set of optional flags to include. directories is a boolean that can be included to return directories instead of files.

var glob = require( 'globulesce' );

var files = glob( './', [ '**/*.js' ], [ '.git', 'node_modules' ] );

The ignore directory ignores all directories with a matching name regardless of depth

For my purposes, when I need to ignore a directory, I always want to ignore it. This may not be helpful. If you need different behavior, send a PR :D


This library does almost nothing and relies almost entirely on

  • minimatch

Why Reinvent The Wheel!?

I needed a way to scan a directory tree for files that wouldn't first eagerly scan .git and node_modules. There are several NPM libs that promise to do this but don't. The end result is that you wait a few seconds whilst they tear through an entire tree and then proceed to toss a bunch of results out (or don't even do that).

None of my specific use cases care about what are in .git or node_modules and are time sensitive.

Current Tags

  • 1.0.0                                ...           latest (2 years ago)

8 Versions

  • 1.0.0                                ...           2 years ago
  • 0.1.6                                ...           3 years ago
  • 0.1.5                                ...           4 years ago
  • 0.1.4                                ...           5 years ago
  • 0.1.3                                ...           5 years ago
  • 0.1.2                                ...           5 years ago
  • 0.1.1                                ...           5 years ago
  • 0.1.0                                ...           5 years ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 1
Dependencies (1)
Dev Dependencies (8)

Copyright 2014 - 2017 © |