Deukhoofd 95cff6f702 | ||
---|---|---|
.. | ||
node_modules | ||
LICENSE | ||
README.md | ||
index.js | ||
package.json |
README.md
glob-stream
A wrapper around node-glob to make it streamy.
Usage
var gs = require('glob-stream');
var stream = gs.create('./files/**/*.coffee', { /* options */ });
stream.on('data', function(file){
// file has path, base, and cwd attrs
});
You can pass any combination of globs. One caveat is that you can not only pass a glob negation, you must give it at least one positive glob so it knows where to start. All given must match for the file to be returned.
API
create(globs, options)
Returns a stream for multiple globs or filters.
createStream(positiveGlob, negativeGlobs, options)
Returns a stream for a single glob or filter.
Options
- cwd
- Default is
process.cwd()
- Default is
- base
- Default is everything before a glob starts (see glob-parent)
- cwdbase
- Default is
false
- When true it is the same as saying opt.base = opt.cwd
- Default is
- allowEmpty
- Default is
false
- If true, won't emit an error when a glob pointing at a single file fails to match
- Default is
- Any through2 related options are documented in through2
This argument is passed directly to node-glob so check there for more options
Glob
var stream = gs.create(['./**/*.js', '!./node_modules/**/*']);
Globs are executed in order, so negations should follow positive globs. For example:
gulp.src(['!b*.js', '*.js'])
would not exclude any files, but this would
gulp.src(['*.js', '!b*.js'])
Related
- globby - Non-streaming
glob
wrapper with support for multiple patterns.
License
MIT