iFQdZddlmZddlmZddlmZddlmZddl m Z ddl m Z ddl mZmZmZdd lmZmZdd lmZerdd lmZGd d e ZGdde ZGdde ZGdde ZGdde ZdS)z:This module contains classes related to gifs sent by bots.)Sequence) TYPE_CHECKING)Chat)Sticker) MessageEntity)TelegramObject)de_json_optionalde_list_optionalparse_sequence_arg)parse_message_entitiesparse_message_entity)JSONDict)Botc DeZdZdZdZdddededededzffd ZxZS) GiftBackgroundaThis object describes the background of a 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` and :attr:`text_color` are equal. .. versionadded:: 22.6 Args: center_color (:obj:`int`): Center color of the background in RGB format. edge_color (:obj:`int`): Edge color of the background in RGB format. text_color (:obj:`int`): Text color of the background in RGB format. Attributes: center_color (:obj:`int`): Center color of the background in RGB format. edge_color (:obj:`int`): Edge color of the background in RGB format. text_color (:obj:`int`): Text color of the background in RGB format. ) center_color edge_color text_colorN api_kwargsrrrrct|||_||_||_|j|j|jf|_|dSNr)super__init__rrr _id_attrs_freeze)selfrrrr __class__s O/Users/shanyulin/my-agent/.venv/lib/python3.11/site-packages/telegram/_gifts.pyrzGiftBackground.__init__@sd J///!-))   O O  ) __name__ __module__ __qualname____doc__ __slots__intrr __classcell__rs@rrr%s(I'+   tO r rceZdZdZdZ ddddededededzd edzd edzd edzd edzd edzde dzde dzde dzdedzde dzffdZ e dde ddddffd ZxZS)GiftakThis object represents a gift that can be sent by the bot. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal if their :attr:`id` is equal. .. versionadded:: 21.8 Args: id (:obj:`str`): Unique identifier of the gift. sticker (:class:`~telegram.Sticker`): The sticker that represents the gift. star_count (:obj:`int`): The number of Telegram Stars that must be paid to send the sticker. total_count (:obj:`int`, optional): The total number of the gifts of this type that can be sent by all users; for limited gifts only. remaining_count (:obj:`int`, optional): The number of remaining gifts of this type that can be sent by all users; for limited gifts only. upgrade_star_count (:obj:`int`, optional): The number of Telegram Stars that must be paid to upgrade the gift to a unique one. .. versionadded:: 21.10 publisher_chat (:class:`telegram.Chat`, optional): Information about the chat that published the gift. .. versionadded:: 22.4 personal_total_count (:obj:`int`, optional): The total number of gifts of this type that can be sent by the bot; for limited gifts only. .. versionadded:: 22.6 personal_remaining_count (:obj:`int`, optional): The number of remaining gifts of this type that can be sent by the bot; for limited gifts only. .. versionadded:: 22.6 background (:class:`GiftBackground`, optional): Background of the gift. .. versionadded:: 22.6 is_premium (:obj:`bool`, optional): :obj:`True`, if the gift can only be purchased by Telegram Premium subscribers. .. versionadded:: 22.6 has_colors (:obj:`bool`, optional): :obj:`True`, if the gift can be used (after being upgraded) to customize a user's appearance. .. versionadded:: 22.6 unique_gift_variant_count (:obj:`int`, optional): The total number of different unique gifts that can be obtained by upgrading the gift. .. versionadded:: 22.6 Attributes: id (:obj:`str`): Unique identifier of the gift. sticker (:class:`~telegram.Sticker`): The sticker that represents the gift. star_count (:obj:`int`): The number of Telegram Stars that must be paid to send the sticker. total_count (:obj:`int`): Optional. The total number of the gifts of this type that can be sent by all users; for limited gifts only. remaining_count (:obj:`int`): Optional. The number of remaining gifts of this type that can be sent by all users; for limited gifts only. upgrade_star_count (:obj:`int`): Optional. The number of Telegram Stars that must be paid to upgrade the gift to a unique one. .. versionadded:: 21.10 publisher_chat (:class:`telegram.Chat`): Optional. Information about the chat that published the gift. .. versionadded:: 22.4 personal_total_count (:obj:`int`): Optional. The total number of gifts of this type that can be sent by the bot; for limited gifts only. .. versionadded:: 22.6 personal_remaining_count (:obj:`int`): Optional. The number of remaining gifts of this type that can be sent by the bot; for limited gifts only. .. versionadded:: 22.6 background (:class:`GiftBackground`): Optional. Background of the gift. .. versionadded:: 22.6 is_premium (:obj:`bool`): Optional. :obj:`True`, if the gift can only be purchased by Telegram Premium subscribers. .. versionadded:: 22.6 has_colors (:obj:`bool`): Optional. :obj:`True`, if the gift can be used (after being upgraded) to customize a user's appearance. .. versionadded:: 22.6 unique_gift_variant_count (:obj:`int`): Optional. The total number of different unique gifts that can be obtained by upgrading the gift. .. versionadded:: 22.6 ) background has_colorsid is_premiumpersonal_remaining_countpersonal_total_countpublisher_chatremaining_count star_countsticker total_countunique_gift_variant_countupgrade_star_countNrr-r4r3r5r2r7r1r0r/r+r.r,r6rcDt|||_||_||_||_||_||_||_||_ | |_ | |_ | |_ | |_ | |_|jf|_|dSr)rrr-r4r3r5r2r7r1r0r/r+r.r,r6rr)rr-r4r3r5r2r7r1r0r/r+r.r,r6rrs rrz Gift.__init__s$ J/// ' )'2+:.@+90D!4L%1;'1'15N&' r databot Bot | Nonereturnc|||}t|dt||d<t|dt||d<t|dt ||d<t ||S),See :meth:`telegram.TelegramObject.de_json`.r4r1r+r9r:) _parse_datar getrrrrde_jsonclsr9r:rs rrBz Gift.de_jsonst$$*488I+>+>MMY!1$((;K2L2LdTW!X!X -dhh|.D.DnVYZZ\wwDc222r ) NNNNNNNNNNN)r!r"r#r$r%strrr&rrboolrr classmethodrBr'r(s@rr*r*VsYYvI*#'&*)-&*+//3,0"&"&04# '+!### ## # 4Z # t # $J#t #"Dj##&*##T)#4K#4K#$':# tO!######J3383,3&33333[33333r r*creZdZdZdZdddeededzffdZe d ded d d dffd Z xZ S)GiftsavThis object represent a list of gifts. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal if their :attr:`gifts` are equal. .. versionadded:: 21.8 Args: gifts (Sequence[:class:`Gift`]): The sequence of gifts. Attributes: gifts (tuple[:class:`Gift`]): The sequence of gifts. )giftsNrrKrct|t||_|jf|_|dSr)rrr rKrr)rrKrrs rrzGifts.__init__sK J///'9%'@'@ * r r9r:r;r<c||}t|dt||d<t ||S)r>rKr?)r@r rAr*rrBrCs rrBz Gifts.de_jsonsQt$$('):):D#FFW wwDc222r rE) r!r"r#r$r%rr*rrrHrBr'r(s@rrJrJs  I '+   ~ tO      3383,3'33333[33333r rJc$eZdZdZdZ ddddededzdedzdedzd edzd edzd e e dzd edzd edzdedzde dzffdZ e dde ddddffd Zde defdZddeedzdee effdZxZS)GiftInfoa Describes a service message about a regular 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` is equal. .. versionadded:: 22.1 Args: gift (:class:`Gift`): Information about the gift. 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. convert_star_count (:obj:`int`, optional) Number of Telegram Stars that can be claimed by the receiver by converting the gift; omitted if conversion to Telegram Stars is impossible. prepaid_upgrade_star_count (:obj:`int`, optional): Number of Telegram Stars that were prepaid for the ability to upgrade the gift. can_be_upgraded (:obj:`bool`, optional): :obj:`True`, if the gift can be upgraded to a unique gift. text (:obj:`str`, optional): Text of the message that was added to the gift. entities (Sequence[:class:`telegram.MessageEntity`], optional): Special entities that appear in the text. is_private (:obj:`bool`, optional): :obj:`True`, if the sender and gift text are shown only to the gift receiver; otherwise, everyone will be able to see them. is_upgrade_separate (:obj:`bool`, optional): :obj:`True`, if the gift's upgrade was purchased after the gift was sent. .. versionadded:: 22.6 unique_gift_number (:obj:`int`, optional): Unique number reserved for this gift when upgraded. See the number field in :class:`~telegram.UniqueGift`. .. versionadded:: 22.6 Attributes: gift (:class:`Gift`): Information about the gift. 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. convert_star_count (:obj:`int`): Optional. Number of Telegram Stars that can be claimed by the receiver by converting the gift; omitted if conversion to Telegram Stars is impossible. prepaid_upgrade_star_count (:obj:`int`): Optional. Number of Telegram Stars that were prepaid for the ability to upgrade the gift. can_be_upgraded (:obj:`bool`): Optional. :obj:`True`, if the gift can be upgraded to a unique gift. text (:obj:`str`): Optional. Text of the message that was added to the gift. entities (Sequence[:class:`telegram.MessageEntity`]): Optional. Special entities that appear in the text. is_private (:obj:`bool`): Optional. :obj:`True`, if the sender and gift text are shown only to the gift receiver; otherwise, everyone will be able to see them. is_upgrade_separate (:obj:`bool`): Optional. :obj:`True`, if the gift's upgrade was purchased after the gift was sent. .. versionadded:: 22.6 unique_gift_number (:obj:`int`): Optional. Unique number reserved for this gift when upgraded. See the number field in :class:`~telegram.UniqueGift`. .. versionadded:: 22.6 ) can_be_upgradedconvert_star_countentitiesgift is_privateis_upgrade_separate owned_gift_idprepaid_upgrade_star_counttextunique_gift_numberNrrSrVrQrWrPrXrRrTrYrUrc 4t| ||_||_||_||_||_||_t||_ ||_ | |_ | |_ |jf|_ |dSr)rrrSrVrQrWrPrXr rRrTrYrUrr) rrSrVrQrWrPrXrRrTrYrUrrs rrzGiftInfo.__init__cs J/// )6.@6P',; $ 3Eh3O3O '1.@0C ) r r9r:r;r<c$||}t|dt||d<t |dt ||d<t ||S)r>rSrRr?)r@r rAr*r rrrBrCs rrBzGiftInfo.de_jsonstt$$'(8(8$DDV +DHHZ,@,@-QTUUZwwDc222r entitycX|jstdt|j|S)aReturns the text in :attr:`text` from a given :class:`telegram.MessageEntity` of :attr:`entities`. Note: This method is present because Telegram calculates the offset and length in UTF-16 codepoint pairs, which some versions of Python don't handle automatically. (That is, you can't just slice ``Message.text`` with the offset and length.) Args: entity (:class:`telegram.MessageEntity`): The entity to extract the text from. It must be an entity that belongs to :attr:`entities`. Returns: :obj:`str`: The text of the given entity. Raises: RuntimeError: If the gift info has no text. This GiftInfo has no 'text'.)rX RuntimeErrorr )rr\s r parse_entityzGiftInfo.parse_entitys/(y ?=>> >#DIv666r typescd|jstdt|j|j|S)aO Returns a :obj:`dict` that maps :class:`telegram.MessageEntity` to :obj:`str`. It contains entities from this gift info's text filtered by their ``type`` attribute as the key, and the text that each entity belongs to as the value of the :obj:`dict`. Note: This method should always be used instead of the :attr:`entities` attribute, since it calculates the correct substring from the message text based on UTF-16 codepoints. See :attr:`parse_entity` for more info. Args: types (list[:obj:`str`], optional): List of ``MessageEntity`` types as strings. If the ``type`` attribute of an entity is contained in this list, it will be returned. Defaults to :attr:`telegram.MessageEntity.ALL_TYPES`. Returns: dict[:class:`telegram.MessageEntity`, :obj:`str`]: A dictionary of entities mapped to the text that belongs to them, calculated based on UTF-16 codepoints. Raises: RuntimeError: If the gift info has no text. r^)rXr_r rR)rras rparse_entitieszGiftInfo.parse_entitiess30y ?=>> >%diFFFr ) NNNNNNNNNrE)r!r"r#r$r%r*rFr&rGrrrrrHrBr`listdictrcr'r(s@rrOrOs99v I %))-15'+37"&)-+/'+Tz $J  %($J   Dj=)D04K $J"D[tOB3383,3*33333[37=7S77772GGDI$4G]TWEW@XGGGGGGGGr rOcLeZdZdZdZdddedededed ed edzf fd ZxZS) AcceptedGiftTypesaThis object describes the types of gifts that can be gifted to a user or a chat. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal if their :attr:`unlimited_gifts`, :attr:`limited_gifts`, :attr:`unique_gifts`, :attr:`premium_subscription` and :attr:`gifts_from_channels` are equal. .. versionadded:: 22.1 .. versionchanged:: 22.6 :attr:`gifts_from_channels` is now considered for equality checks. Args: unlimited_gifts (:class:`bool`): :obj:`True`, if unlimited regular gifts are accepted. limited_gifts (:class:`bool`): :obj:`True`, if limited regular gifts are accepted. unique_gifts (:class:`bool`): :obj:`True`, if unique gifts or gifts that can be upgraded to unique for free are accepted. premium_subscription (:class:`bool`): :obj:`True`, if a Telegram Premium subscription is accepted. gifts_from_channels (:obj:`bool`): :obj:`True`, if transfers of unique gifts from channels are accepted .. versionadded:: 22.6 Attributes: unlimited_gifts (:class:`bool`): :obj:`True`, if unlimited regular gifts are accepted. limited_gifts (:class:`bool`): :obj:`True`, if limited regular gifts are accepted. unique_gifts (:class:`bool`): :obj:`True`, if unique gifts or gifts that can be upgraded to unique for free are accepted. premium_subscription (:class:`bool`): :obj:`True`, if a Telegram Premium subscription is accepted. gifts_from_channels (:obj:`bool`): :obj:`True`, if transfers of unique gifts from channels are accepted .. versionadded:: 22.6 )gifts_from_channels limited_giftspremium_subscription unique_giftsunlimited_giftsNrrlrirkrjrhrct|||_||_||_||_||_|j|j|j|j|jf|_|dSr) rrrlrirkrjrhrr)rrlrirkrjrhrrs rrzAcceptedGiftTypes.__init__s J///%4#0".*>!)<        %  $   r ) r!r"r#r$r%rGrrr'r(s@rrgrgs""HI '+  #  " tOr rgN)r$collections.abcrtypingrtelegram._chatrtelegram._files.stickerrtelegram._messageentityrtelegram._telegramobjectrtelegram._utils.argumentparsingr r r telegram._utils.entitiesr r telegram._utils.typesrtelegramrrr*rJrOrgr rrys(A@$$$$$$ ++++++111111333333bbbbbbbbbbQQQQQQQQ******.....^...bY3Y3Y3Y3Y3>Y3Y3Y3x%3%3%3%3%3N%3%3%3PhGhGhGhGhG~hGhGhGVFFFFFFFFFFr