poker-cli 0.11.2__py3-none-any.whl

poker_cli/__init__.py

@@ -0,0 +1,3 @@
+"""Terminal Texas Hold'em."""
+
+__version__ = "0.11.2"

poker_cli/builtin_ranges.py

@@ -0,0 +1,132 @@
+from __future__ import annotations
+
+from .ranges import RangeSource, RangeSpot, parse_pio_range
+
+
+SOURCE = RangeSource(
+    name="PokerCoaching official chart",
+    url="https://pokercoaching.com/preflop-charts/",
+    note=(
+        "Official public study chart. 100BB cash, no ante; RFI 2.5BB "
+        "(SB 3BB), IP 3-bet 3.5x, OOP 3-bet 4x."
+    ),
+)
+
+
+# Transcribed from the official public chart above. The source deliberately
+# simplifies mixed solver frequencies to one implementable action per combo.
+RANGES = {
+    "RFI_UTG": {
+        "raise": "AA,AKs,AQs,AJs,ATs,A9s,A8s,A7s,A6s,A5s,A4s,A3s,AKo,KK,KQs,KJs,KTs,K9s,K8s,AQo,KQo,QQ,QJs,QTs,Q9s,AJo,KJo,QJo,JJ,JTs,J9s,ATo,TT,T9s,99,88,77,66"
+    },
+    "RFI_HJ": {
+        "raise": "AA,AKs,AQs,AJs,ATs,A9s,A8s,A7s,A6s,A5s,A4s,A3s,A2s,AKo,KK,KQs,KJs,KTs,K9s,K8s,K7s,K6s,AQo,KQo,QQ,QJs,QTs,Q9s,Q8s,AJo,KJo,QJo,JJ,JTs,J9s,ATo,KTo,QTo,TT,T9s,99,98s,88,87s,77,76s,66,55"
+    },
+    "RFI_CO": {
+        "raise": "AA,AKs,AQs,AJs,ATs,A9s,A8s,A7s,A6s,A5s,A4s,A3s,A2s,AKo,KK,KQs,KJs,KTs,K9s,K8s,K7s,K6s,K5s,K4s,K3s,AQo,KQo,QQ,QJs,QTs,Q9s,Q8s,Q7s,Q6s,AJo,KJo,QJo,JJ,JTs,J9s,J8s,ATo,KTo,QTo,JTo,TT,T9s,T8s,T7s,A9o,99,98s,97s,A8o,88,87s,77,76s,66,55,44,33"
+    },
+    "RFI_BTN": {
+        "raise": "AA,AKs,AQs,AJs,ATs,A9s,A8s,A7s,A6s,A5s,A4s,A3s,A2s,AKo,KK,KQs,KJs,KTs,K9s,K8s,K7s,K6s,K5s,K4s,K3s,K2s,AQo,KQo,QQ,QJs,QTs,Q9s,Q8s,Q7s,Q6s,Q5s,Q4s,Q3s,AJo,KJo,QJo,JJ,JTs,J9s,J8s,J7s,J6s,J5s,J4s,ATo,KTo,QTo,JTo,TT,T9s,T8s,T7s,T6s,A9o,K9o,Q9o,J9o,T9o,99,98s,97s,96s,A8o,K8o,T8o,98o,88,87s,86s,85s,A7o,77,76s,75s,A6o,66,65s,64s,A5o,55,54s,53s,A4o,44,33,22"
+    },
+    "RFI_SB": {
+        "raise": "AKs,ATs,A9s,A8s,A7s,A5s,KK,KJs,KTs,K8s,K5s,K3s,K2s,AQo,QQ,QJs,QTs,Q5s,Q4s,Q3s,Q2s,AJo,KJo,JJ,JTs,J7s,J6s,J5s,J4s,T9s,T6s,T5s,K9o,Q9o,J9o,96s,A8o,K8o,T8o,98o,A7o,K7o,A6o,65s,64s,54s,53s,A4o,33,22",
+        "call": "AA,AQs,AJs,A6s,A4s,A3s,A2s,AKo,KQs,K9s,K7s,K6s,K4s,KQo,Q9s,Q8s,Q7s,Q6s,QJo,J9s,J8s,J3s,J2s,ATo,KTo,QTo,JTo,TT,T8s,T7s,T4s,T3s,A9o,T9o,99,98s,97s,95s,94s,Q8o,J8o,88,87s,86s,85s,84s,Q7o,J7o,T7o,97o,87o,77,76s,75s,74s,K6o,Q6o,86o,76o,66,63s,A5o,K5o,Q5o,55,K4o,44,43s,A3o,A2o",
+    },
+    "HJ_VS_UTG": {
+        "raise": "AA,AKs,AQs,AJs,ATs,A5s,AKo,KK,KQs,KJs,KTs,AQo,KQo,QQ,QJs,JJ,TT,99"
+    },
+    "CO_VS_UTG": {
+        "raise": "AA,AKs,AQs,AJs,ATs,A5s,AKo,KK,KQs,KJs,KTs,AQo,KQo,QQ,QJs,JJ,TT,99,88"
+    },
+    "CO_VS_HJ": {
+        "raise": "AA,AKs,AQs,AJs,ATs,A9s,A5s,A4s,AKo,KK,KQs,KJs,KTs,AQo,KQo,QQ,QJs,AJo,JJ,TT,99,88"
+    },
+    "BTN_VS_UTG": {
+        "raise": "AA,AKs,AQs,A9s,A8s,A4s,A3s,AKo,KK,K9s,KQo,QQ,QJs,AJo,JJ,T9s",
+        "call": "AJs,ATs,A5s,KQs,KJs,KTs,AQo,QTs,JTs,TT,99,88,77,76s,66,65s,55,54s",
+    },
+    "BTN_VS_HJ": {
+        "raise": "AA,AKs,AQs,A9s,A8s,A7s,A4s,A3s,AKo,KK,KTs,K9s,K8s,KQo,QQ,QTs,Q9s,AJo,JJ,T9s,66",
+        "call": "AJs,ATs,A5s,KQs,KJs,AQo,QJs,JTs,TT,99,98s,88,87s,77,55,44",
+    },
+    "BTN_VS_CO": {
+        "raise": "AA,AKs,AQs,A8s,A7s,A6s,A4s,A3s,AKo,KK,KQs,K9s,KQo,QQ,QJs,Q9s,AJo,KJo,QJo,JJ,JTs,J9s,ATo,TT,55",
+        "call": "AJs,ATs,A9s,A5s,KJs,KTs,AQo,QTs,T9s,99,98s,88,77,66",
+    },
+    "SB_VS_UTG": {
+        "raise": "AA,AKs,AQs,AJs,ATs,A5s,AKo,KK,KQs,KJs,KTs,AQo,QQ,QJs,JJ,TT,99"
+    },
+    "SB_VS_HJ": {
+        "raise": "AA,AKs,AQs,AJs,ATs,A5s,AKo,KK,KQs,KJs,KTs,AQo,QQ,QJs,QTs,JJ,JTs,TT,99,88,77"
+    },
+    "SB_VS_CO": {
+        "raise": "AA,AKs,AQs,AJs,ATs,A9s,A5s,AKo,KK,KQs,KJs,KTs,AQo,KQo,QQ,QJs,QTs,JJ,JTs,J9s,TT,T9s,99,88,77,66"
+    },
+    "SB_VS_BTN": {
+        "raise": "AA,AKs,AQs,AJs,ATs,A9s,A8s,A7s,A5s,A4s,AKo,KK,KQs,KJs,KTs,K9s,AQo,KQo,QQ,QJs,QTs,Q9s,AJo,KJo,JJ,JTs,J9s,TT,T9s,T8s,99,88,77,66,55"
+    },
+    "BB_VS_UTG": {
+        "raise": "AA,AKs,AQs,A5s,A4s,AKo,KK,KQs,KJs,QQ,QJs,JJ,JTs,65s,54s",
+        "call": "AJs,ATs,A9s,A8s,A7s,A6s,A3s,A2s,KTs,K9s,K8s,K7s,K6s,K5s,K4s,K3s,K2s,AQo,KQo,QTs,Q9s,Q8s,Q7s,Q6s,Q5s,AJo,KJo,QJo,J9s,J8s,ATo,JTo,TT,T9s,T8s,T7s,99,98s,97s,96s,88,87s,86s,85s,77,76s,75s,74s,66,64s,63s,55,53s,44,43s,33,32s,22",
+    },
+    "BB_VS_HJ": {
+        "raise": "AA,AKs,AQs,A9s,A5s,A4s,AKo,KK,KQs,KJs,KTs,K5s,QQ,QJs,QTs,JJ,JTs,TT,65s,54s",
+        "call": "AJs,ATs,A8s,A7s,A6s,A3s,A2s,K9s,K8s,K7s,K6s,K4s,K3s,K2s,AQo,KQo,Q9s,Q8s,Q7s,Q6s,Q5s,AJo,KJo,QJo,J9s,J8s,J7s,ATo,KTo,QTo,JTo,T9s,T8s,T7s,A9o,99,98s,97s,96s,88,87s,86s,85s,77,76s,75s,74s,66,64s,63s,55,53s,44,43s,33,22",
+    },
+    "BB_VS_CO": {
+        "raise": "AA,AKs,AQs,AJs,A9s,A5s,A4s,AKo,KK,KQs,KJs,KTs,AQo,QQ,QJs,QTs,Q9s,JJ,JTs,J9s,TT,T9s,99,65s,54s",
+        "call": "ATs,A8s,A7s,A6s,A3s,A2s,K9s,K8s,K7s,K6s,K5s,K4s,K3s,K2s,KQo,Q8s,Q7s,Q6s,Q5s,Q4s,Q3s,AJo,KJo,QJo,J8s,J7s,J6s,ATo,KTo,QTo,JTo,T8s,T7s,A9o,T9o,98s,97s,96s,A8o,88,87s,86s,85s,77,76s,75s,74s,66,64s,63s,A5o,55,53s,52s,44,43s,33,22",
+    },
+    "BB_VS_BTN": {
+        "raise": "AA,AKs,AQs,AJs,ATs,A6s,A5s,A4s,AKo,KK,KQs,KJs,KTs,K9s,AQo,KQo,QQ,QJs,QTs,Q9s,JJ,JTs,J9s,J8s,TT,T9s,T8s,99,98s,97s,88,87s,76s,65s,54s",
+        "call": "A9s,A8s,A7s,A3s,A2s,K8s,K7s,K6s,K5s,K4s,K3s,K2s,Q8s,Q7s,Q6s,Q5s,Q4s,Q3s,Q2s,AJo,KJo,QJo,J7s,J6s,J5s,J4s,J3s,J2s,ATo,KTo,QTo,JTo,T7s,T6s,T5s,T4s,T3s,T2s,A9o,K9o,Q9o,J9o,T9o,96s,95s,94s,A8o,K8o,Q8o,J8o,T8o,98o,86s,85s,84s,A7o,K7o,87o,77,75s,74s,73s,A6o,K6o,76o,66,64s,63s,62s,A5o,65o,55,53s,52s,A4o,54o,44,43s,42s,A3o,33,32s,22",
+    },
+}
+
+
+def builtin_spots() -> list[RangeSpot]:
+    spots: list[RangeSpot] = []
+    for key, expressions in RANGES.items():
+        if key.startswith("RFI_"):
+            scenario = "RFI"
+            position = key.removeprefix("RFI_")
+            opener = None
+            open_size = 3.0 if position == "SB" else 2.5
+        else:
+            position, opener = key.split("_VS_")
+            scenario = "VS_OPEN"
+            open_size = 2.5
+        actions = {
+            action: parse_pio_range(expression)
+            for action, expression in expressions.items()
+        }
+        totals = {
+            combo: sum(values.get(combo, 0.0) for values in actions.values())
+            for combo in _all_combos()
+        }
+        actions["fold"] = {
+            combo: 1.0 - total for combo, total in totals.items() if total < 1.0
+        }
+        spots.append(
+            RangeSpot(
+                spot_id=f"pokercoaching-6max-100bb-{key.lower()}",
+                source=SOURCE,
+                format="6-max cash · 100BB · no ante",
+                players=6,
+                stack_bb=100,
+                ante_bb=0,
+                position=position,
+                scenario=scenario,
+                opener=opener,
+                open_size_bb=open_size,
+                actions=actions,
+                reference_only=True,
+            )
+        )
+    return spots
+
+
+def _all_combos() -> tuple[str, ...]:
+    from .ranges import ALL_COMBOS
+
+    return ALL_COMBOS

poker_cli/cards.py

@@ -0,0 +1,42 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+import random
+
+RANKS = "23456789TJQKA"
+SUITS = "cdhs"
+SUIT_SYMBOLS = {"c": "♣", "d": "♦", "h": "♥", "s": "♠"}
+
+
+@dataclass(frozen=True, order=True)
+class Card:
+    rank: int
+    suit: str
+
+    @classmethod
+    def parse(cls, value: str) -> "Card":
+        value = value.strip()
+        if len(value) != 2 or value[0].upper() not in RANKS or value[1].lower() not in SUITS:
+            raise ValueError(f"invalid card: {value}")
+        return cls(RANKS.index(value[0].upper()) + 2, value[1].lower())
+
+    def __str__(self) -> str:
+        return f"{RANKS[self.rank - 2]}{SUIT_SYMBOLS[self.suit]}"
+
+    def code(self) -> str:
+        return f"{RANKS[self.rank - 2]}{self.suit}"
+
+
+class Deck:
+    def __init__(self, rng: random.Random | None = None) -> None:
+        self._rng = rng or random.Random()
+        self.cards = [Card(rank, suit) for rank in range(2, 15) for suit in SUITS]
+        self._rng.shuffle(self.cards)
+
+    def draw(self, count: int = 1) -> list[Card]:
+        if count > len(self.cards):
+            raise ValueError("not enough cards")
+        result = self.cards[-count:]
+        del self.cards[-count:]
+        return result
+