1.1.0

README.md

@@ -12,9 +12,18 @@ accepts call to execute in gulp pipeline.
 ```javascript
 var gulp = require("gulp");
 var gulpFunction = require("gulp-function");
+var Q = require("q");
 
 var myFunction = function () {
+    var 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() {
@@ -24,5 +33,6 @@ gulp.task('gulpTest',function() {
 });
 ```
 
->Note: The first argument of gulpFunction can also be an array of multiple functionnames.  
+> Note: The first argument of gulpFunction can also be an array of multiple functionnames.
->Note: the second argument can be empty (defaults to 'forEach') or 'atEnd'
+Each function can return a promise. the pipe stop will finish when every promise is fullfilled.  
+> Note: the second argument can be empty (defaults to 'forEach') or 'atEnd'

index.d.ts

@@ -1,4 +1,6 @@
 /// <reference path="ts/typings/main.d.ts" />
-declare var through: any;
+declare var plugins: {
-declare var path: any;
+    beautylog: any;
-declare var beautylog: any;
+    Q: any;
+    through: any;
+};

index.js

@@ -1,41 +1,57 @@
 #!/usr/bin/env node
 
 /// <reference path="typings/main.d.ts" />
-var through = require("through2");
+var plugins = {
-var path = require("path");
+    beautylog: require("beautylog"),
-var beautylog = require("beautylog");
+    Q: require("q"),
+    through: require("through2")
+};
 module.exports = function (functionsToExecuteArg, executionModeArg) {
     if (executionModeArg === void 0) { executionModeArg = 'forEach'; }
     //important vars
-    var gulpFunction = {
+    var executionMode = executionModeArg; //can be forEach or atEnd
-        executionMode: executionModeArg,
+    var functionsToExecute = functionsToExecuteArg;
-        functionsToExecute: functionsToExecuteArg
+    var promiseArray = [];
-    };
+    var runFunction = function (functionArg) {
-    var runFunctionNames = function () {
+        var returnValue = functionArg();
-        if (typeof gulpFunction.functionsToExecute === "function") {
+        if (typeof returnValue !== "undefined" && typeof returnValue.then !== "undefined") {
-            gulpFunction.functionsToExecute();
+            promiseArray.push(returnValue);
         }
-        else if (Array.isArray(gulpFunction.functionsToExecute)) {
+    };
-            for (var anyFunction in gulpFunction.functionsToExecute) {
+    var checkAndRunFunction = function () {
-                gulpFunction.functionsToExecute[anyFunction]();
+        if (typeof functionsToExecute === "function") {
+            runFunction(functionsToExecute);
+        }
+        else if (Array.isArray(functionsToExecute)) {
+            for (var anyFunction in functionsToExecute) {
+                runFunction(functionsToExecute[anyFunction]);
             }
         }
         else {
-            beautylog.error('gulp-callfunction: something is strange with the given arguments');
+            plugins.beautylog.error('gulp-callfunction: something is strange with the given arguments');
         }
+        return plugins.Q.all(promiseArray);
     };
     var forEach = function (file, enc, cb) {
-        if (gulpFunction.executionMode === 'forEach') {
+        if (executionMode === 'forEach') {
-            runFunctionNames();
+            checkAndRunFunction().then(function () {
+                cb(null, file);
+            });
+        }
+        else {
+            cb(null, file);
         }
         //tell gulp that we are complete
-        return cb(null, file);
     };
     var atEnd = function (cb) {
-        if (gulpFunction.executionMode === "atEnd") {
+        if (executionMode === "atEnd") {
-            runFunctionNames();
+            checkAndRunFunction().then(function () {
+                cb();
+            });
+        }
+        else {
+            cb();
         }
-        cb();
     };
-    return through.obj(forEach, atEnd);
+    return plugins.through.obj(forEach, atEnd);
 };

npmts.json

@@ -0,0 +1,4 @@
+{
+  "mode":"default",
+  "coveralls":true
+}

package.json

@@ -1,6 +1,6 @@
 {
   "name": "gulp-function",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "description": "accepts a function call as parameter to execute in gulp pipeline",
   "main": "index.js",
   "scripts": {
@@ -25,8 +25,9 @@
   },
   "homepage": "https://github.com/pushrocks/gulp-function",
   "dependencies": {
-    "beautylog": "2.1.1",
+    "beautylog": "^2.1.1",
-    "through2": "2.0.1"
+    "q": "^1.4.1",
+    "through2": "^2.0.1"
   },
   "devDependencies": {
     "gulp": "^3.9.1",

test/test.d.ts

@@ -2,5 +2,7 @@
 declare var gulp: any;
 declare var gulpFunction: any;
 declare var beautylog: any;
-declare var myFunction: () => void;
+declare var Q: any;
-declare var myFunction2: () => void;
+declare var myFunction: () => any;
+declare var myFunction2: () => any;
+declare var myFunction3: () => any;

test/test.js

@@ -4,27 +4,42 @@
 var gulp = require("gulp");
 var gulpFunction = require("../index.js");
 var beautylog = require("beautylog");
+var Q = require("q");
 var myFunction = function () {
+    var done = Q.defer();
     beautylog.log("Function executed");
+    done.resolve();
+    return done.promise;
 };
 var myFunction2 = function () {
-    beautylog.log("Function2 executed");
+    var done = Q.defer();
+    beautylog.ok("Function2 executed");
+    done.resolve();
+    return done.promise;
+};
+var myFunction3 = function () {
+    var done = Q.defer();
+    beautylog.success("Function3 executed");
+    done.resolve();
+    return done.promise;
 };
 describe("gulpFunction", function () {
-    it("should run through smoothly with " + "'forEach'".blue, function () {
+    it("should run through smoothly with " + "'forEach'".blue, function (done) {
         gulp.src('./test/*.md')
             .pipe(gulpFunction(myFunction, 'forEach'))
             .pipe(gulp.dest("./test/result/"));
         gulp.src('./test/*.md')
-            .pipe(gulpFunction([myFunction, myFunction2], 'forEach'))
+            .pipe(gulpFunction([myFunction2, myFunction3], 'forEach'))
-            .pipe(gulp.dest("./test/result/"));
+            .pipe(gulp.dest("./test/result/"))
+            .pipe(gulpFunction(done, "atEnd"));
     });
-    it("should run through smoothly with " + "'atEnd'".blue, function () {
+    it("should run through smoothly with " + "'atEnd'".blue, function (done) {
         gulp.src('./test/*.md')
             .pipe(gulpFunction(myFunction, 'atEnd'))
             .pipe(gulp.dest("./test/result/"));
         gulp.src('./test/*.md')
-            .pipe(gulpFunction([myFunction, myFunction2], 'atEnd'))
+            .pipe(gulpFunction([myFunction2, myFunction3], 'atEnd'))
-            .pipe(gulp.dest("./test/result/"));
+            .pipe(gulp.dest("./test/result/"))
+            .pipe(gulpFunction(done, "atEnd"));
     });
 });

ts/index.ts

@@ -1,42 +1,60 @@
 /// <reference path="typings/main.d.ts" />
-var through = require("through2");
+
-var path = require("path");
+var plugins = {
-var beautylog = require("beautylog");
+    beautylog: require("beautylog"),
+    Q: require("q"),
+    through: require("through2")
+}
+
+
 
 
 module.exports = function (functionsToExecuteArg:any|any[],executionModeArg:string = 'forEach') {
     //important vars
-    var gulpFunction = {
+    var executionMode = executionModeArg; //can be forEach or atEnd
-        executionMode: executionModeArg, //can be forEach or atEnd
+    var functionsToExecute = functionsToExecuteArg;
-        functionsToExecute: functionsToExecuteArg
+    var promiseArray = [];
+    var runFunction = function(functionArg){
+        var returnValue = functionArg();
+        if (typeof returnValue !== "undefined" && typeof returnValue.then !== "undefined") {
+            promiseArray.push(returnValue);
+        }
     };
 
-    var runFunctionNames = function () {
+    var checkAndRunFunction = function () {
-        if (typeof gulpFunction.functionsToExecute === "function" ) {
+        if (typeof functionsToExecute === "function" ) {
-            gulpFunction.functionsToExecute();
+            runFunction(functionsToExecute);
-        } else if (Array.isArray(gulpFunction.functionsToExecute)) {
+        } else if (Array.isArray(functionsToExecute)) {
-            for (var anyFunction in gulpFunction.functionsToExecute) {
+            for (var anyFunction in functionsToExecute) {
-                gulpFunction.functionsToExecute[anyFunction]();
+                runFunction(functionsToExecute[anyFunction]);
             }
         } else {
-            beautylog.error('gulp-callfunction: something is strange with the given arguments');
+            plugins.beautylog.error('gulp-callfunction: something is strange with the given arguments');
         }
+        return plugins.Q.all(promiseArray);
     };
 
 
     var forEach = function (file, enc, cb) {
-        if (gulpFunction.executionMode === 'forEach') {
+        if (executionMode === 'forEach') {
-            runFunctionNames();
+            checkAndRunFunction().then(function(){
+                cb(null, file);
+            });
+        } else {
+            cb(null, file);
         }
         //tell gulp that we are complete
-        return cb(null, file);
+
     };
 
     var atEnd = function(cb) {
-        if (gulpFunction.executionMode === "atEnd") {
+        if (executionMode === "atEnd") {
-            runFunctionNames();
+            checkAndRunFunction().then(function(){
+                cb();
+            });
+        } else {
+            cb();
         }
-        cb();
     };
-    return through.obj(forEach,atEnd);
+    return plugins.through.obj(forEach,atEnd);
 };

ts/test.ts

@@ -2,32 +2,49 @@
 var gulp = require("gulp");
 var gulpFunction = require("../index.js");
 var beautylog = require("beautylog");
+var Q = require("q");
 
 var myFunction = function () {
+    var done = Q.defer()
     beautylog.log("Function executed");
+    done.resolve();
+    return done.promise;
 };
 var myFunction2 = function () {
-    beautylog.log("Function2 executed");
+    var done = Q.defer();
+    beautylog.ok("Function2 executed");
+    done.resolve();
+    return done.promise;
+};
+var myFunction3 = function () {
+    var done = Q.defer();
+    beautylog.success("Function3 executed");
+    done.resolve();
+    return done.promise;
 };
 
 describe("gulpFunction",function(){
-    it("should run through smoothly with " + "'forEach'".blue,function(){
+    it("should run through smoothly with " + "'forEach'".blue,function(done){
         gulp.src('./test/*.md')
             .pipe(gulpFunction(myFunction,'forEach'))
             .pipe(gulp.dest("./test/result/"));
+
         gulp.src('./test/*.md')
-            .pipe(gulpFunction([myFunction,myFunction2],'forEach'))
+            .pipe(gulpFunction([myFunction2,myFunction3],'forEach'))
-            .pipe(gulp.dest("./test/result/"));
+            .pipe(gulp.dest("./test/result/"))
+            .pipe(gulpFunction(done,"atEnd"));
 
     });
 
-    it("should run through smoothly with " + "'atEnd'".blue,function(){
+    it("should run through smoothly with " + "'atEnd'".blue,function(done){
         gulp.src('./test/*.md')
             .pipe(gulpFunction(myFunction,'atEnd'))
             .pipe(gulp.dest("./test/result/"));
+
         gulp.src('./test/*.md')
-            .pipe(gulpFunction([myFunction,myFunction2],'atEnd'))
+            .pipe(gulpFunction([myFunction2,myFunction3],'atEnd'))
-            .pipe(gulp.dest("./test/result/"));
+            .pipe(gulp.dest("./test/result/"))
+            .pipe(gulpFunction(done,"atEnd"));
     });
 });