iffdZddlZddlmZddlmZmZddlm Z ddl m Z ddl m Z ddlmZdd lmZdd lmZmZdd lmZmZdd lmZdd lmZddlmZmZddlm Z erddlm!Z!GddeZ"GddeZ#GddeZ$GddeZ%GddeZ&GddeZ'GddeZ(y)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)Botc\eZdZdZdZdddedededeed 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_kwargsrrrrrrrcPt||||_||_||_t ||_||_t ||_|j|j|j|j |j|jf|_ |jyNr) super__init__rrrr rrr _id_attrs_freeze) selfrrrrrrr __class__s K/var/www/telegram/venv/lib/python3.12/site-packages/telegram/_uniquegift.pyr"zUniqueGiftColors.__init__Vs J/*?"+A#+A#9K $: %+@"8JKb8c$  & &  ' '  ' '  ) )  & &  ( (   ) __name__ __module__ __qualname____doc__ __slots__strintrrr" __classcell__r&s@r'rr-sn>I$'+"!$!$  #+3-  # "*#tOr(rc heZdZdZdZdddededededzffd 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|_|j yr r!r"r5r7r6r#r$r%r5r7r6rr&s r'r"zUniqueGiftModel.__init__P J/ ' %5))T\\43H3HI r(databot Bot | Nonereturnc|j|}t|jdt||d<t|||S,See :meth:`telegram.TelegramObject.de_json`.r7r<r= _parse_datar getrr!de_jsonclsr<r=r&s r'rGzUniqueGiftModel.de_jsonAt$*488I+>MYwDc22r(N r)r*r+r,r-r.rr/rr" classmethodrGr0r1s@r'r3r3wsm*I'+   tO "383,3BS33r(r3c heZdZdZdZdddededededzffd 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|_|j yr r9r:s r'r"zUniqueGiftSymbol.__init__r;r(r<r=r>r?c|j|}t|jdt||d<t|||SrArDrHs r'rGzUniqueGiftSymbol.de_jsonrJr(rKrLr1s@r'rOrOsm*I'+   tO "383,3BT33r(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|j f|_|jyr )r!r"rTrUrVrWr#r$)r%rTrUrVrWrr&s r'r"z!UniqueGiftBackdropColors.__init__sc J/!-)!-)++T__d>O>OQUQ`Q`a r() r)r*r+r,r-r/rr"r0r1s@r'rSrSsR,I'+   tOr(rSc heZdZdZdZdddededededzffd 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|_|j yr )r!r"r5r[r6r#r$)r%r5r[r6rr&s r'r"zUniqueGiftBackdrop.__init__3sP J/ 06 %5))T[[$2G2GH r(r<r=r>r?c|j|}t|jdt||d<t|||S)rBr[rC)rEr rFrSr!rGrHs r'rGzUniqueGiftBackdrop.de_jsonDsCt$)$((8*<>VX[\XwDc22r(rK) r)r*r+r,r-r.rSr/rr"rMrGr0r1s@r'rZrZsm*I'+ )  tO "383,3BV33r(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|jf|_|jy)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& ?PQ Q J/# ' ! &+ (. ,4 +9/A'1/5  NN II KK JJ KK MM   r(r<r=r>r?c|j|}t|jdt||d<t|jdt||d<t|jdt ||d<t|jdt ||d<t|jdt||d<t|%||S)rBrerhr`rgr[rC) rEr rFr3rOrZrrr!rGrHs r'rGzUniqueGift.de_jsonst$('):OSQW )$((8*<>NPSTX+DHHZ,@BTVYZZ!1$((;K2LdTW!X )$((8*<>NPSTXwDc22r()NNNNNrK)r)r*r+r,r-r.r/r3rOrZrboolrrr"rMrGr0r1s@r'r_r_NsFP I,'+#*."&*., '+!,,, ,  , ! ,%,t ,t,!4K,4K,!4', tO!,\ 38 3, 3, 3 3r(r_ceZdZUdZej j Zeee d< ej jZ eee d< ej jZ eee d< ej jZ eee d< ej jZ eee d< dZ ddd d ed ed edzd edzdedzdej$dzdedzdedzdedzffdZededzfdZeddeddddffd 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  |%ttdtddddd t || ||_t jtj|||_ ||_ ||_ ||_ ||_||_||_|j |jf|_|j%y) 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+I+I6SYZ )6/B 3I$7I0D!.@))T[[1 r(r?c8tdddd|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{s& /!97!  +++r(r<r=r>c|j|}t|}t|jdt||d<t |jd||d<t |||S)rBrurx)tzinforC)rEr r rFr_rr!rG)rIr<r= loc_tzinfor&s r'rGzUniqueGiftInfo.de_jsonslt$1#6 '(8*cJV %3 HH) *:&  !"wDc22r()NNNNNNrK)r)r*r+r,rrrorr.__annotations__rprqrrrsr-r_r/dtmdatetimerr"propertyr|rMrGr0r1s@r'rnrnsKZ"+!?!?!N!NNE#JN"66<>FE#J>%99BBHeCjBC#88@@GU3Z@B I%)*.-126+/)-*'+***Tz * !4Z *!$d * LL4/*"Dj* $J*tO*Z,d ,," 38 3, 3BR 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(;$'+3 PQ*)4G~GT43n43n43~43n/~/d4343nP3P3fw3^w3r(