plz

simple build automation

Usage no npm install needed!

<script type="module">
  import plz from 'https://cdn.skypack.dev/plz';
</script>

README

Build Status

Install

Plz is a script automation system like "make", "rake", and "cake". It aims to make simple tasks trivial, and difficult tasks easier. Highlights:

  • Fast. Rules are written in javascript or coffee-script and executed by the v8 engine. Your build could be finished before other build systems even launch.
  • Clean. No console spew. The default logging level runs silent unless there's an error.
  • Simple. Most of the basic shell commands are exposed as global functions via shelljs, or just call "exec". You don't have to learn a new syntax for copying files.
  • Powerful. Tasks can be executed by name, or automatically when files change, based on glob patterns. Plugins are easy to write, and can attach new features to existing tasks.

When tasks are triggered by watching for changed files, dependencies become automatic, and less "manual wiring" is required. It adds surprising leverage.

Check out the copious documentation.

Install

Make sure you have node installed (http://nodejs.org/), then:

$ sudo npm install -g plz

Developing

Install dependencies using node, then build with a current version of plz:

$ npm install
$ plz

Pull requests and bug reports are tracked on github: https://github.com/robey/plz

License

Apache 2 (open-source) license, included in 'LICENSE.txt'.

Authors

Thanks

  • @azer for introducing me to the idea of having file triggers launch tasks.
  • @dbrock for letting me use the name on npm.

TODO: command to display dependency tree TODO: had trouble with loading coffee + mocha, having no src/*.coffee, and getting it to run build before test. why?