wrr-pool

Weighted Round Robin Resource pool

Usage no npm install needed!

<script type="module">
  import wrrPool from 'https://cdn.skypack.dev/wrr-pool';
</script>

README

Build Status Test Coverage Dependencies DevDependencies

WRRPool

WRRPool is a Weighted Round Robin resource pool

Using

npm install wrr-pool

Basic usage

var WRRPool = require('wrr-pool');

var pool = new WRRPool();

pool.add('A', 4); // pool.add({ host: '10.0.1.10', port: 8087}, 4)
pool.add('B', 3); // pool.add({ host: '10.0.1.11', port: 8087}, 3)
pool.add('C', 2); // pool.add({ host: '10.0.1.12', port: 8087}, 2)

pool.next(); // A
pool.next(); // A
pool.next(); // B
pool.next(); // A
pool.next(); // B
pool.next(); // C
pool.next(); // A
pool.next(); // B
pool.next(); // C

Get resource and its weight

var pool = new WRRPool();

pool.add({ id: 1 }, 4);
pool.add({ id: 2 }, 3);
pool.add({ id: 3 }, 2);

pool.get({ id: 2 }); // => { value: { id: 2 }, weight: 3 }
var pool = new WRRPool();

pool.add({ id: 1 }, 4);
pool.add({ id: 2 }, 3);
pool.add({ id: 3 }, 2);

pool.get(function (v){ return v.id === 2; }); // => { value: { id: 2 }, weight: 3 }

Update resource value and/or weight

var pool = new WRRPool();

pool.add('A', 4);
pool.add('B', 3);
pool.add('C', 2);

// update value to 'B1' and weight to 4
pool.update(function (v) { return v === 'B';}, 'B1', 4); // => returns index of updated element or undefined if not found

Remove resource from pool

var pool = new WRRPool();

pool.add('A', 4);
pool.add('B', 3);
pool.add('C', 2);

pool.remove(function (v) { return v === 'C';});  // => returns index of removed element or undefined if not found

License

MIT