o /hL@s\dZddlmZddlmZmZmZmZmZmZm Z ddl m Z ddl m Z ddlmZddlmZddlmZdd lmZdd lmZmZdd lmZerTdd 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)Botc seZdZUdZdZejjZee e d< ejj Z ee e d< ejj Z ee e d< ddde d e ed dffd d Ze dd e ede dd e dffdd 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_kwargsrrreturnc6tj|dttj|||_|jf|_|dSNr) super__init__r get_memberr RevenueWithdrawalStateTyper _id_attrs_freezeselfrr __class__P/var/www/html/govbot/env/lib/python3.10/site-packages/telegram/_payment/stars.pyr C  zRevenueWithdrawalState.__init__databotrcsf||}|s dS|jt|jt|jti}|tur+|d|vr+|| 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-_class_mappingr'r)r*r5Js zRevenueWithdrawalState.de_jsonN)__name__ __module__ __qualname____doc__ __slots__r r"rrstr__annotations__rrrrr classmethodr5 __classcell__r)r)r'r*r&s& $rc8eZdZdZdZdddeeddffddZZS) r0zThe withdrawal is in progress. .. versionadded:: 21.4 Attributes: type (:obj:`str`): The type of the state, always :tg-const:`telegram.RevenueWithdrawalState.PENDING`. r)Nrrrctjtj|d|dSN)rr)rr rrr$r&rr'r)r*r v z&RevenueWithdrawalStatePending.__init__ r:r;r<r=r>rrr rBr)r)r'r*r0j (r0c sneZdZdZdZdddededeeddffd d Z e dd eed ed dedffdd 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. )dateurlNrrJrKrrcsZtjtj|d|||_||_|j|jf|_WddS1s&wYdSrE) rr rr _unfrozenrJrKrr#)r&rJrKrr'r)r*r s "z(RevenueWithdrawalStateSucceeded.__init__r,r-rcsB||}|s dSt|}t|dd|d|d<tj||dS)z4See :meth:`telegram.RevenueWithdrawalState.de_json`.NrJtzinfor.)r/rrr3rr5r7r,r- loc_tzinfor'r)r*r5s z'RevenueWithdrawalStateSucceeded.de_jsonr9) r:r;r<r=r>rr?rrr rAr5rBr)r)r'r*r1{s,r1crC) 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)NrrrcrDrE)rr rrr$rFr'r)r*r rGz%RevenueWithdrawalStateFailed.__init__rHr)r)r'r*r2rIr2c seZdZUdZdZejjZee e d< ejj Z ee e d< ejj Z ee e d< ejj Z ee e d< ddd e d eed dffd d Ze ddeededd edffdd 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_ADSNrrrrcrr) rr rr!r TransactionPartnerTyperr#r$r%r'r)r*r r+zTransactionPartner.__init__r,r-rcs||}|dur dS|s|turdS|jt|jt|jt|jt i}|tur8| d|vr8|| 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/rQrRTransactionPartnerFragmentrSTransactionPartnerUserrTTransactionPartnerOtherrUTransactionPartnerTelegramAdsr3r4r5rr6r'r)r*r5s  zTransactionPartner.de_jsonr9)r:r;r<r=r>r rVrRrr?r@rSrTrUrrr rAr5rBr)r)r'r*rQs* $rQc sreZdZdZdZ ddddeddeeddffd d Ze dd eed ed dedffdd Z Z S)rWaDescribes 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[rrrcsFtjtj|d| ||_WddS1swYdSrE)rr rQrRrLr[)r&r[rr'r)r*r s "z#TransactionPartnerFragment.__init__r,r-rcs8||}|s dSt|d||d<tj||dS)0See :meth:`telegram.TransactionPartner.de_json`.Nr[r.)r/rr5r3rr7r,r-r'r)r*r5+s  z"TransactionPartnerFragment.de_jsonr9) r:r;r<r=r>rrr rAr5rBr)r)r'r*rWs, rWcseZdZdZdZ   ddddddeedeeed eed ee d df fd d Z e ddee dedd edffdd Z Z S)rXaDescribes 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_payloaduserNrrar r^r_r`rrcsjtjtj|d|||_||_t||_||_ |j |jf|_ WddS1s.wYdSrE) rr rQrSrLrar^rr_r`rr#)r&rar^r_r`rr'r)r*r `s  "zTransactionPartnerUser.__init__r,r-rcsP||}|s dSt|d||d<tj|d|d|d<tj||dS)r\Nrar_)r-r.)r/r r5r3r de_listrr]r'r)r*r5us zTransactionPartnerUser.de_json)NNNr9)r:r;r<r=r>rr?rr rr rAr5rBr)r)r'r*rX<s<! rXcrC) rYzDescribes 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)NrrrcrDrE)rr rQrTr$rFr'r)r*r rGz TransactionPartnerOther.__init__rHr)r)r'r*rYrIrYcrC) rZzDescribes 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)NrrrcrDrE)rr rQrUr$rFr'r)r*r rGz&TransactionPartnerTelegramAds.__init__rHr)r)r'r*rZrIrZcseZdZdZdZ  ddddedededee d ee d ee d dffd d Z e ddee dedd edffdd 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. )amountrJidreceiversourceNrrerdrJrgrfrrcsJtj|d||_||_||_||_||_|j|j|jf|_|dSr) rr rerdrJrgrfr#r$)r&rerdrJrgrfrr'r)r*r s  zStarTransaction.__init__r,r-rcsn||}|s dSt|}t|dd|d|d<t|d||d<t|d||d<tj||dS),See :meth:`telegram.TelegramObject.de_json`.NrJrMrgrfr.)r/rrr3rQr5rrOr'r)r*r5s zStarTransaction.de_json)NNr9)r:r;r<r=r>r?intrrrQrr rAr5rBr)r)r'r*rcs>$ rcc sjeZdZdZdZdddeedeeffddZ e dd eed ed d edffd 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. ) transactionsNrrkrcs.tj|dt||_|jf|_|dSr)rr rrkr#r$)r&rkrr'r)r*r s   zStarTransactions.__init__r,r-rrcs<||}|dur dSt|d||d<tj||dS)rhNrkr.)r/rcrbr3rr5r]r'r)r*r5s zStarTransactions.de_jsonr9) r:r;r<r=r>rrcrrr rAr5rBr)r)r'r*rjs$ rjN)'r=rtypingrrrrrrr telegramr telegram._paidmediar telegram._telegramobjectr telegram._userr telegram._utilsrtelegram._utils.argumentparsingrtelegram._utils.datetimerrtelegram._utils.typesrrrr0r1r2rQrWrXrYrZrcrjr)r)r)r*s0 $        D7K.IS