gamble is a simple library that implements a collection of some common gambling-related classes
Features
- die, dice, d-notation
- cards, decks, hands
- poker ranks, hand comparison
Usage
Installation
pip install gamble
Basic Usage
Dice
import gamble
# create dice, defaults to 2 6-sided dice
dice = gamble.Dice()
# roll
dice.roll()
>>> 6
dice.rolls
>>> 1
# max, min
dice.max
>>> 12
dice.min
>>> 2
# d-notation for dice constructor
dice = gamble.Dice('d20+8')
# max, min
dice.max
>>> 28
dice.min
>>> 9
# parts
dice.parts
>>> [<d20 Die>, 8]
# roll_many
dice.roll_many(2)
>>> [8, 4]
# max_of, min_of
dice.max_of(3)
>>> (11, [7, 3, 11])
dice.min_of(3)
>>> (2, [2, 9, 4])
Cards
import gamble
# create a deck, defaults to the standard 52 card deck, no jokers
# the deck will be shuffled by default, unless you pass shuffle=False
deck = gamble.Deck()
deck.cards_left
>>> 52
deck.top
>>> <Card:7β >
deck.bottom
>>> <Card:9β >
deck.shuffle() # you can also pass times=(int) to shuffle more than once
card = deck.draw() # you can also pass times=(int) to draw a list of cards
>>> <Card:Aβ >
# the unicode cards icons are implemented as well!
card.unicode
>>> "π‘"
# draw a poker hand, default size 5
hand = deck.draw_hand(). # you can pass size=(int) to draw a different size hand
>>> <Hand[5](straight flush) [Aβ , 2β , 3β , 4β , 5β ]>
hand.rank
>>> Rank(name='straight flush', value=8)
# arbitrary hand, from text notation
new_hand = gamble.Hand.get("2c,3c,4c,Kc,Kh")
>>> <Hand[5](pair) [2β£, 3β£, 4β£, Kβ£, Kβ₯]>
new_hand.rank
>>> Rank(name='pair', value=1)
hand > new_hand
>>> True
Todo
- hand equals/ge/le method
- hand ranking when hands are very similar
78 Dec 13, 2022
5 May 1, 2022
4 Jan 7, 2022
3 Dec 17, 2022
3 Sep 12, 2022
18 Nov 28, 2022
1 May 24, 2022
76 Jan 7, 2023
54 Jan 2, 2023
10 Jun 16, 2022
1 Nov 30, 2021
203 Dec 28, 2022
155 Dec 28, 2022
531 Jan 04, 2023
59 Dec 19, 2022
245 Nov 24, 2022
57 Aug 04, 2022
1 Dec 09, 2021
7 Dec 14, 2022
3 Oct 09, 2022
1 Jul 31, 2022
1 Nov 06, 2021
2 Dec 09, 2021
1 Dec 10, 2021
1 Nov 08, 2021
0 Dec 16, 2021
1 Mar 14, 2022
10 Nov 04, 2022
1 Dec 22, 2021