Simply python app to roll dice for D&D
The dnd_roller provides three main functions: roll, dice_roll, and sequence_rolls to generate a single die roll, multiple rolls of the same die, or multiple rolls of multiple dice.
The former (i.e. roll()) could generate an output in the terminal using emoji characters, whilst the latter (i.e. sequence_rolls()) generate a tabular report for the outcome of each roll in the sequence.
Please have a look at the examples below for additional details.
Rolling a single game die:
>>> from dnd_roller import roll
>>> roll(d=4)
4
>>> roll(d=20, verbose=true)
🎲
You rolled 1️⃣ 7️⃣
17Rolling multiple times the same game die:
>>> from dnd_roller import dice_roll
>>> dice_roll(throws=3, sides=4)
[3, 2, 4]Rolling a sequence of dice rolls:
>>> from dnd_roller import sequence_rolls
>>> sequence_rolls(sequence="12d20, 4d4, 2d10, 1d100", verbose=True)
╒════════╤════════════════════════════════════════════════╤═══════╕
│ dice │ rolls │ sum │
╞════════╪════════════════════════════════════════════════╪═══════╡
│ 12d20 │ [15, 9, 13, 2, 14, 13, 18, 15, 13, 10, 17, 18] │ 157 │
├────────┼────────────────────────────────────────────────┼───────┤
│ 4d4 │ [2, 3, 2, 1] │ 8 │
├────────┼────────────────────────────────────────────────┼───────┤
│ 2d10 │ [8, 5] │ 13 │
├────────┼────────────────────────────────────────────────┼───────┤
│ 1d100 │ [50] │ 50 │
╘════════╧════════════════════════════════════════════════╧═══════╛
{'12d20': [15, 9, 13, 2, 14, 13, 18, 15, 13, 10, 17, 18],
'4d4': [2, 3, 2, 1],
'2d10': [8, 5],
'1d100': [50]}