Th2dZddlZddlZddlmZmZmZmZmZm Z ddl m Z ddl m Z ddlmZddlmZddlmZerdd l mZGd d e Zy) zHThis module contains an object that represents a Telegram MessageEntity.N) TYPE_CHECKINGDictFinalListOptionalSequence) constants)TelegramObject)User)enum)JSONDict)BotceZdZUdZdZ d*dddedededeed eed eed eed ee ffd Z e d+dee deddedffd Z e dededdedfdZeej$Zeeeed< ej$j.Zeeed< ej$j0Zeeed< ej$j2Zeeed< ej$j4Zeeed< ej$j6Zeeed< ej$j8Zeeed< ej$j:Zeeed< ej$j<Zeeed< ej$j>Zeeed< ej$j@Z eeed < ej$jBZ!eeed!< ej$jDZ"eeed"< ej$jFZ#eeed#< ej$jHZ$eeed$< ej$jJZ%eeed%< ej$jLZ&eeed&< ej$jNZ'eeed'< ej$jPZ(eeed(< ej$jRZ)eeed)<xZ*S), MessageEntitya 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), :attr:`CASHTAG` ($USD), :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). .. versionadded:: 20.0 Added inline custom emoji .. versionadded:: 20.8 Added block quotation 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 Attributes: type (:obj:`str`): Type of the entity. Can be :attr:`MENTION` (@username), :attr:`HASHTAG` (#hashtag), :attr:`CASHTAG` ($USD), :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). .. versionadded:: 20.0 Added inline custom emoji .. versionadded:: 20.8 Added block quotation 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 )custom_emoji_idlanguagelengthoffsettypeurluserN api_kwargsrrrrrrrrc>t ||tjtj |||_||_||_||_ ||_ ||_ ||_ |j |j|jf|_ |jy)Nr)super__init__r get_memberr MessageEntityTyperrrrrrr _id_attrs_freeze) selfrrrrrrrr __class__s W/opt/server/standalone/crm/venv/lib/python3.12/site-packages/telegram/_messageentity.pyrzMessageEntity.__init__js} J/)D)DdDQ ! ! "%$( '/ .=))T[[$++> databotrreturnc|j|}|sytj|jd||d<t| ||S)z,See :meth:`telegram.TelegramObject.de_json`.Nr)r%r&) _parse_datar de_jsongetr)clsr%r&r"s r#r*zMessageEntity.de_jsonsI t$||DHHV$4c:V wDc22r$textentitiesc ttjd|D}d}i}t|D]>\}}|dkDr||dz nd}|||}|t |j ddzz }|||<@g} |D]}} || j } || j | jz| z } tj| } | j5| | _| | _ddd| j| | S#1swYxYw)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 c3fK|])}|j|j|jzf+ywN)rr).0xs r# zBMessageEntity.adjust_message_entities_to_utf_16..s',_QRahh1888K-L,_s/1rz utf-16-leN) sorted itertoolschain enumeratelenencoderrcopy _unfrozenappend)r-r. positionsaccumulated_lengthposition_translationiposition last_position text_sliceoutentitytranslated_positionstranslated_length new_entitys r#!adjust_message_entities_to_utf_16z/MessageEntity.adjust_message_entities_to_utf_16s/f9??,_V^,_`a 02$Y/ @KAx01AIa!e,1MmH5J #j&7&7 &D"E"J J -?  *  @  #F#7 #F $V]]V]]%BCFZZ 6*J%%' 6$8 !$5 ! 6 JJz " #  6 6s C99D ALL_TYPES BLOCKQUOTEBOLD BOT_COMMANDCASHTAGCODE CUSTOM_EMOJIEMAILEXPANDABLE_BLOCKQUOTEHASHTAGITALICMENTION PHONE_NUMBERPRESPOILER STRIKETHROUGH TEXT_LINK TEXT_MENTION UNDERLINEURL)NNNNr1)+__name__ __module__ __qualname____doc__ __slots__strintrr r r classmethodr* staticmethodrrLlistr rrMrr__annotations__rNrOrPrQrRrSrTrUrVrWrXrYrZr[r\r]r^r_r` __classcell__)r"s@r#rr#sfBH[I"#"&)-*.  c]  tn 3-"#X&6>B 3H% 3,4UO 3 / " 3 3HH%o6H / "HHT#'y'B'B"CIuT#YCI&88CCJc C!2277D%*7<'99EEKsEC#55==GU3Z=? 2277D%*7<(::GGL%*G"3399E5:9=(1(C(C(Y(Y5:Y$55==GU3Z=?"44;;FE#J;>#55==GU3Z=?(::GGL%*GD1155Cs5;#55==GU3Z=!* ; ; I IM5:IE%77AAIuSzAA(::GGL%*GD%77AAIuSzAA1155Cs5;r$r)rdr=r8typingrrrrrrtelegramr telegram._telegramobjectr telegram._userr telegram._utilsr telegram._utils.typesr rrr$r#rts:&O GG3 *n