o GChQ@shdZddlmZddlmZddlmZmZmZddlm Z ddl m Z ddl m Z ddlmZdd lmZdd lmZdd lmZmZdd lmZerRdd lmZGddde ZGdddeZGdddeZGdddeZGddde ZGdddeZGdddeZ GdddeZ!GdddeZ"Gd d!d!eZ#Gd"d#d#e Z$Gd$d%d%e Z%d&S)'zAThis module contains the classes for Telegram Stars transactions.)Sequence)datetime) TYPE_CHECKINGFinalOptional) 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_memberrRevenueWithdrawalStateTyper _id_attrs_freezeselfrr __class__P/var/www/html/govbot/env/lib/python3.10/site-packages/telegram/_payment/stars.pyrD  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'r2Ks zRevenueWithdrawalState.de_jsonN)__name__ __module__ __qualname____doc__ __slots__rrrrstr__annotations__rrrrr classmethodr2 __classcell__r&r&r$r'r's& $rc8eZdZdZdZdddeeddffddZZS) r-zThe 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)rrrrr!r#rr$r&r'rw z&RevenueWithdrawalStatePending.__init__ r7r8r9r:r;rrrr?r&r&r$r'r-k (r-c sneZdZdZdZdddededeeddffd d Z e dd eed ed dedffdd Z Z S)r.aThe 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. )dateurlNrrGrHrrcsZtjtj|d|||_||_|j|jf|_WddS1s&wYdSrB) rrrr _unfrozenrGrHrr )r#rGrHrr$r&r'rs "z(RevenueWithdrawalStateSucceeded.__init__r)r*rcsB||}|s dSt|}t|dd|d|d<tj||dS)z4See :meth:`telegram.RevenueWithdrawalState.de_json`.NrGtzinfor+)r,r rr0rr2r4r)r* loc_tzinfor$r&r'r2s z'RevenueWithdrawalStateSucceeded.de_jsonr6) r7r8r9r:r;rr<rrrr>r2r?r&r&r$r'r.|s,r.cr@) r/zThe 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&NrrrcrArB)rrrrr!rCr$r&r'rrDz%RevenueWithdrawalStateFailed.__init__rEr&r&r$r'r/rFr/c seZdZUdZdZejjZee e d< ejj Z ee e d< ejj Z ee e d< ejj Z ee e d< ejjZee e d< dd d e d eed dffd dZe 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. rFRAGMENTOTHER TELEGRAM_ADS TELEGRAM_APIUSERNrrrrcrr) rrr rrTransactionPartnerTyperr r!r"r$r&r'rr(zTransactionPartner.__init__r)r*rc s||}|dur dS|s|turdS|jt|jt|jt|jt |j t i}|tur;| d|vr;|| dj||dStj||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,rNrOTransactionPartnerFragmentrSTransactionPartnerUserrQTransactionPartnerTelegramAdsrRTransactionPartnerTelegramApirPTransactionPartnerOtherr0r1r2rr3r$r&r'r2s  zTransactionPartner.de_jsonr6)r7r8r9r:r;rrTrOrr<r=rPrQrRrSrrrr>r2r?r&r&r$r'rNs. $rNc sreZdZdZdZ ddddeddeeddffd d Ze dd eed ed dedffdd Z Z S)rUaDescribes 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_stateNrrZrrrcsFtjtj|d| ||_WddS1swYdSrB)rrrNrOrIrZ)r#rZrr$r&r'r$s "z#TransactionPartnerFragment.__init__r)r*rcs8||}|s dSt|d||d<tj||dS)0See :meth:`telegram.TransactionPartner.de_json`.NrZr+)r,rr2r0rr4r)r*r$r&r'r2/s  z"TransactionPartnerFragment.de_jsonr6) r7r8r9r:r;rrrr>r2r?r&r&r$r'rUs, rUcseZdZdZdZ   ddddddeedeeed eed ee d df fd d Z e ddee dedd edffdd Z Z S)rVaDescribes 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 r]r^r_rrcsjtjtj|d|||_||_t||_||_ |j |jf|_ WddS1s.wYdSrB) rrrNrSrIr`r]r r^r_rr )r#r`r]r^r_rr$r&r'rds  "zTransactionPartnerUser.__init__r)r*rcsP||}|s dSt|d||d<tj|d|d|d<tj||dS)r[Nr`r^)r*r+)r,r r2r0rde_listrr\r$r&r'r2ys zTransactionPartnerUser.de_json)NNNr6)r7r8r9r:r;rr<rrrrr>r2r?r&r&r$r'rV@s<! rVcr@) 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&NrrrcrArB)rrrNrPr!rCr$r&r'rrDz TransactionPartnerOther.__init__rEr&r&r$r'rYrFrYcr@) rWzDescribes 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&NrrrcrArB)rrrNrQr!rCr$r&r'rrDz&TransactionPartnerTelegramAds.__init__rEr&r&r$r'rWrFrWcs<eZdZdZdZdddedeeddffdd ZZ S) rXaDescribes a transaction with payment for `paid broadcasting `_. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`request_count` is equal. .. versionadded:: 21.7 Args: request_count (:obj:`int`): The number of successful requests that exceeded regular limits and were therefore billed. Attributes: type (:obj:`str`): The type of the transaction partner, always :tg-const:`telegram.TransactionPartner.TELEGRAM_API`. request_count (:obj:`int`): The number of successful requests that exceeded regular limits and were therefore billed. ) request_countNrrbrrcsPtjtj|d|||_|jf|_WddS1s!wYdSrB)rrrNrRrIrbr )r#rbrr$r&r'rs   "z&TransactionPartnerTelegramApi.__init__) r7r8r9r:r;intrrrr?r&r&r$r'rXs,rXcseZdZdZdZ  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. )amountrGidreceiversourceNrrfrerGrhrgrrcsJtj|d||_||_||_||_||_|j|j|jf|_|dSr) rrrfrerGrhrgr r!)r#rfrerGrhrgrr$r&r'rs  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`.NrGrJrhrgr+)r,r rr0rNr2rrLr$r&r'r2s zStarTransaction.de_json)NNr6)r7r8r9r:r;r<rcrrrNrrr>r2r?r&r&r$r'rds>$ rdc 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)rrr rkr r!)r#rkrr$r&r'r-s   zStarTransactions.__init__r)r*rrcs<||}|dur dSt|d||d<tj||dS)riNrkr+)r,rdrar0rr2r\r$r&r'r26s zStarTransactions.de_jsonr6) r7r8r9r:r;rrdrrrr>r2r?r&r&r$r'rjs$ rjN)&r:collections.abcrrtypingrrrtelegramrtelegram._paidmediartelegram._telegramobjectr telegram._userr telegram._utilsr telegram._utils.argumentparsingr telegram._utils.datetimer rtelegram._utils.typesrrrr-r.r/rNrUrVrYrWrXrdrjr&r&r&r's4          D7N.IS