tnabtaf/dnd-roller3

Simple python app to roll dice for D&D (Dungeons&Dragons) US RSE Test

dnd-roller3

Simple python app to roll dice for D&D (Dungeons&Dragons) US RSE Test

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.

Examples

Rolling a single game die:

>>> from dnd_roller import roll
>>> roll(d=4)
4
>>> roll(d=20, verbose=true)
You rolled  17
17

Rolling 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]}