o Zzj e@sdZddlZddlmZddlmZmZddlm Z ddl m Z ddl m Z ddlmZdd lmZdd lmZmZdd lmZmZdd lmZerPdd lmZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZ GdddeZ!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)BotcsTeZdZdZdZdddedededeed ed eed edBffd d Z Z 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_kwargsrrrrrrrcsdtj|d||_||_||_t||_||_t||_|j|j|j|j|j|jf|_ | dSNr) super__init__rrrr rrr _id_attrs_freeze)selfrrrrrrr __class__O/var/www/kodo/tsheker/venv/lib/python3.10/site-packages/telegram/_uniquegift.pyrPs"   zUniqueGiftColors.__init__) __name__ __module__ __qualname____doc__ __slots__strintrrr __classcell__r!r!rr"r's& rc sleZdZdZdZ ddddededededBd edBf fd d Z e dd ed dddffdd Z Z 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_millestickerNrr,r/r.r-rcsPtj|d||_||_||_ttj|||_ |j|j|jf|_ | dSr) rrr,r/r.r get_memberrUniqueGiftModelRarityr-rr)rr,r/r.r-rrr!r"rs  zUniqueGiftModel.__init__databot Bot | Nonereturnc0||}t|dt||d<tj||dS,See :meth:`telegram.TelegramObject.de_json`.r/r2r3 _parse_datar getrrde_jsonclsr2r3rr!r"r= zUniqueGiftModel.de_jsonN r#r$r%r&r'r(rr)rr classmethodr=r*r!r!rr"r+qs&" &r+c `eZdZdZdZdddededededBffd d Z e dd ed d ddffdd Z Z 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. )r,r.r/Nrr,r/r.rc>tj|d||_||_||_|j|j|jf|_|dSr)rrr,r/r.rr)rr,r/r.rrr!r"r  zUniqueGiftSymbol.__init__r2r3r4r5cr6r7r:r>rr!r"r=r@zUniqueGiftSymbol.de_jsonrArBr!r!rr"rE &rEc sDeZdZdZdZdddedededed edBf fd d ZZS) 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_colorNrrJrKrLrMrcsHtj|d||_||_||_||_|j|j|j|jf|_|dSr)rrrJrKrLrMrr)rrJrKrLrMrrr!r"rs  z!UniqueGiftBackdropColors.__init__) r#r$r%r&r'r)rrr*r!r!rr"rIsrIc rD)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. )colorsr,r.Nrr,rOr.rcrFr)rrr,rOr.rr)rr,rOr.rrr!r"r?rGzUniqueGiftBackdrop.__init__r2r3r4r5cr6)r8rOr9)r;r r<rIrr=r>rr!r"r=Pr@zUniqueGiftBackdrop.de_jsonrA) r#r$r%r&r'r(rIr)rrrCr=r*r!r!rr"rN#rHrNcseZdZdZdZ     ddddedededed ed ed e d e dBd e dBde dBde dBde dBde dBffddZedde ddddffdd ZZS) 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_namerOgift_id is_burnedis_from_blockchain is_premiummodelr,numberpublisher_chatsymbolNrrSrRr,rXrWrZrQrYrUrVrOrTrc stj| d||_||_||_||_||_||_||_||_ | |_ | |_ | |_ | |_ |j|j|j|j|j|jf|_|dSr)rrrSrRr,rXrWrZrQrYrUrVrOrTrr)rrSrRr,rXrWrZrQrYrUrVrOrTrrr!r"rs* zUniqueGift.__init__r2r3r4r5cs||}t|dt||d<t|dt||d<t|dt||d<t|dt||d<t|dt||d<tj ||dS)r8rWrZrQrYrOr9) r;r r<r+rErNrrrr=r>rr!r"r=s zUniqueGift.de_jsonNNNNNrA)r#r$r%r&r'r(r)r+rErNrboolrrrrCr=r*r!r!rr"rPZsNR     *&rPcseZdZUdZejjZeee d< ejj Z eee d< ejj Z eee d< ejj Z eee d< ejj Z eee d< dZ     ddd d ed ed edBd edBdejdBdedBdedBdedBffddZeddeddddffdd ZZS)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_countNrrcrgrhrirfrerdrc s^tj|d||_ttj|||_||_||_ ||_ ||_ ||_ |j|jf|_ |dSr)rrrcr r0rUniqueGiftInfoOriginrgrhrirfrerdrr) rrcrgrhrirfrerdrrr!r"r\s  zUniqueGiftInfo.__init__r2r3r4r5csN||}t|}t|dt||d<t|d|d|d<tj||dS)r8rcrf)tzinfor9)r;r r r<rPr rr=)r?r2r3 loc_tzinforr!r"r=ws   zUniqueGiftInfo.de_jsonr[rA)r#r$r%r&rrjr^rr(__annotations__r_r`rarbr'rPr)dtmdatetimerrrCr=r*r!r!rr"r]sN I  &r])"r&rorncollections.abcrtypingrrtelegramrtelegram._chatrtelegram._files.stickerrtelegram._telegramobjectrtelegram._utilsr telegram._utils.argumentparsingr r telegram._utils.datetimer r telegram._utils.typesrrrr+rErIrNrPr]r!r!r!r"s,        JI727