gulp-tasks-manager

Gulp tasks manager. If you have too many tasks, you can split tasks into multiple pieces with this tool.

Install

1npm install gulp-tasks-manager --save-dev

Demo

For example, here is the file structure of an app:

1/--app
2  |--build
3      |--tasks
4          |--script.js
5          |--style.js
6      |--gulpfile.js
7  |--js
8  |--css
9  |--node_modules
10  |--package.json

in gulpfile.js:

1var gulp = require('gulp'),
2	plugins = require('gulp-load-plugins')(),
3	tasks = require('gulp-tasks-manager'),
4	task = tasks(gulp, plugins, {
5		rootDir: '../',
6		taskDir: './tasks'
7	});
8
9task('script');
10task('style');
11
12gulp.task('default', tasks.list());

in tasks/script.js:

1module.exports = function(gulp, plugins, ns) {
2	var cxt = ns.context('./js'),
3		path = {
4			src: cxt('./**/*.js'),
5			dst: cxt('./build')
6		};
7
8	gulp.task(ns('build'), function() {
9		gulp.src(path.src)
10			.pipe(plugins.uglify())
11			.pipe(gulp.dest(path.dst));
12	});
13
14	gulp.task(ns('watch'), function() {
15		gulp.watch(path.js, ns(['build']));
16	});
17};

in tasks/style.js:

1module.exports = function(gulp, plugins, ns) {
2	var cxt = ns.context('./css'),
3		path = {
4			src: cxt('./**/*.less'),
5			dst: cxt('./build')
6		};
7
8	gulp.task(ns('build'), function() {
9		gulp.src(path.src)
10			.pipe(plugins.less())
11			.pipe(gulp.dest(path.dst));
12	});
13
14	gulp.task(ns('watch'), function() {
15		gulp.watch(path.less, ns(['build']));
16	});
17};

then just run gulp.

If you want:

• just build and watch script, run gulp script
• just build but not watch style, run gulp style:build

when executing task(script), it is just:

• gulp.task('script:build', function(){})
• gulp.task('script:watch', function(){})
• gulp.task('script', ['script:build', 'script:watch'])

API

• tasks(gulp, plugins [, opts])
  • gulp: the gulp as we all know
  • plugins: gulp-load-plugins(preferred) or a self-defined object
  • opts: options
    • rootDir: default to ./
    • taskDir: default to ./
• tasks.list()
  • list main tasks
  • return value is the format of [namespace1, namespace2, ...]
• tasks.listAll()
  • list all tasks(main tasks and subtasks)
  • return value is the format of {namespace1: [subtask1, subtask2], namespace2: [...], ...}
• task(name [, filename])
  • name: namespace
  • filename: if missed, default to name
• ns
  • ns.name: the namespace
  • ns.context(dir): locate the context dir of a namespace, return a function which is used to locate resources in the module represented by this namespace
  • ns(taskName): return string of namespace:taskName and add it to the task list
  • ns([taskName1, taskName2, ...]): return an array of string with each item is the format of namespace:taskNamex

License

MIT