python-rolldice in Launchpad

python-rolldice

Registered 2010-06-21 by BrandonTomlinson

Roll variously sided dice with syntax for tabletop games. It can be used as a library or a standalone application with the same parameters as rolldice. This is a python implementation of 'rolldice' by Stevie Strickland <sstrickl@cc.gatech.edu>.

pyrolldice.py can be run directly, see --help for documentation.

two concepts this module works with are "dice strings" and "dice dicts". A dice string is a properly formated string (see documentation), and dice dict is a dictionary object that holds a roll profile.

The module holds 3 utility functions
  -roll_dice takes a dice string and returns a list of results
  -parse_dice_string takes a dice string and returns a dice dict
  -roll_dice_dict takes a dice dict and returns a list of results

roll_dice simply passes it's string to parse_dice and then the resultant to roll_dice_dict.