poker_odds 0.2.0-aarch64-linux

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 23bb6767de09667714dad915d0a3d745870304b489abc81caf92a4f4119c4a19
+  data.tar.gz: 7e0000dbfbca83de5a09f361ddb4302e5ba487a4574a3dd47007266bb553f895
+SHA512:
+  metadata.gz: faf16d4694bad1df64525cfbe57373dd537145d4d0d2b57c2cbce877cf5537805261916a42da3b1befd5c4ae9b78e0f564f8aa4be2dad0af25e23edc51e0260d
+  data.tar.gz: 3fff727d76a96951cf73d4c3fc70fc4f5eec480b96999d6fc31248b66fdb2cf2daae59b388e170c5988cc346e736fc75b4d9d7176472cc8112ce93a6750984e2

data/.github/workflows/main.yml

@@ -0,0 +1,47 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby-version: ["3.2", "3.3", "3.4"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Ruby ${{ matrix.ruby-version }}
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby-version }}
+          bundler-cache: true
+
+      - name: Set up Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Compile native extension
+        run: bundle exec rake compile
+
+      - name: Run tests
+        run: bundle exec rspec
+
+  lint:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.4"
+          bundler-cache: true
+
+      - name: Run RuboCop
+        run: bundle exec rubocop

data/.github/workflows/release.yml

@@ -0,0 +1,61 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+
+jobs:
+  cross-compile:
+    name: Cross-compile (${{ matrix.platform }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        platform:
+          - x86_64-linux
+          - aarch64-linux
+          - x86_64-darwin
+          - arm64-darwin
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.4"
+          bundler-cache: true
+
+      - uses: oxidize-rb/actions/cross-gem@v1
+        with:
+          platform: ${{ matrix.platform }}
+          ruby-versions: "3.2,3.3,3.4"
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: gem-${{ matrix.platform }}
+          path: pkg/*-${{ matrix.platform }}.gem
+          if-no-files-found: error
+
+  release:
+    name: Publish to RubyGems
+    needs: cross-compile
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    permissions:
+      id-token: write  # for OIDC trusted publishing
+
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: gem-*
+          merge-multiple: true
+          path: pkg/
+
+      - uses: rubygems/configure-rubygems-credentials@v1.0.0
+
+      - name: Push all gems to RubyGems
+        run: find pkg/ -name "*.gem" | sort | xargs -I{} gem push {}

data/.travis.yml

@@ -0,0 +1,7 @@
+---
+sudo: false
+language: ruby
+cache: bundler
+rvm:
+  - 2.6.8
+before_install: gem install bundler -v 1.17.2

data/CLAUDE.md

@@ -0,0 +1,66 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Commands
+
+```bash
+# Install dependencies
+bin/setup
+# or
+bundle install
+
+# Run all tests
+bundle exec rspec
+# or
+rake spec
+
+# Run a single test file
+bundle exec rspec spec/poker_odds_spec.rb
+
+# Run a single example by line number
+bundle exec rspec spec/poker_odds_spec.rb:10
+
+# Interactive console with Pry
+bundle exec bin/console
+
+# Build gem
+bundle exec rake build
+
+# Install gem locally
+bundle exec rake install
+```
+
+## Architecture
+
+This is a Ruby gem (`poker_odds`) that calculates poker hand equity using Monte Carlo and combinatorial simulations.
+
+### Core module: `PokerOdds::Hand` (`lib/poker_odds/hand.rb`)
+
+The central class. Uses `virtus` gem for typed attributes and `poker_trump` gem for card representation and hand scoring.
+
+**Attributes (set via Virtus or DSL setters):**
+- `player_hands` — Array of player hole card pairs
+- `flop_cards`, `turn_card`, `river_card` — Community cards
+- `expose_cards` — Cards known to be out of the deck
+
+**DSL setters** parse comma-separated card strings:
+```ruby
+round.player = '9d 9c, Kd Kc'  # sets player_hands
+round.flop   = 'Ah 9h Jd'
+round.turn   = '3d'
+```
+
+**Equity methods** — each returns a hash keyed by player hand, with `{ win_rate:, lose_rate:, tie_rate:, outs: }`:
+
+| Method | Stage | Strategy |
+|---|---|---|
+| `equities` | Turn (river unknown) | Exhaustive iteration over remaining deck |
+| `flop_equities` | Flop (turn+river unknown) | Exhaustive combinations of remaining deck |
+| `preflop_equities` | Preflop | Monte Carlo (10,000 random samples) |
+
+**`deck` method** computes remaining cards by removing all known cards (player hands, community cards, exposed cards) from a full 52-card deck.
+
+### Known bug
+
+`hand.rb` `river=` setter references `str` instead of the parameter `s` — calling `round.river = 'Xx'` will raise `NameError`.

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at kyohah@gmail.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2022 kyohah
+
+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.

data/README.md

@@ -0,0 +1,154 @@
+# PokerOdds
+
+Texas Hold'em のポーカーハンドエクイティ計算 Ruby gem です。
+内部に Rust ネイティブ拡張を持ち、完全探索によって高速にエクイティ・アウツを算出します。
+
+## 特徴
+
+- **高速**: Rust 製ハンド評価エンジン [holdem-hand-evaluator](https://github.com/b-inary/holdem-hand-evaluator) を採用（〜12億評価/秒）
+- **完全探索**: モンテカルロではなく全残余カードの組み合わせを網羅
+- **プリコンパイル済みバイナリ配布**: 主要プラットフォーム向けにコンパイル済みgemを提供するため、利用時に Rust は不要
+- **アウツ計算**: 負けているハンドが逆転できるカード（アウツ）を返す
+
+## インストール
+
+```ruby
+gem "poker_odds"
+```
+
+```sh
+bundle install
+# または
+gem install poker_odds
+```
+
+## 使い方
+
+### equities — ターン後（残りリバーを全探索）
+
+```ruby
+round = PokerOdds::Hand.new
+round.flop   = "Ah 9h Jd"
+round.turn   = "3d"
+round.player = "9d 9c, Kd Kc"
+
+result = round.equities
+# => {
+#   "9d9c" => { win_rate: 0.954, lose_rate: 0.045, tie_rate: 0.0, outs: [] },
+#   "KdKc" => { win_rate: 0.045, lose_rate: 0.954, tie_rate: 0.0, outs: ["Kh", "Ks"] }
+# }
+```
+
+`outs` は負けているハンドが勝てるリバーカードの配列です。
+
+### flop_equities — フロップ後（ターン+リバーの全組み合わせを探索）
+
+```ruby
+round = PokerOdds::Hand.new
+round.flop   = "Ah 9h Jd"
+round.player = "9d 9c, Kd Kc"
+
+result = round.flop_equities
+# => {
+#   "9d9c" => { win_rate: 0.87, lose_rate: 0.12, tie_rate: 0.0, outs: [] },
+#   "KdKc" => { win_rate: 0.12, lose_rate: 0.87, tie_rate: 0.0,
+#               outs: [["Kh", "2c"], ["Ks", "7d"], ...] }
+# }
+```
+
+`outs` は `[turn, river]` のペア配列です。
+
+### preflop_equities — プリフロップ（ボード5枚の全組み合わせを探索）
+
+```ruby
+round = PokerOdds::Hand.new
+round.player = "9d 9c, Kd Kc"
+
+result = round.preflop_equities
+# => {
+#   "KdKc" => { win_rate: 0.77, lose_rate: 0.22, tie_rate: 0.0, outs: [] },
+#   "9d9c" => { win_rate: 0.22, lose_rate: 0.77, tie_rate: 0.0,
+#               outs: [["9h", "9s", "2c", "3d", "7h"], ...] }
+# }
+```
+
+`outs` は `[flop1, flop2, flop3, turn, river]` の5枚ボード配列です。
+
+### 3人以上のプレイヤー
+
+```ruby
+round = PokerOdds::Hand.new
+round.player = "9d 9c, Kd Kc, 2h 2s"
+
+result = round.preflop_equities
+result.each do |hand, stats|
+  puts "#{hand}: win=#{stats[:win_rate].round(3)}"
+end
+```
+
+### expose（公開済みカードの指定）
+
+デッキから除外したいカード（バーンカードなど）を指定できます:
+
+```ruby
+round = PokerOdds::Hand.new
+round.flop   = "Ah 9h Jd"
+round.turn   = "3d"
+round.expose = "2c 7s"   # デッキに存在しないカードとして扱う
+round.player = "9d 9c, Kd Kc"
+result = round.equities
+```
+
+## 開発
+
+```sh
+# 依存パッケージのインストール（Rust も必要）
+bin/setup
+
+# テスト実行
+bundle exec rspec
+
+# ネイティブ拡張のコンパイル
+bundle exec rake compile
+
+# 全タスク（compile + spec + rubocop）
+bundle exec rake
+```
+
+## ライセンス
+
+このgemは [MIT License](https://opensource.org/licenses/MIT) のもとで公開されています。
+
+### サードパーティライセンス
+
+このgemは以下のOSSを内部で使用しています:
+
+| ライブラリ | 作者 | ライセンス | 用途 |
+|---|---|---|---|
+| [holdem-hand-evaluator](https://github.com/b-inary/holdem-hand-evaluator) | Wataru Inariba (b-inary) | MIT | Rust製ポーカーハンド評価エンジン |
+
+holdem-hand-evaluator の著作権表示:
+
+```
+MIT License
+
+Copyright (c) 2020 Wataru Inariba
+
+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.
+```

data/Rakefile

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+require "rb_sys/extensiontask"
+require "rubocop/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+GEMSPEC = Gem::Specification.load("poker_odds.gemspec")
+
+RbSys::ExtensionTask.new("poker_odds", GEMSPEC) do |ext|
+  ext.lib_dir = "lib/poker_odds"
+  ext.cross_compile = true
+  ext.cross_platform = %w[
+    x86_64-linux
+    aarch64-linux
+    x86_64-darwin
+    arm64-darwin
+  ]
+end
+
+RuboCop::RakeTask.new
+
+task default: %i[compile spec rubocop]

data/lib/poker_odds/hand.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module PokerOdds
+  # Represents a poker round and calculates equity for each player.
+  class Hand
+    def initialize(**opts)
+      @player_hands = []
+      @flop_cards   = ""
+      @turn_card    = nil
+      @river_card   = nil
+      @expose_cards = ""
+      opts.each { |k, v| send(:"#{k}=", v) }
+    end
+
+    # Getters — return normalized (spaceless) internal representation
+    def player  = @player_hands
+    def flop    = @flop_cards
+    def turn    = @turn_card
+    def river   = @river_card
+    def expose  = @expose_cards
+
+    # "9d 9c, Kd Kc" -> ["9d9c", "KdKc"]
+    def player=(str)
+      @player_hands = str.split(",").map { |s| s.strip.delete(" ") }
+    end
+
+    # "Ah 9h Jd" -> "Ah9hJd"
+    def flop=(str)
+      @flop_cards = str.delete(" ")
+    end
+
+    # "3d" -> "3d"
+    def turn=(str)
+      @turn_card = str.strip
+    end
+
+    # "Xx" -> "Xx"
+    def river=(str)
+      @river_card = str.strip
+    end
+
+    # "Ah Kd" -> "AhKd"
+    def expose=(str)
+      @expose_cards = str.delete(" ")
+    end
+
+    # Flop + turn known (4 cards). Exhaustively iterates all possible river cards.
+    # Returns: { "9d9c" => { win_rate:, lose_rate:, tie_rate:, outs: ["Kh", ...] }, ... }
+    def equities
+      board = [@flop_cards, @turn_card].join
+      PokerOdds::Evaluator.equities(@player_hands, board, @expose_cards)
+    end
+
+    # Flop known (3 cards). Exhaustively iterates all C(deck, 2) turn+river combinations.
+    # Returns: { "9d9c" => { win_rate:, lose_rate:, tie_rate:, outs: [["Tc","Qd"], ...] }, ... }
+    def flop_equities
+      PokerOdds::Evaluator.flop_equities(@player_hands, @flop_cards, @expose_cards)
+    end
+
+    # No community cards. Exhaustively iterates all C(deck, 5) boards.
+    # Returns: { "9d9c" => { win_rate:, lose_rate:, tie_rate:, outs: [["Ah",...], ...] }, ... }
+    def preflop_equities
+      PokerOdds::Evaluator.preflop_equities(@player_hands, @expose_cards)
+    end
+  end
+end

data/lib/poker_odds/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module PokerOdds
+  VERSION = "0.2.0"
+end

data/lib/poker_odds.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require "poker_odds/poker_odds" # native Rust extension
+require_relative "poker_odds/version"
+require_relative "poker_odds/hand"
+
+module PokerOdds
+  class Error < StandardError; end
+end

data/mise.toml

@@ -0,0 +1,2 @@
+[tools]
+ruby = "4.0.1"

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification
+name: poker_odds
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: aarch64-linux
+authors:
+- kyohah
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2026-02-23 00:00:00.000000000 Z
+dependencies: []
+description: Calculates win/lose/tie equity and outs for Texas Hold'em using exhaustive
+  enumeration. Powered by holdem-hand-evaluator via a Magnus/rb-sys Rust extension
+  (~1.2B evaluations/sec).
+email:
+- kyohah@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/main.yml"
+- ".github/workflows/release.yml"
+- ".travis.yml"
+- CLAUDE.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/poker_odds.rb
+- lib/poker_odds/3.2/poker_odds.so
+- lib/poker_odds/3.3/poker_odds.so
+- lib/poker_odds/3.4/poker_odds.so
+- lib/poker_odds/hand.rb
+- lib/poker_odds/version.rb
+- mise.toml
+homepage: https://github.com/kyohah/poker_odds
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/kyohah/poker_odds
+  source_code_uri: https://github.com/kyohah/poker_odds
+  changelog_uri: https://github.com/kyohah/poker_odds/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+  - - "<"
+    - !ruby/object:Gem::Version
+      version: 3.5.dev
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.23
+signing_key: 
+specification_version: 4
+summary: Fast poker hand equity calculator backed by a Rust native extension.
+test_files: []