Texas Hold'em Poker combination finder tool
Project description
# Texas Hold'em Poker combination finder tool
## Install
```
pip install РЎTHPoker
```
## Usage
### Card
Card is a number.
Weight numbers: `20` (Two), `30` (Three), `40` (Four), `50` (Five), `60` (Six), `70` (Seven), `80` (Eight), `90` (Nine), `100` (Ten), `110` (Jack), `120` (Queen), `130` (King), `140` (Ace).
Suit numbers: `1` (clubs), `2` (diamonds), `3` (hearts), `4` (spades).
Ace of a spades looks like `144`.
### Combination
Combination is a list of numbers.
First number is type of combination: `1` (High card), `2` (One pair), `3` (Two pairs), `4` (Three of a kind), `5` (Straight), `6` (Flush), `7` (Full house), `8` (Four of a kind), `9` (StraightFlush).
Other numbers is combination value.
```python
# High card of Queen with Ten, Seven, Six and Four
[1, 12, 10, 7, 6, 4]
# One pair of Nine with King, Eight and Five
[2, 9, 13, 8, 5]
# Two pairs of Jakes and Three with Nine
[3, 11, 3, 9]
# Three of a kind of Deuce with Ace and Ten
[4, 2, 14, 10]
# Straight of Six, Five, Four, Three and Two
[5, 6]
# Flush of Ten, Nine, Six, Four and Two
[6, 10, 9, 6, 4, 2]
# Full house of Three and Six
[7, 3, 6]
# Four of a kind of Seven with Queen
[8, 7, 12]
# StraightFlush of Ten, Nine, Eight, Seven and Six
[9, 10]
```
### Find pure combination
```python
from cthpoker import findCombo
cards = [144, 134, 124, 114, 104] # Aв™ Kв™ Qв™ Jв™ Tв™
combo = findCombo(cards)
print(combo)
# [9, 14]
```
### Ratio
Ratio shows whether player hand cards in combination base cards or not.
There is three ratio kind: `0` - nominal combination (player hand cards not in combination base cards), `1` - half nominal combination (player hand cards in part of combination base cards, possible in Full house and Two pairs only), `2` - real combination (player hand cards in combination base cards).
#### High card
Combination cards - `A♠Q♦ T♠7♦ 6♣`. Combination base cards - `A♠Q♦ T♠7♦ 6♣`. Other cards are absent.
#### One pair
Combination cards - `9♣ 9♥ K♦ Q♣ 7♠`. Combination base cards - `9♣ 9♥`. Other cards - `K♦ Q♣ 7♠`.
#### Two pairs
Combination cards - `J♥ J♦ 4♠4♦ 3♣`. Combination base cards - `J♥ J♦ 4♠4♦`. Other cards - `3♣`. There are two parts of combination base cards: first - `J♥ J♦` , second - `4♠4♦`.
#### Three of a kind
Combination cards - `6♦ 6♠6♣ Q♥ 8♠`. Combination base cards - `6♦ 6♠6♣`. Other cards - `Q♥ 8♠`.
#### Straight
Combination cards - `K♠Q♦ J♠T♦ 9♣`. Combination base cards - `K♠Q♦ J♠T♦ 9♣`. Other cards are absent.
#### Flush
Combination cards - `A♥ J♥ 8♥ 5♥ 2♥`. Combination base cards - `A♥ J♥ 8♥ 5♥ 2♥`. Other cards are absent.
#### Full house
Combination cards - `3♣ 3♦ 3♥ 8♣ 8♠`. Combination base cards - `3♣ 3♦ 3♥ 8♣ 8♠`. Other cards are absent. There are two parts of combination base cards: first - `3♣ 3♦ 3♥` , second - `8♣ 8♠`.
#### Three of a kind
Combination cards - `Q♠Q♦ Q♣ Q♥ 4♣`. Combination base cards - `Q♠Q♦ Q♣ Q♥`. Other cards - `4♣`.
#### StraightFlush
Combination cards - `Aв™ Kв™ Qв™ Jв™ Tв™ `. Combination base cards - `Aв™ Kв™ Qв™ Jв™ Tв™ `. Other cards are absent.
### Find ratio combination
```python
from cthpoker import findRatioCombo
# In hand card is card increased by 1000
cards = [144, 1114, 84, 72, 54, 1031, 24] # Aв™ Jв™ 8в™ 7♦ 5в™ 3в™Ј 2в™
# table cards Aв™ 8в™ 7♦ 5в™ 2в™
# hand cards Jв™ 3в™Ј
combo, ratio = findRatioCombo(cards)
print(combo)
# [6, 14, 11, 8, 5, 2]
print(ratio)
# 2
cards = [103, 102, 104, 1131, 133, 83, 1041] # T♥ T♦ T♠K♣ K♥ 8♥ 4♣
# table cards T♥ T♦ T♠K♥ 8♥
# hand cards Kв™Ј 4в™Ј
combo, ratio = findRatioCombo(cards)
print(combo)
# [7, 10, 13]
print(ratio)
# 1
cards = [52, 54, 51, 124, 101, 1062, 1023] # 5♦ 5♠5♣ Q♠T♣ 6♦ 2♥
# table cards 5♦ 5♠5♣ Q♠T♣
# hand cards 6♦ 2♥
combo, ratio = findRatioCombo(cards)
print(combo)
# [4, 5, 12, 10]
print(ratio)
# 0
```
## Install
```
pip install РЎTHPoker
```
## Usage
### Card
Card is a number.
Weight numbers: `20` (Two), `30` (Three), `40` (Four), `50` (Five), `60` (Six), `70` (Seven), `80` (Eight), `90` (Nine), `100` (Ten), `110` (Jack), `120` (Queen), `130` (King), `140` (Ace).
Suit numbers: `1` (clubs), `2` (diamonds), `3` (hearts), `4` (spades).
Ace of a spades looks like `144`.
### Combination
Combination is a list of numbers.
First number is type of combination: `1` (High card), `2` (One pair), `3` (Two pairs), `4` (Three of a kind), `5` (Straight), `6` (Flush), `7` (Full house), `8` (Four of a kind), `9` (StraightFlush).
Other numbers is combination value.
```python
# High card of Queen with Ten, Seven, Six and Four
[1, 12, 10, 7, 6, 4]
# One pair of Nine with King, Eight and Five
[2, 9, 13, 8, 5]
# Two pairs of Jakes and Three with Nine
[3, 11, 3, 9]
# Three of a kind of Deuce with Ace and Ten
[4, 2, 14, 10]
# Straight of Six, Five, Four, Three and Two
[5, 6]
# Flush of Ten, Nine, Six, Four and Two
[6, 10, 9, 6, 4, 2]
# Full house of Three and Six
[7, 3, 6]
# Four of a kind of Seven with Queen
[8, 7, 12]
# StraightFlush of Ten, Nine, Eight, Seven and Six
[9, 10]
```
### Find pure combination
```python
from cthpoker import findCombo
cards = [144, 134, 124, 114, 104] # Aв™ Kв™ Qв™ Jв™ Tв™
combo = findCombo(cards)
print(combo)
# [9, 14]
```
### Ratio
Ratio shows whether player hand cards in combination base cards or not.
There is three ratio kind: `0` - nominal combination (player hand cards not in combination base cards), `1` - half nominal combination (player hand cards in part of combination base cards, possible in Full house and Two pairs only), `2` - real combination (player hand cards in combination base cards).
#### High card
Combination cards - `A♠Q♦ T♠7♦ 6♣`. Combination base cards - `A♠Q♦ T♠7♦ 6♣`. Other cards are absent.
#### One pair
Combination cards - `9♣ 9♥ K♦ Q♣ 7♠`. Combination base cards - `9♣ 9♥`. Other cards - `K♦ Q♣ 7♠`.
#### Two pairs
Combination cards - `J♥ J♦ 4♠4♦ 3♣`. Combination base cards - `J♥ J♦ 4♠4♦`. Other cards - `3♣`. There are two parts of combination base cards: first - `J♥ J♦` , second - `4♠4♦`.
#### Three of a kind
Combination cards - `6♦ 6♠6♣ Q♥ 8♠`. Combination base cards - `6♦ 6♠6♣`. Other cards - `Q♥ 8♠`.
#### Straight
Combination cards - `K♠Q♦ J♠T♦ 9♣`. Combination base cards - `K♠Q♦ J♠T♦ 9♣`. Other cards are absent.
#### Flush
Combination cards - `A♥ J♥ 8♥ 5♥ 2♥`. Combination base cards - `A♥ J♥ 8♥ 5♥ 2♥`. Other cards are absent.
#### Full house
Combination cards - `3♣ 3♦ 3♥ 8♣ 8♠`. Combination base cards - `3♣ 3♦ 3♥ 8♣ 8♠`. Other cards are absent. There are two parts of combination base cards: first - `3♣ 3♦ 3♥` , second - `8♣ 8♠`.
#### Three of a kind
Combination cards - `Q♠Q♦ Q♣ Q♥ 4♣`. Combination base cards - `Q♠Q♦ Q♣ Q♥`. Other cards - `4♣`.
#### StraightFlush
Combination cards - `Aв™ Kв™ Qв™ Jв™ Tв™ `. Combination base cards - `Aв™ Kв™ Qв™ Jв™ Tв™ `. Other cards are absent.
### Find ratio combination
```python
from cthpoker import findRatioCombo
# In hand card is card increased by 1000
cards = [144, 1114, 84, 72, 54, 1031, 24] # Aв™ Jв™ 8в™ 7♦ 5в™ 3в™Ј 2в™
# table cards Aв™ 8в™ 7♦ 5в™ 2в™
# hand cards Jв™ 3в™Ј
combo, ratio = findRatioCombo(cards)
print(combo)
# [6, 14, 11, 8, 5, 2]
print(ratio)
# 2
cards = [103, 102, 104, 1131, 133, 83, 1041] # T♥ T♦ T♠K♣ K♥ 8♥ 4♣
# table cards T♥ T♦ T♠K♥ 8♥
# hand cards Kв™Ј 4в™Ј
combo, ratio = findRatioCombo(cards)
print(combo)
# [7, 10, 13]
print(ratio)
# 1
cards = [52, 54, 51, 124, 101, 1062, 1023] # 5♦ 5♠5♣ Q♠T♣ 6♦ 2♥
# table cards 5♦ 5♠5♣ Q♠T♣
# hand cards 6♦ 2♥
combo, ratio = findRatioCombo(cards)
print(combo)
# [4, 5, 12, 10]
print(ratio)
# 0
```
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
CTHPoker-1.0.0.tar.gz
(8.8 kB
view hashes)