Skip to content

A generator & coroutine-based task runner. Fasten your seatbelt. πŸš€

License

Notifications You must be signed in to change notification settings

lukeed/taskr-outdated

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Taskr

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

Community Plugins

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

License

MIT Β© Luke Edwards