՟fLdZddlmZddlmZmZmZmZmZmZm Z ddl m Z ddl m Z ddlmZddlmZddlmZdd lmZdd lmZmZdd lmZerdd l mZGd deZGddeZGddeZGddeZGddeZ Gdde Z!Gdde Z"Gdde Z#Gdde Z$Gdd eZ%Gd!d"eZ&y#)$zAThis module contains the classes for Telegram Stars transactions.)datetime) TYPE_CHECKINGDictFinalOptionalSequenceTupleType) constants) PaidMedia)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 R/var/www/cvtools/html/venv/lib/python3.12/site-packages/telegram/_payment/stars.pyr"zRevenueWithdrawalState.__init__CsD J/)M)MtUYZ )) databotrc2|j|}|sy|jt|jt|j t i}|tur8|jd|vr%||jdj||St|)||S)a[Converts JSON data to the appropriate :class:`RevenueWithdrawalState` 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-) _parse_datarRevenueWithdrawalStatePendingrRevenueWithdrawalStateSucceededrRevenueWithdrawalStateFailedrgetpopde_jsonr!clsr,r-_class_mappingr)s r*r6zRevenueWithdrawalState.de_jsonJst$ KK6 MM: JJ4C  ( (TXXf-=-O!$((6"23;;3;O OwDc22r+N)__name__ __module__ __qualname____doc__ __slots__r r$rrstr__annotations__rrrrr" classmethodr6 __classcell__r)s@r*rr&s&I#>>FFGU3ZFH%@@JJIuSzJJ"==DDFE#JDGFJS(1Ct>B3H%3,4UO3 * +33r+rc<eZdZdZdZdddeeddffdZxZS)r1zThe 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__vs% 4<<T r+ r;r<r=r>r?rrr"rCrDs@r*r1r1j/I;?hx&8Dr+r1c |eZdZdZdZdddededeeddffd Z e dd eed ed dedffd Z xZ S)r2aThe 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. )dateurlNrrMrNrrct|tj||j 5||_||_|j|j f|_dddy#1swYyxYwrH) r!r"rr _unfrozenrMrNrr%)r(rMrNrr)s r*r"z(RevenueWithdrawalStateSucceeded.__init__sb 4>>:V ^^  "&DIDH  DN   s ,A&&A/r,r-rc|j|}|syt|}t|jdd||d<t|||S)z4See :meth:`telegram.RevenueWithdrawalState.de_json`.NrMtzinfor/)r0rrr4r!r6r8r,r- loc_tzinfor)s r*r6z'RevenueWithdrawalStateSucceeded.de_jsonsS t$2#6 %dhhvt&r?rr@rrr"rBr6rCrDs@r*r2r2{s$ I*.  X&   ">B 3H% 3,4UO 3 3 4 3 3r+r2c<eZdZdZdZdddeeddffdZxZS)r3zThe 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`. rFNrrrcdt|tj||j yrH)r!r"rrr&rIs r*r"z%RevenueWithdrawalStateFailed.__init__s% 4;; S r+rJrDs@r*r3r3rKr+r3c 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/)r0rYrZTransactionPartnerFragmentr[TransactionPartnerUserr\TransactionPartnerOtherr]TransactionPartnerTelegramAdsr4r5r6r!r7s r*r6zTransactionPartner.de_jsonst$ <11 LL4 HH, II.   ; ?  $ $&)9^)K!$((6"23;;3;O OwDc22r+r:)r;r<r=r>r?r r_rZrr@rAr[r\r]rrr"rBr6rCrDs@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 (:class:`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 (:class:`telegram.RevenueWithdrawalState`): Optional. State of the transaction if the transaction is outgoing. )withdrawal_stateNrrfrrrct|tj||j 5||_dddy#1swYyxYwrH)r!r"rYrZrPrf)r(rfrr)s r*r"z#TransactionPartnerFragment.__init__ sI 099jQ ^^  WFVD ! W W Ws AA r,r-rc|j|}|sytj|jd||d<t| ||S)0See :meth:`telegram.TransactionPartner.de_json`.Nrfr/)r0rr6r4r!r8r,r-r)s r*r6z"TransactionPartnerFragment.de_json+sS t$#9#A#A HH' (#$   wDc22r+r:) r;r<r=r>r?rrr"rBr6rCrDs@r*raras &I@D W*. W"#;< WX& W  W>B 3H% 3,4UO 3 . / 3 3r+raceZdZdZdZ ddddddeedeeed eed ee d df fd Z e dd ee dedd 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. paid_media (Sequence[:class:`telegram.PaidMedia`], optional): Information about the paid media bought by the user. .. versionadded:: 21.5 paid_media_payload (:obj:`str`, optional): Optional. Bot-specified paid media payload. .. versionadded:: 21.6 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. paid_media (Tuple[:class:`telegram.PaidMedia`]): Optional. Information about the paid media bought by the user. .. versionadded:: 21.5 paid_media_payload (:obj:`str`): Optional. Optional. Bot-specified paid media payload. .. versionadded:: 21.6 )invoice_payload paid_mediapaid_media_payloaduserNrrorrlrmrnrrct|tj||j 5||_||_t||_||_ |j|j f|_ dddy#1swYyxYwrH) r!r"rYr[rProrlrrmrnrr%)r(rorlrmrnrr)s r*r"zTransactionPartnerUser.__init__`sx 055*M ^^  "DI2AD ?QR\?]DO5GD #  DN    s AA==Br,r-rc|j|}|sytj|jd||d<t j |jd||d<t | ||S)riNrorm)r-r/)r0rr6r4r de_listr!rjs r*r6zTransactionPartnerUser.de_jsonusi t$||DHHV$4c:V &..txx /E3O\wDc22r+)NNNr:)r;r<r=r>r?rr@rr rr"rBr6rCrDs@r*rbrb<sBPI *.48,0 *."#Xi01  %SM 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`. rFNrrrcdt|tj||j yrH)r!r"rYr\r&rIs r*r"z TransactionPartnerOther.__init__s% 066:N r+rJrDs@r*rcrcrKr+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`. rFNrrrcdt|tj||j yrH)r!r"rYr]r&rIs r*r"z&TransactionPartnerTelegramAds.__init__s% 0==*U r+rJrDs@r*rdrdrKr+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. )amountrMidreceiversourceNrrzryrMr|r{rrct||||_||_||_||_||_|j|j |j f|_|jyr ) r!r"rzryrMr|r{r%r&)r(rzryrMr|r{rr)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),See :meth:`telegram.TelegramObject.de_json`.NrMrRr|r{r/)r0rrr4rYr6r!rTs r*r6zStarTransaction.de_jsons t$2#6 %dhhvt&r?r@intrrrYrr"rBr6rCrDs@r*rxrxs"H?I0415 *.   +,  -. X& 0>B3H%3,4UO3 # $33r+rxc 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. ) transactionsNrrrct||t||_|jf|_|j yr )r!r"rrr%r&)r(rrr)s r*r"zStarTransactions.__init__ s; J/9KL9Y++- r+r,r-rrc|j|}|ytj|jd||d<t|||S)rNrr/)r0rxrrr4r!r6rjs r*r6zStarTransactions.de_jsonsO t$ <.66txx7OQTU^wDc22r+r:) r;r<r=r>r?rrxrrr"rBr6rCrDs@r*rrss "I\`$_5FNxFX>B 3H% 3,4UO 3 $ % 3 3r+rN)'r>rtypingrrrrrr r telegramr telegram._paidmediar telegram._telegramobjectr telegram._userrtelegram._utilsrtelegram._utils.argumentparsingrtelegram._utils.datetimerrtelegram._utils.typesrrrr1r2r3rYrarbrcrdrxrrFr+r*rs(HNNN)3 >Q*A3^A3H$:"43&<43n#9"H3H3V+3!3+3\F3/F3R0"$6"P3nP3f&3~&3r+