New: Support --tasks-json flag for gulp 3.x

Author: sttk

lib/versioned/^3.7.0/index.js

@@ -1,9 +1,12 @@
 'use strict';
 
+var fs = require('fs');
+
 var log = require('gulplog');
 var stdout = require('mute-stdout');
 
 var taskTree = require('./task-tree');
+var copyTree = require('../../shared/log/copy-tree');
 
 var tildify = require('../../shared/tildify');
 var logTasks = require('../../shared/log/tasks');
@@ -16,7 +19,7 @@ function execute(opts, env, config) {
   var tasks = opts._;
   var toRun = tasks.length ? tasks : ['default'];
 
-  if (opts.tasksSimple || opts.tasks) {
+  if (opts.tasksSimple || opts.tasks || opts.tasksJson) {
     // Mute stdout if we are listing tasks
     stdout.mute();
   }
@@ -50,6 +53,22 @@ function execute(opts, env, config) {
         return gulpInst.tasks[task].fn;
       });
     }
+    if (opts.tasksJson) {
+      tree = taskTree(gulpInst.tasks);
+      if (config.description && isString(config.description)) {
+        tree.label = config.description;
+      } else {
+        tree.label = 'Tasks for ' + tildify(env.configPath);
+      }
+
+      var output = JSON.stringify(copyTree(tree, opts));
+
+      if (typeof opts.tasksJson === 'boolean') {
+        return console.log(output);
+      }
+
+      return fs.writeFileSync(opts.tasksJson, output, 'utf-8');
+    }
     gulpInst.start.apply(gulpInst, toRun);
   });
 }

lib/versioned/^3.7.0/task-tree.js

@@ -4,14 +4,22 @@ module.exports = function(tasks) {
   var map = {};
   var arr = [];
   Object.keys(tasks).forEach(function(taskname) {
-    var task = { label: taskname, nodes: [], };
+    var task = {
+      label: taskname,
+      type: 'task',
+      nodes: [],
+    };
     map[taskname] = task;
     arr.push(task);
   });
   Object.keys(tasks).forEach(function(taskname) {
     var task = map[taskname];
     tasks[taskname].dep.forEach(function(childname) {
-      var child = map[childname] || { label: childname, nodes: [], };
+      var child = map[childname] || {
+        label: childname,
+        type: 'task',
+        nodes: [],
+      };
       task.nodes.push(child);
     });
   });

test/lib/task-tree.js

@@ -26,19 +26,22 @@ describe('lib: taskTree', function() {
       nodes: [
         {
           label: 'test',
+          type: 'task',
           nodes: [
-            { label: 'dep1', nodes: [], },
-            { label: 'dep2', nodes: [], },
+            { label: 'dep1', type: 'task', nodes: [], },
+            { label: 'dep2', type: 'task', nodes: [], },
           ],
         },
         {
           label: 'test2',
+          type: 'task',
           nodes: [
-            { label: 'dep3', nodes: [], },
+            { label: 'dep3', type: 'task', nodes: [], },
           ],
         },
         {
           label: 'test3',
+          type: 'task',
           nodes: [],
         },
       ],
@@ -66,33 +69,40 @@ describe('lib: taskTree', function() {
       nodes: [
         {
           label: 'test',
+          type: 'task',
           nodes: [
             {
               label: 'test2',
+              type: 'task',
               nodes: [
                 {
                   label: 'test3',
+                  type: 'task',
                   nodes: [],
                 },
               ],
             },
             {
               label: 'test3',
+              type: 'task',
               nodes: [],
             },
           ],
         },
         {
           label: 'test2',
+          type: 'task',
           nodes: [
             {
               label: 'test3',
+              type: 'task',
               nodes: [],
             },
           ],
         },
         {
           label: 'test3',
+          type: 'task',
           nodes: [],
         },
       ],