+ ?QjRtRt^RIt^RIHt^RIHt^RIHt^RI H t H t ]'d ^RI H t HtRRRlltR R ltRR R lltR RltRRRlltR#)zThis module contains convenience helper functions. .. versionchanged:: 20.0 Previously, the contents of this module were available through the (no longer existing) module ``telegram.utils.helpers``. Nescape) TYPE_CHECKING)MarkdownVersion) MessageLimit MessageTypeMessageUpdatecVV^8dQhR\R\R\R,R\/#)textversion entity_typeNreturn)strr)formats"ڒ/home/ubuntu/.hermes/installs/5f0a1ff4045d044e/environments/50f6b671e3f94b538e344231dfcb664f/venv/lib/python3.14/site-packages/telegram/helpers.py __annotate__r-s6 C C  C' C:=* C Cc\V4^8XdRpM2\V4^8XdVR 9dRpMVR 9dRpMRpM \R4h\P!R\P!V4 R2RV4#) azHelper function to escape telegram markup symbols. .. versionchanged:: 20.3 Custom emoji entity escaping is now supported. Args: text (:obj:`str`): The text. version (:obj:`int` | :obj:`str`): Use to specify the version of telegrams Markdown. Either ``1`` or ``2``. Defaults to ``1``. entity_type (:obj:`str`, optional): For the entity types :tg-const:`telegram.MessageEntity.PRE`, :tg-const:`telegram.MessageEntity.CODE` and the link part of :tg-const:`telegram.MessageEntity.TEXT_LINK` and :tg-const:`telegram.MessageEntity.CUSTOM_EMOJI`, only certain characters need to be escaped in :tg-const:`telegram.constants.ParseMode.MARKDOWN_V2`. See the `official API documentation `_ for details. Only valid in combination with ``version=2``, will be ignored else. z_*`[z\`z\)z\_*[]()~`>#+-=|{}.!z'Markdown version must be either 1 or 2!z([z])z\\\1)precode) text_link custom_emoji)int ValueErrorresubr)r rr escape_charss&&& rescape_markdownr -ss( 7|q W  / ) L 9 9 L1LBCC 66Bryy./r2GT BBrcRV^8dQhR\\,R\R\/#)r user_idnamer)rr)rs"rrrPs* B B#) B3 B3 Brc&RV R\V4 R2#)z Helper function to create a user mention as HTML tag. Args: user_id (:obj:`int`): The user's id which you want to mention. name (:obj:`str`): The name the mention is showing. Returns: :obj:`str`: The inline mention for the user as HTML. zzr)r"r#s&&r mention_htmlr%Ps$G9Bvd|nD AArc^V^8dQhR\\,R\R\R\/#)r r"r#rr)rrr)rs"rrr^s3DDcCiDsD_DUXDrcRRV 2pV^8Xd RV RV R2#R\WR7 RV R2#)a Helper function to create a user mention in Markdown syntax. Args: user_id (:obj:`int`): The user's id which you want to mention. name (:obj:`str`): The name the mention is showing. version (:obj:`int` | :obj:`str`): Use to specify the version of Telegram's Markdown. Either ``1`` or ``2``. Defaults to ``1``. Returns: :obj:`str`: The inline mention for the user as Markdown. z tg://user?id=[z]())r)r )r"r#rtg_links&&& rmention_markdownr+^sGgY'G!|4&7)1%% t56b  CCrc6V^8dQhRRR\R,/#)r entityzMessage | UpdaterN)r)rs"rrrqs!!#5!#*!rc^RIHpHp\W4'dTpMJ\W4'd"VP'gR#VPpM\ R\ V4 R24h\FpW4,'gKVu# R#)a Extracts the type of message as a string identifier from a :class:`telegram.Message` or a :class:`telegram.Update`. Args: entity (:class:`telegram.Update` | :class:`telegram.Message`): The ``update`` or ``message`` to extract from. Returns: :obj:`str` | :obj:`None`: One of :class:`telegram.constants.MessageType` if the entity contains a message that matches one of those types. :obj:`None` otherwise. rNz/The entity is neither Message nor Update (got: r))telegramr r isinstanceeffective_message TypeErrortyper)r-r r message message_types& reffective_message_typer6qsv &"" F # #'''**I$v,WXYZZ#   $ rcVV^8dQhR\R\R,R\R\/#)r bot_usernamepayloadNgroupr)rbool)rs"rrrs07)7)7) #d 7):>7)7)rcPVe\V4^8:d \R4hRV 2pV'gV#\V4\P8d\R\P R24h\P !RV4'g \R4hV'dRMRpV R V R V 2#) a Creates a deep-linked URL for this :paramref:`~create_deep_linked_url.bot_username` with the specified :paramref:`~create_deep_linked_url.payload`. See https://core.telegram.org/bots/features#deep-linking to learn more. The :paramref:`~create_deep_linked_url.payload` may consist of the following characters: ``A-Z, a-z, 0-9, _, -`` Note: Works well in conjunction with ``CommandHandler("start", callback, filters=filters.Regex('payload'))`` Examples: * ``create_deep_linked_url(bot.get_me().username, "some-params")`` * :any:`Deep Linking ` Args: bot_username (:obj:`str`): The username to link to. payload (:obj:`str`, optional): Parameters to encode in the created URL. group (:obj:`bool`, optional): If :obj:`True` the user is prompted to select a group to add the bot to. If :obj:`False`, opens a one-on-one conversation with the bot. Defaults to :obj:`False`. Returns: :obj:`str`: An URL to start the bot with specific parameters. Raises: :exc:`ValueError`: If the length of the :paramref:`payload` exceeds :tg-const:`telegram.constants.MessageLimit.DEEP_LINK_LENGTH` characters, contains invalid characters, or if the :paramref:`bot_username` is less than 4 characters. z&You must provide a valid bot_username.z https://t.me/z)The deep-linking payload must not exceed z characters.z^[A-Za-z0-9_-]+$zVOnly the following characters are allowed for deep-linked URLs: A-Z, a-z, 0-9, _ and - startgroupstart?=)lenrrDEEP_LINK_LENGTHrmatch)r8r9r:base_urlkeys&&& rcreate_deep_linked_urlrFsFs<0A5ABB|n-H  7|l3337 8U8U7VVb c   88' 1 1 +   ,WCZqQwi ((r)rFr6r r%r+)N)rG)NF)__doc____all__rhtmlrtypingrtelegram._utils.typesrtelegram.constantsrrr/r r r r%r+r6rFrrrOsK&   18( CF BD&!H7)7)r