Xi+SrSSKJrJr SSKrSSKJr SSKJr Sr Sr Sr Sr S r S rS rS rS rSrSr\"SS\55r\"SS\55r"SS5rSSSSS.rSSSSSS S!S"S#S$S%S&S'S(. rSS)SS*SS+S S,S-S.S/S0S1S2S3S4S5S6\S7\S8\S9\S:\S;\S<0rSGS=\S>\S?\4S@jjrSGS=\S>\S?\4SAjjrS=\S?\4SBjrSGSC\\S>\S?\4SDjjrSHSC\\SE\ S?\\4SFjjr!g)Iz Reusable card and deck utilities for card games. Provides Card, Deck, and DeckFactory classes that can be used by any card game. ) dataclassfieldN)DataClassJSONMixin) LocalizationcX\rSrSr%Sr\\S'\\S'\\S'S\4SjrS\S\ 4S jr S r g ) CardzPlaying card model. Attributes: id: Unique identifier. rank: Card rank (1-13 standard, 1-10 Italian, 14-19 RS Games special). suit: Suit number (0=none, 1=diamonds, 2=clubs, 3=hearts, 4=spades). idranksuitreturncUR$)z+Hash cards by stable id for set/dict usage.)rselfs 6C:\Users\dbart\PlayPalace11\server\game_utils\cards.py__hash__ Card.__hash__-s wwotherc`[U[5(dgURUR:H$)zCompare cards by id equality.F) isinstancerr)rrs r__eq__ Card.__eq__1s%%&&ww%((""rN) __name__ __module__ __qualname____firstlineno____doc__int__annotations__robjectboolr"__static_attributes__r$rrrrs7 G I I##F#t#rrc\rSrSr%Sr\"\S9r\\\ S'SSjr SS\ S\\4S jjr S\S-4S jr S\\SS4S jrS\\SS4S jrS\ 4S jrS\4SjrS\\4SjrSrg)Deck8zgDeck of cards with draw/shuffle operations. Attributes: cards: Ordered list of cards in the deck. )default_factorycardsrNcD[R"UR5 g)zShuffle the deck in place.N)randomshuffler3rs rr6 Deck.shuffleBstzz"rcountcLURSUnURUSUlU$)z$Draw cards from the top of the deck.Nr3)rr8drawns rdraw Deck.drawFs) 6E"ZZ'  rc\UR(aURRS5$g)z,Draw a single card from the top of the deck.rN)r3poprs rdraw_one Deck.draw_oneLs ::::>>!$ $rc:URRU5 g)z$Add cards to the bottom of the deck.N)r3extendrr3s raddDeck.addRs % rc*XR-Ulg)z!Add cards to the top of the deck.Nr:rDs radd_top Deck.add_topVsZZ' rc,[UR5$)z'Return the number of cards in the deck.lenr3rs rsize Deck.sizeZs4::rc2[UR5S:H$)zCheck if the deck is empty.rrKrs ris_empty Deck.is_empty^s4::!##rc,URn/UlU$)z*Remove and return all cards from the deck.r:rDs rclear Deck.clearbs   rr:)rNr)r%r&r'r(r)rlistr3rr+r6r*r<r@rErHrMr-rPrSr.r$rrr0r08s d3E4:3##d4j $+ !d!!(T$Z(D(c$$$tDzrr0c \rSrSrSr\S S\S\\\ \\ 444Sjj5r \S S\S\\\ \\ 444Sjj5r \S\\\ \\ 444Sj5r \S\\\ \\ 444Sj5rS rg ) DeckFactoryiz'Factory for creating common deck types. num_decksrc /n0nSn[U5HMn[SS5H:n[SS5H'n[X6US9nURU5 XrU'US- nM) M< MO [US9nUR 5 X4$)z Create Italian 40-card deck (4 suits x 10 ranks). Args: num_decks: Number of decks to combine. Returns: Tuple of (shuffled deck, card lookup dict mapping id -> Card) rr rrrr:rangerappendr0r6 rZr3 card_lookupcard_id_rrcarddecks r italian_deckDeckFactory.italian_deckl') y!Aa !!RLD7DADLL&+/(qLG )$"%    rc /n0nSn[U5HMn[SS5H:n[SS5H'n[X6US9nURU5 XrU'US- nM) M< MO [US9nUR 5 X4$)z Create standard 52-card deck (4 suits x 13 ranks). Args: num_decks: Number of decks to combine. Returns: Tuple of (shuffled deck, card lookup dict mapping id -> Card) rrr\r r^r:r_rbs r standard_deckDeckFactory.standard_deckrjrc/n0nSn[SS5H=n[S5H+n[X#[S9nURU5 XQU'US- nM- M? [[ [ [[[4H=n[S5H+n[X#[S9nURU5 XQU'US- nM- M? [US9nUR5 Xa4$)a  Create RS Games 60-card deck for Ninety-Nine variant. Contains: - Number cards 1-9: 4 of each (36 cards) - Special cards: +10, -10, Pass, Reverse, Skip, Ninety-Nine (4 of each, 24 cards) Returns: Tuple of (shuffled deck, card lookup dict mapping id -> Card) rr r r^r:) r`r SUIT_NONEraRS_RANK_PLUS_10RS_RANK_MINUS_10 RS_RANK_PASSRS_RANK_REVERSE RS_RANK_SKIPRS_RANK_NINETY_NINEr0r6)r3rcrdrrerfrgs r rs_games_deckDeckFactory.rs_games_decks') !RLD1Xw B T"'+G$1  !        D1Xw B T"'+G$1   %    rc /n0nSn[S5HMn[SS5H:n[SS5H'n[X%US9nURU5 XaU'US- nM) M< MO [S5H,n[US[S9nURU5 XaU'US- nM. [S5H,n[US [S9nURU5 XaU'US- nM. [ US 9nUR 5 Xq4$) a Create Phase 10 108-card deck. Contains: - 2 copies of each number 1-12 in 4 colors (suit 1=Red, 2=Blue, 3=Green, 4=Yellow) = 96 cards - 8 Wild cards (rank=13, suit=0) - 4 Skip cards (rank=14, suit=0) Returns: Tuple of (shuffled deck, card lookup dict mapping id -> Card) rrrr\ r^r r r:)r`rrarpr0r6)r3rcrdrerrrfrgs r phase10_deckDeckFactory.phase10_decks') qAa !!RLD7DADLL&+/(qLG )$qA7)   2C NI6>   2C NI   FKi PPrcZ[X5nUSR5S;aSU3$SU3$)z Get card name with article (a/an). Args: card: The card to name. locale: Locale for localization. Returns: Card name with appropriate article (e.g., 'an Ace of Hearts'). raeiou8zan za )rlower)rfrnames rcard_name_with_articler>s8 T "D Aw}}("TF| v;rcNUR[:Xa3[RUR[ UR55$SSSSS.nSSSS S .nURUR[ UR55nURURS 5nUU3$) z Get short card name (e.g., '7D' for Seven of Diamonds). Args: card: The card to name. Returns: Short card name string. DCHSrAJQK)rr]rrz?)rrprrrr)rf suit_chars rank_charsrank_strsuit_strs rcard_name_shortrPs yyI"&&tyy#dii.AASSS1Jcs4J~~diiTYY8H~~dii-HZz ""rr3cU(d[R"US5$UVs/sHn[X!5PM nn[R"X5$s snf)z Format a list of cards for speech output. Args: cards: List of cards to read. locale: Locale for localization. Returns: Formatted string with card names joined by 'and'. zno-cards)rrrformat_list_and)r3rcnamess r read_cardsresI  33+0 15aYq !5E 1  ' ' 66 2sAby_suitc<U(a [USS9$[USS9$)z Sort cards by suit then rank, or by rank then suit. Args: cards: List of cards to sort. by_suit: If True, sort by suit first. Otherwise by rank first. Returns: New sorted list of cards. c2URUR4$N)rrrs rsort_cards..AFFAFF+;r)keyc2URUR4$rrrs rrrrr)sorted)r3rs r sort_cardsrvs#e!;<<e!;<rs ) 40         # # #0 - - -`K!K!`     $sssssssssTe&Y&&QDQ#QQ4sc$#$#3#*7d4j7#77"=d4j=4=4:=r