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