gulp-filter

Filter files in a vinyl stream

gulp-filter

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 use the restore stream.

$ npm install --save-dev gulp-filter

You may want to just filter the stream content:

var gulp = require('gulp');
var jscs = require('gulp-jscs');
var gulpFilter = require('gulp-filter');
 
gulp.task('default', function () {
    // create filter instance inside task function 
    var filter = gulpFilter(['*', '!src/vendor']);
 
    return gulp.src('src/*.js')
        // filter a subset of the files 
        .pipe(filter)
        // run them through a plugin 
        .pipe(jscs())
        .pipe(gulp.dest('dist'));
});
var gulp = require('gulp');
var jscs = require('gulp-jscs');
var gulpFilter = require('gulp-filter');
 
gulp.task('default', function () {
    // create filter instance inside task function 
    var filter = gulpFilter(['*', '!src/vendor'], {restore: true});
 
    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'));
});

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');
 
gulp.task('default', function () {
    var jsFilter = gulpFilter('**/*.js', {restore: true});
    var lessFilter = gulpFilter('**/*.less', {restore: true});
 
    return gulp.src('assets/**')
        .pipe(jsFilter)
        .pipe(concat('bundle.js'))
        .pipe(jsFilter.restore)
        .pipe(lessFilter)
        .pipe(less())
        .pipe(lessFilter.restore)
        .pipe(gulp.dest('out/'));
});

You can restore filtered files in a different place and use it as a standalone source of files (ReadableStream). Setting the passthrough option to false allows you to do so.

var gulp = require('gulp');
var jscs = require('gulp-jscs');
var gulpFilter = require('gulp-filter');
 
gulp.task('default', function () {
    var filter = gulpFilter(['*', '!src/vendor'], {restore: true, passthrough: false});
 
    var stream = 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.pipe(gulp.dest('vendor-dist'));
 
    return stream;
});

Returns a transform stream with a .restore object.

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);
});

Type: object

Accepts minimatch options.

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

Type: boolean Default: false

Restore filtered files.

Type: boolean Default: true

When set to true filtered files are restored with a PassThrough stream, otherwise, when set to false, filtered files are restored as a Readable stream.

When the stream is Readable it ends by itself, but when PassThrough, you are responsible of ending the stream.

MIT © Sindre Sorhus