U dd5r@s~dZddlZddlmZddlmZmZmZmZm Z m Z m Z ddl m Z ddlmZddlmZddlmZdd lmZdd lmZdd lmZdd lmZdd lmZddlmZddl m!Z!ddl"m#Z#ddl$m%Z%ddl&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,ddl-m.Z.ddl/m0Z0ddl1m2Z2ddl3m4Z4ddl5m6Z6ddl7m8Z8ddl9m:Z:ddl;mZ>ddl?m@Z@mAZAddlBmCZCddlDmEZEddlFmGZGdd lHmIZImJZJdd!lKmLZLmMZMdd"lNmOZOmPZPmQZQmRZRmSZSdd#lTmUZUdd$lVmWZWmXZXmYZYmZZZdd%l[m\Z\dd&l]m^Z^dd'l_m`Z`maZadd(lbmcZcdd)ldmeZeerjdd*lfmgZgmhZhmiZimjZjmkZkmlZlmmZmmnZnmoZoGd+d,d,eCZpdS)-zBThis module contains an object that represents a Telegram Message.N)escape) TYPE_CHECKINGDictListOptionalSequenceTupleUnion)Chat)Dice) Animation)Audio)Contact)Document)Location) PhotoSize)Sticker)Venue)Video) VideoNote)Voice)ForumTopicClosedForumTopicCreatedForumTopicEditedForumTopicReopenedGeneralForumTopicHiddenGeneralForumTopicUnhidden)Game)InlineKeyboardMarkup)MessageAutoDeleteTimerChanged) MessageEntity) PassportData)Invoice)SuccessfulPayment)Poll)ProximityAlertTriggered) ChatShared UserShared)TelegramObject)User)parse_sequence_arg)extract_tzinfo_from_defaultsfrom_timestamp) DEFAULT_NONE DefaultValue)DVInput FileInputJSONDictODVInput ReplyMarkup)warn)VideoChatEndedVideoChatParticipantsInvitedVideoChatScheduledVideoChatStarted) WebAppData)WriteAccessAllowed)MessageAttachmentType ParseMode)escape_markdown)PTBDeprecationWarning) Bot GameHighScore InputMediaInputMediaAudioInputMediaDocumentInputMediaPhotoInputMediaVideo LabeledPrice MessageIdcKsFeZdZdZdZdddeejeeeeeejdeje e de de e e e eeeeee ee eeeee e eeeeeeedeee e e e eeee eeeeeee e!e"e#eee$eee%e&e'e(e)e*e+ee,e-e.dHfddZ/e0ed d d Z1e0ed d d Z2e0e3e d ddZ4e5e3e.de3ddfdd Z6e0e7ee eee e eeee eeeeeeeedfd ddZ8e3ee3ee3edddZ9e:e:e:dde:de:df de:e:e:e:dde e;e e;eee;e>e;e>e;e>e.ddddZ?e:e:dde:de:dfde:e:e:e:dde e;eee;e>e;e>e;e>e.ddddZ@e:e:dde:de:dfde:e:e:e:dde e;eee;e>e;e>e;e>e.ddd d!ZAe:e:dde:de:dfde:e:e:e:dde e;eee;e>e;e>e;e>e.ddd"d#ZBe:de:e:dfde:d$e:e:dde:dd% e e7d&e;eee;ee;eeee;e>e;e>e;e>e;e>e.e3e e;e e deCd'd(d)d*ZDde:dde:e:de:ddf dde:d$e:e:dd+e7eEd,fe ee;e>e;e>e;e>e.dd-d.d/ZFdddde:dde:de:de:ddfdde:d$e:e:dd+e7eEd0fee e e ee;e>e;e>e;e>e.dd1d2d3ZGde:dde:dde:de:ddf dde:d$e:e:dd+e7eEd4fe ee;e>e;e>e;e>e.dd5d6d7ZHddddde:e:dde:de:dddfdde:d$e:e:dd+e7eEd8feeeeEe e;e ee;e>e;e>e;e>e.dd9d:d;ZIe:dde:e:ddfde:d$e:e:dde7eEde;e>e;e>e;e>e.dd=d>d?ZJdde:dddde:dde:de:dddfdde:d$e:e:dd+e7eEd@fee ee;e>e;e>e;e>e.ddAdBdCZKdde:ddde:e:ddf dde:d$e:e:dd+e7eEdDfeeee;e>e;e>e;e>e.ddEdFdGZLdde:dde:e:de:df dde:d$e:e:dd+e7eEdHfee ee;e>e;e>e;e>e.ddIdJdKZMdde:dddddde:e:df dde:e:e:e:ddLe>e>eeee;ee;eeeee;e>e;e>e;e>e;e>e.ddMdNdOZNddddde:ddddde:e:dfdde:e:e:e:ddPe>e>e e e ee;e>e;e>e;e>e.ddQdRdSZOddde:ddde:e:df dde:e:e:e:ddTe e e ee;e>e;e>e;e>e.ddUdVdWZPddddde:ddde:dde:de:dfde:e:e:e:dde e e ee eeee;eee=e e;e ee7eejfe;ee de;eeee;e>e;e>e;e>e;e>e.ddXdYdZZQe:ddde:e:dfde:e:e:e:dde;eee=e e;ee;eeee;e>e;e>e;e>e;e>e.dd[d\d]ZRde:e:e:e:dd^e ee;e>e;e>e;e>e;e>e.ed_d`daZSe:dde:e:dfde:e:e:e:dde ee;e>e;e>e;e>e.ddcdddeZTdddddddddde:ddddde:dde:dfde:e:e:e:dde e e e e e dfe e eeeeeeeeee;e>e;e>e;e>e.ddg"dhdiZVe:e:dfe:e:e:e:dd^e7ee fee;e>e;e>e;e>e.ddj dkdlZWde:de:de:de:df e:e:e:e:dd^e7ee fe e;e e dee;e>e;e>e;e>e.dmdndodpZXde:de:de:de:df de:e:e:e:dde7e efee e;e e dee;e>e;e>e;e>e.dmdqdrdsZYe:e:ddfe:e:e:e:dd^e e;e e;eee de;e>e;e>e;e>e;e>e.e7defdt dudvZZdde:dfe:e:e:e:dd^e ee;e e de;e>e;e>e;e>e;e>e.e7defdw dxdyZ[de:e:e:e:dd^dzee;e>e;e>e;e>e;e>e.e7defd{d|d}Z\de:e:e:e:dd^e3dbe;e>e;e>e;e>e;e>e.e7defd~ddZ]dde:e:e:e:dde>e>ee>eeee;e>e;e>e;e>e;e>e.e7defd ddZ^de:e:e:e:dd^ee;e>e;e>e;e>e;e>e.e7defd~ddZ_de:e:e:e:dd^e7ee feeee;e>e;e>e;e>e;e>e.e7defd ddZ`e:e:e:e:dd^e7ee fe;e>e;e>e;e>e;e>e.eCddddZae:e:e:e:dd^e;e>e;e>e;e>e;e>e.edddZbde:e:e:e:dd^ee;e>e;e>e;e>e;e>e.ed~ddZce:fe:e:e:e:dd^e;ee;e>e;e>e;e>e;e>e.edddZde:e:e:e:dd^e;e>e;e>e;e>e;e>e.edddZede:e:e:e:dd^e e e;e>e;e>e;e>e;e>e.edddZfe:e:e:e:dd^e;e>e;e>e;e>e;e>e.edddZge:e:e:e:dd^e;e>e;e>e;e>e;e>e.edddZhe:e:e:e:dd^e;e>e;e>e;e>e;e>e.edddZie:e:e:e:dd^e;e>e;e>e;e>e;e>e.edddZjeke dddZleke dddZmdene eoeke fdddZpdene eoeke fdddZqerde3e eoeke feee3e dddZse0e d ddZte0e d ddZue0e d ddZve0e d ddZwerde3e eoeke feeee3e dddZxe0e d ddZye0e d ddZze0e d ddÄZ{e0e d ddńZ|e0e d ddDŽZ}e0e d ddɄZ~e0e d dd˄Ze0e d dd̈́ZZS)MessageaqThis object represents a message. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`message_id` and :attr:`chat` are equal. Note: In Python :keyword:`from` is a reserved word. Use :paramref:`from_user` instead. .. versionchanged:: 20.0 * The arguments and attributes ``voice_chat_scheduled``, ``voice_chat_started`` and ``voice_chat_ended``, ``voice_chat_participants_invited`` were renamed to :paramref:`video_chat_scheduled`/:attr:`video_chat_scheduled`, :paramref:`video_chat_started`/:attr:`video_chat_started`, :paramref:`video_chat_ended`/:attr:`video_chat_ended` and :paramref:`video_chat_participants_invited`/:attr:`video_chat_participants_invited`, respectively, in accordance to Bot API 6.0. * The following are now keyword-only arguments in Bot methods: ``{read, write, connect, pool}_timeout``, ``api_kwargs``, ``contact``, ``quote``, ``filename``, ``loaction``, ``venue``. Use a named argument for those, and notice that some positional arguments changed position as a result. Args: message_id (:obj:`int`): Unique message identifier inside this chat. from_user (:class:`telegram.User`, optional): Sender of the message; empty for messages sent to channels. For backward compatibility, this will contain a fake sender user in non-channel chats, if the message was sent on behalf of a chat. sender_chat (:class:`telegram.Chat`, optional): Sender of the message, sent on behalf of a chat. For example, the channel itself for channel posts, the supergroup itself for messages from anonymous group administrators, the linked channel for messages automatically forwarded to the discussion group. For backward compatibility, :attr:`from_user` contains a fake sender user in non-channel chats, if the message was sent on behalf of a chat. date (:class:`datetime.datetime`): Date the message was sent in Unix time. Converted to :class:`datetime.datetime`. .. versionchanged:: 20.3 |datetime_localization| chat (:class:`telegram.Chat`): Conversation the message belongs to. forward_from (:class:`telegram.User`, optional): For forwarded messages, sender of the original message. forward_from_chat (:class:`telegram.Chat`, optional): For messages forwarded from channels or from anonymous administrators, information about the original sender chat. forward_from_message_id (:obj:`int`, optional): For forwarded channel posts, identifier of the original message in the channel. forward_sender_name (:obj:`str`, optional): Sender's name for messages forwarded from users who disallow adding a link to their account in forwarded messages. forward_date (:class:`datetime.datetime`, optional): For forwarded messages, date the original message was sent in Unix time. Converted to :class:`datetime.datetime`. .. versionchanged:: 20.3 |datetime_localization| is_automatic_forward (:obj:`bool`, optional): :obj:`True`, if the message is a channel post that was automatically forwarded to the connected discussion group. .. versionadded:: 13.9 reply_to_message (:class:`telegram.Message`, optional): For replies, the original message. Note that the Message object in this field will not contain further ``reply_to_message`` fields even if it itself is a reply. edit_date (:class:`datetime.datetime`, optional): Date the message was last edited in Unix time. Converted to :class:`datetime.datetime`. .. versionchanged:: 20.3 |datetime_localization| has_protected_content (:obj:`bool`, optional): :obj:`True`, if the message can't be forwarded. .. versionadded:: 13.9 media_group_id (:obj:`str`, optional): The unique identifier of a media message group this message belongs to. text (:obj:`str`, optional): For text messages, the actual UTF-8 text of the message, 0-:tg-const:`telegram.constants.MessageLimit.MAX_TEXT_LENGTH` characters. entities (Sequence[:class:`telegram.MessageEntity`], optional): For text messages, special entities like usernames, URLs, bot commands, etc. that appear in the text. See :attr:`parse_entity` and :attr:`parse_entities` methods for how to use properly. This list is empty if the message does not contain entities. .. versionchanged:: 20.0 |sequenceclassargs| caption_entities (Sequence[:class:`telegram.MessageEntity`], optional): For messages with a Caption. Special entities like usernames, URLs, bot commands, etc. that appear in the caption. See :attr:`Message.parse_caption_entity` and :attr:`parse_caption_entities` methods for how to use properly. This list is empty if the message does not contain caption entities. .. versionchanged:: 20.0 |sequenceclassargs| audio (:class:`telegram.Audio`, optional): Message is an audio file, information about the file. document (:class:`telegram.Document`, optional): Message is a general file, information about the file. animation (:class:`telegram.Animation`, optional): Message is an animation, information about the animation. For backward compatibility, when this field is set, the document field will also be set. game (:class:`telegram.Game`, optional): Message is a game, information about the game. photo (Sequence[:class:`telegram.PhotoSize`], optional): Message is a photo, available sizes of the photo. This list is empty if the message does not contain a photo. .. versionchanged:: 20.0 |sequenceclassargs| sticker (:class:`telegram.Sticker`, optional): Message is a sticker, information about the sticker. video (:class:`telegram.Video`, optional): Message is a video, information about the video. voice (:class:`telegram.Voice`, optional): Message is a voice message, information about the file. video_note (:class:`telegram.VideoNote`, optional): Message is a video note, information about the video message. new_chat_members (Sequence[:class:`telegram.User`], optional): New members that were added to the group or supergroup and information about them (the bot itself may be one of these members). This list is empty if the message does not contain new chat members. .. versionchanged:: 20.0 |sequenceclassargs| caption (:obj:`str`, optional): Caption for the animation, audio, document, photo, video or voice, 0-:tg-const:`telegram.constants.MessageLimit.CAPTION_LENGTH` characters. contact (:class:`telegram.Contact`, optional): Message is a shared contact, information about the contact. location (:class:`telegram.Location`, optional): Message is a shared location, information about the location. venue (:class:`telegram.Venue`, optional): Message is a venue, information about the venue. For backward compatibility, when this field is set, the location field will also be set. left_chat_member (:class:`telegram.User`, optional): A member was removed from the group, information about them (this member may be the bot itself). new_chat_title (:obj:`str`, optional): A chat title was changed to this value. new_chat_photo (Sequence[:class:`telegram.PhotoSize`], optional): A chat photo was changed to this value. This list is empty if the message does not contain a new chat photo. .. versionchanged:: 20.0 |sequenceclassargs| delete_chat_photo (:obj:`bool`, optional): Service message: The chat photo was deleted. group_chat_created (:obj:`bool`, optional): Service message: The group has been created. supergroup_chat_created (:obj:`bool`, optional): Service message: The supergroup has been created. This field can't be received in a message coming through updates, because bot can't be a member of a supergroup when it is created. It can only be found in :attr:`reply_to_message` if someone replies to a very first message in a directly created supergroup. channel_chat_created (:obj:`bool`, optional): Service message: The channel has been created. This field can't be received in a message coming through updates, because bot can't be a member of a channel when it is created. It can only be found in :attr:`reply_to_message` if someone replies to a very first message in a channel. message_auto_delete_timer_changed (:class:`telegram.MessageAutoDeleteTimerChanged`, optional): Service message: auto-delete timer settings changed in the chat. .. versionadded:: 13.4 migrate_to_chat_id (:obj:`int`, optional): The group has been migrated to a supergroup with the specified identifier. migrate_from_chat_id (:obj:`int`, optional): The supergroup has been migrated from a group with the specified identifier. pinned_message (:class:`telegram.Message`, optional): Specified message was pinned. Note that the Message object in this field will not contain further :attr:`reply_to_message` fields even if it is itself a reply. invoice (:class:`telegram.Invoice`, optional): Message is an invoice for a payment, information about the invoice. successful_payment (:class:`telegram.SuccessfulPayment`, optional): Message is a service message about a successful payment, information about the payment. connected_website (:obj:`str`, optional): The domain name of the website on which the user has logged in. forward_signature (:obj:`str`, optional): For messages forwarded from channels, signature of the post author if present. author_signature (:obj:`str`, optional): Signature of the post author for messages in channels, or the custom title of an anonymous group administrator. passport_data (:class:`telegram.PassportData`, optional): Telegram Passport data. poll (:class:`telegram.Poll`, optional): Message is a native poll, information about the poll. dice (:class:`telegram.Dice`, optional): Message is a dice with random value. via_bot (:class:`telegram.User`, optional): Bot through which message was sent. proximity_alert_triggered (:class:`telegram.ProximityAlertTriggered`, optional): Service message. A user in the chat triggered another user's proximity alert while sharing Live Location. video_chat_scheduled (:class:`telegram.VideoChatScheduled`, optional): Service message: video chat scheduled. .. versionadded:: 20.0 video_chat_started (:class:`telegram.VideoChatStarted`, optional): Service message: video chat started. .. versionadded:: 20.0 video_chat_ended (:class:`telegram.VideoChatEnded`, optional): Service message: video chat ended. .. versionadded:: 20.0 video_chat_participants_invited (:class:`telegram.VideoChatParticipantsInvited` optional): Service message: new participants invited to a video chat. .. versionadded:: 20.0 web_app_data (:class:`telegram.WebAppData`, optional): Service message: data sent by a Web App. .. versionadded:: 20.0 reply_markup (:class:`telegram.InlineKeyboardMarkup`, optional): Inline keyboard attached to the message. :paramref:`~telegram.InlineKeyboardButton.login_url` buttons are represented as ordinary url buttons. is_topic_message (:obj:`bool`, optional): :obj:`True`, if the message is sent to a forum topic. .. versionadded:: 20.0 message_thread_id (:obj:`int`, optional): Unique identifier of a message thread to which the message belongs; for supergroups only. .. versionadded:: 20.0 forum_topic_created (:class:`telegram.ForumTopicCreated`, optional): Service message: forum topic created. .. versionadded:: 20.0 forum_topic_closed (:class:`telegram.ForumTopicClosed`, optional): Service message: forum topic closed. .. versionadded:: 20.0 forum_topic_reopened (:class:`telegram.ForumTopicReopened`, optional): Service message: forum topic reopened. .. versionadded:: 20.0 forum_topic_edited (:class:`telegram.ForumTopicEdited`, optional): Service message: forum topic edited. .. versionadded:: 20.0 general_forum_topic_hidden (:class:`telegram.GeneralForumTopicHidden`, optional): Service message: General forum topic hidden. .. versionadded:: 20.0 general_forum_topic_unhidden (:class:`telegram.GeneralForumTopicUnhidden`, optional): Service message: General forum topic unhidden. .. versionadded:: 20.0 write_access_allowed (:class:`telegram.WriteAccessAllowed`, optional): Service message: the user allowed the bot added to the attachment menu to write messages. .. versionadded:: 20.0 has_media_spoiler (:obj:`bool`, optional): :obj:`True`, if the message media is covered by a spoiler animation. .. versionadded:: 20.0 user_shared (:class:`telegram.UserShared`, optional): Service message: a user was shared with the bot. .. versionadded:: 20.1 chat_shared (:class:`telegram.ChatShared`, optional):Service message: a chat was shared with the bot. .. versionadded:: 20.1 Attributes: message_id (:obj:`int`): Unique message identifier inside this chat. from_user (:class:`telegram.User`): Optional. Sender of the message; empty for messages sent to channels. For backward compatibility, this will contain a fake sender user in non-channel chats, if the message was sent on behalf of a chat. sender_chat (:class:`telegram.Chat`): Optional. Sender of the message, sent on behalf of a chat. For example, the channel itself for channel posts, the supergroup itself for messages from anonymous group administrators, the linked channel for messages automatically forwarded to the discussion group. For backward compatibility, :attr:`from_user` contains a fake sender user in non-channel chats, if the message was sent on behalf of a chat. date (:class:`datetime.datetime`): Date the message was sent in Unix time. Converted to :class:`datetime.datetime`. .. versionchanged:: 20.3 |datetime_localization| chat (:class:`telegram.Chat`): Conversation the message belongs to. forward_from (:class:`telegram.User`): Optional. For forwarded messages, sender of the original message. forward_from_chat (:class:`telegram.Chat`): Optional. For messages forwarded from channels or from anonymous administrators, information about the original sender chat. forward_from_message_id (:obj:`int`): Optional. For forwarded channel posts, identifier of the original message in the channel. forward_date (:class:`datetime.datetime`): Optional. For forwarded messages, date the original message was sent in Unix time. Converted to :class:`datetime.datetime`. .. versionchanged:: 20.3 |datetime_localization| is_automatic_forward (:obj:`bool`): Optional. :obj:`True`, if the message is a channel post that was automatically forwarded to the connected discussion group. .. versionadded:: 13.9 reply_to_message (:class:`telegram.Message`): Optional. For replies, the original message. Note that the Message object in this field will not contain further ``reply_to_message`` fields even if it itself is a reply. edit_date (:class:`datetime.datetime`): Optional. Date the message was last edited in Unix time. Converted to :class:`datetime.datetime`. .. versionchanged:: 20.3 |datetime_localization| has_protected_content (:obj:`bool`): Optional. :obj:`True`, if the message can't be forwarded. .. versionadded:: 13.9 media_group_id (:obj:`str`): Optional. The unique identifier of a media message group this message belongs to. text (:obj:`str`): Optional. For text messages, the actual UTF-8 text of the message, 0-:tg-const:`telegram.constants.MessageLimit.MAX_TEXT_LENGTH` characters. entities (Tuple[:class:`telegram.MessageEntity`]): Optional. For text messages, special entities like usernames, URLs, bot commands, etc. that appear in the text. See :attr:`parse_entity` and :attr:`parse_entities` methods for how to use properly. This list is empty if the message does not contain entities. .. versionchanged:: 20.0 |tupleclassattrs| caption_entities (Tuple[:class:`telegram.MessageEntity`]): Optional. For messages with a Caption. Special entities like usernames, URLs, bot commands, etc. that appear in the caption. See :attr:`Message.parse_caption_entity` and :attr:`parse_caption_entities` methods for how to use properly. This list is empty if the message does not contain caption entities. .. versionchanged:: 20.0 |tupleclassattrs| audio (:class:`telegram.Audio`): Optional. Message is an audio file, information about the file. .. seealso:: :wiki:`Working with Files and Media ` document (:class:`telegram.Document`): Optional. Message is a general file, information about the file. .. seealso:: :wiki:`Working with Files and Media ` animation (:class:`telegram.Animation`): Optional. Message is an animation, information about the animation. For backward compatibility, when this field is set, the document field will also be set. .. seealso:: :wiki:`Working with Files and Media ` game (:class:`telegram.Game`): Optional. Message is a game, information about the game. photo (Tuple[:class:`telegram.PhotoSize`]): Optional. Message is a photo, available sizes of the photo. This list is empty if the message does not contain a photo. .. seealso:: :wiki:`Working with Files and Media ` .. versionchanged:: 20.0 |tupleclassattrs| sticker (:class:`telegram.Sticker`): Optional. Message is a sticker, information about the sticker. .. seealso:: :wiki:`Working with Files and Media ` video (:class:`telegram.Video`): Optional. Message is a video, information about the video. .. seealso:: :wiki:`Working with Files and Media ` voice (:class:`telegram.Voice`): Optional. Message is a voice message, information about the file. .. seealso:: :wiki:`Working with Files and Media ` video_note (:class:`telegram.VideoNote`): Optional. Message is a video note, information about the video message. .. seealso:: :wiki:`Working with Files and Media ` new_chat_members (Tuple[:class:`telegram.User`]): Optional. New members that were added to the group or supergroup and information about them (the bot itself may be one of these members). This list is empty if the message does not contain new chat members. .. versionchanged:: 20.0 |tupleclassattrs| caption (:obj:`str`): Optional. Caption for the animation, audio, document, photo, video or voice, 0-:tg-const:`telegram.constants.MessageLimit.CAPTION_LENGTH` characters. contact (:class:`telegram.Contact`): Optional. Message is a shared contact, information about the contact. location (:class:`telegram.Location`): Optional. Message is a shared location, information about the location. venue (:class:`telegram.Venue`): Optional. Message is a venue, information about the venue. For backward compatibility, when this field is set, the location field will also be set. left_chat_member (:class:`telegram.User`): Optional. A member was removed from the group, information about them (this member may be the bot itself). new_chat_title (:obj:`str`): Optional. A chat title was changed to this value. new_chat_photo (Tuple[:class:`telegram.PhotoSize`]): A chat photo was changed to this value. This list is empty if the message does not contain a new chat photo. .. versionchanged:: 20.0 |tupleclassattrs| delete_chat_photo (:obj:`bool`): Optional. Service message: The chat photo was deleted. group_chat_created (:obj:`bool`): Optional. Service message: The group has been created. supergroup_chat_created (:obj:`bool`): Optional. Service message: The supergroup has been created. This field can't be received in a message coming through updates, because bot can't be a member of a supergroup when it is created. It can only be found in :attr:`reply_to_message` if someone replies to a very first message in a directly created supergroup. channel_chat_created (:obj:`bool`): Optional. Service message: The channel has been created. This field can't be received in a message coming through updates, because bot can't be a member of a channel when it is created. It can only be found in :attr:`reply_to_message` if someone replies to a very first message in a channel. message_auto_delete_timer_changed (:class:`telegram.MessageAutoDeleteTimerChanged`): Optional. Service message: auto-delete timer settings changed in the chat. .. versionadded:: 13.4 migrate_to_chat_id (:obj:`int`): Optional. The group has been migrated to a supergroup with the specified identifier. migrate_from_chat_id (:obj:`int`): Optional. The supergroup has been migrated from a group with the specified identifier. pinned_message (:class:`telegram.Message`): Optional. Specified message was pinned. Note that the Message object in this field will not contain further :attr:`reply_to_message` fields even if it is itself a reply. invoice (:class:`telegram.Invoice`): Optional. Message is an invoice for a payment, information about the invoice. successful_payment (:class:`telegram.SuccessfulPayment`): Optional. Message is a service message about a successful payment, information about the payment. connected_website (:obj:`str`): Optional. The domain name of the website on which the user has logged in. forward_signature (:obj:`str`): Optional. For messages forwarded from channels, signature of the post author if present. author_signature (:obj:`str`): Optional. Signature of the post author for messages in channels, or the custom title of an anonymous group administrator. forward_sender_name (:obj:`str`): Optional. Sender's name for messages forwarded from users who disallow adding a link to their account in forwarded messages. passport_data (:class:`telegram.PassportData`): Optional. Telegram Passport data. Examples: :any:`Passport Bot ` poll (:class:`telegram.Poll`): Optional. Message is a native poll, information about the poll. dice (:class:`telegram.Dice`): Optional. Message is a dice with random value. via_bot (:class:`telegram.User`): Optional. Bot through which message was sent. proximity_alert_triggered (:class:`telegram.ProximityAlertTriggered`): Optional. Service message. A user in the chat triggered another user's proximity alert while sharing Live Location. video_chat_scheduled (:class:`telegram.VideoChatScheduled`): Optional. Service message: video chat scheduled. .. versionadded:: 20.0 video_chat_started (:class:`telegram.VideoChatStarted`): Optional. Service message: video chat started. .. versionadded:: 20.0 video_chat_ended (:class:`telegram.VideoChatEnded`): Optional. Service message: video chat ended. .. versionadded:: 20.0 video_chat_participants_invited (:class:`telegram.VideoChatParticipantsInvited`): Optional. Service message: new participants invited to a video chat. .. versionadded:: 20.0 web_app_data (:class:`telegram.WebAppData`): Optional. Service message: data sent by a Web App. .. versionadded:: 20.0 reply_markup (:class:`telegram.InlineKeyboardMarkup`): Optional. Inline keyboard attached to the message. :paramref:`~telegram.InlineKeyboardButton.login_url` buttons are represented as ordinary url buttons. is_topic_message (:obj:`bool`): Optional. :obj:`True`, if the message is sent to a forum topic. .. versionadded:: 20.0 message_thread_id (:obj:`int`): Optional. Unique identifier of a message thread to which the message belongs; for supergroups only. .. versionadded:: 20.0 forum_topic_created (:class:`telegram.ForumTopicCreated`): Optional. Service message: forum topic created. .. versionadded:: 20.0 forum_topic_closed (:class:`telegram.ForumTopicClosed`): Optional. Service message: forum topic closed. .. versionadded:: 20.0 forum_topic_reopened (:class:`telegram.ForumTopicReopened`): Optional. Service message: forum topic reopened. .. versionadded:: 20.0 forum_topic_edited (:class:`telegram.ForumTopicEdited`): Optional. Service message: forum topic edited. .. versionadded:: 20.0 general_forum_topic_hidden (:class:`telegram.GeneralForumTopicHidden`): Optional. Service message: General forum topic hidden. .. versionadded:: 20.0 general_forum_topic_unhidden (:class:`telegram.GeneralForumTopicUnhidden`): Optional. Service message: General forum topic unhidden. .. versionadded:: 20.0 write_access_allowed (:class:`telegram.WriteAccessAllowed`): Optional. Service message: the user allowed the bot added to the attachment menu to write messages. .. versionadded:: 20.0 has_media_spoiler (:obj:`bool`): Optional. :obj:`True`, if the message media is covered by a spoiler animation. .. versionadded:: 20.0 user_shared (:class:`telegram.UserShared`): Optional. Service message: a user was shared with the bot. .. versionadded:: 20.1 chat_shared (:class:`telegram.ChatShared`): Optional. Service message: a chat was shared with the bot. .. versionadded:: 20.1 .. |custom_emoji_formatting_note| replace:: Custom emoji entities will be ignored by this function. Instead, the supplied replacement for the emoji will be used. .. |custom_emoji_md1_deprecation| replace:: Since custom emoji entities are not supported by :attr:`~telegram.constants.ParseMode.MARKDOWN`, this method will raise a :exc:`ValueError` in future versions instead of falling back to the supplied replacement for the emoji. )H reply_markupaudiocontactmigrate_to_chat_idforward_signaturechatsuccessful_paymentgametextforward_sender_namedocumentnew_chat_title forward_dategroup_chat_createdmedia_group_idcaptionvideoentitiesvia_botnew_chat_membersconnected_website animationmigrate_from_chat_id forward_fromstickerlocationvenue edit_datereply_to_message passport_datapinned_messageforward_from_chatnew_chat_photo message_iddelete_chat_photo from_userauthor_signatureproximity_alert_triggered sender_chatdiceforward_from_message_idcaption_entitiesvoicedatesupergroup_chat_createdpollleft_chat_memberphotochannel_chat_createdinvoice video_note_effective_attachment!message_auto_delete_timer_changedvideo_chat_endedvideo_chat_participants_invitedvideo_chat_startedvideo_chat_scheduledis_automatic_forwardhas_protected_content web_app_datais_topic_messagemessage_thread_idforum_topic_createdforum_topic_closedforum_topic_reopenedforum_topic_editedgeneral_forum_topic_hiddengeneral_forum_topic_unhiddenwrite_access_allowedhas_media_spoiler user_shared chat_sharedN api_kwargsr )HrjrtrNrlr`rhrqrUrerdrQrZrrrJrSrPrxrarYrsr{r\rXrKrbrcrwrTrirkrVruryrLr_rgrzrOrMrmrWr]r^rfrvrRrIrpr[rnrorr~rr}rrrrrrrrrrrrrrrrrcHIstj|Hd||_||_|3|_||_||_||_||_||_ |9|_ | |_ | |_ |:|_ | |_t| |_t| |_||_||_||_t||_||_||_||_||_||_||_||_||_t||_||_||_ t||_!t"||_#t"||_$t"| |_%|"|_&|#|_'t"|!|_(|7|_)|$|_*||_+|%|_,|&|_-|*|_.|'|_/|.|_0|(|_1|)|_2|+|_3|,|_4|-|_5|0|_6|1|_7|2|_8|8|_9|4|_:|5|_;|6|_<|/|_=|;|_>|<|_?|=|_@|>|_A|?|_B|@|_C|A|_D|B|_E|C|_F|D|_G|E|_H|F|_I|G|_JtK|_L|j|jf|_M|NdS)Nr)Osuper__init__rjrlrortrNr`rhrUrrerdrrQr*rZrrrJrPrSrxrarYrsr{rXrKrbrcr\rwrTriboolrkrVrurLr_ryr}rgrqrzrOr]rMrRrmrWr^rfrvrpr[rnrrr~rrIrrrrrrrrrrrrrr-r|Z _id_attrsZ_freeze)IselfrjrtrNrlr`rhrqrUrerdrQrZrrrJrSrPrxrarYrsr{r\rXrKrbrcrwrTrirkrVruryrLr_rgrzrOrMrmrWr]r^rfrvrRrIrpr[rnrorr~rr}rrrrrrrrrrrrrrrrr __class__5/tmp/pip-unpacked-wheel-e3anp165/telegram/_message.pyrsL         zMessage.__init__)returncCs|jjS)zC:obj:`int`: Shortcut for :attr:`telegram.Chat.id` for :attr:`chat`.)rNidrrrrchat_idDszMessage.chat_idcCs|jS)zb :obj:`int`: Shortcut for :attr:`message_id`. .. versionadded:: 20.0 )rjrrrrrIsz Message.idcCsz|jjtjtjfkrv|jjr$|jjndt|jjdd}d|d|j}|j r\|j sb|j rr|d|j }|SdS)aL:obj:`str`: Convenience property. If the chat of the message is not a private chat or normal group, returns a t.me link of the message. .. versionchanged:: 20.3 For messages that are replies or part of a forum topic, the link now points to the corresponding thread view. zc/Nz https://t.me//z?thread=) rNtyper PRIVATEZGROUPusernamestrrrjrrre)rZto_linkZbaselinkrrrlinkRs *z Message.linkr?)databotrcsv||}|sdSt|}t|dd||d<t|d||d<t|d|d|d<t|d||d<t |d||d<t |d ||d <t|d ||d <t|d ||d <t|d |d|d <t |d ||d <t|d|d|d<t |d||d<t |d||d<t |d||d<t|d||d<t |d||d<t|d||d<t|d||d<t|d||d<t|d||d<t|d||d<t|d||d<t|d||d<t |d||d<t|d||d<t |d||d<t|d||d<t |d||d<t|d ||d <t|d!||d!<t|d"||d"<t|d#||d#<t|d$||d$<t|d%||d%<t|d&||d&<t|d'||d'<t|d(||d(<t |d)||d)<t!|d*||d*<t"|d+||d+<t#|d,||d,<t$|d-||d-<t%|d.||d.<t&|d/||d/<t'|d0||d0<t(|d1||d1<t)|d2||d2<t*|d3||d3<t+|d4||d4<t,|d5||d5<t-j||d6S)7z,See :meth:`telegram.TelegramObject.de_json`.Nfromrlrort)tzinforNrZrrr`rhrUrerdrJrSr^rPrxrarYrsr{rKrbrcr\rwrir}rgrzrOrfrvrpr[rnrIrrr~rrrrrrrrrrr)rr).Z _parse_datar+r)de_jsonpopr getr,r Zde_listrHr rr rrrrrrrrrrr"r#r!r$r r%rr7r8r5r6r9rrrrrrr:r'r&r)clsrrZ loc_tzinforrrrfs zMessage.de_jsoncCs>t|jts|jStD]}||r|||_q8qd|_|jS)a7If this message is neither a plain text message nor a status update, this gives the attachment that this message was sent with. This may be one of * :class:`telegram.Audio` * :class:`telegram.Dice` * :class:`telegram.Contact` * :class:`telegram.Document` * :class:`telegram.Animation` * :class:`telegram.Game` * :class:`telegram.Invoice` * :class:`telegram.Location` * :class:`telegram.PassportData` * List[:class:`telegram.PhotoSize`] * :class:`telegram.Poll` * :class:`telegram.Sticker` * :class:`telegram.SuccessfulPayment` * :class:`telegram.Venue` * :class:`telegram.Video` * :class:`telegram.VideoNote` * :class:`telegram.Voice` Otherwise :obj:`None` is returned. .. seealso:: :wiki:`Working with Files and Media ` .. versionchanged:: 20.0 :attr:`dice`, :attr:`passport_data` and :attr:`poll` are now also considered to be an attachment. N) isinstancer|r.r;)rZattachment_typerrreffective_attachments5  zMessage.effective_attachment)quotereply_to_message_idrcCsn|dk r |S|dk r |rj|jSnJt|drF|jrF|jj}nd}|dkr`|jjtjksd|rj|jSdS)z3Modify kwargs for replying with or without quoting.Ndefaults) rjhasattrget_botrrrNrr r)rrrZ default_quoterrr_quoteszMessage._quote)r read_timeout write_timeoutconnect_timeout pool_timeoutr)rQ parse_modedisable_web_page_previewdisable_notificationrrIallow_sending_without_replyrZprotect_contentrrrrrrrrc sB|| |}|j|j||||||||| | | | |||dIdHS)a|Shortcut for:: await bot.send_message(update.effective_message.chat_id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_message`. Keyword Args: quote (:obj:`bool`, optional): If set to :obj:`True`, the message is sent as an actual reply to this message. If ``reply_to_message_id`` is passed, this parameter will be ignored. Default: :obj:`True` in group chats and :obj:`False` in private chats. Returns: :class:`telegram.Message`: On success, instance representing the message posted. rrQrrrrrIrrZrrrrrrrN)rr send_messager)rrQrrrrrIrrZrrrrrrrrrrr reply_texts&# zMessage.reply_text)rQrrrrIrrZrrrrrrrrrc sD|| |}|j|j|tj|||||||| | | | ||dIdHS)aShortcut for:: await bot.send_message( update.effective_message.chat_id, parse_mode=ParseMode.MARKDOWN, *args, **kwargs, ) Sends a message with Markdown version 1 formatting. For the documentation of the arguments, please see :meth:`telegram.Bot.send_message`. Note: :tg-const:`telegram.constants.ParseMode.MARKDOWN` is a legacy mode, retained by Telegram for backward compatibility. You should use :meth:`reply_markdown_v2` instead. Keyword Args: quote (:obj:`bool`, optional): If set to :obj:`True`, the message is sent as an actual reply to this message. If ``reply_to_message_id`` is passed, this parameter will be ignored. Default: :obj:`True` in group chats and :obj:`False` in private chats. Returns: :class:`telegram.Message`: On success, instance representing the message posted. rN)rrrrr<ZMARKDOWNrrQrrrrIrrZrrrrrrrrrrrreply_markdownEs&, zMessage.reply_markdownc sD|| |}|j|j|tj|||||||| | | | ||dIdHS)a(Shortcut for:: await bot.send_message( update.effective_message.chat_id, parse_mode=ParseMode.MARKDOWN_V2, *args, **kwargs, ) Sends a message with markdown version 2 formatting. For the documentation of the arguments, please see :meth:`telegram.Bot.send_message`. Keyword Args: quote (:obj:`bool`, optional): If set to :obj:`True`, the message is sent as an actual reply to this message. If ``reply_to_message_id`` is passed, this parameter will be ignored. Default: :obj:`True` in group chats and :obj:`False` in private chats. Returns: :class:`telegram.Message`: On success, instance representing the message posted. rN)rrrrr<Z MARKDOWN_V2rrrrreply_markdown_v2s&( zMessage.reply_markdown_v2c sD|| |}|j|j|tj|||||||| | | | ||dIdHS)aShortcut for:: await bot.send_message( update.effective_message.chat_id, parse_mode=ParseMode.HTML, *args, **kwargs, ) Sends a message with HTML formatting. For the documentation of the arguments, please see :meth:`telegram.Bot.send_message`. Keyword Args: quote (:obj:`bool`, optional): If set to :obj:`True`, the message is sent as an actual reply to this message. If ``reply_to_message_id`` is passed, this parameter will be ignored. Default: :obj:`True` in group chats and :obj:`False` in private chats. Returns: :class:`telegram.Message`: On success, instance representing the message posted. rN)rrrrr<ZHTMLrrrr reply_htmls&( zMessage.reply_html) rrrrrrrXrrr)rBrCrDrE)rH.)mediarrrrrrrrrrrrXrrrrc s@|||}|j|j||||| | | | |||| ||dIdHS)aShortcut for:: await bot.send_media_group(update.effective_message.chat_id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_media_group`. Keyword Args: quote (:obj:`bool`, optional): If set to :obj:`True`, the media group is sent as an actual reply to this message. If ``reply_to_message_id`` is passed, this parameter will be ignored. Default: :obj:`True` in group chats and :obj:`False` in private chats. Returns: Tuple[:class:`telegram.Message`]: An array of the sent Messages. Raises: :class:`telegram.error.TelegramError` )rrrrrrrrrrrrrXrrrN)rrZsend_media_groupr)rrrrrrrrrrrrrrXrrrrrrreply_media_groups$' zMessage.reply_media_group)filenamerrrrrrr)rxrXrrrIrrrrrr has_spoilerrrrrrrrrc sF|| |}|j|j||||||||| | | |||||| dIdHS)avShortcut for:: await bot.send_photo(update.effective_message.chat_id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_photo`. Keyword Args: quote (:obj:`bool`, optional): If set to :obj:`True`, the photo is sent as an actual reply to this message. If ``reply_to_message_id`` is passed, this parameter will be ignored. Default: :obj:`True` in group chats and :obj:`False` in private chats. Returns: :class:`telegram.Message`: On success, instance representing the message posted. )rrxrXrrrIrrrrrrrrrrrrrN)rrZ send_photor)rrxrXrrrIrrrrrrrrrrrrrrrrr reply_photo7s*% zMessage.reply_photor )rJduration performertitlerXrrrIrthumbrrrrr thumbnailrrrrrrrrcsN|||}|j|j||||||||| | | | || |||||||dIdHS)avShortcut for:: await bot.send_audio(update.effective_message.chat_id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_audio`. Keyword Args: quote (:obj:`bool`, optional): If set to :obj:`True`, the audio is sent as an actual reply to this message. If ``reply_to_message_id`` is passed, this parameter will be ignored. Default: :obj:`True` in group chats and :obj:`False` in private chats. Returns: :class:`telegram.Message`: On success, instance representing the message posted. )rrJrrrrXrrrIrrrrrrrrrrrrrrN)rrZ send_audior)rrJrrrrXrrrIrrrrrrrrrrrrrrrrrr reply_audiors2) zMessage.reply_audior)rSrXrrrIrrdisable_content_type_detectionrrrrrrrrrrrrrrcsJ|||}|j|j||||||||||||||| | | | | dIdHS)aShortcut for:: await bot.send_document(update.effective_message.chat_id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_document`. Keyword Args: quote (:obj:`bool`, optional): If set to :obj:`True`, the document is sent as an actual reply to this message. If ``reply_to_message_id`` is passed, this parameter will be ignored. Default: :obj:`True` in group chats and :obj:`False` in private chats. Returns: :class:`telegram.Message`: On success, instance representing the message posted. )rrSrrXrrrIrrrrrrrrrrrrrrN)rrZ send_documentr)rrSrXrrrIrrrrrrrrrrrrrrrrrrrreply_documents.' zMessage.reply_documentr )r^rwidthheightrrXrrrrIrrrrrrrrrrrrrrrcsP||| } |j|j||||||||| | |||||| | || |||dIdHS)aShortcut for:: await bot.send_animation(update.effective_message.chat_id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_animation`. Keyword Args: quote (:obj:`bool`, optional): If set to :obj:`True`, the animation is sent as an actual reply to this message. If ``reply_to_message_id`` is passed, this parameter will be ignored. Default: :obj:`True` in group chats and :obj:`False` in private chats. Returns: :class:`telegram.Message`: On success, instance representing the message posted. )rr^rrrrrXrrrrIrrrrrrrrrrrrrN)rrZsend_animationr)rr^rrrrrXrrrrIrrrrrrrrrrrrrrrrrreply_animations4+ zMessage.reply_animationr)rarrrIrrremojirrrrrrrc s>|| |}|j|j||||| | | | |||||dIdHS)a|Shortcut for:: await bot.send_sticker(update.effective_message.chat_id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_sticker`. Keyword Args: quote (:obj:`bool`, optional): If set to :obj:`True`, the sticker is sent as an actual reply to this message. If ``reply_to_message_id`` is passed, this parameter will be ignored. Default: :obj:`True` in group chats and :obj:`False` in private chats. Returns: :class:`telegram.Message`: On success, instance representing the message posted. )rrarrrIrrrrrrrrrN)rrZ send_stickerr)rrarrrIrrrrrrrrrrrrr reply_sticker:s"! zMessage.reply_stickerr)rYrrXrrrIrrrsupports_streamingrrrrrrrrrrrrrrrrcsR|||}|j|j||||||||||||| | | || | |||||dIdHS)avShortcut for:: await bot.send_video(update.effective_message.chat_id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_video`. Keyword Args: quote (:obj:`bool`, optional): If set to :obj:`True`, the video is sent as an actual reply to this message. If ``reply_to_message_id`` is passed, this parameter will be ignored. Default: :obj:`True` in group chats and :obj:`False` in private chats. Returns: :class:`telegram.Message`: On success, instance representing the message posted. )rrYrrXrrrIrrrrrrrrrrrrrrrrrrN)rrZ send_videor)rrYrrXrrrIrrrrrrrrrrrrrrrrrrrrrr reply_videoms6+ zMessage.reply_videor)r{rlengthrrrIrrrrrrrrrrrrrc sF|| |}|j|j|||||||||||||| | | | dIdHS)aShortcut for:: await bot.send_video_note(update.effective_message.chat_id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_video_note`. Keyword Args: quote (:obj:`bool`, optional): If set to :obj:`True`, the video note is sent as an actual reply to this message. If ``reply_to_message_id`` is passed, this parameter will be ignored. Default: :obj:`True` in group chats and :obj:`False` in private chats. Returns: :class:`telegram.Message`: On success, instance representing the message posted. )rr{rrrrrIrrrrrrrrrrrN)rrZsend_video_noter)rr{rrrrrIrrrrrrrrrrrrrrrreply_video_notes*& zMessage.reply_video_noter)rsrrXrrrIrrrrrrrrrrrrrrc sF|| |}|j|j|||||||||||||| | | | dIdHS)aShortcut for:: await bot.send_voice(update.effective_message.chat_id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_voice`. Keyword Args: quote (:obj:`bool`, optional): If set to :obj:`True`, the voice note is sent as an actual reply to this message. If ``reply_to_message_id`` is passed, this parameter will be ignored. Default: :obj:`True` in group chats and :obj:`False` in private chats. Returns: :class:`telegram.Message`: On success, instance representing the message posted. )rrsrrXrrrIrrrrrrrrrrrrN)rrZ send_voicer)rrsrrXrrrIrrrrrrrrrrrrrrrr reply_voices*& zMessage.reply_voice)rbrrrrrr)latitude longituderrrI live_periodhorizontal_accuracyheadingproximity_alert_radiusrrrrbrrrrrrrc sH|||}|j|j|||||||||| ||||| | | | dIdHS)aShortcut for:: await bot.send_location(update.effective_message.chat_id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_location`. Keyword Args: quote (:obj:`bool`, optional): If set to :obj:`True`, the location is sent as an actual reply to this message. If ``reply_to_message_id`` is passed, this parameter will be ignored. Default: :obj:`True` in group chats and :obj:`False` in private chats. Returns: :class:`telegram.Message`: On success, instance representing the message posted. )rrrrrrIrrrrrbrrrrrrrrN)rrZ send_locationr)rrrrrrIrrrrrrrrbrrrrrrrrrreply_location,s,& zMessage.reply_location)rcrrrrrr)rrraddress foursquare_idrrrIfoursquare_typegoogle_place_idgoogle_place_typerrrrcrrrrrrrcsL|||}|j|j|||||||||||||| || | | | |dIdHS)avShortcut for:: await bot.send_venue(update.effective_message.chat_id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_venue`. Keyword Args: quote (:obj:`bool`, optional): If set to :obj:`True`, the venue is sent as an actual reply to this message. If ``reply_to_message_id`` is passed, this parameter will be ignored. Default: :obj:`True` in group chats and :obj:`False` in private chats. Returns: :class:`telegram.Message`: On success, instance representing the message posted. )rrrrrrrrrIrrrrrcrrrrrrrN)rrZ send_venuer)rrrrrrrrrIrrrrrrrcrrrrrrrrr reply_venueis0( zMessage.reply_venue)rKrrrrrr) phone_number first_name last_namerrrIvcardrrrrKrrrrrrrc sD|| |}|j|j||||||| |||| |||| | dIdHS)a|Shortcut for:: await bot.send_contact(update.effective_message.chat_id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_contact`. Keyword Args: quote (:obj:`bool`, optional): If set to :obj:`True`, the contact is sent as an actual reply to this message. If ``reply_to_message_id`` is passed, this parameter will be ignored. Default: :obj:`True` in group chats and :obj:`False` in private chats. Returns: :class:`telegram.Message`: On success, instance representing the message posted. )rrrrrrrIrrrrrKrrrrrN)rrZ send_contactr)rrrrrrrIrrrrrKrrrrrrrrr reply_contacts($ zMessage.reply_contact)questionoptions is_anonymousrallows_multiple_answerscorrect_option_id is_closedrrrI explanationexplanation_parse_mode open_period close_daterexplanation_entitiesrrrrrrrrrcsR||| } |j|j||||||||| | ||||| | | ||||||dIdHS)asShortcut for:: await bot.send_poll(update.effective_message.chat_id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_poll`. Keyword Args: quote (:obj:`bool`, optional): If set to :obj:`True`, the poll is sent as an actual reply to this message. If ``reply_to_message_id`` is passed, this parameter will be ignored. Default: :obj:`True` in group chats and :obj:`False` in private chats. Returns: :class:`telegram.Message`: On success, instance representing the message posted. )rrrrrrrrrrrIrrrrrrrrrrrrrN)rrZ send_pollr)rrrrrrrrrrrIrrrrrrrrrrrrrrrrr reply_polls6+ zMessage.reply_poll)rrrIrrrrrrrrrrrcs<|||}|j|j|||| | | | || |||d IdHS)asShortcut for:: await bot.send_dice(update.effective_message.chat_id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_dice`. Keyword Args: quote (:obj:`bool`, optional): If set to :obj:`True`, the dice is sent as an actual reply to this message. If ``reply_to_message_id`` is passed, this parameter will be ignored. Default: :obj:`True` in group chats and :obj:`False` in private chats. Returns: :class:`telegram.Message`: On success, instance representing the message posted. ) rrrrIrrrrrrrrrN)rrZ send_dicer)rrrrIrrrrrrrrrrrrr reply_dice*s zMessage.reply_dice)rrrrr)actionrrrrrrrc s&|j|j|||||||dIdHS)aGShortcut for:: await bot.send_chat_action(update.effective_message.chat_id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_chat_action`. .. versionadded:: 13.2 Returns: :obj:`bool`: On success, :obj:`True` is returned. )rrrrrrrrN)rZsend_chat_actionr)rrrrrrrrrrrreply_chat_action[szMessage.reply_chat_actionr)game_short_namerrrIrrrrrrrrrrcs<|||}|j|j||||| | | | | |||d IdHS)aShortcut for:: await bot.send_game(update.effective_message.chat_id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_game`. Keyword Args: quote (:obj:`bool`, optional): If set to :obj:`True`, the game is sent as an actual reply to this message. If ``reply_to_message_id`` is passed, this parameter will be ignored. Default: :obj:`True` in group chats and :obj:`False` in private chats. .. versionadded:: 13.2 Returns: :class:`telegram.Message`: On success, instance representing the message posted. ) rrrrrIrrrrrrrrN)rrZ send_gamer)rrrrrIrrrrrrrrrrrr reply_game}s " zMessage.reply_gamerF)"r descriptionpayloadprovider_tokencurrencypricesstart_parameter photo_url photo_size photo_width photo_height need_nameneed_phone_number need_emailneed_shipping_address is_flexiblerrrI provider_datasend_phone_number_to_providersend_email_to_providerrmax_tip_amountsuggested_tip_amountsrrrrrrrrrc"#sd|||}|j|j||||||||| | | | | ||||||||||||| |!|||||d!IdHS)aShortcut for:: await bot.send_invoice(update.effective_message.chat_id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_invoice`. Warning: As of API 5.2 :paramref:`start_parameter ` is an optional argument and therefore the order of the arguments had to be changed. Use keyword arguments to make sure that the arguments are passed correctly. .. versionadded:: 13.2 .. versionchanged:: 13.5 As of Bot API 5.2, the parameter :paramref:`start_parameter ` is optional. Keyword Args: quote (:obj:`bool`, optional): If set to :obj:`True`, the invoice is sent as an actual reply to this message. If ``reply_to_message_id`` is passed, this parameter will be ignored. Default: :obj:`True` in group chats and :obj:`False` in private chats. Returns: :class:`telegram.Message`: On success, instance representing the message posted. )!rrrrrrrrrrr r r r r rrrrrIrrrrrrrrrrrrrN)rrZ send_invoicer)"rrrrrrrrrrr r r r r rrrrrIrrrrrrrrrrrrrrrrr reply_invoicesH@ zMessage.reply_invoice) rrrrrrrrrrc s.|j||j|j|||||||| d IdHS)aShortcut for:: await bot.forward_message( from_chat_id=update.effective_message.chat_id, message_id=update.effective_message.message_id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.forward_message`. Note: Since the release of Bot API 5.5 it can be impossible to forward messages from some chats. Use the attributes :attr:`telegram.Message.has_protected_content` and :attr:`telegram.Chat.has_protected_content` to check this. As a workaround, it is still possible to use :meth:`copy`. However, this behaviour is undocumented and might be changed by Telegram. Returns: :class:`telegram.Message`: On success, instance representing the message forwarded. ) r from_chat_idrjrrrrrrrrN)rZforward_messagerrj) rrrrrrrrrrrrrforward s$zMessage.forwardrG)rrXrrrrrrrIrrrrrrrrc s:|j||j|j|||||||| | | ||| | dIdHS)aShortcut for:: await bot.copy_message( chat_id=chat_id, from_chat_id=update.effective_message.chat_id, message_id=update.effective_message.message_id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.copy_message`. Returns: :class:`telegram.MessageId`: On success, returns the MessageId of the sent message. rrrjrXrrrrrrrIrrrrrrrN)r copy_messagerrj)rrrXrrrrrrrIrrrrrrrrrrcopyG s&#z Message.copy)rrjrXrrrrrrrIrrrrrrrrrc sD|| |}|j|j||||||||| | ||||| | dIdHS)aShortcut for:: await bot.copy_message( chat_id=message.chat.id, message_id=message_id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.copy_message`. Keyword Args: quote (:obj:`bool`, optional): If set to :obj:`True`, the copy is sent as an actual reply to this message. If ``reply_to_message_id`` is passed, this parameter will be ignored. Default: :obj:`True` in group chats and :obj:`False` in private chats. .. versionadded:: 13.1 Returns: :class:`telegram.MessageId`: On success, returns the MessageId of the sent message. rN)rrrr)rrrjrXrrrrrrrIrrrrrrrrrrr reply_copy~ s(+ zMessage.reply_copy) rQrrrIrZrrrrrrc s2|j|j|j|||||||| | |dd IdHS)aShortcut for:: await bot.edit_message_text( chat_id=message.chat_id, message_id=message.message_id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.edit_message_text`. Note: You can only edit messages that the bot sent itself (i.e. of the ``bot.send_*`` family of methods) or channel posts, if the bot is an admin in that channel. However, this behaviour is undocumented and might be changed by Telegram. Returns: :class:`telegram.Message`: On success, if edited message is sent by the bot, the edited Message is returned, otherwise ``True`` is returned. N) rrjrQrrrIrrrrrrZinline_message_id)rZedit_message_textrrj) rrQrrrIrZrrrrrrrr edit_text s zMessage.edit_text) rXrIrrrrrrrrrc s0|j|j|j|||||||| |dd IdHS)aShortcut for:: await bot.edit_message_caption( chat_id=message.chat_id, message_id=message.message_id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.edit_message_caption`. Note: You can only edit messages that the bot sent itself (i.e. of the ``bot.send_*`` family of methods) or channel posts, if the bot is an admin in that channel. However, this behaviour is undocumented and might be changed by Telegram. Returns: :class:`telegram.Message`: On success, if edited message is sent by the bot, the edited Message is returned, otherwise ``True`` is returned. N) rrjrXrIrrrrrrrrr)rZedit_message_captionrrj) rrXrIrrrrrrrrrrr edit_caption s zMessage.edit_captionrA)rrIrrrrrrc s,|j||j|j||||||dd IdHS)aShortcut for:: await bot.edit_message_media( chat_id=message.chat_id, message_id=message.message_id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.edit_message_media`. Note: You can only edit messages that the bot sent itself(i.e. of the ``bot.send_*`` family of methods) or channel posts, if the bot is an admin in that channel. However, this behaviour is undocumented and might be changed by Telegram. Returns: :class:`telegram.Message`: On success, if edited message is not an inline message, the edited Message is returned, otherwise ``True`` is returned. N) rrrjrIrrrrrr)rZedit_message_mediarrj)rrrIrrrrrrrr edit_media szMessage.edit_media)rIrrrrrrc s*|j|j|j||||||dd IdHS)aShortcut for:: await bot.edit_message_reply_markup( chat_id=message.chat_id, message_id=message.message_id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.edit_message_reply_markup`. Note: You can only edit messages that the bot sent itself (i.e. of the ``bot.send_*`` family of methods) or channel posts, if the bot is an admin in that channel. However, this behaviour is undocumented and might be changed by Telegram. Returns: :class:`telegram.Message`: On success, if edited message is sent by the bot, the edited Message is returned, otherwise ``True`` is returned. N rrjrIrrrrrr)rZedit_message_reply_markuprrjrrIrrrrrrrredit_reply_markupH szMessage.edit_reply_markup)rbrrrrr) rrrIrrrrbrrrrrrc s6|j|j|j|||||| | | | |||ddIdHS)aShortcut for:: await bot.edit_message_live_location( chat_id=message.chat_id, message_id=message.message_id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.edit_message_live_location`. Note: You can only edit messages that the bot sent itself (i.e. of the ``bot.send_*`` family of methods) or channel posts, if the bot is an admin in that channel. However, this behaviour is undocumented and might be changed by Telegram. Returns: :class:`telegram.Message`: On success, if edited message is sent by the bot, the edited Message is returned, otherwise :obj:`True` is returned. N)rrjrrrbrIrrrrrrrrr)rZedit_message_live_locationrrj) rrrrIrrrrbrrrrrrrredit_live_locationp s""zMessage.edit_live_locationc s*|j|j|j||||||dd IdHS)aShortcut for:: await bot.stop_message_live_location( chat_id=message.chat_id, message_id=message.message_id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.stop_message_live_location`. Note: You can only edit messages that the bot sent itself (i.e. of the ``bot.send_*`` family of methods) or channel posts, if the bot is an admin in that channel. However, this behaviour is undocumented and might be changed by Telegram. Returns: :class:`telegram.Message`: On success, if edited message is sent by the bot, the edited Message is returned, otherwise :obj:`True` is returned. Nr )rZstop_message_live_locationrrjr!rrrstop_live_location szMessage.stop_live_location) user_idscoreforcedisable_edit_messagerrrrrrc s0|j|j|j||||||||| dd IdHS)aShortcut for:: await bot.set_game_score( chat_id=message.chat_id, message_id=message.message_id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.set_game_score`. Note: You can only edit messages that the bot sent itself (i.e. of the ``bot.send_*`` family of methods) or channel posts, if the bot is an admin in that channel. However, this behaviour is undocumented and might be changed by Telegram. Returns: :class:`telegram.Message`: On success, if edited message is sent by the bot, the edited Message is returned, otherwise :obj:`True` is returned. N) rrjr%r&r'r(rrrrrr)rset_game_scorerrj) rr%r&r'r(rrrrrrrrr) szMessage.set_game_score)r@.)r%rrrrrrc s*|j|j|j||||||dd IdHS)a{Shortcut for:: await bot.get_game_high_scores( chat_id=message.chat_id, message_id=message.message_id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.get_game_high_scores`. Note: You can only edit messages that the bot sent itself (i.e. of the ``bot.send_*`` family of methods) or channel posts, if the bot is an admin in that channel. However, this behaviour is undocumented and might be changed by Telegram. Returns: Tuple[:class:`telegram.GameHighScore`] N) rrjr%rrrrrr)rget_game_high_scoresrrj)rr%rrrrrrrrr* szMessage.get_game_high_scores)rrrrrrc s&|j|j|j|||||dIdHS)a\Shortcut for:: await bot.delete_message( chat_id=message.chat_id, message_id=message.message_id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.delete_message`. Returns: :obj:`bool`: On success, :obj:`True` is returned. rrjrrrrrN)rZdelete_messagerrjrrrrrrrrrdelete szMessage.deletec s(|j|j|j||||||dIdHS)aShortcut for:: await bot.stop_poll( chat_id=message.chat_id, message_id=message.message_id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.stop_poll`. Returns: :class:`telegram.Poll`: On success, the stopped Poll with the final results is returned. )rrjrIrrrrrN)r stop_pollrrjr!rrrr.? szMessage.stop_poll)rrrrrrrc s(|j|j|j||||||dIdHS)a`Shortcut for:: await bot.pin_chat_message( chat_id=message.chat_id, message_id=message.message_id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.pin_chat_message`. Returns: :obj:`bool`: On success, :obj:`True` is returned. )rrjrrrrrrN)rZpin_chat_messagerrj)rrrrrrrrrrpina sz Message.pinc s&|j|j|j|||||dIdHS)adShortcut for:: await bot.unpin_chat_message( chat_id=message.chat_id, message_id=message.message_id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.unpin_chat_message`. Returns: :obj:`bool`: On success, :obj:`True` is returned. r+N)rZunpin_chat_messagerrjr,rrrunpin sz Message.unpin)nameicon_custom_emoji_idrrrrrrc s*|j|j|j|||||||d IdHS)aShortcut for:: await bot.edit_forum_topic( chat_id=message.chat_id, message_thread_id=message.message_thread_id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.edit_forum_topic`. .. versionadded:: 20.0 Returns: :obj:`bool`: On success, :obj:`True` is returned. ) rrr1r2rrrrrN)redit_forum_topicrr)rr1r2rrrrrrrrr3 szMessage.edit_forum_topicc s&|j|j|j|||||dIdHS)aShortcut for:: await bot.close_forum_topic( chat_id=message.chat_id, message_thread_id=message.message_thread_id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.close_forum_topic`. .. versionadded:: 20.0 Returns: :obj:`bool`: On success, :obj:`True` is returned. rrrrrrrN)rclose_forum_topicrrr,rrrr5 szMessage.close_forum_topicc s&|j|j|j|||||dIdHS)aShortcut for:: await bot.reopen_forum_topic( chat_id=message.chat_id, message_thread_id=message.message_thread_id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.reopen_forum_topic`. .. versionadded:: 20.0 Returns: :obj:`bool`: On success, :obj:`True` is returned. r4N)rreopen_forum_topicrrr,rrrr6 szMessage.reopen_forum_topicc s&|j|j|j|||||dIdHS)aShortcut for:: await bot.delete_forum_topic( chat_id=message.chat_id, message_thread_id=message.message_thread_id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.delete_forum_topic`. .. versionadded:: 20.0 Returns: :obj:`bool`: On success, :obj:`True` is returned. r4N)rdelete_forum_topicrrr,rrrr7 szMessage.delete_forum_topicc s&|j|j|j|||||dIdHS)aShortcut for:: await bot.unpin_all_forum_topic_messages( chat_id=message.chat_id, message_thread_id=message.message_thread_id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.unpin_all_forum_topic_messages`. .. versionadded:: 20.0 Returns: :obj:`bool`: On success, :obj:`True` is returned. r4N)runpin_all_forum_topic_messagesrrr,rrrr8- sz&Message.unpin_all_forum_topic_messages)entityrcCsB|jstd|jd}||jd|j|jd}|dS)aReturns the text from a given :class:`telegram.MessageEntity`. 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 ``Message.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 this message. Returns: :obj:`str`: The text of the given entity. Raises: RuntimeError: If the message has no text. zThis Message has no 'text'. utf-16-le)rQ RuntimeErrorencodeoffsetrdecoderr9Z entity_textrrr parse_entityO s  zMessage.parse_entitycCsB|jstd|jd}||jd|j|jd}|dS)aReturns the text from a given :class:`telegram.MessageEntity`. 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 ``Message.caption`` 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 this message. Returns: :obj:`str`: The text of the given entity. Raises: RuntimeError: If the message has no caption. zThis Message has no 'caption'.r:r;)rXr<r=r>rr?r@rrrparse_caption_entityi s  zMessage.parse_caption_entity)typesrcs$dkrtjfddjDS)ai Returns a :obj:`dict` that maps :class:`telegram.MessageEntity` to :obj:`str`. It contains entities from this message filtered by their :attr:`telegram.MessageEntity.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 :class:`telegram.MessageEntity` types as strings. If the ``type`` attribute of an entity is contained in this list, it will be returned. Defaults to a list of all types. All types can be found as constants in :class:`telegram.MessageEntity`. 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. Ncs"i|]}|jkr||qSr)rrA.0r9rrCrr s z*Message.parse_entities..)r ALL_TYPESrZrFrrFrparse_entities s  zMessage.parse_entitiescs$dkrtjfddjDS)a{ Returns a :obj:`dict` that maps :class:`telegram.MessageEntity` to :obj:`str`. It contains entities from this message's caption filtered by their :attr:`telegram.MessageEntity.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:`caption_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 :class:`telegram.MessageEntity` types as strings. If the ``type`` attribute of an entity is contained in this list, it will be returned. Defaults to a list of all types. All types can be found as constants in :class:`telegram.MessageEntity`. 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. Ncs"i|]}|jkr||qSr)rrBrDrFrrrG s z2Message.parse_caption_entities..)r rHrrrFrrFrparse_caption_entities s  zMessage.parse_caption_entitiesFr) message_textrZurledr>rc s|dkr dS|d}d}d}t|ddd}g}|D]L\}|kr:fdd|D} |t| |} t|} | rtj| | |j d } j t j krd j d | d } n`j t jkrjrd jjd | d } n4j t jkr|rd | d | d } n j t jkr*d| d} nj t jkrFd| d} n҈j t jkrbd| d} nj t jkrjrdjd | d} n d| d} n|j t jkrd| d} n`j t jkrd| d} nDj t jkrd| d} n(j t jkrdjd | d} n| } |dkrP|t||d j |d d| 7}n(|||d j |d d| 7}j |j}q:|dkr|t||d dd7}n|||d dd7}|S)!Nr:rcSs |djSNrr>itemrrr z%Message._parse_html..keycsBi|]:\}}|jjkr|j|jjjkr|kr||qSrr>rrEetr9rrrG s  z'Message._parse_html..)rLr>z zzz
z
zzzzzzzrcst|}|dkrdS|d}d}d}t|ddd}g}|D].\} |krBfdd|D} |t| t| |d } | r|d krtd t j | | |j |d } j t jkr|d krʈj} ntj|t jd} d| d| d} n j t jkr"jr"d| djjd} n܈j t jkr^|r^|d krD| n| }d|d| d} nj t jkr|d| d} nj t jkrd| d} ndj t jkrdt| |t jd} n<j t jkrt| |t jd}jrdjd}n|dr d}nd}||d} nj t jkrL|d kr>tdd| d} nj t jkrz|d krltdd| d} nj t jkr|d krtdd| d} nVj t jkr|d kr| } td d!td"n$tj |t jd}d#| d$|d} n| } |dkr:|t||d j |d !d|d | 7}n(|||d j |d !d| 7}j |j"}qB|dkr|t||d d!d|d 7}n|||d d!d7}|S)%Nr:rMrcSs |djSrNrOrPrrrrR rSz)Message._parse_markdown..rTcsBi|]:\}}|jjkr|j|jjjkr|kr||qSrrVrWrZrrrG s  z+Message._parse_markdown..)rr;z8Nested entities are not supported for Markdown version 1)rLr>rr~)rZ entity_type[z]()z](tg://user?id=*_`z``` \z``` z;Underline entities are not supported for Markdown version 1__z?Strikethrough entities are not supported for Markdown version 1~z9Spoiler entities are not supported for Markdown version 1z||zCustom emoji entities are not supported for Markdown version 1. Future version of PTB will raise a ValueError instead of falling back to the alternative standard emoji.) stacklevelcategoryz![z](tg://emoji?id=)#intr=r[r\r]r^r_r= ValueErrorrH_parse_markdownr>rr rarbrcrdrrerfrgrhrirj startswithrkrlrmrnr4r>ror?r)rKrZrLrr>Z markdown_textrprqrrrQrsrurbrvrcodeprefixrorrZrrn s                zMessage._parse_markdowncCs|j|j|ddS)ayCreates an Markdown-formatted string from the markup entities found in the message using :class:`telegram.constants.ParseMode.MARKDOWN`. Use this if you want to retrieve the message text with the entities formatted as Markdown in the same way the original message was formatted. Note: * :tg-const:`telegram.constants.ParseMode.MARKDOWN` is a legacy mode, retained by Telegram for backward compatibility. You should use :meth:`text_markdown_v2` instead. * |custom_emoji_formatting_note| .. deprecated:: 20.3 |custom_emoji_md1_deprecation| Returns: :obj:`str`: Message text with entities formatted as Markdown. Raises: :exc:`ValueError`: If the message contains underline, strikethrough, spoiler or nested entities. FrwrrQrIrrrr text_markdownszMessage.text_markdowncCs|j|j|dddS)aNCreates an Markdown-formatted string from the markup entities found in the message using :class:`telegram.constants.ParseMode.MARKDOWN_V2`. Use this if you want to retrieve the message text with the entities formatted as Markdown in the same way the original message was formatted. .. versionchanged:: 13.10 Spoiler entities are now formatted as Markdown V2. .. versionchanged:: 20.3 Custom emoji entities are now supported. Returns: :obj:`str`: Message text with entities formatted as Markdown. Fr;rLrrrrrrtext_markdown_v2!szMessage.text_markdown_v2cCs|j|j|ddS)aCreates an Markdown-formatted string from the markup entities found in the message using :class:`telegram.constants.ParseMode.MARKDOWN`. Use this if you want to retrieve the message text with the entities formatted as Markdown. This also formats :attr:`telegram.MessageEntity.URL` as a hyperlink. Note: * :tg-const:`telegram.constants.ParseMode.MARKDOWN` is a legacy mode, retained by Telegram for backward compatibility. You should use :meth:`text_markdown_v2_urled` instead. * |custom_emoji_formatting_note| .. deprecated:: 20.3 |custom_emoji_md1_deprecation| Returns: :obj:`str`: Message text with entities formatted as Markdown. Raises: :exc:`ValueError`: If the message contains underline, strikethrough, spoiler or nested entities. Trwrrrrrtext_markdown_urled4szMessage.text_markdown_urledcCs|j|j|dddS)a`Creates an Markdown-formatted string from the markup entities found in the message using :class:`telegram.constants.ParseMode.MARKDOWN_V2`. Use this if you want to retrieve the message text with the entities formatted as Markdown. This also formats :attr:`telegram.MessageEntity.URL` as a hyperlink. .. versionchanged:: 13.10 Spoiler entities are now formatted as Markdown V2. .. versionchanged:: 20.3 Custom emoji entities are now supported. Returns: :obj:`str`: Message text with entities formatted as Markdown. Tr;rrrrrrtext_markdown_v2_urledPszMessage.text_markdown_v2_urledcCs|j|j|ddS)aCreates an Markdown-formatted string from the markup entities found in the message's caption using :class:`telegram.constants.ParseMode.MARKDOWN`. Use this if you want to retrieve the message caption with the caption entities formatted as Markdown in the same way the original message was formatted. Note: * :tg-const:`telegram.constants.ParseMode.MARKDOWN` is a legacy mode, retained by Telegram for backward compatibility. You should use :meth:`caption_markdown_v2` instead. * |custom_emoji_formatting_note| .. deprecated:: 20.3 |custom_emoji_md1_deprecation| Returns: :obj:`str`: Message caption with caption entities formatted as Markdown. Raises: :exc:`ValueError`: If the message contains underline, strikethrough, spoiler or nested entities. FrwrrXrJrrrrcaption_markdowncszMessage.caption_markdowncCs|j|j|dddS)anCreates an Markdown-formatted string from the markup entities found in the message's caption using :class:`telegram.constants.ParseMode.MARKDOWN_V2`. Use this if you want to retrieve the message caption with the caption entities formatted as Markdown in the same way the original message was formatted. .. versionchanged:: 13.10 Spoiler entities are now formatted as Markdown V2. .. versionchanged:: 20.3 Custom emoji entities are now supported. Returns: :obj:`str`: Message caption with caption entities formatted as Markdown. Fr;rrrrrrcaption_markdown_v2s zMessage.caption_markdown_v2cCs|j|j|ddS)aCreates an Markdown-formatted string from the markup entities found in the message's caption using :class:`telegram.constants.ParseMode.MARKDOWN`. Use this if you want to retrieve the message caption with the caption entities formatted as Markdown. This also formats :attr:`telegram.MessageEntity.URL` as a hyperlink. Note: * :tg-const:`telegram.constants.ParseMode.MARKDOWN` is a legacy mode, retained by Telegram for backward compatibility. You should use :meth:`caption_markdown_v2_urled` instead. * |custom_emoji_formatting_note| .. deprecated:: 20.3 |custom_emoji_md1_deprecation| Returns: :obj:`str`: Message caption with caption entities formatted as Markdown. Raises: :exc:`ValueError`: If the message contains underline, strikethrough, spoiler or nested entities. Trwrrrrrcaption_markdown_urledszMessage.caption_markdown_urledcCs|j|j|dddS)aCreates an Markdown-formatted string from the markup entities found in the message's caption using :class:`telegram.constants.ParseMode.MARKDOWN_V2`. Use this if you want to retrieve the message caption with the caption entities formatted as Markdown. This also formats :attr:`telegram.MessageEntity.URL` as a hyperlink. .. versionchanged:: 13.10 Spoiler entities are now formatted as Markdown V2. .. versionchanged:: 20.3 Custom emoji entities are now supported. Returns: :obj:`str`: Message caption with caption entities formatted as Markdown. Tr;rrrrrrcaption_markdown_v2_urleds z!Message.caption_markdown_v2_urled)DNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNN)N)N)N)NNNNNN)N)NN)N)NN)N)N)Fr)Fr~r)__name__ __module__ __qualname____doc__ __slots__rdatetimer r)rrr rrrrrrrrrrrr"r#r r!r$rr r%r8r5r6rr7r9rrrrrrr:r'r&r1rpropertyrrrr classmethodrr rrr-r2r/r3floatrrrrrrr0rrrrrrrrrrrrrrrobjectrrrrrrrr"r#r$r)r*r-r.r/r0r3r5r6r7r8r rArBrrrIrJ staticmethodr`ryrzr|r}rrrrrrrrr __classcell__rrrrrHYs, yPJ) Q@  :  C  ?  A  =  >  F  B  I   6  J  ?  > ? C  =  I  4 %  ;  h  5   ;  C 2 2 - *  6 ,  1  * ! $ $ ! ) % % % "  ` rH)qrrhtmlrtypingrrrrrrr Ztelegram._chatr Ztelegram._dicer Ztelegram._files.animationr Ztelegram._files.audior Ztelegram._files.contactrZtelegram._files.documentrZtelegram._files.locationrZtelegram._files.photosizerZtelegram._files.stickerrZtelegram._files.venuerZtelegram._files.videorZtelegram._files.videonoterZtelegram._files.voicerZtelegram._forumtopicrrrrrrZtelegram._games.gamerZ%telegram._inline.inlinekeyboardmarkuprZ'telegram._messageautodeletetimerchangedrZtelegram._messageentityr Ztelegram._passport.passportdatar!Ztelegram._payment.invoicer"Z#telegram._payment.successfulpaymentr#Ztelegram._pollr$Z!telegram._proximityalerttriggeredr%Ztelegram._sharedr&r'Ztelegram._telegramobjectr(Ztelegram._userr)Ztelegram._utils.argumentparsingr*Ztelegram._utils.datetimer+r,Ztelegram._utils.defaultvaluer-r.Ztelegram._utils.typesr/r0r1r2r3Ztelegram._utils.warningsr4Ztelegram._videochatr5r6r7r8Ztelegram._webappdatar9Ztelegram._writeaccessallowedr:Ztelegram.constantsr;r<Ztelegram.helpersr=Ztelegram.warningsr>Ztelegramr?r@rArBrCrDrErFrGrHrrrrsV $                               ,