Taskr

A generator & coroutine-based task runner.

Fasten your seatbelt. 🚀

Taskr is a highly performant task runner, much like Gulp or Grunt, but written with concurrency in mind. With Taskr, everything is a coroutine, which allows for cascading and composable tasks; but unlike Gulp, it's not limited to the stream metaphor.

Taskr is extremely extensible, so anything can be a task. Our core system will accept whatever you throw at it, resulting in a modular system of reusable plugins and tasks, connected by a declarative taskfile.js that's easy to read.

const src = 'src/{admin,client}';
const dist = 'build';

module.exports = {
  *lint(task) {
    yield task.source(`${src}/*.js`).xo({ esnext:true });
  },
  *scripts(task) {
    yield task.source(`${src}/*.js`).babel({ presets:['es2015'] }).target(`${dist}/js`);
  },
  *styles(task) {
    yield task.source(`${src}/*.sass`).sass().autoprefixer().target(`${dist}/css`);
  },
  *build(task) {
    yield task.parallel(['lint', 'scripts', 'styles']);
  }
}

History

TL;DR This is the continuation of and successor to Fly!

I was forcibly removed by its inactive co-owner, due to his newfound "interest" in the project (aka, the stars). He's also taken to alter Fly's commit history in order to remove evidence of my work.

As a result of this dispute, Taskr exists as a separate (mono)repo but includes the full, original history for Fly.

In regards the NPM downloadable(s), taskr@1.0.5 is equivalent to fly@2.0.6 -- with a few exceptions:

1. The flyfile.js has been renamed to taskfile.js;
2. The fly key inside package.json has been renamed to taskr. (See Local Plugins)

At this point, the Fly & Taskr ecosystems are fully interchangeable, which means that you can install taskr and use any fly-* or taskr-* plugins of your choosing. That said, most plugins have been ported over to the new namespace.

Please bear with me as we, collectively, transition into a stronger and more stable product!

Core Features

• lightweight: with 6 dependencies, installation takes seconds
• minimal API: Taskr only exposes a couple methods, but they're everything you'll ever need
• performant: because of Bluebird, creating and running Tasks are quick and inexpensive
• cascadable: sequential Task chains can cascade their return values, becoming the next Task's argument
• asynchronous: concurrent Task chains run without side effects & can be yielded consistently
• composable: chain APIs and Tasks directly; say goodbye to pipe() x 100!
• modular: easily share or export individual Tasks or Plugins for later use
• stable: requires Node >= 4.6 to run (LTS is 6.11)

Docs

The main documentation can be found in taskr, our core package.

Each @taskr/* or taskr-* plugin will also include its own documentation, too!

Packages

The Taskr repo is managed as a monorepo that is composed of its many official packages.

Important: The core pacakge is taskr and must be installed before using any additional plugins.

Official Packages

These npm packages are officially released and maintained by the Taskr team.

If you can't find what you need, be sure to check out the community list or browse for all taskr-related plugins on npmjs.com, too!

If you're still missing something, open a ticket so that the team & community can try to help you... or create & share your own Taskr plugin! We have an awesome Yeoman generator to help speed up the process.

Package	Version	Dependencies	Description
taskr			Core package. Required
@taskr/babel			Babel plugin for Taskr
@taskr/browserify			Browserify plugin for Taskr
@taskr/buble			Bublé plugin for Taskr
@taskr/clear			Remove one or more directories
@taskr/coffee			CoffeeScript plugin for Taskr
@taskr/concat			Concatenate files with optional source maps.
@taskr/esnext			Allows async/await syntax within taskfile.js
@taskr/flatten			Flatten source files to a max of sub-dirs.
@taskr/gzip			Gzip plugin for Taskr
@taskr/htmlmin			Minify HTML with Taskr
@taskr/jest			Jest plugin for Taskr
@taskr/less			Compile LESS to CSS with Taskr
@taskr/postcss			PostCSS plugin for Taskr
@taskr/prettier			Prettier plugin for Taskr
@taskr/rev			Version/Hash assets for cache-busting
@taskr/sass			Compile SASS to CSS with Taskr
@taskr/shell			Execute shell commands with Taskr
@taskr/stylus			Compile Stylus to CSS with Taskr
@taskr/typescript			Compile Typescript with Taskr
@taskr/uglify			UglifyJS plugin for Taskr
@taskr/unflow			Remove Flow type annotations with Taskr
@taskr/watch			Watch files & Execute specified tasks on change
@taskr/zip			ZIP compress files with Taskr
generator-taskr			Official Yeoman generator

Community Plugins

Package	Version	Dependencies	Description
taskr-autoprefixer			CSS Autoprefixer plugin for Taskr
taskr-nunjucks			Render Nunjucks templates with Taskr
taskr-precache			Cache assets for offline use via service worker
taskr-svelte			Compile Svelte components with Taskr
taskr-xo			XO plugin for Taskr

License

MIT © Luke Edwards