flowless

Less but better control-flow library

node-flowless - Less but better control-flow library

flowless is not a flawless :)

var fs = require('fs');
var flowless = require('../index');

flowless.series([
  flowless.makeParallel([
    [fs.readFile, 'path1', 'utf8'],
    [fs.readFile, 'path2', 'utf8']
  ]),
  function(results, cb) {
    fs.writeFile('path3', results.join(''), cb);
  },
  [fs.readFile, 'path3', 'utf8']
], function(err, result) {
  if (this.err) throw this.err;
  console.log(result);
  console.log('all done');
});
$ npm install flowless

Runs functions in series.

  • Arguments
    • functions: An array of functions. It can contain an array passed to makeFunc().
    • cb: A callback function.

Returns a new function which runs functions in series.

  • Arguments
    • functions: An array of functions. It can contain an array passed to makeFunc().
  • Returns
    • A function which runs functions in series.

      `function([args...] cb)`
      
    • Arguments

      • args: Zero or more arguments that will be passed to first element of functions.
      • cb: A callback function.

Runs functions in parallel.

  • Arguments
    • functions: An array of functions. It can contain an array passed to makeFunc().
    • cb: A callback function.

Returns a new function which runs functions in parallel.

  • Arguments
    • functions: An array of functions. It can contain an array passed to makeFunc().
  • Returns
    • A new function which runs functions in parallel.

      `function([args...] cb)`
      
    • Arguments

      • args: Zero or more arguments that will be passed to all element of functions.
      • cb: A callback function.

Returns a new function from a template.

  • Arguments
    • template: An array of function template. The first element must be a function. The rest of elements are used as a parameter of the function. The array can include a special value, flowless.first, flowless.second and flowless.third. When the returned function is called, they are replaced with the actual argument of a corresponding position.
  • Returns
    • A function which invokes the first element of template.

      `function([args,...] cb)`
      
    • Arguments

      • args: Zero or more arguments. If template includes a special value, it is replaced with args of a corresponding position.
      • cb: A callback function. It is added to the rest of template.

Example:

var fn = flowless.makeFunc(['fs.readFile', flowless.first, 'utf8']);
fn('foo.txt', cb);

is equivalent of:

fs.readFile('foo.txt', 'utf8', cb);

flowless is inspired by Slide.

License

flowless is licensed under the MIT license.