gulp-async-func-runner

A gulp task for running asynchronous functions.

Usage

This gulp task expects an options object, an asynchronous function and a callback function. The task runs the asynchronous function passing it the options, a chunk of data, and the callback function.

As a gulp task

Use the task to execute an asynchronous function within a gulp pipe.

var asyncPipe = require('gulp-async-func-runner');
gulp.src('test/*')
    .pipe(asyncPipe(
        opts,
        asyncFunc,
        callback)
    );

API

gulp-async-func-runner ⇒ through2

A gulp task for running asynchronous functions. Returns: through2 - readable-stream/transform

Param	Type	Default	Description
opts	Object		optional options. Options to be passed to the task function should be provided in this object.
[opts.oneTimeRun]	Object	false	flag to run the task only once no matter how many data chunks are passed through the stream
[opts.passThrough]	Object	false	flag to pass data chunks through without modification. Default behaviour is to stream the data transformed by the asynchronous function. Set to passThrough to true if you only want to use the results of the asynchronous function as part of the done callback function.
task	function		the asynchronous task to call and wait for callback to be executed. The task must be a function with the following signature: task(options, chunk, enc, callback) - options {Object} - an options object. This will be passed the opts parameter from this module. - chunk {Object} - the current chunk of data passing through stream. - callback - the callback function to be executed once task complete. The callback function has the following signature: callback(error, data). This will be passed the done parameter from this module which must have a matching signature.
done	function		the callback function called once the asynchronous task has completed. The function must have the following signature: done(error, data).

Example
Usage:

var asyncPipe = require('gulp-async-func-runner');

Given a simple asynchronous function:

var asyncFunc = function (opts, cb) {
    assert.equal(opts.testOpt, "test option");
    cb(false, "test data");
};

When executing the function as part of a gulp pipe:

var opts = {
    oneTimeRun: true,
    passThrough: true,
    testOpt: "test option"
};
gulp.src('test/*')
    .pipe(asyncPipe(
        opts,
        function(opts, chunk, cb) {
            asyncFunc(opts, cb); //wrap in function to match the function signature
        },
        function (error, data) {
            //results of the asynchronous function available on data parameter
            ...
        })
    );

Then the pipe will wait for function to complete before continuing:

gulp.src('test/*')
    .pipe(asyncPipe(
        ...
    )
    .on('finish', function(){
        //pipe will not finish before the results of the asynchronous function are available
        ...
    });

documented by jsdoc-to-markdown.

Changelog

	Type	ID	Summary
Version: 0.1.10 - released 2015-08-23
	Non-functional	MDGASYNC-20	Package: Remove node_modules packages from repository
Version: 0.1.9 - released 2015-08-23
	Non-functional	MDGASYNC-19	Package: Update development dependencies and configure for travis-ci
Version: 0.1.8 - released 2015-06-12
	Non-functional	MDGASYNC-18	Package: Update package dependencies
Version: 0.1.7 - released 2015-05-24
	Non-functional	MDGASYNC-17	Package: Fix readme-usage header
Version: 0.1.6 - released 2015-05-24
	Non-functional	MDGASYNC-16	Package: Update development dependencies
Version: 0.1.5 - released 2015-05-21
	Non-functional	MDGASYNC-15	Package: remove dependency on underscore.js
	Non-functional	MDGASYNC-14	Package: Update jsdoc2markdown and regenerate documentation
Version: 0.1.4 - released 2015-04-11
	Non-functional	MDGASYNC-13	Package: Update package dependencies
	Non-functional	MDGASYNC-12	Package: Update eslint configuration, test.js runner and dev dependencies
	Non-functional	MDGASYNC-11	Package: Update eslint configuration, test.js runner and dev dependencies
	Non-functional	MDGASYNC-10	Package: Migrate from jshint to eslint static code analysis
	Non-functional	MDGASYNC-9	Package: Remove all gulp tasks except 'test' and update readme docs
Version: 0.1.3 - released 2014-10-07
	Non-functional	MDGASYNC-7	Package: Update package dependencies
	Non-functional	MDGASYNC-6	Doc: update changelog template
Version: 0.1.2 - released 2014-09-05
	Non-functional	MDGASYNC-4	Package: Rename package and Github repository to change word function to func. Word function was causing an error with David-dm.org
Version: 0.1.1 - released 2014-09-05
	Bug	MDGASYNC-3	Task: Fix stream.push() after EOF called
Version: 0.1.0 - released 2014-09-05
	Feature	MDGASYNC-2	Package: Develop asynchronous function runner. As a developer I can execute asynchronous functions as a gulp task So that I can efficiently integrate asynchronous functions into streams

License

MIT License (MIT). All rights not explicitly granted in the license are reserved.

Copyright (c) 2015 John Barry

Dependencies

gulp-async-func-runner@0.1.9 - "MIT License (MIT)", documented by npm-licenses.