gulp-tasks-manager

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

Install

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

Demo

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

/--app
  |--build
      |--tasks
          |--script.js
          |--style.js
      |--gulpfile.js
  |--js
  |--css
  |--node_modules
  |--package.json

in gulpfile.js:

var gulp = require('gulp'),
	plugins = require('gulp-load-plugins')(),
	tasks = require('gulp-tasks-manager'),
	task = tasks(gulp, plugins, {
		rootDir: '../',
		taskDir: './tasks'
	});

task('script');
task('style');

gulp.task('default', tasks.list());

in tasks/script.js:

module.exports = function(gulp, plugins, ns) {
	var cxt = ns.context('./js'),
		path = {
			src: cxt('./**/*.js'),
			dst: cxt('./build')
		};

	gulp.task(ns('build'), function() {
		gulp.src(path.src)
			.pipe(plugins.uglify())
			.pipe(gulp.dest(path.dst));
	});

	gulp.task(ns('watch'), function() {
		gulp.watch(path.js, ns(['build']));
	});
};

in tasks/style.js:

module.exports = function(gulp, plugins, ns) {
	var cxt = ns.context('./css'),
		path = {
			src: cxt('./**/*.less'),
			dst: cxt('./build')
		};

	gulp.task(ns('build'), function() {
		gulp.src(path.src)
			.pipe(plugins.less())
			.pipe(gulp.dest(path.dst));
	});

	gulp.task(ns('watch'), function() {
		gulp.watch(path.less, ns(['build']));
	});
};

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