i6OBdZddlZddlmZddlmZmZddlm Z ddl m Z ddl m Z ddlmZdd lmZdd lmZdd lmZdd lmZmZmZdd lmZmZddlmZmZddl m!Z!erddlm"Z"GddeZ#GddeZ$Gdde#Z%Gdde#Z&dS)z8This module contains objects that represent owned gifts.N)Sequence) TYPE_CHECKINGFinal) constants)Gift) MessageEntity)TelegramObject) UniqueGift)User)enum)de_json_optionalde_list_optionalparse_sequence_arg)extract_tzinfo_from_defaultsfrom_timestamp)parse_message_entitiesparse_message_entity)JSONDict)BotceZdZUdZdZejjZee e d< ejj Z ee e d< ddde de dzd dffd Z edd e d d d dffd ZxZS) OwnedGiftaThis object describes a gift received and owned by a user or a chat. Currently, it can be one of: * :class:`telegram.OwnedGiftRegular` * :class:`telegram.OwnedGiftUnique` Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`type` is equal. .. versionadded:: 22.1 Args: type (:obj:`str`): Type of the owned gift. Attributes: type (:obj:`str`): Type of the owned gift. )typeREGULARUNIQUEN api_kwargsrrreturnct|tjtj|||_|jf|_|dSNr) super__init__r get_memberr OwnedGiftTyper _id_attrs_freeze)selfrr __class__s S/Users/shanyulin/my-agent/.venv/lib/python3.11/site-packages/telegram/_ownedgift.pyr!zOwnedGift.__init__CsT J///)@$MM ) databot Bot | NonecH||}|jt|jti}|t urG|d|vr0||d||St||S)aXConverts JSON data to the appropriate :class:`OwnedGift` object, i.e. takes care of selecting the correct subclass. Args: data (dict[:obj:`str`, ...]): The JSON data. bot (:class:`telegram.Bot`, optional): The bot associated with this object. Returns: The Telegram object. rr*r+) _parse_datarOwnedGiftRegularrOwnedGiftUniquergetpopde_jsonr )clsr*r+_class_mappingr's r(r4zOwnedGift.de_jsonOst$$ K) J6  )   0 0N B B!$((6"2"23;;3;OO OwwDc222r)N)__name__ __module__ __qualname____doc__ __slots__rr#rrstr__annotations__rrr! classmethodr4 __classcell__r's@r(rr)s$I#19GU3Z999;"07FE#J777: '+    tO        3383,3+33333[33333r)rc eZdZdZdZ ddddedeededzde dzffd Z e dd e d d d dffd Z xZ S) OwnedGiftsauContains the list of gifts received and owned by 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:`total_count` and :attr:`gifts` are equal. .. versionadded:: 22.1 Args: total_count (:obj:`int`): The total number of gifts owned by the user or the chat. gifts (Sequence[:class:`telegram.OwnedGift`]): The list of gifts. next_offset (:obj:`str`, optional): Offset for the next request. If empty, then there are no more results. Attributes: total_count (:obj:`int`): The total number of gifts owned by the user or the chat. gifts (Sequence[:class:`telegram.OwnedGift`]): The list of gifts. next_offset (:obj:`str`): Optional. Offset for the next request. If empty, then there are no more results. )gifts next_offset total_countNrrFrDrErct|||_t||_||_|j|jf|_|dSr)r r!rFrrDrEr$r%)r&rFrDrErr's r(r!zOwnedGifts.__init__sa J/// +,>u,E,E '2*DJ7 r)r*r+r,rc||}t|dt||d<t ||S)z,See :meth:`telegram.TelegramObject.de_json`.rDr.)r/rr2rr r4)r5r*r+r's r(r4zOwnedGifts.de_jsonsQt$$('):):IsKKW wwDc222r)r7)r8r9r:r;r<intrrr=rr!r?r4r@rAs@r(rCrCis(I#'  '+  "4Z  tO "3383,3,33333[33333r)rCc"ZeZdZdZdZ ddddedejdedzde dzd edzd e e dzd e dzd e dzd e dzde dzde dzde dzde dzde dzdedzddf fdZeddeddddffd Zde defdZddeedzdee effdZxZS) r0aDescribes a regular gift owned by 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:`gift` and :attr:`send_date` are equal. .. versionadded:: 22.1 Args: gift (:class:`telegram.Gift`): Information about the regular gift. owned_gift_id (:obj:`str`, optional): Unique identifier of the gift for the bot; for gifts received on behalf of business accounts only. sender_user (:class:`telegram.User`, optional): Sender of the gift if it is a known user. send_date (:obj:`datetime.datetime`): Date the gift was sent as :class:`datetime.datetime`. |datetime_localization|. 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_saved (:obj:`bool`, optional): :obj:`True`, if the gift is displayed on the account's profile page; for gifts received on behalf of business accounts only. can_be_upgraded (:obj:`bool`, optional): :obj:`True`, if the gift can be upgraded to a unique gift; for gifts received on behalf of business accounts only. was_refunded (:obj:`bool`, optional): :obj:`True`, if the gift was refunded and isn't available anymore. convert_star_count (:obj:`int`, optional): Number of Telegram Stars that can be claimed by the receiver instead of the gift; omitted if the gift cannot be converted to Telegram Stars; for gifts received on behalf of business accounts only. prepaid_upgrade_star_count (:obj:`int`, optional): Number of Telegram Stars that were paid for the ability to upgrade the gift. is_upgrade_separate (:obj:`bool`, optional): :obj:`True`, if the gift's upgrade was purchased after the gift was sent; for gifts received on behalf of business accounts .. 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: type (:obj:`str`): Type of the gift, always :attr:`~telegram.OwnedGift.REGULAR`. gift (:class:`telegram.Gift`): Information about the regular gift. owned_gift_id (:obj:`str`): Optional. Unique identifier of the gift for the bot; for gifts received on behalf of business accounts only. sender_user (:class:`telegram.User`): Optional. Sender of the gift if it is a known user. send_date (:obj:`datetime.datetime`): Date the gift was sent as :class:`datetime.datetime`. |datetime_localization|. 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_saved (:obj:`bool`): Optional. :obj:`True`, if the gift is displayed on the account's profile page; for gifts received on behalf of business accounts only. can_be_upgraded (:obj:`bool`): Optional. :obj:`True`, if the gift can be upgraded to a unique gift; for gifts received on behalf of business accounts only. was_refunded (:obj:`bool`): Optional. :obj:`True`, if the gift was refunded and isn't available anymore. convert_star_count (:obj:`int`): Optional. Number of Telegram Stars that can be claimed by the receiver instead of the gift; omitted if the gift cannot be converted to Telegram Stars; for gifts received on behalf of business accounts only. prepaid_upgrade_star_count (:obj:`int`): Optional. Number of Telegram Stars that were paid for the ability to upgrade the gift. is_upgrade_separate (:obj:`bool`): Optional. :obj:`True`, if the gift's upgrade was purchased after the gift was sent; for gifts received on behalf of business accounts .. 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_savedis_upgrade_separate owned_gift_idprepaid_upgrade_star_count send_date sender_usertextunique_gift_number was_refundedNrrNrTrRrUrVrMrOrPrKrXrLrSrQrWrrcttj||5||_||_||_||_||_ t||_ ||_ ||_ | |_| |_| |_| |_| |_||_|j|j|jf|_ddddS#1swxYwYdSN)rr)r r!rr _unfrozenrNrTrRrUrVrrMrOrPrKrXrLrSrQrWrr$)r&rNrTrRrUrVrMrOrPrKrXrLrSrQrWrr's r(r!zOwnedGiftRegular.__init__s3& i/JGGG ^^   D D"DI+4DN-:D ,7D $(DI7I(7S7SDM+5DO)1DM0?D -9D 2DD #:TD +4GD $2DD #"iDNCDN! D D D D D D D D D D D D D D D D D DsB CC Cr*r+r,c||}t|}t|d||d<t |dt ||d<t |dt ||d<t|dt||d<t ||S)'See :meth:`telegram.OwnedGift.de_json`.rTtzinforUrNrMr.) r/rrr2r r rrrr r4r5r*r+ loc_tzinfor's r(r4zOwnedGiftRegular.de_json!st$$1#66 *488K+@+@TTT[.txx /F/FcRR]'(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 ``OwnedGiftRegular.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 owned gift has no text. $This OwnedGiftRegular has no 'text'.)rV RuntimeErrorr)r&rbs r( parse_entityzOwnedGiftRegular.parse_entity.s0(y GEFF F#DIv666r)typescd|jstdt|j|j|S)aQ Returns a :obj:`dict` that maps :class:`telegram.MessageEntity` to :obj:`str`. It contains entities from this owned gift'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 owned gift has no text. rd)rVrerrM)r&rgs r(parse_entitieszOwnedGiftRegular.parse_entitiesGs40y GEFF F%diFFFr)) NNNNNNNNNNNNr7)r8r9r:r;r<rdtmdatetimer=r rrboolrIrr!r?r4rflistdictrir@rAs@r(r0r0s,HHTI*%)#'37"& $'+$()-15+/)-%D"'+#%D%D%D%D<%DTz %D D[ %D Dj %D=)D0%D4K%D+%D%DTk%D $J%D%($J%D"D[%D $J%D"tO#%D$ %%D%D%D%D%D%DN 3 38 3, 3BT 3 3 3 3 3[ 37=7S77772GGDI$4G]TWEW@XGGGGGGGGr)r0ceZdZdZdZ ddddedejdedzde dzd e dzd e dzd e dzd ejdzd e dzddffdZ edde ddddffd ZxZS)r1ah Describes a unique gift received and owned by 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:`gift` and :attr:`send_date` are equal. .. versionadded:: 22.1 Args: gift (:class:`telegram.UniqueGift`): Information about the unique gift. owned_gift_id (:obj:`str`, optional): Unique identifier of the received gift for the bot; for gifts received on behalf of business accounts only. sender_user (:class:`telegram.User`, optional): Sender of the gift if it is a known user. send_date (:obj:`datetime.datetime`): Date the gift was sent as :class:`datetime.datetime`. |datetime_localization| is_saved (:obj:`bool`, optional): :obj:`True`, if the gift is displayed on the account's profile page; for gifts received on behalf of business accounts only. can_be_transferred (:obj:`bool`, optional): :obj:`True`, if the gift can be transferred to another owner; for gifts received on behalf of business accounts only. 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. 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: type (:obj:`str`): Type of the owned gift, always :tg-const:`~telegram.OwnedGift.UNIQUE`. gift (:class:`telegram.UniqueGift`): Information about the unique gift. owned_gift_id (:obj:`str`): Optional. Unique identifier of the received gift for the bot; for gifts received on behalf of business accounts only. sender_user (:class:`telegram.User`): Optional. Sender of the gift if it is a known user. send_date (:obj:`datetime.datetime`): Date the gift was sent as :class:`datetime.datetime`. |datetime_localization| is_saved (:obj:`bool`): Optional. :obj:`True`, if the gift is displayed on the account's profile page; for gifts received on behalf of business accounts only. can_be_transferred (:obj:`bool`): Optional. :obj:`True`, if the gift can be transferred to another owner; for gifts received on behalf of business accounts only. 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. 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 )can_be_transferredrNrPnext_transfer_daterRrTrUtransfer_star_countNrrNrTrRrUrPrprrrqrrc ^ttj| |5||_||_||_||_||_ ||_ ||_ ||_ |j |j|jf|_ddddS#1swxYwYdSrZ)r r!rrr[rNrTrRrUrPrprrrqrr$) r&rNrTrRrUrPrprrrqrr's r(r!zOwnedGiftUnique.__init__s i.:FFF ^^   D D$(DI+4DN-:D ,7D )1DM3ED #3FD $;MD #"iDNCDN D D D D D D D D D D D D D D D D D DsAB""B&)B&r*r+r,c||}t|}t|d||d<t |dt ||d<t |dt ||d<t|d||d<t||S)r]rTr^rUrNrqr.) r/rrr2r r r r r4r`s r(r4zOwnedGiftUnique.de_jsonst$$1#66 *488K+@+@TTT[.txx /F/FcRR]'(8(8*cJJV %3 HH) * *:& & &  !"wwDc222r))NNNNNNr7)r8r9r:r;r<r rjrkr=r rlrIrr!r?r4r@rAs@r(r1r1esR,,\ I%)#' $*.*.26D'+DDDD<DTz D D[ D + D!4KD!4ZD L4/DtOD DDDDDD6 3 38 3, 3BS 3 3 3 3 3[ 3 3 3 3 3r)r1)'r;rkrjcollections.abcrtypingrrtelegramrtelegram._giftsrtelegram._messageentityrtelegram._telegramobjectr telegram._uniquegiftr telegram._userr telegram._utilsr telegram._utils.argumentparsingr rrtelegram._utils.datetimerrtelegram._utils.entitiesrrtelegram._utils.typesrrrrCr0r1r)r(rs &?>$$$$$$'''''''' 111111333333++++++ bbbbbbbbbbQQQQQQQQQQQQQQQQ******=3=3=3=3=3=3=3=3@2323232323232323jDGDGDGDGDGyDGDGDGNb3b3b3b3b3ib3b3b3b3b3r)