shuffle
node.js package for shuffling and dealing decks of cards (or anything else you'd like to shuffle)
Last updated 6 years ago by troygoode .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install shuffle 
SYNC missed versions from official npm registry.

shuffle

Shuffle is a node.js package for shuffling and dealing decks of cards (or anything else you'd like to shuffle).

NPM

build status

Installation (via npm)

$ npm install shuffle

Quick Start

Using shuffle is simple:

var Shuffle = require('shuffle');
var deck = Shuffle.shuffle();
var card = deck.draw();

Alternatively you can draw multiple cards at once:

var hand = deck.draw(5);

You can also use it to deal cards to multiple hands:

var player1, player2, player3, player4;
deck.deal(5, [player1, player2, player3, player4]);

The above deals a card to player #1 then player #2 then player #3 then player #4 then back again to player #1 until each player has five cards.

If you need to reset and reshuffle the deck, it is as easy as:

deck.reset(); //sets the deck back to a full 52-card deck, unshuffled
deck.shuffle();

More Stuff

You don't have to shuffle standard playing cards. You can shuffle other stuff too:

var Shuffle = require('shuffle');
var goFish = [{color: 'red', number: 1}, {color: 'blue', number: 2}, ...];
var deck = Shuffle.shuffle({deck: goFish});

You can also supply your own randomizer so that you can supply a custom seed:

var Shuffle = require('shuffle');
var srand = require('srand'); //https://github.com/isaacs/node-srand (npm install srand)
srand.seed(1000);
var deck = Shuffle.shuffle({random: function(){ return srand.random(); }});

Other deck methods:

deck.drawFromBottomOfDeck() // 1 card
deck.drawFromBottomOfDeck(5) // array of 5 cards

deck.drawRandom() // 1 card
deck.drawRandom(5) // array of 5 cards

deck.putOnTopOfDeck(card)
deck.putOnTopOfDeck([card, card, card])

deck.putOnBottomOfDeck(card)
deck.putOnBottomOfDeck([card, card, card])

deck.length // integer (# of cards left in deck)

License

MIT License

Author

Troy Goode (troygoode@gmail.com)

Current Tags

  • 0.2.2                                ...           latest (6 years ago)

6 Versions

  • 0.2.2                                ...           6 years ago
  • 0.2.1                                ...           7 years ago
  • 0.2.0                                ...           8 years ago
  • 0.1.2                                ...           9 years ago
  • 0.1.1                                ...           9 years ago
  • 0.1.0                                ...           9 years ago
Maintainers (1)
Downloads
Today 0
This Week 2
This Month 0
Last Day 1
Last Week 0
Last Month 2
Dependencies (0)
None
Dev Dependencies (2)

Copyright 2014 - 2016 © taobao.org |