gulp-task-list

gulp-task-list is a gulp task that lists all tasks in gulpfile.js along with their comments.

gulpfile.js

 
    var gulp = require('gulp');
 
    require('gulp-task-list')(gulp);
 
    // this task is a dummy task
    gulp.task('some-task', function() {
        console.log('this is some-task');
    });
 
    // now, this one is the second dummy task
    gulp.task('the-second-task', ['some-task'], function() {
        console.log('uuuu, a second task :)');
    });

command line

$ gulp task-list

Task name         Description                                         Dependencies
some-task         this task is a dummy task
the-secont-task   now, this one is the second dummy task              some-task

Ignore a task to be displayed

 
    var gulp = require('gulp');
 
    require('gulp-task-list')(gulp, ['private-task']);
 
    // this task is a dummy task
    gulp.task('some-task', function() {
        console.log('this is some-task');
    });
 
    // this is a private task
    gulp.task('private-task', function() {
        console.log('This task is private');
    });

Explicitly describe files to be crawled for documentation

 
    var gulp = require('gulp');
 
    // array of files to be used for gulp tasks
    var files = [
        __filename,
        'tests/gulp-tasks.js',
        'gulp-tasks/prod.js',
        'gulp-tasks/dev.js',
        'gulp-tasks/infra.js',
        'gulp-tasks/common.js'
    ];
 
    require('gulp-task-list')(gulp, null, files);

command line

$ gulp task-list

Task name         Description                                         Dependencies
some-task         this task is a dummy task