jetedrow.SnapCall 2026.3.6

SnapCall

SnapCall is a compact poker hand evaluation helper library focused on correctness and flexibility for various card set sizes and configurations.

Overview SnapCall evaluates poker hands for 2–7 card sets. It supports conventional 5-card poker rankings plus Five-of-a-Kind when duplicate cards are allowed (useful for multi-deck scenarios). The library provides both exact 5-card evaluation and best-5 selection for hands with more than five cards. Partial-hand evaluation for fewer than five cards is optional and configurable.

Usage Create and evaluate hands using the Hand type. Typical usage:

// Parse a hand (uses global EvaluationOptions by default)
var h = Hand.Parse("Ac Ks Qh 9s 7d");
var strength = h.GetStrength();

// Parse with per-call options (override global)
var s = Hand.Parse("9s 9s", new EvaluationOptions(evaluatePartialHands: true, allowDuplicateCards: true));

// Evaluate with per-call options
var strength2 = h.GetStrength(new EvaluationOptions(evaluatePartialHands: false));

// Concatenate hands
var a = Hand.Parse("9s 9d");
var b = Hand.Parse("2c 3h 4d");
var combined = a + b; // combines cards from both hands

Classes and important members

• Hand — represents a collection of Card instances. Methods: Parse(string, EvaluationOptions?), GetStrength(EvaluationOptions?), and operator+ to concatenate hands.
• HandStrength — returned by GetStrength(); includes HandRanking, Kickers and CardCount (the originating hand size used for tie-breaking).
• EvaluationOptions — configuration type with a global instance at EvaluationOptions.Global and optional per-call overrides.

Options Currently EvaluationOptions exposes two flags:

• EvaluatePartialHands (bool, default true) — when true, hands with fewer than five cards will be evaluated for possible rankings (Pair, TwoPair, ThreeOfAKind, FourOfAKind, HighCard). When false, GetStrength() returns null for such hands.
• AllowDuplicateCards (bool, default false) — when false, creating or combining hands that would contain duplicate cards (same rank and suit) will throw DuplicateCardException. Set to true to allow duplicate cards (multi-deck) and enable Five-of-a-Kind detection.

Exceptions

• DuplicateCardException — thrown when attempting to parse or combine hands that contain duplicate cards while AllowDuplicateCards is false. Use EvaluationOptions to allow duplicates if desired.

Testing Unit tests are organized under the Tests/ folder and cover ranking correctness, partial-hand behavior, duplicate-card handling, five-of-a-kind detection, operator+ behavior, parsing, and other sanity checks. Run the suite with dotnet test.

Dependencies See project files for referenced NuGet packages. The README no longer documents legacy performance tables or evaluator file usage.