gulp-filter

Filter files in a vinyl stream

npm install gulp-filter
147 downloads in the last day
940 downloads in the last week
3 386 downloads in the last month

gulp-filter Build Status

Filter files in a vinyl stream

Enables you to work on a subset of the original files by filtering them using globbing. When you're done and want all the original files back you just call the restore method.

Install

$ npm install --save-dev gulp-filter

Usage

Simple

var gulp = require('gulp');
var jscs = require('gulp-jscs');
var gulpFilter = require('gulp-filter');

var filter = gulpFilter('!src/vendor');

gulp.task('default', function () {
    return gulp.src('src/*.js')
        // filter a subset of the files
        .pipe(filter)
        // run them through a plugin
        .pipe(jscs())
        // bring back the previously filtered out files (optional)
        .pipe(filter.restore())
        .pipe(gulp.dest('dist'));
});

Multiple filters

By combining and restoring different filters you can process different sets of files with a single pipeline.

var gulp = require('gulp');
var less = require('gulp-less');
var concat = require('gulp-concat');
var gulpFilter = require('gulp-filter');

var jsFilter = gulpFilter('**/*.js');
var lessFilter = gulpFilter('**/*.less');

gulp.task('default', function () {
    gulp.src('assets/**')
        .pipe(jsFilter)
        .pipe(concat("bundle.js"))
        .pipe(jsFilter.restore())
        .pipe(lessFilter)
        .pipe(less())
        .pipe(lessFilter.restore())
        .pipe(gulp.dest('out/'));
});

Restore as a file source

You may also want to restore filtered files in a different place and use it as a standalone source of files. The end option allow you to do so.

var gulp = require('gulp');
var jscs = require('gulp-jscs');
var gulpFilter = require('gulp-filter');

var filter = gulpFilter('!src/vendor');

gulp.task('default', function () {
    gulp.src('src/*.js')
        // filter a subset of the files
        .pipe(filter)
        // run them through a plugin
        .pipe(jscs())
        .pipe(gulp.dest('dist'));

    // use filtered files as a gulp file source
    filter.restore({end: true})
          .pipe(gulp.dest('vendor-dist'));
});

API

filter(pattern, options)

Returns a transform stream with a .restore() method.

pattern

Type: String|Array|Function

Accepts a string/array with globbing patterns which are run through multimatch.

If you supply a function you'll get a vinyl file object as the first argument and you're expected to return true/false whether to include the file:

filter(function (file) {
    return /unicorns/.test(file.path);
});

options

Type: Object

Accepts minimatch options.

Note: Set dot: true if you need to match files prefixed with a dot (eg. .gitignore).

stream.restore(options)

Brings back the previously filtered out files.

options.end

Type: boolean
Default: false

Set to true if you want restore streams to end when their source stream ends.

License

MIT © Sindre Sorhus

npm loves you