setup.py

from distutils.core import setup, Extension

module = Extension('shuffle', sources=['shufflemodule.c'])
setup(
	name = 'shuffle',
	version = '0.9',
	description = 'Simulate Human Card Shuffling Techniques for use with Python Lists',
	author = 'Jonathan Johnson',
	author_email = 'me@jondavidjohn.com',
	url = 'https://github.com/jondavidjohn/Card-Shuffle-for-Python',
    download_url = "https://github.com/jondavidjohn/Card-Shuffle-for-Python/tarball/master",
    keywords = ["card", "shuffle", "list", "random"],
    classifiers = [
        "Programming Language :: Python",
        "Programming Language :: Python :: 3",
        "Development Status :: 4 - Beta",
        "Intended Audience :: Developers",
        "License :: OSI Approved :: MIT License",
        "Operating System :: OS Independent",
        "Topic :: Software Development :: Libraries :: Python Modules",
        "Topic :: Utilities"
    ],
    long_description = """\
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
============

::

    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
""",
	ext_modules=[module]
)