'iFQdZddlmZddlmZddlmZddlmZddl m Z ddl m Z ddl mZmZmZdd lmZmZdd lmZerdd lmZGd d e ZGdde ZGdde ZGdde ZGdde Zy)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|_|j yNr)super__init__rrr _id_attrs_freeze)selfrrrr __class__s Y/home/obispo/Crisostomo_bridge/mision_env/lib/python3.12/site-packages/telegram/_gifts.pyrzGiftBackground.__init__@sX J/!-))    OO OO  ) __name__ __module__ __qualname____doc__ __slots__intrr __classcell__rs@rrr%sH(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,r6rc t||||_||_||_||_||_||_||_||_ | |_ | |_ | |_ | |_ | |_|jf|_|j!yr)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|j|}t|jdt||d<t|jdt||d<t|jdt ||d<t |||S),See :meth:`telegram.TelegramObject.de_json`.r4r1r+r9r:) _parse_datar getrrrrde_jsonclsr9r:rs rrBz Gift.de_jsons}t$*488I+>MY!1$((;K2LdTW!X -dhh|.DnVYZ\wDc22r ) NNNNNNNNNNN)r!r"r#r$r%strrr&rrboolrr classmethodrBr'r(s@rr*r*Vs!YvI*#'&*)-&*+//3,0"&"&04# '+!# ## # 4Z # t # $J#t #"Dj##&*##T)#4K#4K#$':# tO!#J383,3&33r r*cfeZdZdZdZdddeededzffdZe 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|_|j yr)rrr rKrr)rrKrrs rrzGifts.__init__s7 J/'9%'@ ** r r9r:r;r<c|j|}t|jdt||d<t|||S)r>rKr?)r@r rAr*rrBrCs rrBz Gifts.de_jsonsAt$('):D#FW wDc22r rE) r!r"r#r$r%rr*rrrHrBr'r(s@rrJrJs\ I '+ ~ tO 383,3'33r 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 t || ||_||_||_||_||_||_t||_ ||_ | |_ | |_ |jf|_ |jyr)rrrSrVrQrWrPrXr rRrTrYrUrr) rrSrVrQrWrPrXrRrTrYrUrrs rrzGiftInfo.__init__cs| J/ )6.@6P',; $ 3Eh3O '1.@0C )) r r9r:r;r<c|j|}t|jdt||d<t |jdt ||d<t |||S)r>rSrRr?)r@r rAr*r rrrBrCs rrBzGiftInfo.de_jsons^t$'(8$DV +DHHZ,@-QTUZwDc22r entityc\|js tdt|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((yy=> >#DIIv66r typescr|js tdt|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_entitiess.0yy=> >%diiFFr ) NNNNNNNNNrE)r!r"r#r$r%r*rFr&rGrrrrrHrBr`listdictrcr'r(s@rrOrOs=9v I %))-15'+37"&)-+/'+Tz $J  %($J   Dj=)D04K $J"D[tOB383,3*337=7S72GDI$4G]TWEW@XGr 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 |j f|_|jyr) 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 rrysw(A$ +13bbQ*.^.bY3>Y3x%3N%3PhG~hGVFFr