update to latest standards
This commit is contained in:
		
							
								
								
									
										40
									
								
								README.md
									
									
									
									
									
								
							
							
						
						
									
										40
									
								
								README.md
									
									
									
									
									
								
							@@ -1,13 +1,16 @@
 | 
				
			|||||||
# gulp-function
 | 
					# gulp-function
 | 
				
			||||||
 | 
					
 | 
				
			||||||
accepts a function call as parameter to execute in gulp pipeline
 | 
					accepts a function call as parameter to execute in gulp pipeline
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Availabililty
 | 
					## Availabililty
 | 
				
			||||||
 | 
					
 | 
				
			||||||
[](https://www.npmjs.com/package/gulp-function)
 | 
					[](https://www.npmjs.com/package/gulp-function)
 | 
				
			||||||
[](https://GitLab.com/pushrocks/gulp-function)
 | 
					[](https://GitLab.com/pushrocks/gulp-function)
 | 
				
			||||||
[](https://github.com/pushrocks/gulp-function)
 | 
					[](https://github.com/pushrocks/gulp-function)
 | 
				
			||||||
[](https://pushrocks.gitlab.io/gulp-function/)
 | 
					[](https://pushrocks.gitlab.io/gulp-function/)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Status for master
 | 
					## Status for master
 | 
				
			||||||
 | 
					
 | 
				
			||||||
[](https://GitLab.com/pushrocks/gulp-function/commits/master)
 | 
					[](https://GitLab.com/pushrocks/gulp-function/commits/master)
 | 
				
			||||||
[](https://GitLab.com/pushrocks/gulp-function/commits/master)
 | 
					[](https://GitLab.com/pushrocks/gulp-function/commits/master)
 | 
				
			||||||
[](https://www.npmjs.com/package/gulp-function)
 | 
					[](https://www.npmjs.com/package/gulp-function)
 | 
				
			||||||
@@ -18,12 +21,43 @@ accepts a function call as parameter to execute in gulp pipeline
 | 
				
			|||||||
[](https://nodejs.org/dist/latest-v6.x/docs/api/)
 | 
					[](https://nodejs.org/dist/latest-v6.x/docs/api/)
 | 
				
			||||||
[](http://standardjs.com/)
 | 
					[](http://standardjs.com/)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Usage
 | 
					### Usage
 | 
				
			||||||
Use TypeScript for best in class instellisense.
 | 
					
 | 
				
			||||||
 | 
					```typescript
 | 
				
			||||||
 | 
					import * as gulp from "gulp";
 | 
				
			||||||
 | 
					import gulpFunction from "gulp-function"; // default ES6 export
 | 
				
			||||||
 | 
					// import {forFirst, forEach, atEnd} from 'gulp-function'
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					let myAsyncFunction = async (file, enc) => {
 | 
				
			||||||
 | 
					  // await some async stuff
 | 
				
			||||||
 | 
					};
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					gulp.task("gulpTest", function() {
 | 
				
			||||||
 | 
					  let stream = gulp
 | 
				
			||||||
 | 
					    .src("./mydir/*.something")
 | 
				
			||||||
 | 
					    .pipe(gulpFunction(myFunction, "forEach")) //read the notes below
 | 
				
			||||||
 | 
					    // .pipe(forEach(myFunction)) // if imported as >> import { forEach } from 'gulp-function' <<
 | 
				
			||||||
 | 
					    .pipe(gulp.dest("./build/"));
 | 
				
			||||||
 | 
					  return stream; // by returning the stream gulp knows when our task has finished.
 | 
				
			||||||
 | 
					});
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### Notes
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					* The first argument of gulpFunction can also be an **array of multiple functionnames**.
 | 
				
			||||||
 | 
					  Each function can return a promise. The pipe stop will finish when every promise is fullfilled.
 | 
				
			||||||
 | 
					  When providing an array of functions be careful with modifying the file object -> race condition
 | 
				
			||||||
 | 
					* The second argument can be empty, it defaults to "forEach"
 | 
				
			||||||
 | 
					* The following options are available:
 | 
				
			||||||
 | 
					  * "forFirst" - executes when first chunk/vinylfile of the stream reaches the pipestop.
 | 
				
			||||||
 | 
					    file is pushed further down the line when function's returned promise is fullfilled.
 | 
				
			||||||
 | 
					  * "forEach" - executes like "forFirst" but with every chunk/vinylfile in the stream;
 | 
				
			||||||
 | 
					  * "atEnd" - executes after all chunks have passed and are processed in full.
 | 
				
			||||||
 | 
					    That means the stream's "finish" event fires **before "atLast" is executed**!!!
 | 
				
			||||||
 | 
					
 | 
				
			||||||
For further information read the linked docs at the top of this README.
 | 
					For further information read the linked docs at the top of this README.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
> MIT licensed | **©** [Lossless GmbH](https://lossless.gmbh)
 | 
					> MIT licensed | **©** [Lossless GmbH](https://lossless.gmbh)
 | 
				
			||||||
| By using this npm module you agree to our [privacy policy](https://lossless.gmbH/privacy.html)
 | 
					> | By using this npm module you agree to our [privacy policy](https://lossless.gmbH/privacy.html)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
[](https://push.rocks)
 | 
					[](https://push.rocks)
 | 
				
			||||||
 
 | 
				
			|||||||
							
								
								
									
										5
									
								
								dist/index.d.ts
									
									
									
									
										vendored
									
									
								
							
							
						
						
									
										5
									
								
								dist/index.d.ts
									
									
									
									
										vendored
									
									
								
							@@ -1,7 +1,6 @@
 | 
				
			|||||||
/// <reference types="node" />
 | 
					/// <reference types="node" />
 | 
				
			||||||
import 'typings-global';
 | 
					import { Transform } from "stream";
 | 
				
			||||||
import { Transform } from 'stream';
 | 
					export declare type TExecutionMode = "forEach" | "forFirst" | "atEnd";
 | 
				
			||||||
export declare type TExecutionMode = 'forEach' | 'forFirst' | 'atEnd';
 | 
					 | 
				
			||||||
export interface IPromiseFunction {
 | 
					export interface IPromiseFunction {
 | 
				
			||||||
    (file?: any, enc?: any): PromiseLike<any>;
 | 
					    (file?: any, enc?: any): PromiseLike<any>;
 | 
				
			||||||
}
 | 
					}
 | 
				
			||||||
 
 | 
				
			|||||||
							
								
								
									
										30
									
								
								dist/index.js
									
									
									
									
										vendored
									
									
								
							
							
						
						
									
										30
									
								
								dist/index.js
									
									
									
									
										vendored
									
									
								
							@@ -1,17 +1,17 @@
 | 
				
			|||||||
"use strict";
 | 
					"use strict";
 | 
				
			||||||
Object.defineProperty(exports, "__esModule", { value: true });
 | 
					Object.defineProperty(exports, "__esModule", { value: true });
 | 
				
			||||||
require("typings-global");
 | 
					 | 
				
			||||||
const through2 = require("through2");
 | 
					const through2 = require("through2");
 | 
				
			||||||
let defaultExport = (functionsToExecuteArg, executionModeArg = 'forEach') => {
 | 
					let defaultExport = (functionsToExecuteArg, executionModeArg = "forEach") => {
 | 
				
			||||||
    let promiseArray = [];
 | 
					    let promiseArray = [];
 | 
				
			||||||
    let runFunction = function (functionArg, file, enc) {
 | 
					    let runFunction = function (functionArg, file, enc) {
 | 
				
			||||||
        let returnValue = functionArg(file, enc);
 | 
					        let returnValue = functionArg(file, enc);
 | 
				
			||||||
        if (typeof returnValue !== 'undefined' && typeof returnValue.then !== 'undefined') {
 | 
					        if (typeof returnValue !== "undefined" &&
 | 
				
			||||||
 | 
					            typeof returnValue.then !== "undefined") {
 | 
				
			||||||
            promiseArray.push(returnValue);
 | 
					            promiseArray.push(returnValue);
 | 
				
			||||||
        }
 | 
					        }
 | 
				
			||||||
    };
 | 
					    };
 | 
				
			||||||
    let checkAndRunFunction = function (file, enc) {
 | 
					    let checkAndRunFunction = function (file, enc) {
 | 
				
			||||||
        if (typeof functionsToExecuteArg === 'function') {
 | 
					        if (typeof functionsToExecuteArg === "function") {
 | 
				
			||||||
            runFunction(functionsToExecuteArg, file, enc);
 | 
					            runFunction(functionsToExecuteArg, file, enc);
 | 
				
			||||||
        }
 | 
					        }
 | 
				
			||||||
        else if (Array.isArray(functionsToExecuteArg)) {
 | 
					        else if (Array.isArray(functionsToExecuteArg)) {
 | 
				
			||||||
@@ -20,22 +20,22 @@ let defaultExport = (functionsToExecuteArg, executionModeArg = 'forEach') => {
 | 
				
			|||||||
            }
 | 
					            }
 | 
				
			||||||
        }
 | 
					        }
 | 
				
			||||||
        else {
 | 
					        else {
 | 
				
			||||||
            throw new Error('gulp-callfunction: something is strange with the given arguments');
 | 
					            throw new Error("gulp-callfunction: something is strange with the given arguments");
 | 
				
			||||||
        }
 | 
					        }
 | 
				
			||||||
        return Promise.all(promiseArray);
 | 
					        return Promise.all(promiseArray);
 | 
				
			||||||
    };
 | 
					    };
 | 
				
			||||||
    let hasExecutedOnce = false;
 | 
					    let hasExecutedOnce = false;
 | 
				
			||||||
    let forEach = function (file, enc, cb) {
 | 
					    let forEach = function (file, enc, cb) {
 | 
				
			||||||
 | 
					        // the forEach function is called for every chunk
 | 
				
			||||||
        switch (executionModeArg) {
 | 
					        switch (executionModeArg) {
 | 
				
			||||||
            case 'forEach':
 | 
					            case "forEach":
 | 
				
			||||||
                checkAndRunFunction(file, enc).then(function () {
 | 
					                checkAndRunFunction(file, enc).then(function () {
 | 
				
			||||||
                    cb(null, file);
 | 
					                    cb(null, file);
 | 
				
			||||||
                });
 | 
					                });
 | 
				
			||||||
                break;
 | 
					                break;
 | 
				
			||||||
            case 'forFirst':
 | 
					            case "forFirst":
 | 
				
			||||||
                if (hasExecutedOnce) {
 | 
					                if (hasExecutedOnce) {
 | 
				
			||||||
                    checkAndRunFunction(file, enc)
 | 
					                    checkAndRunFunction(file, enc).then(function () {
 | 
				
			||||||
                        .then(function () {
 | 
					 | 
				
			||||||
                        cb(null, file);
 | 
					                        cb(null, file);
 | 
				
			||||||
                    });
 | 
					                    });
 | 
				
			||||||
                }
 | 
					                }
 | 
				
			||||||
@@ -44,7 +44,7 @@ let defaultExport = (functionsToExecuteArg, executionModeArg = 'forEach') => {
 | 
				
			|||||||
                }
 | 
					                }
 | 
				
			||||||
                hasExecutedOnce = true;
 | 
					                hasExecutedOnce = true;
 | 
				
			||||||
                break;
 | 
					                break;
 | 
				
			||||||
            case 'atEnd':
 | 
					            case "atEnd":
 | 
				
			||||||
                cb();
 | 
					                cb();
 | 
				
			||||||
                break;
 | 
					                break;
 | 
				
			||||||
            default:
 | 
					            default:
 | 
				
			||||||
@@ -52,7 +52,7 @@ let defaultExport = (functionsToExecuteArg, executionModeArg = 'forEach') => {
 | 
				
			|||||||
        }
 | 
					        }
 | 
				
			||||||
    };
 | 
					    };
 | 
				
			||||||
    let atEnd = function (cb) {
 | 
					    let atEnd = function (cb) {
 | 
				
			||||||
        if (executionModeArg === 'atEnd') {
 | 
					        if (executionModeArg === "atEnd") {
 | 
				
			||||||
            checkAndRunFunction(null, null).then(function () {
 | 
					            checkAndRunFunction(null, null).then(function () {
 | 
				
			||||||
                cb();
 | 
					                cb();
 | 
				
			||||||
            });
 | 
					            });
 | 
				
			||||||
@@ -64,13 +64,13 @@ let defaultExport = (functionsToExecuteArg, executionModeArg = 'forEach') => {
 | 
				
			|||||||
    return through2.obj(forEach, atEnd);
 | 
					    return through2.obj(forEach, atEnd);
 | 
				
			||||||
};
 | 
					};
 | 
				
			||||||
exports.forEach = (funcArg) => {
 | 
					exports.forEach = (funcArg) => {
 | 
				
			||||||
    return defaultExport(funcArg, 'forEach');
 | 
					    return defaultExport(funcArg, "forEach");
 | 
				
			||||||
};
 | 
					};
 | 
				
			||||||
exports.forFirst = (funcArg) => {
 | 
					exports.forFirst = (funcArg) => {
 | 
				
			||||||
    return defaultExport(funcArg, 'forFirst');
 | 
					    return defaultExport(funcArg, "forFirst");
 | 
				
			||||||
};
 | 
					};
 | 
				
			||||||
exports.atEnd = (funcArg) => {
 | 
					exports.atEnd = (funcArg) => {
 | 
				
			||||||
    return defaultExport(funcArg, 'atEnd');
 | 
					    return defaultExport(funcArg, "atEnd");
 | 
				
			||||||
};
 | 
					};
 | 
				
			||||||
exports.default = defaultExport;
 | 
					exports.default = defaultExport;
 | 
				
			||||||
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUFBLDBCQUF1QjtBQUV2QixxQ0FBb0M7QUFTcEMsSUFBSSxhQUFhLEdBQUcsQ0FDbEIscUJBQTRELEVBQzVELG1CQUFtQyxTQUFTLEVBQ2pDLEVBQUU7SUFFYixJQUFJLFlBQVksR0FBRyxFQUFFLENBQUE7SUFDckIsSUFBSSxXQUFXLEdBQUcsVUFBVSxXQUFXLEVBQUUsSUFBSSxFQUFFLEdBQUc7UUFDaEQsSUFBSSxXQUFXLEdBQUcsV0FBVyxDQUFDLElBQUksRUFBRSxHQUFHLENBQUMsQ0FBQTtRQUN4QyxFQUFFLENBQUMsQ0FBQyxPQUFPLFdBQVcsS0FBSyxXQUFXLElBQUksT0FBTyxXQUFXLENBQUMsSUFBSSxLQUFLLFdBQVcsQ0FBQyxDQUFDLENBQUM7WUFDbEYsWUFBWSxDQUFDLElBQUksQ0FBQyxXQUFXLENBQUMsQ0FBQTtRQUNoQyxDQUFDO0lBQ0gsQ0FBQyxDQUFBO0lBRUQsSUFBSSxtQkFBbUIsR0FBRyxVQUFVLElBQUksRUFBRSxHQUFHO1FBQzNDLEVBQUUsQ0FBQyxDQUFDLE9BQU8scUJBQXFCLEtBQUssVUFBVSxDQUFDLENBQUMsQ0FBQztZQUNoRCxXQUFXLENBQUMscUJBQXFCLEVBQUUsSUFBSSxFQUFFLEdBQUcsQ0FBQyxDQUFBO1FBQy9DLENBQUM7UUFBQyxJQUFJLENBQUMsRUFBRSxDQUFDLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxxQkFBcUIsQ0FBQyxDQUFDLENBQUMsQ0FBQztZQUNoRCxHQUFHLENBQUMsQ0FBQyxJQUFJLFdBQVcsSUFBSSxxQkFBcUIsQ0FBQyxDQUFDLENBQUM7Z0JBQzlDLFdBQVcsQ0FBQyxxQkFBcUIsQ0FBRSxXQUFXLENBQUUsRUFBRSxJQUFJLEVBQUUsR0FBRyxDQUFDLENBQUE7WUFDOUQsQ0FBQztRQUNILENBQUM7UUFBQyxJQUFJLENBQUMsQ0FBQztZQUNOLE1BQU0sSUFBSSxLQUFLLENBQUMsa0VBQWtFLENBQUMsQ0FBQTtRQUNyRixDQUFDO1FBQ0QsTUFBTSxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsWUFBWSxDQUFDLENBQUE7SUFDbEMsQ0FBQyxDQUFBO0lBRUQsSUFBSSxlQUFlLEdBQUcsS0FBSyxDQUFBO0lBQzNCLElBQUksT0FBTyxHQUFHLFVBQVUsSUFBSSxFQUFFLEdBQUcsRUFBRSxFQUFFO1FBQ25DLE1BQU0sQ0FBQyxDQUFDLGdCQUFnQixDQUFDLENBQUMsQ0FBQztZQUN6QixLQUFLLFNBQVM7Z0JBQ1osbUJBQW1CLENBQUMsSUFBSSxFQUFFLEdBQUcsQ0FBQyxDQUFDLElBQUksQ0FBQztvQkFDbEMsRUFBRSxDQUFDLElBQUksRUFBRSxJQUFJLENBQUMsQ0FBQTtnQkFDaEIsQ0FBQyxDQUFDLENBQUE7Z0JBQ0YsS0FBSyxDQUFBO1lBQ1AsS0FBSyxVQUFVO2dCQUNiLEVBQUUsQ0FBQyxDQUFDLGVBQWUsQ0FBQyxDQUFDLENBQUM7b0JBQ3BCLG1CQUFtQixDQUFDLElBQUksRUFBRSxHQUFHLENBQUM7eUJBQzNCLElBQUksQ0FBQzt3QkFDSixFQUFFLENBQUMsSUFBSSxFQUFFLElBQUksQ0FBQyxDQUFBO29CQUNoQixDQUFDLENBQUMsQ0FBQTtnQkFDTixDQUFDO2dCQUFDLElBQUksQ0FBQyxDQUFDO29CQUNOLEVBQUUsQ0FBQyxJQUFJLEVBQUUsSUFBSSxDQUFDLENBQUE7Z0JBQ2hCLENBQUM7Z0JBQ0QsZUFBZSxHQUFHLElBQUksQ0FBQTtnQkFDdEIsS0FBSyxDQUFBO1lBQ1AsS0FBSyxPQUFPO2dCQUNWLEVBQUUsRUFBRSxDQUFBO2dCQUNKLEtBQUssQ0FBQTtZQUNQO2dCQUNFLEtBQUssQ0FBQTtRQUNULENBQUM7SUFDSCxDQUFDLENBQUE7SUFFRCxJQUFJLEtBQUssR0FBRyxVQUFVLEVBQUU7UUFDdEIsRUFBRSxDQUFDLENBQUMsZ0JBQWdCLEtBQUssT0FBTyxDQUFDLENBQUMsQ0FBQztZQUNqQyxtQkFBbUIsQ0FBQyxJQUFJLEVBQUUsSUFBSSxDQUFDLENBQUMsSUFBSSxDQUFDO2dCQUNuQyxFQUFFLEVBQUUsQ0FBQTtZQUNOLENBQUMsQ0FBQyxDQUFBO1FBQ0osQ0FBQztRQUFDLElBQUksQ0FBQyxDQUFDO1lBQ04sRUFBRSxFQUFFLENBQUE7UUFDTixDQUFDO0lBQ0gsQ0FBQyxDQUFBO0lBQ0QsTUFBTSxDQUFDLFFBQVEsQ0FBQyxHQUFHLENBQUMsT0FBTyxFQUFFLEtBQUssQ0FBQyxDQUFBO0FBQ3JDLENBQUMsQ0FBQTtBQUVVLFFBQUEsT0FBTyxHQUFHLENBQUMsT0FBeUIsRUFBRSxFQUFFO0lBQ2pELE1BQU0sQ0FBQyxhQUFhLENBQUMsT0FBTyxFQUFFLFNBQVMsQ0FBQyxDQUFBO0FBQzFDLENBQUMsQ0FBQTtBQUVVLFFBQUEsUUFBUSxHQUFHLENBQUMsT0FBeUIsRUFBRSxFQUFFO0lBQ2xELE1BQU0sQ0FBQyxhQUFhLENBQUMsT0FBTyxFQUFFLFVBQVUsQ0FBQyxDQUFBO0FBQzNDLENBQUMsQ0FBQTtBQUVVLFFBQUEsS0FBSyxHQUFHLENBQUMsT0FBeUIsRUFBRSxFQUFFO0lBQy9DLE1BQU0sQ0FBQyxhQUFhLENBQUMsT0FBTyxFQUFFLE9BQU8sQ0FBQyxDQUFBO0FBQ3hDLENBQUMsQ0FBQTtBQUVELGtCQUFlLGFBQWEsQ0FBQSJ9
 | 
					//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUNBLHFDQUFxQztBQVNyQyxJQUFJLGFBQWEsR0FBRyxDQUNsQixxQkFBNEQsRUFDNUQsbUJBQW1DLFNBQVMsRUFDakMsRUFBRTtJQUNiLElBQUksWUFBWSxHQUFHLEVBQUUsQ0FBQztJQUN0QixJQUFJLFdBQVcsR0FBRyxVQUFTLFdBQVcsRUFBRSxJQUFJLEVBQUUsR0FBRztRQUMvQyxJQUFJLFdBQVcsR0FBRyxXQUFXLENBQUMsSUFBSSxFQUFFLEdBQUcsQ0FBQyxDQUFDO1FBQ3pDLEVBQUUsQ0FBQyxDQUNELE9BQU8sV0FBVyxLQUFLLFdBQVc7WUFDbEMsT0FBTyxXQUFXLENBQUMsSUFBSSxLQUFLLFdBQzlCLENBQUMsQ0FBQyxDQUFDO1lBQ0QsWUFBWSxDQUFDLElBQUksQ0FBQyxXQUFXLENBQUMsQ0FBQztRQUNqQyxDQUFDO0lBQ0gsQ0FBQyxDQUFDO0lBRUYsSUFBSSxtQkFBbUIsR0FBRyxVQUFTLElBQUksRUFBRSxHQUFHO1FBQzFDLEVBQUUsQ0FBQyxDQUFDLE9BQU8scUJBQXFCLEtBQUssVUFBVSxDQUFDLENBQUMsQ0FBQztZQUNoRCxXQUFXLENBQUMscUJBQXFCLEVBQUUsSUFBSSxFQUFFLEdBQUcsQ0FBQyxDQUFDO1FBQ2hELENBQUM7UUFBQyxJQUFJLENBQUMsRUFBRSxDQUFDLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxxQkFBcUIsQ0FBQyxDQUFDLENBQUMsQ0FBQztZQUNoRCxHQUFHLENBQUMsQ0FBQyxJQUFJLFdBQVcsSUFBSSxxQkFBcUIsQ0FBQyxDQUFDLENBQUM7Z0JBQzlDLFdBQVcsQ0FBQyxxQkFBcUIsQ0FBQyxXQUFXLENBQUMsRUFBRSxJQUFJLEVBQUUsR0FBRyxDQUFDLENBQUM7WUFDN0QsQ0FBQztRQUNILENBQUM7UUFBQyxJQUFJLENBQUMsQ0FBQztZQUNOLE1BQU0sSUFBSSxLQUFLLENBQ2Isa0VBQWtFLENBQ25FLENBQUM7UUFDSixDQUFDO1FBQ0QsTUFBTSxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsWUFBWSxDQUFDLENBQUM7SUFDbkMsQ0FBQyxDQUFDO0lBRUYsSUFBSSxlQUFlLEdBQUcsS0FBSyxDQUFDO0lBQzVCLElBQUksT0FBTyxHQUFHLFVBQVMsSUFBSSxFQUFFLEdBQUcsRUFBRSxFQUFFO1FBQ2xDLGlEQUFpRDtRQUNqRCxNQUFNLENBQUMsQ0FBQyxnQkFBZ0IsQ0FBQyxDQUFDLENBQUM7WUFDekIsS0FBSyxTQUFTO2dCQUNaLG1CQUFtQixDQUFDLElBQUksRUFBRSxHQUFHLENBQUMsQ0FBQyxJQUFJLENBQUM7b0JBQ2xDLEVBQUUsQ0FBQyxJQUFJLEVBQUUsSUFBSSxDQUFDLENBQUM7Z0JBQ2pCLENBQUMsQ0FBQyxDQUFDO2dCQUNILEtBQUssQ0FBQztZQUNSLEtBQUssVUFBVTtnQkFDYixFQUFFLENBQUMsQ0FBQyxlQUFlLENBQUMsQ0FBQyxDQUFDO29CQUNwQixtQkFBbUIsQ0FBQyxJQUFJLEVBQUUsR0FBRyxDQUFDLENBQUMsSUFBSSxDQUFDO3dCQUNsQyxFQUFFLENBQUMsSUFBSSxFQUFFLElBQUksQ0FBQyxDQUFDO29CQUNqQixDQUFDLENBQUMsQ0FBQztnQkFDTCxDQUFDO2dCQUFDLElBQUksQ0FBQyxDQUFDO29CQUNOLEVBQUUsQ0FBQyxJQUFJLEVBQUUsSUFBSSxDQUFDLENBQUM7Z0JBQ2pCLENBQUM7Z0JBQ0QsZUFBZSxHQUFHLElBQUksQ0FBQztnQkFDdkIsS0FBSyxDQUFDO1lBQ1IsS0FBSyxPQUFPO2dCQUNWLEVBQUUsRUFBRSxDQUFDO2dCQUNMLEtBQUssQ0FBQztZQUNSO2dCQUNFLEtBQUssQ0FBQztRQUNWLENBQUM7SUFDSCxDQUFDLENBQUM7SUFFRixJQUFJLEtBQUssR0FBRyxVQUFTLEVBQUU7UUFDckIsRUFBRSxDQUFDLENBQUMsZ0JBQWdCLEtBQUssT0FBTyxDQUFDLENBQUMsQ0FBQztZQUNqQyxtQkFBbUIsQ0FBQyxJQUFJLEVBQUUsSUFBSSxDQUFDLENBQUMsSUFBSSxDQUFDO2dCQUNuQyxFQUFFLEVBQUUsQ0FBQztZQUNQLENBQUMsQ0FBQyxDQUFDO1FBQ0wsQ0FBQztRQUFDLElBQUksQ0FBQyxDQUFDO1lBQ04sRUFBRSxFQUFFLENBQUM7UUFDUCxDQUFDO0lBQ0gsQ0FBQyxDQUFDO0lBQ0YsTUFBTSxDQUFDLFFBQVEsQ0FBQyxHQUFHLENBQUMsT0FBTyxFQUFFLEtBQUssQ0FBQyxDQUFDO0FBQ3RDLENBQUMsQ0FBQztBQUVTLFFBQUEsT0FBTyxHQUFHLENBQUMsT0FBeUIsRUFBRSxFQUFFO0lBQ2pELE1BQU0sQ0FBQyxhQUFhLENBQUMsT0FBTyxFQUFFLFNBQVMsQ0FBQyxDQUFDO0FBQzNDLENBQUMsQ0FBQztBQUVTLFFBQUEsUUFBUSxHQUFHLENBQUMsT0FBeUIsRUFBRSxFQUFFO0lBQ2xELE1BQU0sQ0FBQyxhQUFhLENBQUMsT0FBTyxFQUFFLFVBQVUsQ0FBQyxDQUFDO0FBQzVDLENBQUMsQ0FBQztBQUVTLFFBQUEsS0FBSyxHQUFHLENBQUMsT0FBeUIsRUFBRSxFQUFFO0lBQy9DLE1BQU0sQ0FBQyxhQUFhLENBQUMsT0FBTyxFQUFFLE9BQU8sQ0FBQyxDQUFDO0FBQ3pDLENBQUMsQ0FBQztBQUVGLGtCQUFlLGFBQWEsQ0FBQyJ9
 | 
				
			||||||
@@ -1,40 +0,0 @@
 | 
				
			|||||||
### Usage
 | 
					 | 
				
			||||||
```javascript
 | 
					 | 
				
			||||||
import * as gulp from 'gulp';
 | 
					 | 
				
			||||||
import gulpFunction from 'gulp-function' // default ES6 export
 | 
					 | 
				
			||||||
// import {forFirst, forEach, atEnd} from 'gulp-function'
 | 
					 | 
				
			||||||
let Q = require("q");
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
let myFunction = function (file, enc) { // file and enc are optional in case you want to modify the file object
 | 
					 | 
				
			||||||
    let done = Q.defer();
 | 
					 | 
				
			||||||
    console.log("Hello World!")
 | 
					 | 
				
			||||||
    
 | 
					 | 
				
			||||||
    // NOTE:
 | 
					 | 
				
			||||||
    // you can use done.resolve as callback function
 | 
					 | 
				
			||||||
    // of any async tasks within this function
 | 
					 | 
				
			||||||
    done.resolve();
 | 
					 | 
				
			||||||
    
 | 
					 | 
				
			||||||
    return done.promise;
 | 
					 | 
				
			||||||
}
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
gulp.task('gulpTest',function() {
 | 
					 | 
				
			||||||
    let stream = gulp.src('./mydir/*.something')
 | 
					 | 
				
			||||||
        .pipe(gulpFunction(myFunction,'forEach')) //read the notes below
 | 
					 | 
				
			||||||
        // .pipe(forEach(myFunction)) // if imported as >> import { forEach } from 'gulp-function' <<
 | 
					 | 
				
			||||||
        .pipe(gulp.dest("./build/"));
 | 
					 | 
				
			||||||
    return stream; // by returning the stream gulp knows when our task has finished.
 | 
					 | 
				
			||||||
});
 | 
					 | 
				
			||||||
```
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
### Notes:
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
* The first argument of gulpFunction can also be an **array of multiple functionnames**.
 | 
					 | 
				
			||||||
Each function can return a promise. The pipe stop will finish when every promise is fullfilled.
 | 
					 | 
				
			||||||
When providing an array of functions be careful with modifying the file object -> race condition
 | 
					 | 
				
			||||||
* The second argument can be empty, it defaults to "forEach"
 | 
					 | 
				
			||||||
* The following options are available:
 | 
					 | 
				
			||||||
    * "forFirst" - executes when first chunk/vinylfile of the stream reaches the pipestop.
 | 
					 | 
				
			||||||
       file is pushed further down the line when function's returned promise is fullfilled.
 | 
					 | 
				
			||||||
    *  "forEach" - executes like "forFirst" but with every chunk/vinylfile in the stream;
 | 
					 | 
				
			||||||
    *  "atEnd" - executes after all chunks have passed and are processed in full.
 | 
					 | 
				
			||||||
       That means the stream's "finish" event fires **before "atLast" is executed**!!!
 | 
					 | 
				
			||||||
@@ -14,7 +14,8 @@
 | 
				
			|||||||
  "keywords": [
 | 
					  "keywords": [
 | 
				
			||||||
    "gulpplugin",
 | 
					    "gulpplugin",
 | 
				
			||||||
    "gulp",
 | 
					    "gulp",
 | 
				
			||||||
    "function"
 | 
					    "function",
 | 
				
			||||||
 | 
					    "pushrocks"
 | 
				
			||||||
  ],
 | 
					  ],
 | 
				
			||||||
  "author": "Lossless GmbH <office@lossless.com> (https://lossless.com)",
 | 
					  "author": "Lossless GmbH <office@lossless.com> (https://lossless.com)",
 | 
				
			||||||
  "license": "MIT",
 | 
					  "license": "MIT",
 | 
				
			||||||
@@ -25,8 +26,7 @@
 | 
				
			|||||||
  "dependencies": {
 | 
					  "dependencies": {
 | 
				
			||||||
    "@types/through2": "^2.0.32",
 | 
					    "@types/through2": "^2.0.32",
 | 
				
			||||||
    "smartq": "^1.1.6",
 | 
					    "smartq": "^1.1.6",
 | 
				
			||||||
    "through2": "^2.0.3",
 | 
					    "through2": "^2.0.3"
 | 
				
			||||||
    "typings-global": "^1.0.16"
 | 
					 | 
				
			||||||
  },
 | 
					  },
 | 
				
			||||||
  "devDependencies": {
 | 
					  "devDependencies": {
 | 
				
			||||||
    "gulp": "^3.9.1",
 | 
					    "gulp": "^3.9.1",
 | 
				
			||||||
 
 | 
				
			|||||||
							
								
								
									
										117
									
								
								ts/index.ts
									
									
									
									
									
								
							
							
						
						
									
										117
									
								
								ts/index.ts
									
									
									
									
									
								
							@@ -1,89 +1,92 @@
 | 
				
			|||||||
import 'typings-global'
 | 
					import * as q from "smartq";
 | 
				
			||||||
import * as q from 'smartq'
 | 
					import * as through2 from "through2";
 | 
				
			||||||
import * as through2 from 'through2'
 | 
					import { Transform } from "stream";
 | 
				
			||||||
import { Transform } from 'stream'
 | 
					 | 
				
			||||||
 | 
					
 | 
				
			||||||
export type TExecutionMode = 'forEach' | 'forFirst' | 'atEnd'
 | 
					export type TExecutionMode = "forEach" | "forFirst" | "atEnd";
 | 
				
			||||||
 | 
					
 | 
				
			||||||
export interface IPromiseFunction {
 | 
					export interface IPromiseFunction {
 | 
				
			||||||
  (file?, enc?): PromiseLike<any>
 | 
					  (file?, enc?): PromiseLike<any>;
 | 
				
			||||||
}
 | 
					}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
let defaultExport = (
 | 
					let defaultExport = (
 | 
				
			||||||
  functionsToExecuteArg: IPromiseFunction | IPromiseFunction[],
 | 
					  functionsToExecuteArg: IPromiseFunction | IPromiseFunction[],
 | 
				
			||||||
  executionModeArg: TExecutionMode = 'forEach'
 | 
					  executionModeArg: TExecutionMode = "forEach"
 | 
				
			||||||
): Transform => {
 | 
					): Transform => {
 | 
				
			||||||
 | 
					  let promiseArray = [];
 | 
				
			||||||
  let promiseArray = []
 | 
					  let runFunction = function(functionArg, file, enc) {
 | 
				
			||||||
  let runFunction = function (functionArg, file, enc) {
 | 
					    let returnValue = functionArg(file, enc);
 | 
				
			||||||
    let returnValue = functionArg(file, enc)
 | 
					    if (
 | 
				
			||||||
    if (typeof returnValue !== 'undefined' && typeof returnValue.then !== 'undefined') {
 | 
					      typeof returnValue !== "undefined" &&
 | 
				
			||||||
      promiseArray.push(returnValue)
 | 
					      typeof returnValue.then !== "undefined"
 | 
				
			||||||
 | 
					    ) {
 | 
				
			||||||
 | 
					      promiseArray.push(returnValue);
 | 
				
			||||||
    }
 | 
					    }
 | 
				
			||||||
  }
 | 
					  };
 | 
				
			||||||
 | 
					
 | 
				
			||||||
  let checkAndRunFunction = function (file, enc) {
 | 
					  let checkAndRunFunction = function(file, enc) {
 | 
				
			||||||
    if (typeof functionsToExecuteArg === 'function') {
 | 
					    if (typeof functionsToExecuteArg === "function") {
 | 
				
			||||||
      runFunction(functionsToExecuteArg, file, enc)
 | 
					      runFunction(functionsToExecuteArg, file, enc);
 | 
				
			||||||
    } else if (Array.isArray(functionsToExecuteArg)) {
 | 
					    } else if (Array.isArray(functionsToExecuteArg)) {
 | 
				
			||||||
      for (let anyFunction in functionsToExecuteArg) {
 | 
					      for (let anyFunction in functionsToExecuteArg) {
 | 
				
			||||||
        runFunction(functionsToExecuteArg[ anyFunction ], file, enc)
 | 
					        runFunction(functionsToExecuteArg[anyFunction], file, enc);
 | 
				
			||||||
      }
 | 
					      }
 | 
				
			||||||
    } else {
 | 
					    } else {
 | 
				
			||||||
      throw new Error('gulp-callfunction: something is strange with the given arguments')
 | 
					      throw new Error(
 | 
				
			||||||
 | 
					        "gulp-callfunction: something is strange with the given arguments"
 | 
				
			||||||
 | 
					      );
 | 
				
			||||||
    }
 | 
					    }
 | 
				
			||||||
    return Promise.all(promiseArray)
 | 
					    return Promise.all(promiseArray);
 | 
				
			||||||
  }
 | 
					  };
 | 
				
			||||||
 | 
					
 | 
				
			||||||
  let hasExecutedOnce = false
 | 
					  let hasExecutedOnce = false;
 | 
				
			||||||
  let forEach = function (file, enc, cb) { // the forEach function is called for every chunk
 | 
					  let forEach = function(file, enc, cb) {
 | 
				
			||||||
 | 
					    // the forEach function is called for every chunk
 | 
				
			||||||
    switch (executionModeArg) {
 | 
					    switch (executionModeArg) {
 | 
				
			||||||
      case 'forEach':
 | 
					      case "forEach":
 | 
				
			||||||
        checkAndRunFunction(file, enc).then(function () {
 | 
					        checkAndRunFunction(file, enc).then(function() {
 | 
				
			||||||
          cb(null, file)
 | 
					          cb(null, file);
 | 
				
			||||||
        })
 | 
					        });
 | 
				
			||||||
        break
 | 
					        break;
 | 
				
			||||||
      case 'forFirst':
 | 
					      case "forFirst":
 | 
				
			||||||
        if (hasExecutedOnce) {
 | 
					        if (hasExecutedOnce) {
 | 
				
			||||||
          checkAndRunFunction(file, enc)
 | 
					          checkAndRunFunction(file, enc).then(function() {
 | 
				
			||||||
            .then(function () {
 | 
					            cb(null, file);
 | 
				
			||||||
              cb(null, file)
 | 
					          });
 | 
				
			||||||
            })
 | 
					 | 
				
			||||||
        } else {
 | 
					        } else {
 | 
				
			||||||
          cb(null, file)
 | 
					          cb(null, file);
 | 
				
			||||||
        }
 | 
					        }
 | 
				
			||||||
        hasExecutedOnce = true
 | 
					        hasExecutedOnce = true;
 | 
				
			||||||
        break
 | 
					        break;
 | 
				
			||||||
      case 'atEnd':
 | 
					      case "atEnd":
 | 
				
			||||||
        cb()
 | 
					        cb();
 | 
				
			||||||
        break
 | 
					        break;
 | 
				
			||||||
      default:
 | 
					      default:
 | 
				
			||||||
        break
 | 
					        break;
 | 
				
			||||||
    }
 | 
					    }
 | 
				
			||||||
  }
 | 
					  };
 | 
				
			||||||
 | 
					
 | 
				
			||||||
  let atEnd = function (cb) {
 | 
					  let atEnd = function(cb) {
 | 
				
			||||||
    if (executionModeArg === 'atEnd') {
 | 
					    if (executionModeArg === "atEnd") {
 | 
				
			||||||
      checkAndRunFunction(null, null).then(function () {
 | 
					      checkAndRunFunction(null, null).then(function() {
 | 
				
			||||||
        cb()
 | 
					        cb();
 | 
				
			||||||
      })
 | 
					      });
 | 
				
			||||||
    } else {
 | 
					    } else {
 | 
				
			||||||
      cb()
 | 
					      cb();
 | 
				
			||||||
    }
 | 
					    }
 | 
				
			||||||
  }
 | 
					  };
 | 
				
			||||||
  return through2.obj(forEach, atEnd)
 | 
					  return through2.obj(forEach, atEnd);
 | 
				
			||||||
}
 | 
					};
 | 
				
			||||||
 | 
					
 | 
				
			||||||
export let forEach = (funcArg: IPromiseFunction) => {
 | 
					export let forEach = (funcArg: IPromiseFunction) => {
 | 
				
			||||||
  return defaultExport(funcArg, 'forEach')
 | 
					  return defaultExport(funcArg, "forEach");
 | 
				
			||||||
}
 | 
					};
 | 
				
			||||||
 | 
					
 | 
				
			||||||
export let forFirst = (funcArg: IPromiseFunction) => {
 | 
					export let forFirst = (funcArg: IPromiseFunction) => {
 | 
				
			||||||
  return defaultExport(funcArg, 'forFirst')
 | 
					  return defaultExport(funcArg, "forFirst");
 | 
				
			||||||
}
 | 
					};
 | 
				
			||||||
 | 
					
 | 
				
			||||||
export let atEnd = (funcArg: IPromiseFunction) => {
 | 
					export let atEnd = (funcArg: IPromiseFunction) => {
 | 
				
			||||||
  return defaultExport(funcArg, 'atEnd')
 | 
					  return defaultExport(funcArg, "atEnd");
 | 
				
			||||||
}
 | 
					};
 | 
				
			||||||
 | 
					
 | 
				
			||||||
export default defaultExport
 | 
					export default defaultExport;
 | 
				
			||||||
 
 | 
				
			|||||||
		Reference in New Issue
	
	Block a user