o ZzjFQ@sdZddlmZddlmZddlmZddlmZddl m Z ddl m Z ddl mZmZmZdd lmZmZdd lmZerFdd lmZGd d d e ZGddde ZGddde ZGddde ZGddde 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 s@eZdZdZdZdddededededBffd d ZZS) 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_kwargsrrrrcs>tj|d||_||_||_|j|j|jf|_|dSNr)super__init__rrr _id_attrs_freeze)selfrrrr __class__J/var/www/kodo/tsheker/venv/lib/python3.10/site-packages/telegram/_gifts.pyr@s zGiftBackground.__init__) __name__ __module__ __qualname____doc__ __slots__intr r __classcell__rrrrr%s rcseZdZdZdZ          ddddededededBd edBd edBd edBd edBd edBde dBde dBde dBdedBde dBffddZ e dde ddddffdd ZZS)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)r0r/r1r.r3r-r,r+r'r*r(r2rcsrtj|d||_||_||_||_||_||_||_||_ | |_ | |_ | |_ | |_ | |_|jf|_|dSr)rrr)r0r/r1r.r3r-r,r+r'r*r(r2rr)rr)r0r/r1r.r3r-r,r+r'r*r(r2rrrrrs   z Gift.__init__databot Bot | Nonereturncs\||}t|dt||d<t|dt||d<t|dt||d<tj||dS),See :meth:`telegram.TelegramObject.de_json`.r0r-r'r4r5) _parse_datargetrrrrde_jsonclsr4r5rrrr<s z Gift.de_json) NNNNNNNNNNN)rr r!r"r#strrr$rrboolr r classmethodr<r%rrrrr&Vs\[     %&r&cs\eZdZdZdZdddeededBffddZe dd ed d d dffd d Z Z 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. )giftsNrrDrcs.tj|dt||_|jf|_|dSr)rrr rDrr)rrDrrrrrs   zGifts.__init__r4r5r6r7cs0||}t|dt||d<tj||dS)r8rDr9)r:r r;r&rr<r=rrrr<s z Gifts.de_jsonr?) rr r!r"r#rr&r rrBr<r%rrrrrCs &rCcseZdZdZdZ         ddddededBdedBdedBd edBd edBd e e dBd edBd edBdedBde dBffddZ e dde ddddffdd Zde defddZddeedBdee effddZZS) 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_numberNrrIrLrGrMrFrNrHrJrOrKrc  sdtj| d||_||_||_||_||_||_t||_ ||_ | |_ | |_ |jf|_ |dSr)rrrIrLrGrMrFrNr rHrJrOrKrr) rrIrLrGrMrFrNrHrJrOrKrrrrrcs   zGiftInfo.__init__r4r5r6r7csF||}t|dt||d<t|dt||d<tj||dS)r8rIrHr9)r:rr;r&r rrr<r=rrrr<s zGiftInfo.de_jsonentitycCs|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'.)rN RuntimeErrorr )rrPrrr parse_entitys zGiftInfo.parse_entitytypescCs|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. rQ)rNrRr rH)rrTrrrparse_entitiesszGiftInfo.parse_entities) NNNNNNNNNr?)rr r!r"r#r&r@r$rArrr rrBr<rSlistdictrUr%rrrrrEsR;      ! ,rEcsHeZdZdZdZdddedededed ed edBf fd d ZZS) 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_giftsNrr]rZr\r[rYrcsRtj|d||_||_||_||_||_|j|j|j|j|jf|_|dSr) rrr]rZr\r[rYrr)rr]rZr\r[rYrrrrrs  zAcceptedGiftTypes.__init__) rr r!r"r#rAr rr%rrrrrXs"$rXN)r"collections.abcrtypingrtelegram._chatrtelegram._files.stickerrtelegram._messageentityrtelegram._telegramobjectrtelegram._utils.argumentparsingrr r telegram._utils.entitiesr r telegram._utils.typesr telegramrrr&rCrErXrrrrs&        1(,