Redis backed Round-Robin player turn control
JavaScript
Permalink
Failed to load latest commit information.
test
.gitignore
README.md
index.js
package.json

README.md

NextPlayer

NextPlayer is a tool for keeping track of whose turn it is, Round Robin style. Players can be added or removed at will. NextPlayer relies on Redis for tracking data. This is a very generic module, it can be used for anything which needs to track Round Robin data where entries can be dynamically added and removed. Operations are atomic, relying on Redis MULTI calls.

If there's an existing module which does the same thing please let me know!

Example Usage

var NextPlayer = require('./index.js');
var nextplayer = new NextPlayer();
var ns = "game-12345";

nextplayer.add(ns, ["Larry", "Curly", "Shemp", "Moe"], function(err, list) {
  console.log('ADD', list); // Larry, Curly, Shemp, Moe
  nextplayer.remove(ns, "Shemp", function(err, list) {
    console.log('REMOVE', list); // Larry, Curly, Moe
    nextplayer.step(ns, function(err, list) {
      console.log('STEP1', list); // Curly, Moe, Larry
      nextplayer.step(ns, function(err, list) {
        console.log('STEP2', list); // Moe, Larry, Curly
        nextplayer.list(ns, function(err, list) {
          console.log('LIST', list); // Moe, Larry, Curly
          nextplayer.destroy(ns, function(err) {
            console.log('FIN');
            process.exit();
          });
        });
      });
    });
  });
});

Installation

npm install nextplayer

Methods

Note: If you want to use a Promise-based API, consider using Bluebird's Promisfy All feature.

Constructor

Creates a new instance of NextPlayer. An instance isn't tied to a particular game, think of it as a reusable service. Instead it's tied to a particular Redis key naming convention.

Options

  • keyPrefix: A List key representing the list of all players
  • redis: (Optional) A fully configured and instantiated redis client
  • redisOptions: (Optional) A list of redis connection options, defaults to local
var nextplayer = new NextPlayer({
  keyPrefix: 'list-',
  redis: redis.createClient({host: 'localhost', port: 6370})
});

.add(namespace, identifiers, callback)

If an array is provided, inserts a list of players to go last. Otherwise, adds a single player.

nextplayer.add(namespace, "tod", callback);
nextplayer.add(namespace, ["bev", "jim"], callback);

function callback(err, newList) {}

.set(namespace, identifiers, callback)

Much like add(), except any players already in the list will be replaced with this entirely new list.

nextplayer.set(namespace, "tod", callback);
nextplayer.set(namespace, ["bev", "jim"], callback);

function callback(err, newList) {}

.remove(namespace, identifier, callback)

Removes a single player, by identifier, from the list.

nextplayer.remove(namespace, "ted", callback);

function callback(err, newList) {}

.step(namespace, callback)

Cycles through the players in the list, so the current player is now the last player, and the next becomes current.

nextplayer.step(namespace, callback);

function callback(err, newList) {}

.list(namespace, callback)

Gets an array of all players in the list, starting with the current player.

nextplayer.list(namespace, callback);

function callback(err, list) {}

.current(namespace, callback)

Returns just the current player from the list.

nextplayer.current(namespace, callback);

function callback(err, current) {}

.destroy(namespace, callback)

Destroys all keys associated with the provided namespace. Doesn't destroy the NextPlayer instance.

nextplayer.destroy(namespace, callback);

function callback(err) {}