PokerKit Plus
Fork-free capability extensions on top of PokerKit.
pokerkit_plus is a drop-in superset of pokerkit: it re-exports the entire
upstream surface unchanged and adds new capabilities on top via subclasses, free
functions, and thin wrappers. The upstream package is never modified, so PokerKit
Plus keeps riding upstream's maintenance (correctness fixes, new parsers, etc.).
# Anywhere you used pokerkit, you can use pokerkit_plus instead:
from pokerkit_plus import NoLimitTexasHoldem, Automation, State # all of pokerkit
# ...plus the PokerKit Plus additions as they land.
Design
- Form: standalone extension package,
pip-depends onpokerkit==0.7.3(pinned). - No fork, no monkeypatch. PokerKit is built for fork-free extension
(
_begin_/_update_/_end_phase hooks, mixin-composed variants, injectablerake/divmod,ClassVarregistries). Most additions need zero core edits. compat.pypins the pokerkit version and is the single home for stable aliases of version-fragile upstream names.
Status
Semantic layer P0/P1 implemented (drop-in superset of pokerkit + first capabilities):
pokerkit_plus.texture—BoardTexture.from_boardplusWetness,Connectivity,RankBand,StraightDraw,FlushDraw, andare_two_tone/are_monotone/are_rainbow.pokerkit_plus.combos—Nuts.from_board,CategoryCombos.from_board,HoleCombo,made_label,meets,CATEGORY_ORDER(made-hand category is pokerkit's ownLabel).pokerkit_plus.draws—Draws.from_hand(hero flush/straight draw + nut rank) and the sharedNutRank.pokerkit_plus.tags—HandTier.from_hand(made-hand tier +labels()) withPairTier/KickerTier/TwoPairTier/ThreeOfAKindTier.pokerkit_plus.outs—Outs.from_hand(category-upgrade outs, grouped).pokerkit_plus.blockers—BlockerReport.from_hand(count-based: how many of the board's nut combos a holding removes).pokerkit_plus.ranges—ComboClass/expand_range(notation),build_value_range,calculate_range_advantage(Monte-Carlo equity), andnut_advantage(exact nut-category share).pokerkit_plus.facade—HandReport.from_handandBoardReport.from_board, the one-call composed entry points for callers wanting a complete reading.
Built on pokerkit's lookup-table total order (no hand-rolled scoring); every
per-board / per-hand enumeration is memoized, and equity is delegated to
pokerkit's Monte-Carlo sampler. Verified: mypy --strict clean, ruff clean,
unit tests + doctests green, Nuts/Outs/blockers match brute-force oracles,
and a 2000-hand sweep shows no is_nut/nut_rank contradictions.
Candidate capabilities (menu, not yet scheduled)
| Capability | Category | Effort |
|---|---|---|
| FastState: snapshot/restore + undo for tree search | performance | L |
| Exact + deterministic equity engine with sampled-hand callbacks | equity | M |
| Range engine v2: weights, %-ranges, removal-aware combos | equity | M |
| Structured action-history & rich State view layer | dev-experience | M |
| Positions + multi-hand Table/session object | dev-experience | M |
| Bot/agent framework + baseline agents | AI/bots | M |
| Missing variants: 5/6-card PLO, Big O, Courchevel, 5-Card Draw, A-5 | variants | M |
| Mixed-game rotation (HORSE / 8-Game) | variants | M |
| Variant registry + parse-by-name + uniform create | integration | S |
| Fast lookup-table hand evaluator (5/6/7-card) | performance | L |
| Robust async multi-variant hand-history I/O | integration | L |
| State visualization & serialization (ASCII / SVG / JSON) | visualization | S |
| compat shim + Decimal/currency value type | dev-experience | S |
Development
python3 -m venv .venv && . .venv/bin/activate
pip install -e ".[dev]"
pytest
License
MIT (same as PokerKit).
Metadata
Release files for pokerkit-plus 0.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| pokerkit_plus-0.0.1.tar.gz | 40.8 kB | Without provenance | Details for pokerkit_plus-0.0.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| pokerkit_plus-0.0.1-py3-none-any.whl | Python 3 | none | any | Details for pokerkit_plus-0.0.1-py3-none-any.whl |
Total release size: 84.3 kB
Release files / pokerkit_plus-0.0.1.tar.gz
| Download URL | pokerkit_plus-0.0.1.tar.gz |
|---|---|
| Size | 40.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
909378824862e020168c6b6340104d49d4a9adac740059c4afc9c1de96b13906
|
|
BLAKE2b-256 checksum How to use checksums |
a91c2e32659d09732487e368e3852b57629e13f4e26c51ec8864ae4686a23145
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.0
|
Release files / pokerkit_plus-0.0.1-py3-none-any.whl
| Download URL | pokerkit_plus-0.0.1-py3-none-any.whl |
|---|---|
| Size | 43.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
43fb9324cb22af92c52fec4476f783774a5d00b9d251ee0f4adb5bdf21e486bf
|
|
BLAKE2b-256 checksum How to use checksums |
76da29ae50801b0c4e587ffc27a02b8ee2bf7e53b8de1687e5b2826e07ba7d13
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.0
|
Security for pokerkit-plus 0.0.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.