U gL@s\dZddlmZddlmZmZmZmZmZmZm Z ddl m Z ddl m Z ddlmZddlmZddlmZdd lmZdd lmZmZdd lmZerdd l mZGd ddeZGdddeZGdddeZGdddeZGdddeZ Gddde Z!Gddde Z"Gddde Z#Gddde Z$Gdd d eZ%Gd!d"d"eZ&d#S)$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)BotcseZdZUdZdZejjZee e d<ejj Z ee e d<ejj Z ee e d<dde e eddfd d Zede ee d e dd fd d ZZS)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_kwargsrrreturncs6tj|dttj|||_|jf|_|dSNr) super__init__r get_memberr RevenueWithdrawalStateTyper _id_attrs_freezeselfrr __class__;/tmp/pip-unpacked-wheel-swnnwir2/telegram/_payment/stars.pyr Cs zRevenueWithdrawalState.__init__rdatabotrcsf||}|sdS|jt|jt|jti}|tkrV|d|krV|| dj ||dSt j ||dS)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_jsonrclsr,r-Z_class_mappingr'r)r*r5Js zRevenueWithdrawalState.de_json)N)__name__ __module__ __qualname____doc__ __slots__r r"rrstr__annotations__rrrrr classmethodr5 __classcell__r)r)r'r*r&s  rcs6eZdZdZdZddeeddfddZZS)r0zThe withdrawal is in progress. .. versionadded:: 21.4 Attributes: type (:obj:`str`): The type of the state, always :tg-const:`telegram.RevenueWithdrawalState.PENDING`. r)Nrrrcstjtj|d|dSN)rr)rr rrr$r&rr'r)r*r vsz&RevenueWithdrawalStatePending.__init__ r8r9r:r;r<rrr r@r)r)r'r*r0js r0csbeZdZdZdZddeeeeddfddZ e d eeededd fd d Z Z 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. )dateurlNr)rErFrrc sDtjtj|d| ||_||_|j|jf|_W5QRXdSrB) rr rr _unfrozenrErFrr#)r&rErFrr'r)r*r s z(RevenueWithdrawalStateSucceeded.__init__rr+csB||}|sdSt|}t|dd|d|d<tj||dS)z4See :meth:`telegram.RevenueWithdrawalState.de_json`.NrEtzinfor.)r/rrr3rr5r7r,r-Z loc_tzinfor'r)r*r5s  z'RevenueWithdrawalStateSucceeded.de_json)N) r8r9r:r;r<rr=rrr r?r5r@r)r)r'r*r1{s r1cs6eZdZdZdZddeeddfddZZS)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`. r)NrrAcstjtj|d|dSrB)rr rrr$rCr'r)r*r sz%RevenueWithdrawalStateFailed.__init__rDr)r)r'r*r2s r2cseZdZUdZdZejjZee e d<ejj Z ee e d<ejj Z ee e d<ejj Z ee e d<dde eedd fd d Zedeeed edd fdd ZZS)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_ADSNrrcs6tj|dttj|||_|jf|_|dSr) rr rr!r TransactionPartnerTyperr#r$r%r'r)r*r s zTransactionPartner.__init__rr+cs||}|dkrdS|s&|tkr&dS|jt|jt|jt|jt i}|tkrp| d|krp|| dj ||dSt j ||dS)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/rKrLTransactionPartnerFragmentrMTransactionPartnerUserrNTransactionPartnerOtherrOTransactionPartnerTelegramAdsr3r4r5rr6r'r)r*r5s"  zTransactionPartner.de_json)N)r8r9r:r;r<r rPrLrr=r>rMrNrOrrr r?r5r@r)r)r'r*rKs  rKcsfeZdZdZdZd ddedeeddfddZedeeed edd fd d Z Z S)rQaDescribes 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_stateNrr)rUrrc s0tjtj|d| ||_W5QRXdSrB)rr rKrLrGrU)r&rUrr'r)r*r s z#TransactionPartnerFragment.__init__rr+cs8||}|sdSt|d||d<tj||dS)0See :meth:`telegram.TransactionPartner.de_json`.NrUr.)r/rr5r3rr7r,r-r'r)r*r5+s z"TransactionPartnerFragment.de_json)N)N) r8r9r:r;r<rrr r?r5r@r)r)r'r*rQs" rQc sxeZdZdZdZd dddeeeeeeeee ddfddZ e dee ed edd fd d Z Z S)rRaDescribes 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_payloaduserNrr )r[rXrYrZrrc sTtjtj|d|0||_||_t||_||_ |j |jf|_ W5QRXdSrB) rr rKrMrGr[rXrrYrZrr#)r&r[rXrYrZrr'r)r*r `s   zTransactionPartnerUser.__init__rr+csP||}|sdSt|d||d<tj|d|d|d<tj||dS)rVNr[rY)r-r.)r/r r5r3r de_listrrWr'r)r*r5us  zTransactionPartnerUser.de_json)NNN)N)r8r9r:r;r<rr=rr rr r?r5r@r)r)r'r*rR<s,! rRcs6eZdZdZdZddeeddfddZZS)rSzDescribes 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`. r)NrrAcstjtj|d|dSrB)rr rKrNr$rCr'r)r*r sz TransactionPartnerOther.__init__rDr)r)r'r*rSs rScs6eZdZdZdZddeeddfddZZS)rTzDescribes 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`. r)NrrAcstjtj|d|dSrB)rr rKrOr$rCr'r)r*r sz&TransactionPartnerTelegramAds.__init__rDr)r)r'r*rTs rTc sreZdZdZdZd ddeeeee ee ee ddfddZ e d ee ededd fd d Z ZS)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. )amountrEidreceiversourceNr)r_r^rErar`rrcsJtj|d||_||_||_||_||_|j|j|jf|_|dSr) rr r_r^rErar`r#r$)r&r_r^rErar`rr'r)r*r s zStarTransaction.__init__rr+csn||}|sdSt|}t|dd|d|d<t|d||d<t|d||d<tj||dS),See :meth:`telegram.TelegramObject.de_json`.NrErHrar`r.)r/rrr3rKr5rrJr'r)r*r5s zStarTransaction.de_json)NN)N)r8r9r:r;r<r=intrrrKrr r?r5r@r)r)r'r*r]s,$r]csbeZdZdZdZddeeeedfddZ e d eeededd fd d Z Z 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. ) transactionsNr)rercs.tj|dt||_|jf|_|dSr)rr rrer#r$)r&rerr'r)r*r s  zStarTransactions.__init__rr+cs<||}|dkrdSt|d||d<tj||dS)rbNrer.)r/r]r\r3rr5rWr'r)r*r5s  zStarTransactions.de_json)N) r8r9r:r;r<rr]rrr r?r5r@r)r)r'r*rds rdN)'r;rtypingrrrrrrr Ztelegramr Ztelegram._paidmediar Ztelegram._telegramobjectr Ztelegram._userr Ztelegram._utilsrZtelegram._utils.argumentparsingrZtelegram._utils.datetimerrZtelegram._utils.typesrrrr0r1r2rKrQrRrSrTr]rdr)r)r)r*s. $        D7K.IS