o N,h9@sdZddlmZddlmZmZddlmZddlm Z ddl m Z ddl m Z ddlmZmZmZdd lmZmZdd lmZerHdd lmZGd d d e ZGddde ZGddde ZGddde ZdS)z:This module contains classes related to gifs sent by bots.)Sequence) TYPE_CHECKINGOptional)Chat)Sticker) MessageEntity)TelegramObject)de_json_optionalde_list_optionalparse_sequence_arg)parse_message_entitiesparse_message_entity)JSONDict)BotcseZdZdZdZ    ddddedededeed eed eed ee d ee ffd dZ e dde dedddffdd Z ZS)GiftaThis 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; for limited gifts only. remaining_count (:obj:`int`, optional): The number of remaining gifts of this type that can be sent; 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 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; for limited gifts only. remaining_count (:obj:`int`): Optional. The number of remaining gifts of this type that can be sent; 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 )idpublisher_chatremaining_count star_countsticker total_countupgrade_star_countN api_kwargsrrrrrrrrc sNtj|d||_||_||_||_||_||_||_|jf|_ | dSNr) super__init__rrrrrrr _id_attrs_freeze) selfrrrrrrrr __class__[/var/www/www-root/data/www/bot.pdev.uz/venv/lib/python3.10/site-packages/telegram/_gifts.pyr]s   z Gift.__init__databotrreturncsF||}t|dt||d<t|dt||d<tj||dS),See :meth:`telegram.TelegramObject.de_json`.rrr$r%) _parse_datar getrrrde_jsonclsr$r%r r"r#r+vs z Gift.de_json)NNNNN)__name__ __module__ __qualname____doc__ __slots__strrintrrrr classmethodr+ __classcell__r"r"r r#r%s8-  *rcs`eZdZdZdZdddeedeeffddZ e dd ed ed 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. )giftsNrr9rcs.tj|dt||_|jf|_|dSr)rrr r9rr)rr9rr r"r#rs   zGifts.__init__r$r%rr&cs0||}t|dt||d<tj||dS)r'r9r()r)r r*rrr+r,r r"r#r+s z Gifts.de_jsonr.) r/r0r1r2r3rrrrrr6r+r7r"r"r r#r8s *r8cseZdZdZdZ       ddddedeedeedeed ee d eed ee e d ee d ee ffddZ edde dedddffdd Zde defddZddeeedee 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 by the sender 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. 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 by the sender 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. )can_be_upgradedconvert_star_countentitiesgift is_private owned_gift_idprepaid_upgrade_star_counttextNrr>r@r<rAr;rBr=r?rc  sXtj| d||_||_||_||_||_||_t||_ ||_ |jf|_ | dSr) rrr>r@r<rAr;rBr r=r?rr) rr>r@r<rAr;rBr=r?rr r"r#rs    zGiftInfo.__init__r$r%rr&csF||}t|dt||d<t|dt||d<tj||dS)r'r>r=r()r)r r*rr rrr+r,r r"r#r+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'.)rB RuntimeErrorr )rrCr"r"r# 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. rD)rBrEr r=)rrGr"r"r#parse_entitiesszGiftInfo.parse_entities)NNNNNNNr.)r/r0r1r2r3rrr4r5boolrrrrr6r+rFlistdictrHr7r"r"r r#r:sF+    " ,r:c sDeZdZdZdZdddedededed eef fd d ZZ S) 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` and :attr:`premium_subscription` are equal. .. versionadded:: 22.1 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. 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. ) limited_giftspremium_subscription unique_giftsunlimited_giftsNrrPrMrOrNrcsHtj|d||_||_||_||_|j|j|j|jf|_|dSr)rrrPrMrOrNrr)rrPrMrOrNrr r"r#r_s  zAcceptedGiftTypes.__init__) r/r0r1r2r3rIrrrr7r"r"r r#rL=srLN)r2collections.abcrtypingrrtelegram._chatrtelegram._files.stickerrtelegram._messageentityrtelegram._telegramobjectrtelegram._utils.argumentparsingr r r telegram._utils.entitiesr r telegram._utils.typesrtelegramrrr8r:rLr"r"r"r#s"       [(