Shuffle

A simple python module that is meant to simulate the action of shuffling a python List as if it were a deck of cards.

Types

Riffle - http://en.wikipedia.org/wiki/Shuffling#Riffle

Predictable behaviours that make a human riffle shuffle imperfect

Once a deck of cards is divided to each hand, the amount of cards in each hand is not (likely) equal.
As each thumb releases from it's half of the deck, sometimes more than one card drops from a single hand at a time.
As the deck in each hand gets more and more thin, the probability of larger chucks of cards dropping from each hand increases.

shuffle.riffle(List original[, int shuffles])

Overhand - http://en.wikipedia.org/wiki/Shuffling#Stripping_or_overhand

Predictable behaviours that make a human overhand shuffle imperfect

Random amounts of cards (chunks) are taken from the top and placed placed in the opposite hand in reverse order (retaining the order within each chunk)

shuffle.overhand(List original[, int shuffles])

Mongean - http://en.wikipedia.org/wiki/Shuffling#Mongean_shuffle

A very predictable shuffle, alternating placing the top card on the bottom/top of the new deck

shuffle.mongean(List original[, int shuffles])

Pile - http://en.wikipedia.org/wiki/Shuffling#Pile_shuffle

Predictable shuffle, dealing items into N piles and then rejoining the piles

shuffle.pile(List original, int piles[, int shuffles])

Installation

Now available via pip

sudo pip install shuffle

Or

git clone git://github.com/jondavidjohn/Card-Shuffle-for-Python.git shuffle
cd ./shuffle
sudo python setup.py install

Linux Users - Make sure you have the python-dev package installed

Usage

import shuffle

riffled_list = shuffle.riffle(original_list, 3)  # riffles the list 3 times
overhanded_list = shuffle.overhand(original_list, 2)  #overhand's the list 2 times
mongeaned_list = shuffle.mongean(original_list, 5)  #mongean shuffle 5 times
piled_list = shuffle.pile(original_list, 3, 6)  #pile shuffle, using 3 piles, 6 times

License

jondavidjohn/python-card-shuffle

About

Resources

License

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages