ifdZddlZddlmZddlmZmZddlm Z ddl m Z ddl m Z ddlmZdd lmZdd lmZmZdd lmZmZdd lmZdd lmZddlmZmZddlm Z erddlm!Z!GddeZ"GddeZ#GddeZ$GddeZ%GddeZ&GddeZ'GddeZ(dS)z4This module contains classes related to unique gifs.N)Sequence) TYPE_CHECKINGFinal) constants)Chat)Sticker)TelegramObject)enum)de_json_optionalparse_sequence_arg)extract_tzinfo_from_defaultsfrom_timestamp)JSONDict)warn)!build_deprecation_warning_message&warn_about_deprecated_attr_in_property)PTBDeprecationWarning)BotcheZdZdZdZdddedededeed ed eed edzffd Z xZ S) UniqueGiftColorsa4This object contains information about the color scheme for a user's name, message replies and link previews based on a unique gift. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal if their :attr:`model_custom_emoji_id`, :attr:`symbol_custom_emoji_id`, :attr:`light_theme_main_color`, :attr:`light_theme_other_colors`, :attr:`dark_theme_main_color`, and :attr:`dark_theme_other_colors` are equal. .. versionadded:: 22.6 Args: model_custom_emoji_id (:obj:`str`): Custom emoji identifier of the unique gift's model. symbol_custom_emoji_id (:obj:`str`): Custom emoji identifier of the unique gift's symbol. light_theme_main_color (:obj:`int`): Main color used in light themes; RGB format. light_theme_other_colors (Sequence[:obj:`int`]): List of 1-3 additional colors used in light themes; RGB format. |sequenceclassargs| dark_theme_main_color (:obj:`int`): Main color used in dark themes; RGB format. dark_theme_other_colors (Sequence[:obj:`int`]): List of 1-3 additional colors used in dark themes; RGB format. |sequenceclassargs| Attributes: model_custom_emoji_id (:obj:`str`): Custom emoji identifier of the unique gift's model. symbol_custom_emoji_id (:obj:`str`): Custom emoji identifier of the unique gift's symbol. light_theme_main_color (:obj:`int`): Main color used in light themes; RGB format. light_theme_other_colors (Tuple[:obj:`int`]): Tuple of 1-3 additional colors used in light themes; RGB format. dark_theme_main_color (:obj:`int`): Main color used in dark themes; RGB format. dark_theme_other_colors (Tuple[:obj:`int`]): Tuple of 1-3 additional colors used in dark themes; RGB format. )dark_theme_main_colordark_theme_other_colorslight_theme_main_colorlight_theme_other_colorsmodel_custom_emoji_idsymbol_custom_emoji_idN api_kwargsrrrrrrrcRt|||_||_||_t ||_||_t ||_|j|j|j|j|j|jf|_ | dSNr) super__init__rrrr rrr _id_attrs_freeze) selfrrrrrrr __class__s T/Users/shanyulin/my-agent/.venv/lib/python3.11/site-packages/telegram/_uniquegift.pyr"zUniqueGiftColors.__init__Vs J///*?"+A#+A#9K $: : %+@"8JKb8c8c$  &  '  '  )  &  (   ) __name__ __module__ __qualname____doc__ __slots__strintrrr" __classcell__r&s@r'rr-s>I$'+"!$!$  #+3-  # "*#tOr(rc neZdZdZdZdddededededzffd Z e dd ed d d dffd Z xZ S)UniqueGiftModelaSThis object describes the model of a unique gift. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal if their :attr:`name`, :attr:`sticker` and :attr:`rarity_per_mille` are equal. .. versionadded:: 22.1 Args: name (:obj:`str`): Name of the model. sticker (:class:`telegram.Sticker`): The sticker that represents the unique gift. rarity_per_mille (:obj:`int`): The number of unique gifts that receive this model for every ``1000`` gifts upgraded. Attributes: name (:obj:`str`): Name of the model. sticker (:class:`telegram.Sticker`): The sticker that represents the unique gift. rarity_per_mille (:obj:`int`): The number of unique gifts that receive this model for every ``1000`` gifts upgraded. namerarity_per_millestickerNrr5r7r6rct|||_||_||_|j|j|jf|_|dSr r!r"r5r7r6r#r$r%r5r7r6rr&s r'r"zUniqueGiftModel.__init__\ J/// ' %5)T\43HI r(databot Bot | Nonereturnc||}t|dt||d<t ||S,See :meth:`telegram.TelegramObject.de_json`.r7r<r= _parse_datar getrr!de_jsonclsr<r=r&s r'rGzUniqueGiftModel.de_jsonQt$$*488I+>+>MMYwwDc222r(N r)r*r+r,r-r.rr/rr" classmethodrGr0r1s@r'r3r3ws*I'+   tO "3383,3BS33333[33333r(r3c neZdZdZdZdddededededzffd Z e dd ed d d dffd Z xZ S)UniqueGiftSymbolakThis object describes the symbol shown on the pattern of a unique gift. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal if their :attr:`name`, :attr:`sticker` and :attr:`rarity_per_mille` are equal. .. versionadded:: 22.1 Args: name (:obj:`str`): Name of the symbol. sticker (:class:`telegram.Sticker`): The sticker that represents the unique gift. rarity_per_mille (:obj:`int`): The number of unique gifts that receive this model for every ``1000`` gifts upgraded. Attributes: name (:obj:`str`): Name of the symbol. sticker (:class:`telegram.Sticker`): The sticker that represents the unique gift. rarity_per_mille (:obj:`int`): The number of unique gifts that receive this model for every ``1000`` gifts upgraded. r4Nrr5r7r6rct|||_||_||_|j|j|jf|_|dSr r9r:s r'r"zUniqueGiftSymbol.__init__r;r(r<r=r>r?c||}t|dt||d<t ||SrArDrHs r'rGzUniqueGiftSymbol.de_jsonrJr(rKrLr1s@r'rOrOs*I'+   tO "3383,3BT33333[33333r(rOc HeZdZdZdZdddedededed edzf fd ZxZS) UniqueGiftBackdropColorsa"This object describes the colors of the backdrop of a unique gift. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal if their :attr:`center_color`, :attr:`edge_color`, :attr:`symbol_color`, and :attr:`text_color` are equal. .. versionadded:: 22.1 Args: center_color (:obj:`int`): The color in the center of the backdrop in RGB format. edge_color (:obj:`int`): The color on the edges of the backdrop in RGB format. symbol_color (:obj:`int`): The color to be applied to the symbol in RGB format. text_color (:obj:`int`): The color for the text on the backdrop in RGB format. Attributes: center_color (:obj:`int`): The color in the center of the backdrop in RGB format. edge_color (:obj:`int`): The color on the edges of the backdrop in RGB format. symbol_color (:obj:`int`): The color to be applied to the symbol in RGB format. text_color (:obj:`int`): The color for the text on the backdrop in RGB format. ) center_color edge_color symbol_color text_colorNrrTrUrVrWrct|||_||_||_||_|j|j|j|jf|_|dSr )r!r"rTrUrVrWr#r$)r%rTrUrVrWrr&s r'r"z!UniqueGiftBackdropColors.__init__sk J///!-)!-)+T_d>OQUQ`a r() r)r*r+r,r-r/rr"r0r1s@r'rSrSs,I'+   tOr(rSc neZdZdZdZdddededededzffd Z e dd ed d d dffd Z xZ S)UniqueGiftBackdropaXThis object describes the backdrop of a unique gift. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal if their :attr:`name`, :attr:`colors`, and :attr:`rarity_per_mille` are equal. .. versionadded:: 22.1 Args: name (:obj:`str`): Name of the backdrop. colors (:class:`telegram.UniqueGiftBackdropColors`): Colors of the backdrop. rarity_per_mille (:obj:`int`): The number of unique gifts that receive this backdrop for every ``1000`` gifts upgraded. Attributes: name (:obj:`str`): Name of the backdrop. colors (:class:`telegram.UniqueGiftBackdropColors`): Colors of the backdrop. rarity_per_mille (:obj:`int`): The number of unique gifts that receive this backdrop for every ``1000`` gifts upgraded. )colorsr5r6Nrr5r[r6rct|||_||_||_|j|j|jf|_|dSr )r!r"r5r[r6r#r$)r%r5r[r6rr&s r'r"zUniqueGiftBackdrop.__init__3s\ J/// 06 %5)T[$2GH r(r<r=r>r?c||}t|dt||d<t ||S)rBr[rC)rEr rFrSr!rGrHs r'rGzUniqueGiftBackdrop.de_jsonDsSt$$)$((8*<*<>VX[\\XwwDc222r(rK) r)r*r+r,r-r.rSr/rr"rMrGr0r1s@r'rZrZs*I'+ )  tO "3383,3BV33333[33333r(rZceZdZdZdZ ddddedededed ed e d e dzd edzd e dzde dzde dzde dzffdZedde ddddffd ZxZS) UniqueGifta This object describes a unique gift that was upgraded from a regular gift. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal if their :attr:`base_name`, :attr:`name`, :attr:`number`, :class:`model`, :attr:`symbol`, and :attr:`backdrop` are equal. .. versionadded:: 22.1 Args: gift_id (:obj:`str`): Identifier of the regular gift from which the gift was upgraded. .. versionadded:: 22.6 base_name (:obj:`str`): Human-readable name of the regular gift from which this unique gift was upgraded. name (:obj:`str`): Unique name of the gift. This name can be used in ``https://t.me/nft/...`` links and story areas. number (:obj:`int`): Unique number of the upgraded gift among gifts upgraded from the same regular gift. model (:class:`UniqueGiftModel`): Model of the gift. symbol (:class:`UniqueGiftSymbol`): Symbol of the gift. backdrop (:class:`UniqueGiftBackdrop`): Backdrop of the gift. publisher_chat (:class:`telegram.Chat`, optional): Information about the chat that published the gift. .. versionadded:: 22.4 is_premium (:obj:`bool`, optional): :obj:`True`, if the original regular gift was exclusively purchaseable by Telegram Premium subscribers. .. versionadded:: 22.6 is_from_blockchain (:obj:`bool`, optional): :obj:`True`, if the gift is assigned from the TON blockchain and can't be resold or transferred in Telegram. .. versionadded:: 22.6 colors (:class:`telegram.UniqueGiftColors`, optional): The color scheme that can be used by the gift's owner for the chat's name, replies to messages and link previews; for business account gifts and gifts that are currently on sale only. .. versionadded:: 22.6 Attributes: gift_id (:obj:`str`): Identifier of the regular gift from which the gift was upgraded. .. versionadded:: 22.6 base_name (:obj:`str`): Human-readable name of the regular gift from which this unique gift was upgraded. name (:obj:`str`): Unique name of the gift. This name can be used in ``https://t.me/nft/...`` links and story areas. number (:obj:`int`): Unique number of the upgraded gift among gifts upgraded from the same regular gift. model (:class:`telegram.UniqueGiftModel`): Model of the gift. symbol (:class:`telegram.UniqueGiftSymbol`): Symbol of the gift. backdrop (:class:`telegram.UniqueGiftBackdrop`): Backdrop of the gift. publisher_chat (:class:`telegram.Chat`): Optional. Information about the chat that published the gift. .. versionadded:: 22.4 is_premium (:obj:`bool`): Optional. :obj:`True`, if the original regular gift was exclusively purchaseable by Telegram Premium subscribers. .. versionadded:: 22.6 is_from_blockchain (:obj:`bool`): Optional. :obj:`True`, if the gift is assigned from the TON blockchain and can't be resold or transferred in Telegram. .. versionadded:: 22.6 colors (:class:`telegram.UniqueGiftColors`): Optional. The color scheme that can be used by the gift's owner for the chat's name, replies to messages and link previews; for business account gifts and gifts that are currently on sale only. .. versionadded:: 22.6 ) backdrop base_namer[gift_idis_from_blockchain is_premiummodelr5numberpublisher_chatsymbolNrrar5rfrerhr`rgrbrcrdr[rc |tdt| ||_||_||_||_||_||_||_ ||_ | |_ | |_ | |_ |j|j|j|j|j|j f|_|dS)Nz2`gift_id` is a required argument since Bot API 9.3r) TypeErrorr!r"rbrar5rfrerhr`rgrcrdr[r#r$)r%rar5rfrerhr`rgrbrcrdr[rr&s r'r"zUniqueGift.__init__s& ?PQQ Q J///# ' ! &+ (. ,4 +9/A'1/5  N I K J K M   r(r<r=r>r?c,||}t|dt||d<t|dt||d<t|dt ||d<t|dt ||d<t|dt||d<t ||S)rBrerhr`rgr[rC) rEr rFr3rOrZrrr!rGrHs r'rGzUniqueGift.de_jsonst$$('):):OSQQW )$((8*<*<>NPSTTX+DHHZ,@,@BTVYZZZ!1$((;K2L2LdTW!X!X )$((8*<*<>NPSTTXwwDc222r()NNNNNrK)r)r*r+r,r-r.r/r3rOrZrboolrrr"rMrGr0r1s@r'r_r_NsLFFP I,'+#*."&*., '+!,,,,, ,  , ! ,%,t ,t,!4K,4K,!4', tO!,,,,,,\ 3 38 3, 3, 3 3 3 3 3[ 3 3 3 3 3r(r_ceZdZUdZejjZeee d< ejj Z eee d< ejj Z eee d< ejj Z eee d< ejj Z eee d< dZ ddd d ed ed edzd edzdedzdejdzdedzdedzdedzffdZededzfdZeddeddddffd ZxZS)UniqueGiftInfoasDescribes a service message about a unique gift that was sent or received. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal if their :attr:`gift`, and :attr:`origin` are equal. .. versionadded:: 22.1 Args: gift (:class:`UniqueGift`): Information about the gift. origin (:obj:`str`): Origin of the gift. Currently, either :attr:`UPGRADE` for gifts upgraded from regular gifts, :attr:`TRANSFER` for gifts transferred from other users or channels, :attr:`RESALE` for gifts bought from other users, :attr:`GIFTED_UPGRADE` for upgrades purchased after the gift was sent, or :attr:`OFFER` for gifts bought or sold through gift purchase offers .. versionchanged:: 22.3 The :attr:`RESALE` origin was added. .. versionchanged:: 22.6 Bot API 9.3 added the :attr:`GIFTED_UPGRADE` and :attr:`OFFER` origins. owned_gift_id (:obj:`str`, optional) Unique identifier of the received gift for the bot; only present for gifts received on behalf of business accounts. transfer_star_count (:obj:`int`, optional): Number of Telegram Stars that must be paid to transfer the gift; omitted if the bot cannot transfer the gift. last_resale_star_count (:obj:`int`, optional): For gifts bought from other users, the price paid for the gift. .. versionadded:: 22.3 .. deprecated:: 22.6 Bot API 9.3 deprecated this field. Use :attr:`last_resale_currency` and :attr:`last_resale_amount` instead. last_resale_currency (:obj:`str`, optional): For gifts bought from other users, the currency in which the payment for the gift was done. Currently, one of ``XTR`` for Telegram Stars or ``TON`` for toncoins. .. versionadded:: 22.6 last_resale_amount (:obj:`int`, optional): For gifts bought from other users, the price paid for the gift in either Telegram Stars or nanotoncoins. .. versionadded:: 22.6 next_transfer_date (:obj:`datetime.datetime`, optional): Date when the gift can be transferred. If it's in the past, then the gift can be transferred now. |datetime_localization| .. versionadded:: 22.3 Attributes: gift (:class:`UniqueGift`): Information about the gift. origin (:obj:`str`): Origin of the gift. Currently, either :attr:`UPGRADE` for gifts upgraded from regular gifts, :attr:`TRANSFER` for gifts transferred from other users or channels, :attr:`RESALE` for gifts bought from other users, :attr:`GIFTED_UPGRADE` for upgrades purchased after the gift was sent, or :attr:`OFFER` for gifts bought or sold through gift purchase offers .. versionchanged:: 22.3 The :attr:`RESALE` origin was added. .. versionchanged:: 22.6 Bot API 9.3 added the :attr:`GIFTED_UPGRADE` and :attr:`OFFER` origins. owned_gift_id (:obj:`str`) Optional. Unique identifier of the received gift for the bot; only present for gifts received on behalf of business accounts. transfer_star_count (:obj:`int`): Optional. Number of Telegram Stars that must be paid to transfer the gift; omitted if the bot cannot transfer the gift. last_resale_currency (:obj:`str`): Optional. For gifts bought from other users, the currency in which the payment for the gift was done. Currently, one of ``XTR`` for Telegram Stars or ``TON`` for toncoins. .. versionadded:: 22.6 last_resale_amount (:obj:`int`): Optional. For gifts bought from other users, the price paid for the gift in either Telegram Stars or nanotoncoins. .. versionadded:: 22.6 next_transfer_date (:obj:`datetime.datetime`): Optional. Date when the gift can be transferred. If it's in the past, then the gift can be transferred now. |datetime_localization| .. versionadded:: 22.3 GIFTED_UPGRADEOFFERRESALETRANSFERUPGRADE)_last_resale_star_countgiftlast_resale_amountlast_resale_currencynext_transfer_dateorigin owned_gift_idtransfer_star_countNrruryrzr{last_resale_star_countrxrwrvrc  |1ttdtddddd t| ||_t jtj |||_ ||_ ||_ ||_ ||_||_||_|j|j f|_|dS) N22.6r|last_resale_currency/amount9.3 parameter)deprecated_namenew_namebot_api_version object_type)versionmessage) stacklevelr)rrrr!r"rur get_memberrUniqueGiftInfoOriginryrzr{rtrxrwrvr#r$) r%ruryrzr{r|rxrwrvrr&s r'r"zUniqueGiftInfo.__init__Ns " - %"=(@!>(-$/      J/// $ ?9+I6SYZZ )6/B 3I$7I0D!.@)T[1 r(r?c6tdddd|jS)a':obj:`int`: Optional. For gifts bought from other users, the price paid for the gift. .. versionadded:: 22.3 .. deprecated:: 22.6 Bot API 9.3 deprecated this field. Use :attr:`last_resale_currency` and :attr:`last_resale_amount` instead. r|rrr~)deprecated_attr_name new_attr_namer ptb_version)rrt)r%s r'r|z%UniqueGiftInfo.last_resale_star_count{s2 /!97!     ++r(r<r=r>c8||}t|}t|dt||d<t |d||d<t ||S)rBrurx)tzinforC)rEr r rFr_rr!rG)rIr<r= loc_tzinfor&s r'rGzUniqueGiftInfo.de_jsonst$$1#66 '(8(8*cJJV %3 HH) * *:& & &  !"wwDc222r()NNNNNNrK)r)r*r+r,rrrorr.__annotations__rprqrrrsr-r_r/dtmdatetimerr"propertyr|rMrGr0r1s@r'rnrnsKKZ"+!?!NNE#JNNN"6FE#J>>>%9BHeCjBBBC#8@GU3Z@@@B I%)*.-126+/)-*'+*****Tz * !4Z *!$d * L4/*"Dj* $J*tO******Z,d ,,,X," 3 38 3, 3BR 3 3 3 3 3[ 3 3 3 3 3r(rn))r,rrcollections.abcrtypingrrtelegramrtelegram._chatrtelegram._files.stickerrtelegram._telegramobjectr telegram._utilsr telegram._utils.argumentparsingr r telegram._utils.datetimer rtelegram._utils.typesrtelegram._utils.warningsr#telegram._utils.warnings_transitionrrtelegram.warningsrrrr3rOrSrZr_rnr(r'rs(;:$$$$$$''''''''++++++333333 PPPPPPPPQQQQQQQQ******))))))433333GGGGG~GGGT4343434343n434343n4343434343~434343n/////~///d4343434343434343nP3P3P3P3P3P3P3P3fw3w3w3w3w3^w3w3w3w3w3r(