poker-cli 0.11.2__tar.gz

poker_cli-0.11.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 redearly123
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

poker_cli-0.11.2/PKG-INFO

@@ -0,0 +1,201 @@
+Metadata-Version: 2.4
+Name: poker-cli
+Version: 0.11.2
+Summary: A privacy-safe, terminal Texas Hold'em game with optional LLM opponents and hand review.
+Author: redearly123
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/redearly123/terminal-poker
+Project-URL: Repository, https://github.com/redearly123/terminal-poker
+Project-URL: Issues, https://github.com/redearly123/terminal-poker/issues
+Keywords: poker,texas-holdem,terminal,tui,codex,claude
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Games/Entertainment :: Board Games
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich<15,>=14.1
+Dynamic: license-file
+
+# Terminal Poker
+
+[![CI](https://github.com/redearly123/terminal-poker/actions/workflows/ci.yml/badge.svg)](https://github.com/redearly123/terminal-poker/actions/workflows/ci.yml)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-3776AB)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+在终端里玩一届完整的德州扑克锦标赛。默认 6-max Sit & Go，由本机
+Codex / Claude Code 登录态驱动 AI 对手，并在比赛结束后复盘你的决策。
+
+## 核心能力
+
+- 让 AI 当你的德扑搭子，也可以全程使用离线对手
+- TUI 可视化牌桌：手牌、公共牌、筹码、动作、翻牌动画和摊牌
+- 自动保存锦标赛进度，随时退出、继续
+- 长期保存每手牌、公开行动、筹码变化和玩家决策
+- 记录整届比赛的玩家决策，结束后由 AI 集中复盘
+- 内置有明确来源的翻前范围表，支持导入自己的求解器数据
+- 模型只会收到自己的底牌与公开信息，不会看到其他玩家手牌
+
+## 安装
+
+需要 Python 3.11+。推荐使用 `pipx` 安装成全局命令：
+
+```bash
+pipx install git+https://github.com/redearly123/terminal-poker.git
+poker
+```
+
+本地开发安装：
+
+```bash
+git clone https://github.com/redearly123/terminal-poker.git
+cd terminal-poker
+python3 -m venv .venv
+.venv/bin/python -m pip install -e .
+.venv/bin/poker
+```
+
+Codex / Claude Code 只在在线对手和 AI 复盘时需要。没有安装或登录，也能在
+开局菜单选择“离线混合”正常游玩。
+
+## 开始游戏
+
+```bash
+poker
+```
+
+一个页面完成全部设置：
+
+- `↑/↓` 或 `Tab`：移动
+- `←/→`：切换选项
+- `Enter`：开始
+- `Esc/Q`：退出
+
+牌桌操作：
+
+```text
+1  Fold
+2  Check / Call
+3  Raise
+4  翻前范围表
+5  无法继续行动时快进本手
+```
+
+加注金额表示“本轮总下注到多少”。每手结算后按 `1` 继续，按 `0` 结束。
+
+继续最近存档、查看长期记录和模型额度：
+
+```bash
+poker resume
+poker history
+poker history --limit 20
+poker history path
+poker usage
+```
+
+## AI 对手与复盘
+
+开局菜单可选择 Codex、Claude Code、混合在线或纯离线对手。程序复用本机
+CLI 的现有登录态，不读取或复制凭据；Claude 默认使用较省额度的 Haiku。
+在线对手默认每个行动都调用模型。开局页面会记住上一次成功确认的全部设置，
+下次运行 `poker` 时自动恢复。需要更快的混合模式时，可改为只在大额跟注、
+较大底池和转河关键节点调用模型；该模式全桌每手最多调用 3 次：
+
+```bash
+poker --online-policy key
+```
+
+默认在整届锦标赛结束后集中复盘，也可以改成逐手复盘或完全关闭：
+
+```bash
+poker --review tournament
+poker --review hand
+poker --review none
+```
+
+每次模型调用只包含该对手自己的底牌、公共牌、公开行动、筹码和合法动作。
+完整引擎、牌堆及其他玩家底牌不会进入模型输入；调用失败时会自动切换到离线
+策略，不中断牌局。
+
+## 长期牌局记录
+
+默认把每一手追加到本机 JSONL 历史中，包括牌面、完整公开行动、盲注、前后
+筹码、结果和你的决策分析。对手底牌只在实际摊牌公开后记录；未亮出的牌不会
+写入文件。开局菜单可关闭，命令行也可使用 `--no-history`。
+
+## 翻前范围表
+
+牌桌内按 `4` 打开。颜色分别表示 jam、raise、call、混合频率和 fold，并
+标出当前手牌。
+
+内置表来自
+[PokerCoaching 公开的 6-max 图表](https://pokercoaching.com/preflop-charts/)。
+完全匹配显示 `EXACT`；人数、筹码或行动树不完全匹配时显示 `REFERENCE`
+并说明偏差，不会把 100BB 现金桌参考冒充成精确短码或 ICM 解。
+
+导入自己的 FreeBetRange / 求解器范围：
+
+```bash
+poker ranges example
+poker ranges import ~/Downloads/my-ranges.json
+poker ranges list
+```
+
+## 常用参数
+
+```bash
+poker --opponent mixed       # 纯离线
+poker --coach codex          # Codex 复盘
+poker --codex-model gpt-5.4-mini
+poker --claude-model sonnet  # 更换 Claude 模型
+poker --online-policy key    # 仅关键局面在线思考
+poker --blind-speed turbo    # 加快升盲
+poker --size compact         # 调整牌桌尺寸
+poker --theme classic        # 更换皮肤
+poker --plain                # 纯文本模式
+```
+
+完整参数：
+
+```bash
+poker --help
+```
+
+## 验证
+
+```bash
+PYTHONPATH=src python -m unittest discover -s tests -v
+```
+
+## 发布
+
+`main` 用于持续开发，不会自动覆盖 PyPI。发布新版本只需打开 GitHub
+Actions 的 `Release`，点击 `Run workflow`，选择 `patch`、`minor` 或
+`major`。工作流会自动修改版本、测试、提交、打 tag、创建 Release，并通过
+Trusted Publishing 上传 PyPI。
+
+首次发布前，仓库所有者只需在 PyPI 添加一次 Trusted Publisher：
+
+```text
+Owner: redearly123
+Repository: terminal-poker
+Workflow: publish.yml
+Environment: pypi
+```
+
+已安装用户仍需主动更新：
+
+```bash
+pipx upgrade poker-cli
+# 或
+python -m pip install --upgrade poker-cli
+```
+
+MIT Licensed.

poker_cli-0.11.2/README.md

@@ -0,0 +1,175 @@
+# Terminal Poker
+
+[![CI](https://github.com/redearly123/terminal-poker/actions/workflows/ci.yml/badge.svg)](https://github.com/redearly123/terminal-poker/actions/workflows/ci.yml)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-3776AB)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+在终端里玩一届完整的德州扑克锦标赛。默认 6-max Sit & Go，由本机
+Codex / Claude Code 登录态驱动 AI 对手，并在比赛结束后复盘你的决策。
+
+## 核心能力
+
+- 让 AI 当你的德扑搭子，也可以全程使用离线对手
+- TUI 可视化牌桌：手牌、公共牌、筹码、动作、翻牌动画和摊牌
+- 自动保存锦标赛进度，随时退出、继续
+- 长期保存每手牌、公开行动、筹码变化和玩家决策
+- 记录整届比赛的玩家决策，结束后由 AI 集中复盘
+- 内置有明确来源的翻前范围表，支持导入自己的求解器数据
+- 模型只会收到自己的底牌与公开信息，不会看到其他玩家手牌
+
+## 安装
+
+需要 Python 3.11+。推荐使用 `pipx` 安装成全局命令：
+
+```bash
+pipx install git+https://github.com/redearly123/terminal-poker.git
+poker
+```
+
+本地开发安装：
+
+```bash
+git clone https://github.com/redearly123/terminal-poker.git
+cd terminal-poker
+python3 -m venv .venv
+.venv/bin/python -m pip install -e .
+.venv/bin/poker
+```
+
+Codex / Claude Code 只在在线对手和 AI 复盘时需要。没有安装或登录，也能在
+开局菜单选择“离线混合”正常游玩。
+
+## 开始游戏
+
+```bash
+poker
+```
+
+一个页面完成全部设置：
+
+- `↑/↓` 或 `Tab`：移动
+- `←/→`：切换选项
+- `Enter`：开始
+- `Esc/Q`：退出
+
+牌桌操作：
+
+```text
+1  Fold
+2  Check / Call
+3  Raise
+4  翻前范围表
+5  无法继续行动时快进本手
+```
+
+加注金额表示“本轮总下注到多少”。每手结算后按 `1` 继续，按 `0` 结束。
+
+继续最近存档、查看长期记录和模型额度：
+
+```bash
+poker resume
+poker history
+poker history --limit 20
+poker history path
+poker usage
+```
+
+## AI 对手与复盘
+
+开局菜单可选择 Codex、Claude Code、混合在线或纯离线对手。程序复用本机
+CLI 的现有登录态，不读取或复制凭据；Claude 默认使用较省额度的 Haiku。
+在线对手默认每个行动都调用模型。开局页面会记住上一次成功确认的全部设置，
+下次运行 `poker` 时自动恢复。需要更快的混合模式时，可改为只在大额跟注、
+较大底池和转河关键节点调用模型；该模式全桌每手最多调用 3 次：
+
+```bash
+poker --online-policy key
+```
+
+默认在整届锦标赛结束后集中复盘，也可以改成逐手复盘或完全关闭：
+
+```bash
+poker --review tournament
+poker --review hand
+poker --review none
+```
+
+每次模型调用只包含该对手自己的底牌、公共牌、公开行动、筹码和合法动作。
+完整引擎、牌堆及其他玩家底牌不会进入模型输入；调用失败时会自动切换到离线
+策略，不中断牌局。
+
+## 长期牌局记录
+
+默认把每一手追加到本机 JSONL 历史中，包括牌面、完整公开行动、盲注、前后
+筹码、结果和你的决策分析。对手底牌只在实际摊牌公开后记录；未亮出的牌不会
+写入文件。开局菜单可关闭，命令行也可使用 `--no-history`。
+
+## 翻前范围表
+
+牌桌内按 `4` 打开。颜色分别表示 jam、raise、call、混合频率和 fold，并
+标出当前手牌。
+
+内置表来自
+[PokerCoaching 公开的 6-max 图表](https://pokercoaching.com/preflop-charts/)。
+完全匹配显示 `EXACT`；人数、筹码或行动树不完全匹配时显示 `REFERENCE`
+并说明偏差，不会把 100BB 现金桌参考冒充成精确短码或 ICM 解。
+
+导入自己的 FreeBetRange / 求解器范围：
+
+```bash
+poker ranges example
+poker ranges import ~/Downloads/my-ranges.json
+poker ranges list
+```
+
+## 常用参数
+
+```bash
+poker --opponent mixed       # 纯离线
+poker --coach codex          # Codex 复盘
+poker --codex-model gpt-5.4-mini
+poker --claude-model sonnet  # 更换 Claude 模型
+poker --online-policy key    # 仅关键局面在线思考
+poker --blind-speed turbo    # 加快升盲
+poker --size compact         # 调整牌桌尺寸
+poker --theme classic        # 更换皮肤
+poker --plain                # 纯文本模式
+```
+
+完整参数：
+
+```bash
+poker --help
+```
+
+## 验证
+
+```bash
+PYTHONPATH=src python -m unittest discover -s tests -v
+```
+
+## 发布
+
+`main` 用于持续开发，不会自动覆盖 PyPI。发布新版本只需打开 GitHub
+Actions 的 `Release`，点击 `Run workflow`，选择 `patch`、`minor` 或
+`major`。工作流会自动修改版本、测试、提交、打 tag、创建 Release，并通过
+Trusted Publishing 上传 PyPI。
+
+首次发布前，仓库所有者只需在 PyPI 添加一次 Trusted Publisher：
+
+```text
+Owner: redearly123
+Repository: terminal-poker
+Workflow: publish.yml
+Environment: pypi
+```
+
+已安装用户仍需主动更新：
+
+```bash
+pipx upgrade poker-cli
+# 或
+python -m pip install --upgrade poker-cli
+```
+
+MIT Licensed.

poker_cli-0.11.2/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "poker-cli"
+version = "0.11.2"
+description = "A privacy-safe, terminal Texas Hold'em game with optional LLM opponents and hand review."
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+authors = [{ name = "redearly123" }]
+keywords = ["poker", "texas-holdem", "terminal", "tui", "codex", "claude"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Games/Entertainment :: Board Games",
+]
+dependencies = ["rich>=14.1,<15"]
+
+[project.scripts]
+poker = "poker_cli.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/redearly123/terminal-poker"
+Repository = "https://github.com/redearly123/terminal-poker"
+Issues = "https://github.com/redearly123/terminal-poker/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]

poker_cli-0.11.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

poker_cli-0.11.2/src/poker_cli/__init__.py

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

poker_cli-0.11.2/src/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-0.11.2/src/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
+