eiHRdZddlZddlZddlZddlmZddlmZm Z ddl m Z ddl m Z ddlmZddlmZdd lmZdd lmZmZdd lmZdd lmZerdd l mZedZGdde ZdS)zHThis module contains an object that represents a Telegram MessageEntity.N)Sequence) TYPE_CHECKINGFinal) constants)TelegramObject)User)enum)de_json_optional)extract_tzinfo_from_defaultsfrom_timestamp) TextEncoding)JSONDict)Bot MessageEntitycleZdZUdZdZ d1dddededededzd edzd edzd edzd edzd ej dzde dzffdZ e d2de ddddffd Z edededefdZedeezdedefdZe deeefeeeefzdeeeffdZeejZeeeed< ejjZeeed< ejjZeeed< ejjZeeed< ejjZeeed < ejjZeeed!< ejj Z eeed"< ejj!Z!eeed#< ejj"Z"eeed$< ejj#Z#eeed%< ejj$Z$eeed&< ejj%Z%eeed'< ejj&Z&eeed(< ejj'Z'eeed)< ejj(Z(eeed*< ejj)Z)eeed+< ejj*Z*eeed,< ejj+Z+eeed-< ejj,Z,eeed.< ejj-Z-eeed/< ejj.Z.eeed0<xZ/S)3ra This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`type`, :attr:`offset` and :attr:`length` are equal. Args: type (:obj:`str`): Type of the entity. Can be :attr:`MENTION` (``@username``), :attr:`HASHTAG` (``#hashtag`` or ``#hashtag@chatusername``), :attr:`CASHTAG` (``$USD`` or ``USD@chatusername``), :attr:`BOT_COMMAND` (``/start@jobs_bot``), :attr:`URL` (``https://telegram.org``), :attr:`EMAIL` (``do-not-reply@telegram.org``), :attr:`PHONE_NUMBER` (``+1-212-555-0123``), :attr:`BOLD` (**bold text**), :attr:`ITALIC` (*italic text*), :attr:`UNDERLINE` (underlined text), :attr:`STRIKETHROUGH`, :attr:`SPOILER` (spoiler message), :attr:`BLOCKQUOTE` (block quotation), :attr:`CODE` (monowidth string), :attr:`PRE` (monowidth block), :attr:`TEXT_LINK` (for clickable text URLs), :attr:`TEXT_MENTION` (for users without usernames), :attr:`CUSTOM_EMOJI` (for inline custom emoji stickers) or :attr:`DATE_TIME` (for formatted date and time). .. versionadded:: 20.0 Added inline custom emoji .. versionadded:: 20.8 Added block quotation .. versionadded:: 22.7 Added date_time offset (:obj:`int`): Offset in UTF-16 code units to the start of the entity. length (:obj:`int`): Length of the entity in UTF-16 code units. url (:obj:`str`, optional): For :attr:`TEXT_LINK` only, url that will be opened after user taps on the text. user (:class:`telegram.User`, optional): For :attr:`TEXT_MENTION` only, the mentioned user. language (:obj:`str`, optional): For :attr:`PRE` only, the programming language of the entity text. custom_emoji_id (:obj:`str`, optional): For :attr:`CUSTOM_EMOJI` only, unique identifier of the custom emoji. Use :meth:`telegram.Bot.get_custom_emoji_stickers` to get full information about the sticker. .. versionadded:: 20.0 date_time_format (:obj:`str`, optional): For :attr:`DATE_TIME` only, the string that defines the formatting of the date and time. See `date-time entity formatting `_ for more details and :class:`telegram.constants.MessageEntityDateTimeFormats` for all possible formats. .. versionadded:: 22.7 unix_time (:class:`datetime.datetime`, optional): For :attr:`DATE_TIME` only, the time associated with the entity. |datetime_localization| .. versionadded:: 22.7 Attributes: type (:obj:`str`): Type of the entity. Can be :attr:`MENTION` (``@username``), :attr:`HASHTAG` (``#hashtag`` or ``#hashtag@chatusername``), :attr:`CASHTAG` (``$USD`` or ``USD@chatusername``), :attr:`BOT_COMMAND` (``/start@jobs_bot``), :attr:`URL` (``https://telegram.org``), :attr:`EMAIL` (``do-not-reply@telegram.org``), :attr:`PHONE_NUMBER` (``+1-212-555-0123``), :attr:`BOLD` (**bold text**), :attr:`ITALIC` (*italic text*), :attr:`UNDERLINE` (underlined text), :attr:`STRIKETHROUGH`, :attr:`SPOILER` (spoiler message), :attr:`BLOCKQUOTE` (block quotation), :attr:`CODE` (monowidth string), :attr:`PRE` (monowidth block), :attr:`TEXT_LINK` (for clickable text URLs), :attr:`TEXT_MENTION` (for users without usernames), :attr:`CUSTOM_EMOJI` (for inline custom emoji stickers) or :attr:`DATE_TIME` (for formatted date and time). .. versionadded:: 20.0 Added inline custom emoji .. versionadded:: 20.8 Added block quotation .. versionadded:: 22.7 Added date_time offset (:obj:`int`): Offset in UTF-16 code units to the start of the entity. length (:obj:`int`): Length of the entity in UTF-16 code units. url (:obj:`str`): Optional. For :attr:`TEXT_LINK` only, url that will be opened after user taps on the text. user (:class:`telegram.User`): Optional. For :attr:`TEXT_MENTION` only, the mentioned user. language (:obj:`str`): Optional. For :attr:`PRE` only, the programming language of the entity text. custom_emoji_id (:obj:`str`): Optional. For :attr:`CUSTOM_EMOJI` only, unique identifier of the custom emoji. Use :meth:`telegram.Bot.get_custom_emoji_stickers` to get full information about the sticker. .. versionadded:: 20.0 date_time_format (:obj:`str`): Optional. For :attr:`DATE_TIME` only, the string that defines the formatting of the date and time. See `date-time entity formatting `_ for more details and :class:`telegram.constants.MessageEntityDateTimeFormats` for all possible formats. .. versionadded:: 22.7 unix_time (:class:`datetime.datetime`): Optional. For :attr:`DATE_TIME` only, the time associated with the entity. |datetime_localization| .. versionadded:: 22.7 ) custom_emoji_iddate_time_formatlanguagelengthoffsettype unix_timeurluserN api_kwargsrrrrrrrrrrc `t| tjtj|||_||_||_||_ ||_ ||_ ||_ ||_ | |_|j|j|jf|_|dS)Nr)super__init__r get_memberrMessageEntityTyperrrrrrrrr _id_attrs_freeze) selfrrrrrrrrrr __class__s [/home/div/.hermes/hermes-agent/venv/lib/python3.11/site-packages/telegram/_messageentity.pyrzMessageEntity.__init__s J///)DdDQQ ! ! "!% $, +:,<.7)T[$+> databotz Bot | Nonereturnc8||}t|dt||d<t |}t |d||d<t ||S)z,See :meth:`telegram.TelegramObject.de_json`.rr)tzinfo)r(r)) _parse_datar getrr r rde_json)clsr(r) loc_tzinfor%s r&r/zMessageEntity.de_jsonst$$'(8(8$DDV 2#66 *488K+@+@TTT[wwDc222r'textentitiescHttjd|D}d}i}t|D]Y\}}|dkr ||dz nd}|||}|t |t jdzz }|||<Zg} |D]} || j} || j| j z| z } tj | } | 5| | _| | _ dddn #1swxYwY| | | S)uUtility functionality for converting the offset and length of entities from Unicode (:obj:`str`) to UTF-16 (``utf-16-le`` encoded :obj:`bytes`). Tip: Only the offsets and lengths calulated in UTF-16 is acceptable by the Telegram Bot API. If they are calculated using the Unicode string (:obj:`str` object), errors may occur when the text contains characters that are not in the Basic Multilingual Plane (BMP). For more information, see `Unicode `_ and `Plane (Unicode) `_. .. versionadded:: 21.4 Examples: Below is a snippet of code that demonstrates how to use this function to convert entities from Unicode to UTF-16 space. The ``unicode_entities`` are calculated in Unicode and the `utf_16_entities` are calculated in UTF-16. .. code-block:: python text = "𠌕 bold 𝄢 italic underlined: 𝛙𝌢𑁍" unicode_entities = [ MessageEntity(offset=2, length=4, type=MessageEntity.BOLD), MessageEntity(offset=9, length=6, type=MessageEntity.ITALIC), MessageEntity(offset=28, length=3, type=MessageEntity.UNDERLINE), ] utf_16_entities = MessageEntity.adjust_message_entities_to_utf_16( text, unicode_entities ) await bot.send_message( chat_id=123, text=text, entities=utf_16_entities, ) # utf_16_entities[0]: offset=3, length=4 # utf_16_entities[1]: offset=11, length=6 # utf_16_entities[2]: offset=30, length=6 Args: text (:obj:`str`): The text that the entities belong to entities (Sequence[:class:`telegram.MessageEntity`]): Sequence of entities with offset and length calculated in Unicode Returns: Sequence[:class:`telegram.MessageEntity`]: Sequence of entities with offset and length calculated in UTF-16 encoding c3BK|]}|j|j|jzfVdSN)rr).0xs r& zBMessageEntity.adjust_message_entities_to_utf_16..s3,_,_QRah188K-L,_,_,_,_,_,_r'rN) sorted itertoolschain enumeratelenencoder UTF_16_LErrcopy _unfrozenappend)r2r3 positionsaccumulated_lengthposition_translationiposition last_position text_sliceoutentitytranslated_positionstranslated_length new_entitys r&!adjust_message_entities_to_utf_16z/MessageEntity.adjust_message_entities_to_utf_16sb9?,_,_V^,_,_,_`aa 02$Y// @ @KAx01AIa!e,,1MmH45J #j&7&7 8N&O&O"P"PTU"U U -?  * * # #F#7 #F $V]V]%BCFZZ 6**J%%'' 6 6$8 !$5 ! 6 6 6 6 6 6 6 6 6 6 6 6 6 6 6 JJz " " " " s&DD D bycVt|tr|n$t|ddz}g}|D]g}t j|}|5|xj|z c_dddn #1swxYwY||h|S)uUtility functionality for shifting the offset of entities by a given amount. Examples: Shifting by an integer amount: .. code-block:: python text = "Hello, world!" entities = [ MessageEntity(offset=0, length=5, type=MessageEntity.BOLD), MessageEntity(offset=7, length=5, type=MessageEntity.ITALIC), ] shifted_entities = MessageEntity.shift_entities(1, entities) await bot.send_message( chat_id=123, text="!" + text, entities=shifted_entities, ) Shifting using a string: .. code-block:: python text = "Hello, world!" prefix = "𝄢" entities = [ MessageEntity(offset=0, length=5, type=MessageEntity.BOLD), MessageEntity(offset=7, length=5, type=MessageEntity.ITALIC), ] shifted_entities = MessageEntity.shift_entities(prefix, entities) await bot.send_message( chat_id=123, text=prefix + text, entities=shifted_entities, ) Tip: The :paramref:`entities` are *not* modified in place. The function returns a sequence of new objects. .. versionadded:: 21.5 Args: by (:obj:`str` | :obj:`int`): Either the amount to shift the offset by or a string whose length will be used as the amount to shift the offset by. In this case, UTF-16 encoding will be used to calculate the length. entities (Sequence[:class:`telegram.MessageEntity`]): Sequence of entities Returns: Sequence[:class:`telegram.MessageEntity`]: Sequence of entities with the offset shifted z utf-16-ler;N) isinstanceintr@rArCrDrrE)rSr3effective_shiftrMrNrQs r&shift_entitieszMessageEntity.shift_entitiessj!+2s 3 3Y""RYY{=S=S9T9TXY9Y # #F6**J%%'' 5 5!!_4!! 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 JJz " " " " s+BB B argscd}g}|D]s}|d|d}}t|dkr |ddur|||}||||||z }t||fS)u Utility functionality for concatenating two text along with their formatting entities. Tip: This function is useful for prefixing an already formatted text with a new text and its formatting entities. In particular, it automatically correctly handles UTF-16 encoding. Examples: This example shows a callback function that can be used to add a prefix and suffix to the message in a :class:`~telegram.ext.CallbackQueryHandler`: .. code-block:: python async def prefix_message(update: Update, context: ContextTypes.DEFAULT_TYPE): prefix = "𠌕 bold 𝄢 italic underlined: 𝛙𝌢𑁍 | " prefix_entities = [ MessageEntity(offset=2, length=4, type=MessageEntity.BOLD), MessageEntity(offset=9, length=6, type=MessageEntity.ITALIC), MessageEntity(offset=28, length=3, type=MessageEntity.UNDERLINE), ] suffix = " | 𠌕 bold 𝄢 italic underlined: 𝛙𝌢𑁍" suffix_entities = [ MessageEntity(offset=5, length=4, type=MessageEntity.BOLD), MessageEntity(offset=12, length=6, type=MessageEntity.ITALIC), MessageEntity(offset=31, length=3, type=MessageEntity.UNDERLINE), ] message = update.effective_message first = (prefix, prefix_entities, True) second = (message.text, message.entities) third = (suffix, suffix_entities, True) new_text, new_entities = MessageEntity.concatenate(first, second, third) await update.callback_query.edit_message_text( text=new_text, entities=new_entities, ) Hint: The entities are *not* modified in place. The function returns a new sequence of objects. .. versionadded:: 21.5 Args: *args (tuple[:obj:`str`, Sequence[:class:`telegram.MessageEntity`]] | tuple[:obj:`str`, Sequence[:class:`telegram.MessageEntity`], :obj:`bool`]): Arbitrary number of tuples containing the text and its entities to concatenate. If the last element of the tuple is a :obj:`bool`, it is used to determine whether to adjust the entities to UTF-16 via :meth:`adjust_message_entities_to_utf_16`. UTF-16 adjustment is disabled by default. Returns: tuple[:obj:`str`, Sequence[:class:`telegram.MessageEntity`]]: The concatenated text and its entities rr:r;T)r@rRextendrX)r0rY output_textoutput_entitiesargr2r3s r& concatenatezMessageEntity.concatenateOsz /1  C VSV(D3xx!||A$@@xPP  " "3#5#5k8#L#L M M M 4 KKO++r' ALL_TYPES BLOCKQUOTEBOLD BOT_COMMANDCASHTAGCODE CUSTOM_EMOJI DATE_TIMEEMAILEXPANDABLE_BLOCKQUOTEHASHTAGITALICMENTION PHONE_NUMBERPRESPOILER STRIKETHROUGH TEXT_LINK TEXT_MENTION UNDERLINEURL)NNNNNNr6)0__name__ __module__ __qualname____doc__ __slots__strrVrdtmdatetimerr classmethodr/ staticmethod_SEMrRrXtupleboolr`listrr!rar__annotations__rbrcrdrerfrgrhrirjrkrlrmrnrorprqrrrsrtru __classcell__)r%s@r&rr*sbbH I" #&*'+)-'+  4Z  Tk *t*<$&tO> 3 38 3, 3/ 3 3 3 3 3[ 3FFtFFFF\FP<39<<<<<\<|G,S$Y%T4"88G, sDy G,G,G,[G,R#'$y'B"C"CIuT#YCCCI&8CJc CCC!27D%*777<'9EKsEEEC#5=GU3Z===? 27D%*777<(:GL%*GGG&7AIuSzAAA"39E5:999=(1(C(Y5:YYY$5=GU3Z===?"4;FE#J;;;>#5=GU3Z===?(:GL%*GGGD15Cs555;#5=GU3Z===!* ; IM5:IIIE%7AIuSzAAAA(:GL%*GGGD%7AIuSzAAAA15Cs555;;;;r')ryrCr}r|r=collections.abcrtypingrrtelegramrtelegram._telegramobjectrtelegram._userrtelegram._utilsr telegram._utils.argumentparsingr telegram._utils.datetimer r telegram._utils.stringsr telegram._utils.typesrrrrr'r&rsQ&ON $$$$$$''''''''333333 <<<<<<QQQQQQQQ000000****** g<g<g<g<g