Readme

Grinder

Grinder - a task based, dependency aware build system.

Intro

A library and tool to drive a command-line build.

Grinder build files are entirely specified in Dart code. This allows you to write and debug your build files with the same tools you use for the rest of your project source.

Generally, a Grinder implementation will look something like this:

void main() {
  defineTask('init', taskFunction: init);
  defineTask('compile', taskFunction: compile, depends: ['init']);
  defineTask('deploy', taskFunction: deploy, depends: ['compile']);
  defineTask('docs', taskFunction: deploy, depends: ['init']);
  defineTask('all', depends: ['deploy', 'docs']);

  startGrinder();
}

void init(GrinderContext context) {
  context.log("I set things up");
}

...

Tasks to run are specified on the command line. If a task has dependencies, those dependent tasks are run before the specified task.

Command-line usage

usage: dart grinder.dart <options> target1 target2 ...

valid options:
-h, --help    show targets but don't build
-d, --deps    display the dependencies of targets