o Zzj6O@sdZddlZddlmZddlmZmZddlm Z ddl m Z ddl m Z ddlmZdd lmZdd lmZdd lmZdd lmZmZmZdd lmZmZddlmZmZddl m!Z!erfddlm"Z"GdddeZ#GdddeZ$Gddde#Z%Gddde#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)BotcseZdZUdZdZejjZee e d< ejj Z ee e d< ddde de dBd dffd d Z edd e d dd dffdd ZZS) 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_kwargsrrreturncs6tj|dttj|||_|jf|_|dSNr) super__init__r get_memberr OwnedGiftTyper _id_attrs_freeze)selfrr __class__N/var/www/kodo/tsheker/venv/lib/python3.10/site-packages/telegram/_ownedgift.pyrCs  zOwnedGift.__init__databot Bot | NonecsX||}|jt|jti}|tur$|d|vr$||dj||dSt j||dS)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$r&r'r1Os zOwnedGift.de_jsonN)__name__ __module__ __qualname____doc__ __slots__rr rrstr__annotations__rrr classmethodr1 __classcell__r&r&r$r'r)s"  &rc sleZdZdZdZ ddddedeededBde dBffd d Z e dd e d d ddffdd Z Z 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_countNrrAr?r@rcs>tj|d||_t||_||_|j|jf|_|dSr)rrrArr?r@r!r")r#rAr?r@rr$r&r'rs   zOwnedGifts.__init__r(r)r*rcs0||}t|dt||d<tj||dS)z,See :meth:`telegram.TelegramObject.de_json`.r?r+)r,r r/rrr1)r2r(r)r$r&r'r1s zOwnedGifts.de_jsonr4)r5r6r7r8r9intrrr:rrr<r1r=r&r&r$r'r>is" &r>c"seZdZdZdZ            d"dddedejdedBde dBd edBd e e dBd e dBd e dBd e dBde dBde dBde dBde dBde dBdedBddf fddZed#deddddffdd Zde defddZd#deedBdee effd d!ZZS)$r-aDescribes 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_refundedNrrFrLrJrMrNrErGrHrCrPrDrKrIrOrrcstjtj|d|>||_||_||_||_||_ t ||_ ||_ ||_ | |_| |_| |_| |_| |_||_|j|j|jf|_WddS1sNwYdSN)rr)rrrr _unfrozenrFrLrJrMrNrrErGrHrCrPrDrKrIrOrr!)r#rFrLrJrMrNrErGrHrCrPrDrKrIrOrr$r&r'rs$  "zOwnedGiftRegular.__init__r(r)r*csz||}t|}t|d|d|d<t|dt||d<t|dt||d<t|dt||d<t j ||dS)'See :meth:`telegram.OwnedGift.de_json`.rLtzinforMrFrEr+) r,rrr/r r rr rrr1r2r(r) loc_tzinfor$r&r'r1!s zOwnedGiftRegular.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 ``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'.)rN RuntimeErrorr)r#rXr&r&r' parse_entity.s zOwnedGiftRegular.parse_entitytypescCs|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. rY)rNrZrrE)r#r\r&r&r'parse_entitiesGszOwnedGiftRegular.parse_entities) NNNNNNNNNNNNr4)r5r6r7r8r9rdtmdatetimer:r rrboolrBrrr<r1r[listdictr]r=r&r&r$r'r-slJ      ' ,r-cseZdZdZdZ      ddddedejdedBde dBd e dBd e dBd e dBd ejdBd e dBddffddZ edde ddddffdd ZZS)r.ah 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_transferredrFrHnext_transfer_daterJrLrMtransfer_star_countNrrFrLrJrMrHrcrerdrrc  stjtj| d|*||_||_||_||_||_ ||_ ||_ ||_ |j |j|jf|_WddS1s:wYdSrQ)rrrrrRrFrLrJrMrHrcrerdrr!) r#rFrLrJrMrHrcrerdrr$r&r'rs "zOwnedGiftUnique.__init__r(r)r*csz||}t|}t|d|d|d<t|dt||d<t|dt||d<t|d|d|d<tj||dS)rSrLrTrMrFrdr+) r,rrr/r r r rr1rVr$r&r'r1s   zOwnedGiftUnique.de_json)NNNNNNr4)r5r6r7r8r9r r^r_r:r r`rBrrr<r1r=r&r&r$r'r.esD.    &r.)'r8r_r^collections.abcrtypingrrtelegramrtelegram._giftsrtelegram._messageentityrtelegram._telegramobjectrtelegram._uniquegiftr telegram._userr telegram._utilsr telegram._utils.argumentparsingr r rtelegram._utils.datetimerrtelegram._utils.entitiesrrtelegram._utils.typesrrrr>r-r.r&r&r&r's,          @5H