Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Manage a pool of disposable processes working on queued jobs
JavaScript
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib
stress
test
.gitignore
.travis.yml
LICENSE
README.md
package.json

README.md

node-hirelings

Build Status

node-hirelings is a lightweight work queue using child processes.

Use this to perform work that might:

  • block the event loop;
  • fail spectacularly;
  • be aborted impolitely;
  • be retried a few times;
  • report progress;
  • be measured with statsd or suchlike.

This is heavily inspired by lloyd/compute-cluster. In fact, node-hirelings began life as a great big pull request before I realized that was a dumb idea and just started my own project.

Installation

$ npm install node-hirelings

Usage

TODO: Need something sensible here. Tests are an example, for now.

API

TODO: Need something sensible here. Maybe pointer to docco output from lib/hirelings.js?

Frequently Anticipated Questions

  • Why "hirelings"?
    • It amuses me to pick odd names for projects. Hirelings are the semi-disposable, semi-reliable hired help that players can pick up in role-playing games.

TODO

  • Further limit respawning workers that die early. Maybe kill the pool entirely with an error if too many workers are dying in a span of time.

  • Promises-based API?

License

This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/.

Something went wrong with that request. Please try again.