A neat generic dice API.
Project description
Angda
Angda (A Neat Generic Dice API) is a dice-rolling API created in Python by Stephen Malone.
- See changes.md for a complete changelog.
- See license.md for licensing information.
Installation
- Install Python 3.7 or higher.
- Run
pip install angda
.
Usage
Angda can be used on the command-line or imported as a Python library.
Command-Line
Run angda --help
to see all available options.
$ angda 2d6+1
#1: 2d6+1 = 7.
$ angda 2d6+1 --quiet
7
$ angda 2d6+1 --details
Dice #1:
- String: 2d6+1.
- Fields: Dice=2, Size=6, Plus=1.
- Result: [4, 2] + 1 = 7.
Python Library
Use angda.roll
for simple rolls, or the Dice
class for more complex cases.
>>> import angda
>>> angda.roll('2d6+1')
7
>>> angda.roll('2d6+1', objects=True)
{'dice': Dice(2, 6, 1), 'roll': Roll(7, 1, [4, 2])}
>>> dice = angda.Dice(dice=4, size=6, plus=0)
>>> dice.roll()
Roll(7, 1, [4, 2])
Credits
Angda uses the following third-party libraries:
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
angda-0.1.0.tar.gz
(4.3 kB
view hashes)
Built Distribution
angda-0.1.0-py3-none-any.whl
(7.7 kB
view hashes)