async-pool/README.md

asynchronous event pool based on bluebird

# async-pool
asynchronous resource pool using bluebird

## Installation

    npm install async-pool
  
## Usage

    AsyncPool = require 'async-pool'
    Promise = require 'bluebird'
  
    pool = new AsyncPool(['foo', 'bar', 'baz'])
  
    Promise.map [1..8], (i)->
      Promise.using pool.use(), (s)->
        console.log(s, pool.resources.length, pool.waiting.length)
        if i % 2 == 0
          throw new Error("Even numbers are bad luck.")
      .catch (err)->
      
Produces:

    baz 0 5
    bar 0 5
    foo 0 5
    baz 0 2
    bar 0 2
    foo 0 2
    baz 1 0
    bar 1 0
      
Also see [async-proxy-pool](https://github.com/shaunc/async-proxy-pool) which extends async pool, supporting parallel as well as serial access.