'i6O(dZddlZddlmZddlmZmZddlm Z ddl m Z ddl m Z ddlmZdd lmZdd lmZdd lmZdd lmZmZmZdd lmZmZddlmZmZddl m!Z!erddlm"Z"GddeZ#GddeZ$Gdde#Z%Gdde#Z&y)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)BotceZdZUdZdZej jZee e d< ej jZ 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 |||_|j f|_|jyNr) super__init__r get_memberr OwnedGiftTyper _id_attrs_freeze)selfrr __class__s ]/home/obispo/Crisostomo_bridge/mision_env/lib/python3.12/site-packages/telegram/_ownedgift.pyr!zOwnedGift.__init__CsE J/)@)@$M )) databot Bot | Nonec |j|}|jt|jti}|t ur8|j d|vr%||jdj||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$ KK) JJ6  )  0N B!$((6"23;;3;O OwDc22r)N)__name__ __module__ __qualname____doc__ __slots__rr#rrstr__annotations__rrr! classmethodr4 __classcell__r's@r(rr)s$I#1199GU3Z9;"0077FE#J7: '+  tO   383,3+33r)rc xeZdZdZdZ 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|_|jyr)r r!rFrrDrEr$r%)r&rFrDrErr's r(r!zOwnedGifts.__init__sP J/ +,>u,E '2**DJJ7 r)r*r+r,rc|j|}t|jdt||d<t|||S)z,See :meth:`telegram.TelegramObject.de_json`.rDr.)r/rr2rr r4)r5r*r+r's r(r4zOwnedGifts.de_jsonsAt$('):IsKW wDc22r)r7)r8r9r:r;r<intrrr=rr!r?r4r@rAs@r(rCrCis(I#'  '+  "4Z  tO "383,3,33r)rCc"LeZdZdZdZ 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_refundedNrrNrTrRrUrVrMrOrPrKrXrLrSrQrWrrct|tj||j 5||_||_||_||_||_ t||_ ||_ ||_ | |_| |_| |_| |_| |_||_|j(|j |j f|_dddy#1swYyxYwN)rr)r r!rr _unfrozenrNrTrRrUrVrrMrOrPrKrXrLrSrQrWrr$)r&rNrTrRrUrVrMrOrPrKrXrLrSrQrWrr's r(r!zOwnedGiftRegular.__init__s& i//JG ^^  D"DI+4DN-:D ,7D $(DI7I(7SDM+5DO)1DM0?D -9D 2DD #:TD +4GD $2DD #"iiDNNCDN! D D Ds BCCr*r+r,cn|j|}t|}t|jd||d<t |jdt ||d<t |jdt ||d<t|jdt||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#6 *488K+@T[.txx /FcR]'(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 ``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.s((yyEF F#DIIv66r)typescr|js tdt|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_entitiesGs.0yyEF F%diiFFr)) NNNNNNNNNNNNr7)r8r9r:r;r<rdtmdatetimer=r rrboolrIrr!r?r4rflistdictrir@rAs@r(r0r0sHTI*%)#'37"& $'+$()-15+/)-%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$ %%DN 38 3, 3BT 3 37=7S72GDI$4G]TWEW@XGr)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 Nt |tj| |j 5||_||_||_||_||_ ||_ ||_ ||_ |j|j |j f|_dddy#1swYyxYwrZ)r r!rrr[rNrTrRrUrPrprrrqrr$) r&rNrTrRrUrPrprrrqrr's r(r!zOwnedGiftUnique.__init__s i..:F ^^  D$(DI+4DN-:D ,7D )1DM3ED #3FD $;MD #"iiDNNCDN D D Ds A!BB$r*r+r,cf|j|}t|}t|jd||d<t |jdt ||d<t |jdt ||d<t|jd||d<t|!||S)r]rTr^rUrNrqr.) r/rrr2r r r r r4r`s r(r4zOwnedGiftUnique.de_jsonst$1#6 *488K+@T[.txx /FcR]'(8*cJV %3 HH) *:&  !"wDc22r))NNNNNNr7)r8r9r:r;r<r rjrkr=r rlrIrr!r?r4r@rAs@r(r1r1es,\ I%)#' $*.*.26D'+DD<<DTz D D[ D + D!4KD!4ZD LL4/DtOD D6 38 3, 3BS 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(rsv&?$' 13+ bbQQ*=3=3@2323jDGyDGNb3ib3r)