Qi:RdZddlZddlmZddlmZmZmZddl m Z ddl m Z ddl mZddlmZdd lmZdd lmZdd lmZdd lmZd dlmZd dlmZerddl mZGddeZGddeZGddeZ GddeZ!GddeZ"GddeZ#GddeZ$y)zIThis module contains the classes for Telegram Stars transaction partners.N)Sequence) TYPE_CHECKINGFinalOptional) constants)Gift) PaidMedia)TelegramObject)User)enum)parse_sequence_arg)JSONDict) AffiliateInfo)RevenueWithdrawalState)Botc eZdZUdZdZej jZee e d< ej jZ ee e d< ej jZ ee e d< ej jZ ee e d< ej jZee e d< ej jZee e d< d d d e d eed d ffdZe ddeededd edffd ZxZS)TransactionPartneraThis object describes the source of a transaction, or its recipient for outgoing transactions. Currently, it can be one of: * :class:`TransactionPartnerUser` * :class:`TransactionPartnerAffiliateProgram` * :class:`TransactionPartnerFragment` * :class:`TransactionPartnerTelegramAds` * :class:`TransactionPartnerTelegramApi` * :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. )typeAFFILIATE_PROGRAMFRAGMENTOTHER TELEGRAM_ADS TELEGRAM_APIUSERN api_kwargsrrreturnct||tjtj |||_|j f|_|jy)Nr) super__init__r get_memberrTransactionPartnerTyper _id_attrs_freeze)selfrr __class__s U/app/.venv/lib/python3.12/site-packages/telegram/_payment/stars/transactionpartner.pyr!zTransactionPartner.__init__RsD J/)I)I4QUV )) databotrc |j|}|tur|r|y|jt|jt |j t|jt|jt|jti}|tur8|jd|vr%||jdj!||St"|A||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+) _parse_datarr"TransactionPartnerAffiliateProgramrTransactionPartnerFragmentrTransactionPartnerUserrTransactionPartnerTelegramAdsrTransactionPartnerTelegramApirTransactionPartnerOthergetpopde_jsonr )clsr*r+_class_mappingr's r(r7zTransactionPartner.de_jsonYst$ % %dt|  ! !#E LL4 HH,   ;   ; II. ?  $ $&)9^)K!$((6"23;;3;O OwDc22r)N)__name__ __module__ __qualname____doc__ __slots__rr#rrstr__annotations__rrrrrrrr! classmethodr7 __classcell__r's@r(rr)s",I$-$D$D$V$VuSzV%;;DDHeCjDE!88>>E5:>B(??LLL%*LI(??LLL%*LI 77<B3H%3,4UO3 & '33r)rc eZdZdZdZ ddddededdeed dffd Ze dd eed ed d edffd Z xZ S)r/a\Describes the affiliate program that issued the affiliate commission received via this transaction. This object is comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`commission_per_mille` are equal. .. versionadded:: 21.9 Args: sponsor_user (:class:`telegram.User`, optional): Information about the bot that sponsored the affiliate program commission_per_mille (:obj:`int`): The number of Telegram Stars received by the bot for each 1000 Telegram Stars received by the affiliate program sponsor from referred users. Attributes: type (:obj:`str`): The type of the transaction partner, always :tg-const:`telegram.TransactionPartner.AFFILIATE_PROGRAM`. sponsor_user (:class:`telegram.User`): Optional. Information about the bot that sponsored the affiliate program commission_per_mille (:obj:`int`): The number of Telegram Stars received by the bot for each 1000 Telegram Stars received by the affiliate program sponsor from referred users. )commission_per_mille sponsor_userNrrFrGr rrct|tj||j 5||_||_|j|j f|_dddy#1swYyxYwN)rr) r r!rr _unfrozenrGrFrr$)r&rFrGrr's r(r!z+TransactionPartnerAffiliateProgram.__init__s] 0BBzZ ^^ 0r?intrrr!rBr7rCrDs@r(r/r/|s.9I *. *. !v& X&   ">B 3H% 3,4UO 3 6 7 3 3r)r/c eZdZdZdZ ddddeddeeddffd Ze dd eed ed dedffd Z xZ S)r0aDescribes 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_stateNrrPrrrct|tj||j 5||_dddy#1swYyxYwrI)r r!rrrJrP)r&rPrr's r(r!z#TransactionPartnerFragment.__init__s< 099jQ ^^ FVD !  s AA r*r+rc|j|}|ytj|jd||d<t| ||S)rLNrPr-)r.rr7r5r rMs r(r7z"TransactionPartnerFragment.de_jsonsU t$ <#9#A#A HH' (#$   wDc22r)r:) r;r<r=r>r?rrr!rBr7rCrDs@r(r0r0s &I@D W*. W"#;< WX& W  W>B 3H% 3,4UO 3 . / 3 3r)r0ceZdZdZdZ ddddddeedeeed eed ee jd ee d ee d ee ddffdZe ddee deddedffd ZxZS)r1aDescribes 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. affiliate (:class:`telegram.AffiliateInfo`, optional): Information about the affiliate that received a commission via this transaction .. versionadded:: 21.9 invoice_payload (:obj:`str`, optional): Bot-specified invoice payload. subscription_period (:class:`datetime.timedelta`, optional): The duration of the paid subscription .. versionadded:: 21.8 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): Bot-specified paid media payload. .. versionadded:: 21.6 gift (:class:`telegram.Gift`, optional): The gift sent to the user by the bot .. versionadded:: 21.8 Attributes: type (:obj:`str`): The type of the transaction partner, always :tg-const:`telegram.TransactionPartner.USER`. user (:class:`telegram.User`): Information about the user. affiliate (:class:`telegram.AffiliateInfo`): Optional. Information about the affiliate that received a commission via this transaction .. versionadded:: 21.9 invoice_payload (:obj:`str`): Optional. Bot-specified invoice payload. subscription_period (:class:`datetime.timedelta`): Optional. The duration of the paid subscription .. versionadded:: 21.8 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. Bot-specified paid media payload. .. versionadded:: 21.6 gift (:class:`telegram.Gift`): Optional. The gift sent to the user by the bot .. versionadded:: 21.8 ) affiliategiftinvoice_payload paid_mediapaid_media_payloadsubscription_perioduserNrrZr rVrWrXrYrUrTrrc<t |tj||j 5||_||_||_t||_ ||_ ||_ ||_ |j|j f|_dddy#1swYyxYwrI)r r!rrrJrZrTrVr rWrXrYrUrr$) r&rZrVrWrXrYrUrTrr's r(r!zTransactionPartnerUser.__init__&s 055*M ^^ "DI6?DN2AD ?QR\?]DO5GD #@SD $(,DI  DN  s ABBr*r+rc|j|}|sytj|jd||d<t j|jd||d<t j |jd||d<|jdx}tj|nd|d<tj|jd||d<t| || S) rLNrZrTrW)r+rY)secondsrUr-) r.r r7r5rr de_listdtm timedeltarr )r8r*r+spr's r(r7zTransactionPartnerUser.de_jsonBs t$||DHHV$4c:V )11$((;2GM[&..txx /E3O\hh455B MM" % "# ||DHHV$4c:V wDc22r))NNNNNNr:)r;r<r=r>r?rr@rr r_r`rrrr!rBr7rCrDs@r(r1r1s5nI*.48,07;#-1*."#Xi01  %SM  &cmm4 tnM*X& 8>B3H%3,4UO3 * +33r)r1c<eZdZdZdZdddeeddffdZxZS)r4zDescribes 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`. Nrrrcdt|tj||j yrI)r r!rrr%r&rr's r(r!z TransactionPartnerOther.__init__es% 066:N r) r;r<r=r>r?rrr!rCrDs@r(r4r4Y/I;?hx&8Dr)r4c<eZdZdZdZdddeeddffdZxZS)r2zDescribes 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`. rcNrrrcdt|tj||j yrI)r r!rrr%res r(r!z&TransactionPartnerTelegramAds.__init__vs% 0==*U r)rfrDs@r(r2r2jrgr)r2c@eZdZdZdZdddedeeddffdZxZ S) r3aDescribes 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_countNrrkrrct|tj||j 5||_|j f|_dddy#1swYyxYwrI)r r!rrrJrkr$)r&rkrr's r(r!z&TransactionPartnerTelegramApi.__init__sJ 0==*U ^^ &3D "002DN  s AA) r;r<r=r>r?rNrrr!rCrDs@r(r3r3{s7&#IOS3c3(8:L3X\33r)r3)%r>datetimer_collections.abcrtypingrrrtelegramrtelegram._giftsrtelegram._paidmediar telegram._telegramobjectr telegram._userr telegram._utilsr telegram._utils.argumentparsingr telegram._utils.typesr affiliateinforrevenuewithdrawalstaterrrr/r0r1r4r2r3rcr)r(rzs(P$11 )3 >*(:P3P3f73);73t+3!3+3\r3/r3j0"$6"3$63r)