ei ejdZddlZddlmZddlmZmZddlm Z ddl m Z ddl m Z ddlmZdd lmZdd lmZmZdd lmZmZdd lmZerdd lmZGddeZGddeZGddeZGddeZGddeZGddeZ 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)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 X/home/div/.hermes/hermes-agent/venv/lib/python3.11/site-packages/telegram/_uniquegift.pyrzUniqueGiftColors.__init__Ps J///*?"+A#+A#9K $: : %+@"8JKb8c8c$  &  '  '  )  &  (   ) __name__ __module__ __qualname____doc__ __slots__strintrrr __classcell__r"s@r#rr's>I$'+"!$!$  #+3-  # "*#tOr$rc |eZdZdZdZ ddddededededzd edzf fd Z e dd ed d ddffd Z xZ S)UniqueGiftModelaThis 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. Always ``0`` for crafted gifts. rarity (:obj:`str`, optional): Rarity of the model if it is a crafted model. Currently, can be :tg-const:`telegram.constants.UniqueGiftModelRarity.UNCOMMON`, :tg-const:`telegram.constants.UniqueGiftModelRarity.RARE`, :tg-const:`telegram.constants.UniqueGiftModelRarity.EPIC`, or :tg-const:`telegram.constants.UniqueGiftModelRarity.LEGENDARY`. .. versionadded:: 22.7 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. Always ``0`` for crafted gifts. rarity (:obj:`str`): Optional. Rarity of the model if it is a crafted model. Currently, can be :tg-const:`telegram.constants.UniqueGiftModelRarity.UNCOMMON`, :tg-const:`telegram.constants.UniqueGiftModelRarity.RARE`, :tg-const:`telegram.constants.UniqueGiftModelRarity.EPIC`, or :tg-const:`telegram.constants.UniqueGiftModelRarity.LEGENDARY`. .. versionadded:: 22.7 )namerarityrarity_per_millestickerNrr0r3r2r1rct|||_||_||_t jtj|||_ |j|j|jf|_ | dSr) rrr0r3r2r get_memberrUniqueGiftModelRarityr1rr )r!r0r3r2r1rr"s r#rzUniqueGiftModel.__init__sv J/// ' %5"&/)2QSY[a"b"b )T\43HI r$databot Bot | Nonereturnc||}t|dt||d<t ||S,See :meth:`telegram.TelegramObject.de_json`.r3r7r8 _parse_datar getrrde_jsonclsr7r8r"s r#rBzUniqueGiftModel.de_jsonQt$$*488I+>+>MMYwwDc222r$N r%r&r'r(r)r*rr+rr classmethodrBr,r-s@r#r/r/qs  DI" '+  d tO*3383,3BS33333[33333r$r/c 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. )r0r2r3Nrr0r3r2rct|||_||_||_|j|j|jf|_|dSr)rrr0r3r2rr )r!r0r3r2rr"s r#rzUniqueGiftSymbol.__init__s\ J/// ' %5)T\43HI r$r7r8r9r:c||}t|dt||d<t ||Sr<r?rCs r#rBzUniqueGiftSymbol.de_jsonrEr$rFrGr-s@r#rJrJs*I'+   tO "3383,3BT33333[33333r$rJc 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_colorNrrOrPrQrRrct|||_||_||_||_|j|j|j|jf|_|dSr)rrrOrPrQrRrr )r!rOrPrQrRrr"s r#rz!UniqueGiftBackdropColors.__init__sk J///!-)!-)+T_d>OQUQ`a r$) r%r&r'r(r)r+rrr,r-s@r#rNrNs,I'+   tOr$rNc 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. )colorsr0r2Nrr0rVr2rct|||_||_||_|j|j|jf|_|dSr)rrr0rVr2rr )r!r0rVr2rr"s r#rzUniqueGiftBackdrop.__init__?s\ J/// 06 %5)T[$2GH r$r7r8r9r:c||}t|dt||d<t ||S)r=rVr>)r@r rArNrrBrCs r#rBzUniqueGiftBackdrop.de_jsonPsSt$$)$((8*<*<>VX[\\XwwDc222r$rF) r%r&r'r(r)r*rNr+rrrHrBr,r-s@r#rUrU#s*I'+ )  tO "3383,3BV33333[33333r$rUceZdZdZdZ ddddedededed ed ed e d e dzd e dzde dzde dzde dzde dzffdZedde ddddffd ZxZS) UniqueGiftaThis 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 .. versionchanged:: 22.7 :attr:`gift_id` is now a positional argument. 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 is_burned (:obj:`bool`, optional): :obj:`True`, if the gift was used to craft another gift and isn't available anymore. .. versionadded:: 22.7 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 is_burned (:obj:`bool`): Optional. :obj:`True`, if the gift was used to craft another gift and isn't available anymore. .. versionadded:: 22.7 ) backdrop base_namerVgift_id is_burnedis_from_blockchain is_premiummodelr0numberpublisher_chatsymbolNrr]r\r0rbrardr[rcr_r`rVr^rc rt| ||_||_||_||_||_||_||_||_ | |_ | |_ | |_ | |_ |j|j|j|j|j|jf|_|dSr)rrr]r\r0rbrardr[rcr_r`rVr^rr )r!r]r\r0rbrardr[rcr_r`rVr^rr"s r#rzUniqueGift.__init__s" J///# ' ! &+ (. ,4 +9/A'1/5 &/ N I K J K M   r$r7r8r9r:c,||}t|dt||d<t|dt||d<t|dt ||d<t|dt ||d<t|dt||d<t ||S)r=rardr[rcrVr>) r@r rAr/rJrUrrrrBrCs r#rBzUniqueGift.de_jsonst$$('):):OSQQW )$((8*<*<>NPSTTX+DHHZ,@,@BTVYZZZ!1$((;K2L2LdTW!X!X )$((8*<*<>NPSTTXwwDc222r$NNNNNrF)r%r&r'r(r)r*r+r/rJrUrboolrrrrHrBr,r-s@r#rZrZZsTPPd I0'+*."&*.!%('+((((( (  (  (!(%(t (!4K(4K(!4'($;(tO((((((T 3 38 3, 3, 3 3 3 3 3[ 3 3 3 3 3r$rZceZdZUdZejjZeee d< ejj Z eee d< ejj Z eee d< ejj Z eee d< ejj Z eee d< dZ ddd d ed ed edzd edzdejdzdedzdedzdedzffdZeddeddddffd ZxZS)UniqueGiftInfoaDescribes 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 .. versionremoved:: 22.7 Removed argument and attribute ``last_resale_star_count`` deprecated since Bot API 9.3. 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_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)giftlast_resale_amountlast_resale_currencynext_transfer_dateorigin owned_gift_idtransfer_star_countNrrprtrurvrsrrrqrc8t|||_tjt j|||_||_||_ ||_ ||_ ||_ |j|jf|_ |dSr)rrrpr r5rUniqueGiftInfoOriginrtrurvrsrrrqrr ) r!rprtrurvrsrrrqrr"s r#rzUniqueGiftInfo.__init__\s J/// $ ?9+I6SYZZ )6/B 7I0D!.@)T[1 r$r7r8r9r:c8||}t|}t|dt||d<t |d||d<t ||S)r=rprs)tzinfor>)r@r r rArZrrrB)rDr7r8 loc_tzinfor"s r#rBzUniqueGiftInfo.de_jsonwst$$1#66 '(8(8*cJJV %3 HH) * *:& & &  !"wwDc222r$rgrF)r%r&r'r(rrxrkrr*__annotations__rlrmrnror)rZr+dtmdatetimerrrHrBr,r-s@r#rjrjsGGR"+!?!NNE#JNNN"6FE#J>>>%9BHeCjBBBC#8@GU3Z@@@BI%)*.26+/)-'+Tz  !4Z   L4/ "Dj $JtO6 3 38 3, 3BR 3 3 3 3 3[ 3 3 3 3 3r$rj)"r(r~r}collections.abcrtypingrrtelegramrtelegram._chatrtelegram._files.stickerrtelegram._telegramobjectr telegram._utilsr telegram._utils.argumentparsingr r telegram._utils.datetimer rtelegram._utils.typesrrrr/rJrNrUrZrjr$r#rsQ(;:$$$$$$''''''''++++++333333 PPPPPPPPQQQQQQQQ******GGGGG~GGGTF3F3F3F3F3nF3F3F3R4343434343~434343n/////~///d4343434343434343nW3W3W3W3W3W3W3W3tN3N3N3N3N3^N3N3N3N3N3r$