ThEdZddlmZddlmZmZmZmZmZmZm Z ddl m Z ddl m Z ddlmZddlmZddlmZdd lmZmZdd lmZerdd l mZGd d e ZGddeZGddeZGddeZGdde ZGddeZGddeZ GddeZ!GddeZ"Gdde Z#Gd d!e Z$y")#zAThis module contains the classes for Telegram Stars transactions.)datetime) TYPE_CHECKINGDictFinalOptionalSequenceTupleType) constants)TelegramObject)User)enum)parse_sequence_arg)extract_tzinfo_from_defaultsfrom_timestamp)JSONDict)Botc 4eZdZUdZdZej jZee e d< ej jZ ee e d< ej jZ ee e d< ddde d e ed dffd Ze dd e ed e dd e dffd ZxZS)RevenueWithdrawalStatea;This object escribes the state of a revenue withdrawal operation. Currently, it can be one of: * :class:`telegram.RevenueWithdrawalStatePending` * :class:`telegram.RevenueWithdrawalStateSucceeded` * :class:`telegram.RevenueWithdrawalStateFailed` Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`type` is equal. .. versionadded:: 21.4 Args: type (:obj:`str`): The type of the state. Attributes: type (:obj:`str`): The type of the state. typePENDING SUCCEEDEDFAILEDN api_kwargsrrreturnct||tjtj |||_|j f|_|jyNr) super__init__r get_memberr RevenueWithdrawalStateTyper _id_attrs_freezeselfrr __class__s W/opt/server/standalone/crm/venv/lib/python3.12/site-packages/telegram/_payment/stars.pyr!zRevenueWithdrawalState.__init__BsD J/)M)MtUYZ )) databotrc2|j|}|sy|jt|jt|j t i}|tur8|jd|vr%||jdj||St|)||S)Nrr+r,) _parse_datarRevenueWithdrawalStatePendingrRevenueWithdrawalStateSucceededrRevenueWithdrawalStateFailedrgetpopde_jsonr clsr+r,_class_mappingr(s r)r5zRevenueWithdrawalState.de_jsonIst$ KK6 MM: JJ4C  ( (TXXf-=-O!$((6"23;;3;O OwDc22r*N)__name__ __module__ __qualname____doc__ __slots__r r#rrstr__annotations__rrrrr! classmethodr5 __classcell__r(s@r)rr%s&I#>>FFGU3ZFH%@@JJIuSzJJ"==DDFE#JDGFJS(1Ct>B3H%3,4UO3 * +33r*rc<eZdZdZdZdddeeddffdZxZS)r0zThe withdrawal is in progress. .. versionadded:: 21.4 Attributes: type (:obj:`str`): The type of the state, always :tg-const:`telegram.RevenueWithdrawalState.PENDING`. Nrrrcdt|tj||j yN)rr)r r!rrr%r'rr(s r)r!z&RevenueWithdrawalStatePending.__init__js% 4<<T r* r:r;r<r=r>rrr!rBrCs@r)r0r0^/I;?hx&8Dr*r0c |eZdZdZdZdddededeeddffd Z e dd eed ed dedffd Z xZ S)r1aThe withdrawal succeeded. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`date` are equal. .. versionadded:: 21.4 Args: date (:obj:`datetime.datetime`): Date the withdrawal was completed as a datetime object. url (:obj:`str`): An HTTPS URL that can be used to see transaction details. Attributes: type (:obj:`str`): The type of the state, always :tg-const:`telegram.RevenueWithdrawalState.SUCCEEDED`. date (:obj:`datetime.datetime`): Date the withdrawal was completed as a datetime object. url (:obj:`str`): An HTTPS URL that can be used to see transaction details. )dateurlNrrLrMrrct|tj||j 5||_||_|j|j f|_dddy#1swYyxYwrG) r r!rr _unfrozenrLrMrr$)r'rLrMrr(s r)r!z(RevenueWithdrawalStateSucceeded.__init__sb 4>>:V ^^  "&DIDH  DN    ,A&&A/r+r,rc|j|}|syt|}t|jdd||d<t|||S)NrLtzinfor.)r/rrr3r r5r7r+r, loc_tzinfor(s r)r5z'RevenueWithdrawalStateSucceeded.de_jsonsSt$2#6 %dhhvt&rr?rrr!rAr5rBrCs@r)r1r1os$ I*.  X&   ">B 3H% 3,4UO 3 3 4 3 3r*r1c<eZdZdZdZdddeeddffdZxZS)r2zThe withdrawal failed and the transaction was refunded. .. versionadded:: 21.4 Attributes: type (:obj:`str`): The type of the state, always :tg-const:`telegram.RevenueWithdrawalState.FAILED`. rENrrrcdt|tj||j yrG)r r!rrr%rHs r)r!z%RevenueWithdrawalStateFailed.__init__s% 4;; S r*rIrCs@r)r2r2rJr*r2c reZdZUdZdZej jZee e d< ej jZ ee e d< ej jZ ee e d< ej jZ ee e d< ddd e d eed dffd Ze dd eededd edffd ZxZS)TransactionPartnerauThis object describes the source of a transaction, or its recipient for outgoing transactions. Currently, it can be one of: * :class:`TransactionPartnerUser` * :class:`TransactionPartnerFragment` * :class:`TransactionPartnerTelegramAds` * :class:`TransactionPartnerOther` Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`type` is equal. .. versionadded:: 21.4 Args: type (:obj:`str`): The type of the transaction partner. Attributes: type (:obj:`str`): The type of the transaction partner. rFRAGMENTUSEROTHER TELEGRAM_ADSNrrrrct||tjtj |||_|j f|_|jyr) r r!rr"r TransactionPartnerTyperr$r%r&s r)r!zTransactionPartner.__init__sD J/)I)I4QUV )) r*r+r,rch|j|}|y|s |tury|jt|jt |j t|jti}|tur8|jd|vr%||jdj||St|1||S)aWConverts JSON data to the appropriate :class:`TransactionPartner` object, i.e. takes care of selecting the correct subclass. Args: data (Dict[:obj:`str`, ...]): The JSON data. bot (:class:`telegram.Bot`): The bot associated with this object. Returns: The Telegram object. Nrr.)r/rYrZTransactionPartnerFragmentr[TransactionPartnerUserr\TransactionPartnerOtherr]TransactionPartnerTelegramAdsr3r4r5r r6s r)r5zTransactionPartner.de_jsonst$ <11 LL4 HH, II.   ; ?  $ $&)9^)K!$((6"23;;3;O OwDc22r*r9)r:r;r<r=r>r r_rZrr?r@r[r\r]rrr!rAr5rBrCs@r)rYrYs(I$;;DDHeCjDE 77<>E5:>B(??LLL%*LIFJS(1Ct>B 3H% 3,4UO 3 & ' 3 3r*rYc eZdZdZdZ ddddeddeeddffd Ze dd eed ed dedffd Z xZ S)raaDescribes a withdrawal transaction with Fragment. .. versionadded:: 21.4 Args: withdrawal_state (:obj:`telegram.RevenueWithdrawalState`, optional): State of the transaction if the transaction is outgoing. Attributes: type (:obj:`str`): The type of the transaction partner, always :tg-const:`telegram.TransactionPartner.FRAGMENT`. withdrawal_state (:obj:`telegram.RevenueWithdrawalState`): Optional. State of the transaction if the transaction is outgoing. )withdrawal_stateNrrfrrrct|tj||j 5||_dddy#1swYyxYwrG)r r!rYrZrOrf)r'rfrr(s r)r!z#TransactionPartnerFragment.__init__sI 099jQ ^^  WFVD ! W W Ws AA r+r,rc|j|}|sytj|jd||d<t| ||S)Nrfr.)r/rr5r3r r7r+r,r(s r)r5z"TransactionPartnerFragment.de_jsonsSt$#9#A#A HH' (#$   wDc22r*r9) r:r;r<r=r>rrr!rAr5rBrCs@r)raras &I@D W*. W"#;< WX& W  W>B 3H% 3,4UO 3 . / 3 3r*rac eZdZdZdZ ddddddeedeed dffd Ze dd eed ed d edffd Z xZ S)rbaDescribes a transaction with a user. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`user` are equal. .. versionadded:: 21.4 Args: user (:class:`telegram.User`): Information about the user. invoice_payload (:obj:`str`, optional): Bot-specified invoice payload. Attributes: type (:obj:`str`): The type of the transaction partner, always :tg-const:`telegram.TransactionPartner.USER`. user (:class:`telegram.User`): Information about the user. invoice_payload (:obj:`str`): Optional. Bot-specified invoice payload. )invoice_payloaduserNrrlr rkrrct|tj||j 5||_||_|j|j f|_dddy#1swYyxYwrG) r r!rYr[rOrlrkrr$)r'rlrkrr(s r)r!zTransactionPartnerUser.__init__Csc 055*M ^^  "DI2AD   DN   rPr+r,rc|j|}|sytj|jd||d<t| ||S)Nrlr.)r/r r5r3r ris r)r5zTransactionPartnerUser.de_jsonTsIt$||DHHV$4c:V wDc22r*r9) r:r;r<r=r>rr?rr!rAr5rBrCs@r)rbrb.s$,I *. *. "# X&   ">B 3H% 3,4UO 3 * + 3 3r*rbc<eZdZdZdZdddeeddffdZxZS)rczDescribes a transaction with an unknown partner. .. versionadded:: 21.4 Attributes: type (:obj:`str`): The type of the transaction partner, always :tg-const:`telegram.TransactionPartner.OTHER`. rENrrrcdt|tj||j yrG)r r!rYr\r%rHs r)r!z TransactionPartnerOther.__init__ns% 066:N r*rIrCs@r)rcrcbrJr*rcc<eZdZdZdZdddeeddffdZxZS)rdzDescribes a withdrawal transaction to the Telegram Ads platform. .. versionadded:: 21.4 Attributes: type (:obj:`str`): The type of the transaction partner, always :tg-const:`telegram.TransactionPartner.TELEGRAM_ADS`. rENrrrcdt|tj||j yrG)r r!rYr]r%rHs r)r!z&TransactionPartnerTelegramAds.__init__s% 0==*U r*rIrCs@r)rdrdsrJr*rdceZdZdZdZ ddddedededee d ee d ee d dffd Z e dd ee dedd edffd Z xZS)StarTransactionatDescribes a Telegram Star transaction. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`id`, :attr:`source`, and :attr:`receiver` are equal. .. versionadded:: 21.4 Args: id (:obj:`str`): Unique identifier of the transaction. Coincides with the identifer of the original transaction for refund transactions. Coincides with :attr:`SuccessfulPayment.telegram_payment_charge_id` for successful incoming payments from users. amount (:obj:`int`): Number of Telegram Stars transferred by the transaction. date (:obj:`datetime.datetime`): Date the transaction was created as a datetime object. source (:class:`telegram.TransactionPartner`, optional): Source of an incoming transaction (e.g., a user purchasing goods or services, Fragment refunding a failed withdrawal). Only for incoming transactions. receiver (:class:`telegram.TransactionPartner`, optional): Receiver of an outgoing transaction (e.g., a user for a purchase refund, Fragment for a withdrawal). Only for outgoing transactions. Attributes: id (:obj:`str`): Unique identifier of the transaction. Coincides with the identifer of the original transaction for refund transactions. Coincides with :attr:`SuccessfulPayment.telegram_payment_charge_id` for successful incoming payments from users. amount (:obj:`int`): Number of Telegram Stars transferred by the transaction. date (:obj:`datetime.datetime`): Date the transaction was created as a datetime object. source (:class:`telegram.TransactionPartner`): Optional. Source of an incoming transaction (e.g., a user purchasing goods or services, Fragment refunding a failed withdrawal). Only for incoming transactions. receiver (:class:`telegram.TransactionPartner`): Optional. Receiver of an outgoing transaction (e.g., a user for a purchase refund, Fragment for a withdrawal). Only for outgoing transactions. )amountrLidreceiversourceNrrvrurLrxrwrrct||||_||_||_||_||_|j|j |j f|_|jyr) r r!rvrurLrxrwr$r%)r'rvrurLrxrwrr(s r)r!zStarTransaction.__init__sc J/! " 4: 6>  GG KK MM  r*r+r,rcD|j|}|syt|}t|jdd||d<tj |jd||d<tj |jd||d<t |||S)NrLrRrxrwr.)r/rrr3rYr5r rTs r)r5zStarTransaction.de_jsonst$2#6 %dhhvt&r?intrrrYrr!rAr5rBrCs@r)rtrts"H?I0415 *.   +,  -. X& 0>B3H%3,4UO3 # $33r*rtc zeZdZdZdZdddeedeeffdZ e d deed ed d edffd Z xZ S)StarTransactionsa Contains a list of Telegram Star transactions. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`transactions` are equal. .. versionadded:: 21.4 Args: transactions (Sequence[:class:`telegram.StarTransaction`]): The list of transactions. Attributes: transactions (Tuple[:class:`telegram.StarTransaction`]): The list of transactions. ) transactionsNrr~rct||t||_|jf|_|j yr)r r!rr~r$r%)r'r~rr(s r)r!zStarTransactions.__init__s; J/9KL9Y++- r*r+r,rrc|j|}|ytj|jd||d<t|||S)Nr~r.)r/rtde_listr3r r5ris r)r5zStarTransactions.de_jsonsOt$ <.66txx7OQTU^wDc22r*r9) r:r;r<r=r>rrtrrr!rAr5rBrCs@r)r}r}ss "I\`$_5FNxFX>B 3H% 3,4UO 3 $ % 3 3r*r}N)%r=rtypingrrrrrr r telegramr telegram._telegramobjectr telegram._userr telegram._utilsrtelegram._utils.argumentparsingrtelegram._utils.datetimerrtelegram._utils.typesrrrr0r1r2rYrarbrcrdrtr}rEr*r)rs(HNNN3 >Q*63^63r$:"33&<33l#9"H3H3V*3!3*3Z13/13h0"$6"O3nO3d%3~%3r*