npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

paratask-promises

v4.0.1

Published

Paratask is a tool that will execute your Back-end JavaScript code in parallel using the full potential of multi-process programming. In contrast to asynchronous task management, Paratask will create a child Node/io.js process.

Downloads

6

Readme

Paratask - Node Parallel Process Manager

Build Status NPM version

Paratask is a tool that will execute your code in parallel using the full potential of multi-process programming. In contrast to asynchronous task management, Paratask will create a child Node/io.js process in which your task function will 'live'.

Note: Scope dependency injection is at your service. More into in the examples below.

Note: This modules embraces the Promises/A+ standard. If you're more into ES5 "callback" style you can use paratask

Install

You can install Paratask Promises/A+ with the Node Package Manager:

npm install paratask-promises

or by getting it from this repo.

Dependencies

Paratask uses only native Node/io.js modules that do not need additional installation: fs and child_process.

Custom Promise lib

You like to use your own Promise constructor or 3rd party alternative? No problem, just type:

var paratask = require('paratask-promises');

paratask.usePromise( require('bluebird').Promise );
// or
paratask.usePromise( require('q').Promise );
// or
paratask.usePromise( require('when').Promise );
// or
paratask.usePromise( require('rsvp').Promise );

Thanks to machinewu for the great suggestion.

Example: Parallel calculation

Both task_1 and task_2 will fork a new Node/io.js process and will run concurrently. When both call resolve(), the final results will be printed in the console.

Note: scope property is your dependency injector. Can only be a valid JSON.parse() value (i.e. no functions allowed).

var paratask = require('paratask-promises');

var task_1 = {
  fork: function (resolve) {
    // Some calculation using the 'count' scope var
    var result = count * 10;
    resolve(result);
  },
  scope: {
    count: 10
  }
};

var task_2 = {
  fork: function (resolve) {
    // Some calculation using the 'count' scope var
    var result = count * 10;
    resolve(result);
  },
  scope: {
    count: 20
  }
};

paratask([ task_1, task_2 ])
.then(function (results) {
  console.log( results );  // [100, 200], 1st task result will be always the 1st in the results array even if completed last
});

Example: Error handling

Both task_1 and task_2 will fork a new process but when task_2 call reject('Error message') both processes will be killed and the final .then() will be executed.

Note: scope property is optional.

var paratask = require('paratask-promises');

var task_1 = {
  fork: function (resolve) {
    var count     = 100000;
    var factorial = 1;

    while (--count) factorial *= count;

    resolve(factorial);
  }
};

var task_2 = {
  fork: function (resolve, reject) {
    reject('Error message');
  }
};

paratask([ task_1, task_2 ])
.catch(function (error) {
  console.log( error );  // 'Error message'
});

Comparison tests

A palette of comparison tests between paratask(), async.parallel(), and process.nextTick() are available in ./tests folder.

Heavy calculation test:

node tests/async_heavy_test.js
node tests/process_nextTick_heavy_test.js
node tests/paratask_heavy_test.js

Conclusion

Paratask is great when you have several time consuming task functions with few external dependencies. In such cases, multi-processing is the best approach. When you want to manage several relevantly quick functions with asynchronous logic, async will handle it with beauty.