rs_poker

Crates.iors_poker
lib.rsrs_poker
version3.0.0-beta.20
sourcesrc
created_at2017-04-06 06:50:33.506614
updated_at2024-04-27 19:33:36.301097
descriptionA library to help with any Rust code dealing with poker. This includes card values, suits, hands, hand ranks, 5 card hand strength calculation, 7 card hand strength calulcation, and monte carlo game simulation helpers.
homepagehttps://docs.rs/rs_poker
repositoryhttps://github.com/elliottneilclark/rs-poker
max_upload_size
id9772
size320,423
Elliott (elliottneilclark)

documentation

README

rs-poker

Crates.io Docs.rs

RS Poker is a rust library aimed to be a good starting place for many poker rust codes. Correctness and performance are the two primary goals.

Core

The Core module contains code not specific to different types of poker games. It contains:

  • Suit type
  • Value type
  • Card type
  • Deck
  • Hand iteration
  • Poker hand rank type
  • Poker hand evaluation for five-card hands.
  • Poker hand evaluation for seven card hands.
  • PlayerBitSet is suitable for keeping track of boolean values on a table.

The poker hand (5 cards) evaluation will rank a hand in ~20 nanoseconds per hand. That means that 50 Million hands per second can be ranked per CPU core. The seven-card hand evaluation will rank a hand in < 25 ns.

The hand evaluation is accurate. rs-poker does not rely on just a single kicker. This accuracy allows for breaking ties on hands that are closer.

Holdem

The holdem module contains code that is specific to holdem. It currently contains:

  • Starting hand enumeration
  • Hand range parsing
  • Monte Carlo game simulation helpers.

Arena

Arena is currently a beta feature. There are no planned breaking changes, but additions are expected.

Arena is a feature that allows the creating of agents that play a simulated Texas Holdem poker game. These autonomous agent vs agent games are ideal for determining the strength of automated strategies. Additionally, agent vs agent arenas are a good way of quickly playing lots of GTO poker.

  • Holdem simulation struct for the overall status of the simulation
  • Game state for the state of the current game
  • Agent trait that you can implement to create your more potent poker agent.
  • A few example Agents.
  • Historians who can watch every action in a simulation as it happens

Testing

The code is well-tested and benchmarked. If you find something that looks like a bug, please submit a PR with an updated test code.

5 Card + Hand iteration is used with fuzzing to validate the seven-card hand evaluation.

Fuzzing is used to validate game simulation via replay generation.

Commit count: 247

cargo fmt