Package: cribbage-scorer
cribbage_scorerCribbage scorer is a simple scoring engine for the classic card game.For details, history and a good summary of the rules of the game seeWikipediaFor instruction on how to play and the rules see theAmerican Cribbage Congress(see link to PDF)The code for the web server front end that uses this python API can befound on GitHub. Raise a bug here if you find any. This server is also now available as aDocker container.This package is tested against against Python versions: "3.6", "3.7", "3.8", "3.9", "3.10" on Ubuntu-latest. (But should work on Windows and Mac etc.)Installationpipinstallcribbage-scorerRun the testspython-mpytestScoringExamples of how to use the library are below.In the library and examples, I have used the following conventions:1 : Ace2-10 : Non face cards.11 : Jack12 : Queen13 : KingD = Diamonds,
H = Hearts,
C = Clubs,
S = Spades.Players are listed in the order in which they play. So...Abiplayed a 5 of Diamonds,Bobplayed a 5 of Spades,Abiplayed a 5 of ClubsBobplayed a Jack of Diamonds....is represented as:players=["Abi","Bob"]played_cards=[(5,"D"),(5,"S"),(5,"C"),(11,"D")]The CutThecut_calc_scorefunction is used during 'the cut' stage of the game.Its a simple function, to assign the 2 points given to the dealer if the pone cuts a Jack as the starter card.fromcribbage_scorerimportcribbage_scorercut_card=(11,"D")players=["Abi","Bob"]dealer="Bob"scores,msg=cribbage_scorer.cut_calc_score(cut_card,players,dealer)print(scores,msg)Results:{'Abi':0,'Bob':2}CutcardisaJack,Dealerscores2pts.The PlayTheplay_calc_score_setfunction is used during 'the play' stage of the game.play_calc_score_sethandles 3 and 4 players as well as the standard 2 player game. It also understands "Go" calls.Note: we use the term 'set' here to refer to a subset of the play, where the players are counting from a first played card upto either last card, Go or 31.
Once the players have ended a set the cards are put aside and another set begins until all cards are played.
The 'play' section of the game usually constitutes multiple sets.To use, clone from GitHub and run this Python code:fromcribbage_scorerimportcribbage_scorerplayers=["Abi","Bob"]played_cards=[(5,"D"),(5,"S"),(5,"C"),(11,"D")]scores,current_count,play_log=cribbage_scorer.play_calc_score_set(played_cards,players)print(scores,current_count,play_log)Results:{'Abi':8,'Bob':3}25['Count: 5, No Points scored, None said Go. ','Count: 10, Bob: 2 of a kind (2pts), score so far: 2 ','Count: 15, Abi: 15 for 2pts, 3 of a kind (6pts), score so far: 8 ','Count: 25, Bob: Last card (1pt), score so far: 3 ']Behind the scenes this method callsplay_score_ongoingfor each card placed down. This provides the scoring and message for each card placed.
You may choose to use this more internal method, to provide details of each card played, though the full play to that point in time requiresplay_calc_score_setto be used.The ShowTheshow_calc_scorefunction is used during 'the show' stage of the game.show_calc_scorehandles Dealer and non dealer hands, for the standard 6 card (4 in your hand, 2 given to the crib) + starter/cut card version of the game.To use, clone from GitHub and run this Python code:fromcribbage_scorerimportcribbage_scorerstarter=(5,"H")hand=[(5,"D"),(5,"S"),(5,"C"),(11,"D")]crib=Falsescore,msg=cribbage_scorer.show_calc_score(starter,hand,crib)print(score,msg)Results:(29, "Four of a kind: 5s (12pts), Made 15 from [(5, 'D'), (11, 'D')] (2pts), Made 15 from [(5, 'S'), (11, 'D')] (2pts), Made 15 from [(5, 'C'), (11, 'D')] (2pts), Made 15 from [(11, 'D'), (5, 'D')] (2pts), Made 15 from [(5, 'D'), (5, 'S'), (5, 'C')] (2pts), Made 15 from [(5, 'D'), (5, 'S'), (5, 'D')] (2pts), Made 15 from [(5, 'D'), (5, 'C'), (5, 'D')] (2pts), Made 15 from [(5, 'S'), (5, 'C'), (5, 'D')] (2pts), One for his nobs (1pt)")License:Copyright © 2023 Peter HoughtonPermission 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.