gulp-each

gulp-each

A for-each for Gulp that exposes the actual content of the file.

I have had to write this code many times because I wanted a "one-off" task that does "somthing quick" to each file. Or, I have wanted to write literally any module that processes code files, and had to start anew every time and figure out this logic.

Most other for-each implementations for Gulp expose the stream (of buffer) object, requiring the user to read the stream (or buffer) and write out a new stream (or buffer). Yes, I used the most annoying way to word that on purpose. This module exposes the content of the file itself, so you can directly start manipulating the content (e.g. code) directly, without worrying about the Gulp plumbing.

Download

npm install gulp-each

Usage

var each = require('gulp-each');

gulp.task('mytask', function() {
    gulp.src('*.js')
        .pipe(each(function(content, file, callback) {
            // content is a string containing the code
            // do with it as you'd like
            var newContent = '// my comment\n' + content;
            
            // file is the original Vinyl file object
            
            // return the new content using the callback
            // the first argument is an error, if you encounter one
            callback(null, newContent);
        })
        .pipe(gulp.dest('output'));
});

Note: it's worth saying that this implementation of for-each is most valuable when working with text files. It may not function as expected when working with binary files.