o "h#@sdZddlZddlmZddlmZddlmZm Z m Z m Z ddl m Z ddlmZddlmZdd lmZdd lmZdd lmZdd lmZdd lmZddlmZmZmZm Z m!Z!m"Z"ddl#m$Z$ddl#m%Z&ddl#m'Z(erddl m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;mZ>m?Z?m@Z@mAZAmBZBmCZCmDZDmEZEGdddeZFGdddeFZGdS)z?This module contains an object that represents a Telegram Chat.N)Sequence)escape) TYPE_CHECKINGFinalOptionalUnion) constants)ChatPermissions) ForumTopic) MenuButton) ReactionType)TelegramObject)enum) DEFAULT_NONE)CorrectOptionID FileInputJSONDictODVInput ReplyMarkup TimePeriod)escape_markdown) mention_html)mention_markdown) AnimationAudioChatInviteLink ChatMemberContactDocumentGiftInlineKeyboardMarkupInputChecklistInputMediaAudioInputMediaDocumentInputMediaPhotoInputMediaVideoInputPaidMediaInputPollOption LabeledPriceLinkPreviewOptionsLocationMessage MessageEntity MessageId PhotoSizeReplyParametersStickerUserChatBoostsVenueVideo VideoNoteVoicecJs*eZdZUdZdZ     dvdddededeedeed eed eed eed ee ffd dZ e j j Z eeed< e j jZeeed< e j jZeeed< e j jZeeed< e j jZeeed< edeefddZedeefddZedeefddZdwdeedefddZdwdeedefddZdwdeedefd d!Zeeeedd"d#eed$eed%eed&eed ee def d'd(Zeeeedd"d#eed$eed%eed&eed ee ded)f d*d+Z eeeedd"d#eed$eed%eed&eed ee def d,d-Z!eeeedd"d.ed#eed$eed%eed&eed ee dd/fd0d1Z"  dxeeeedd"d.ed2eed3ee#ee$j%fd#eed$eed%eed&eed ee defd4d5Z&eeeedd"d6ed#eed$eed%eed&eed ee defd7d8Z'eeeedd"d9e#eefd#eed$eed%eed&eed ee defd:d;Z(eeeedd"d6ed#eed$eed%eed&eed ee defdd?Z* dweeeedd"d.ed@eed#eed$eed%eed&eed ee defdAdBZ+               dyeeeedd"d.edCeedDeedEeedFeedGeedHeedIeedJeedKeedLeedMeedNeedOeedPeedQeed#eed$eed%eed&eed ee def,dRdSZ,  dxeeeedd"d.edTe-d3ee#ee$j%fdUeed#eed$eed%eed&eed ee defdVdWZ. dweeeedd"dTe-dUeed#eed$eed%eed&eed ee defdXdYZ/eeeedd"d.edZed#eed$eed%eed&eed ee defd[d\Z0eeeedd"d]e1d#eed$eed%eed&eed ee defd^d_Z2eeeedd"d#eed$eed%eed&eed ee def d`daZ3eeeedd"ded#eed$eed%eed&eed ee defdbdcZ4 dweeeedd"ddeed#eed$eed%eed&eed ee defdedfZ5edfeeeedd"dgedheedieed#eed$eed%eed&eed ee defdjdkZ6  dxeeeedd"dgeedieed#eed$eed%eed&eed ee defdldmZ7eeeedd"d#eed$eed%eed&eed ee def dndoZ8eeddededdddf dedeeeeddpdqedreedheedsee9dtee:dudveedweedxedydzed{dieed|eed}eed~eedeedeed#eed$eed%eed&eed ee ddf*ddZ;eeeedd"dged#eed$eed%eed&eed ee defddZ  dxeeeedd"dedweedieed#eed$eed%eed&eed ee defddZ?e?Z@ dedededddddddf dedeeeeddd]e#e1dfdeedheedsee9dreedee:dudveedweedeedzed{dieed|eed}eedeed~eedeedeed#eed$eed%eed&eed ee ddf.ddZAdddeddedddddf dedeeeedddeed eed eedheedsee9deedveedweedzed{dieed|eed}eed~eedeededd#eed$eed%eed&eed ee ddf*ddZBddddedededdddddfdedeeeeddde#e1dfdeeCdeedeedeedheedsee9dreedee:dudveedweedee1dzed{dieed|eed}eed~eedeedeed#eed$eed%eed&eed ee ddf2ddZDdededdeddddddf dedeeeeddde#e1dfdeedheedsee9dreedeedee:dudveedweedee1dzed{dieed|eed}eed~eedeedeed#eed$eed%eed&eed ee ddf.ddZEededdfdeeeeedddiedddheedseddveedzed{d|eed~eedeed#eed$eed%eed&eed ee ddfddZFeddedddddf deeeeedddheedsee9deedveedweedzed{dieed|eed}eed~eedeed#eed$eed%eed&eed ee ddf"ddZGededddddfdeeeeedddedheedseddveedweedzed{dieed|eed}eed~eedeed#eed$eed%eed&eed ee ddf"ddZHdddddddddddeddddddeddddfdeeeeedddeddededede:ddeedeedeedeedeedeedeedeedeedeedeedheedseddee#eeIfdeedeedeedee:edveedweedzed{d|eed}eed~eedeed#eed$eed%eed&eed ee ddfHddτZJddedddddedddddfdedeeeeddМdeedeedheedsee9deeCdeedeedeedveedweedzed{dieed|eed}eed~eedeededd#eed$eed%eed&eed ee ddf.ddڄZKddddeeddeddddddddfdedeeeeddde#e1dfdeeCdeedeedeedreedheedsee9dee:dudveedweedeedee1dzed{dieed|eed}eedeed~eedeedeed#eed$eed%eed&eed ee ddf6ddZLededdddddf deeeeeddde#e1dfdheedsee9dveedweedeedzed{dieed|eed}eed~eedeed#eed$eed%eed&eed ee ddf$ddZMdddddeddddedddddfdedeeeedddeedeedeedeedeedheedsee9deedeedeedveedweedzed{dieed|eed}eed~eedeededd#eed$eed%eed&eed ee ddf2ddZNddedddeddeddddddddddfdedeeeeddde#e1dfdeeCdeedheedsee9deedeedreedeedee:dudveedweedeedee1dzed{dieed|eed}eedeedee1deed~eedeedeed#eed$eed%eed&eed ee ddfeed#eed$eed%eed&eed ee deffd?d@Zg  dxeeeedd"dwedeed>eed#eed$eed%eed&eed ee defdAdBZheeeedd"dwed#eed$eed%eed&eed ee defdCdDZieeeedd"dwed#eed$eed%eed&eed ee defdEdFZjeeeedd"dwed#eed$eed%eed&eed ee defdGdHZkeeeedd"dwed#eed$eed%eed&eed ee defdIdJZleeeedd"d#eed$eed%eed&eed ee def dKdLZmeeeedd"ded#eed$eed%eed&eed ee defdMdNZneeeedd"d#eed$eed%eed&eed ee def dOdPZoeeeedd"d#eed$eed%eed&eed ee def dQdRZpeeeedd"d#eed$eed%eed&eed ee def dSdTZqeeeedd"d#eed$eed%eed&eed ee def dUdVZreeeedd"d#eed$eed%eed&eed ee dedf dWdXZseeeedd"d.ed#eed$eed%eed&eed ee ddYfdZd[Zt  dxeeeedd"dged\ee#e:e#euefeuefd]eed#eed$eed%eed&eed ee defd^d_Zvdeddeedddddf edeeeedd`daede:dbdeedreedee:dudeedheedveedzed{dsee9dieedeed}eedeed~eed#eed$eed%eed&eed ee ddf*dcddZwdeddfeeeedd"dee#edffdqeedgeedhee:dudieed#eed$eed%eed&eed ee defdjdkZx dweeeedd"diedledaeed#eed$eed%eed&eed ee defdmdnZy dweeeedd"doeed#eed$eed%eed&eed ee defdpdqZzeeeedd"d#eed$eed%eed&eed ee def drdsZ{eeeedd"diedged#eed$eed%eed&eed ee defdtduZ|Z}S({ _ChatBasezjBase class for :class:`telegram.Chat` and :class:`telegram.ChatFullInfo`. .. versionadded:: 21.3 ) first_nameidis_forum last_nametitletypeusernameN api_kwargsr8r<r;r=r7r:r9r?c sZtj|d||_ttj|||_||_||_ ||_ ||_ ||_ |jf|_ |dS)Nr>)super__init__r8r get_memberrChatTyper<r;r=r7r:r9 _id_attrs_freeze) selfr8r<r;r=r7r:r9r? __class__A/var/www/html/venv/lib/python3.10/site-packages/telegram/_chat.pyrAXs   z_ChatBase.__init__SENDERPRIVATEGROUP SUPERGROUPCHANNELreturncCs$|jdur|jS|jdur|jSdS)z :obj:`str`: Convenience property. Gives :attr:`~Chat.title` if not :obj:`None`, else :attr:`~Chat.full_name` if not :obj:`None`. .. versionadded:: 20.1 N)r; full_namerFrIrIrJeffective_names  z_ChatBase.effective_namecCs(|jsdS|jr|jd|jS|jS)a] :obj:`str`: Convenience property. If :attr:`~Chat.first_name` is not :obj:`None`, gives :attr:`~Chat.first_name` followed by (if available) :attr:`~Chat.last_name`. Note: :attr:`full_name` will always be :obj:`None`, if the chat is a (super)group or channel. .. versionadded:: 13.2 N )r7r:rRrIrIrJrQs  z_ChatBase.full_namecCs|jr d|jSdS)z}:obj:`str`: Convenience property. If the chat has a :attr:`~Chat.username`, returns a t.me link of the chat. z https://t.me/N)r=rRrIrIrJlinks z_ChatBase.linknamecCs|j|jkr|rt|j|S|jrt|j|jStd|jr=|r+d|d|jdS|jr9d|jd|jdStdtd)a Note: :tg-const:`telegram.constants.ParseMode.MARKDOWN` is a legacy mode, retained by Telegram for backward compatibility. You should use :meth:`mention_markdown_v2` instead. .. versionadded:: 20.0 Args: name (:obj:`str`): The name used as a link for the chat. Defaults to :attr:`~Chat.full_name`. Returns: :obj:`str`: The inline mention for the chat as markdown (version 1). Raises: :exc:`TypeError`: If the chat is a private chat and neither the :paramref:`name` nor the :attr:`~Chat.first_name` is set, then throw an :exc:`TypeError`. If the chat is a public chat and neither the :paramref:`name` nor the :attr:`~Chat.title` is set, then throw an :exc:`TypeError`. If chat is a private group chat, then throw an :exc:`TypeError`. =Can not create a mention to a private chat without first name[]()7Can not create a mention to a public chat without title0Can not create a mention to a private group chat) r<rLhelpers_mention_markdownr8rQ TypeErrorr=rUr;rFrVrIrIrJrs  z_ChatBase.mention_markdowncCs|j|jkr |rt|j|ddS|jrt|j|jddStd|jrI|r3dt|ddd|jdS|j rEdt|j ddd|jdStdtd) a .. versionadded:: 20.0 Args: name (:obj:`str`): The name used as a link for the chat. Defaults to :attr:`~Chat.full_name`. Returns: :obj:`str`: The inline mention for the chat as markdown (version 2). Raises: :exc:`TypeError`: If the chat is a private chat and neither the :paramref:`name` nor the :attr:`~Chat.first_name` is set, then throw an :exc:`TypeError`. If the chat is a public chat and neither the :paramref:`name` nor the :attr:`~Chat.title` is set, then throw an :exc:`TypeError`. If chat is a private group chat, then throw an :exc:`TypeError`. )versionrWrXrYrZr[r\) r<rLr]r8rQr^r=rrUr;r_rIrIrJmention_markdown_v2s z_ChatBase.mention_markdown_v2cCs|j|jkr|rt|j|S|jrt|j|jStd|jrA|r-d|jdt|dS|j r=d|jdt|j dStdtd)a .. versionadded:: 20.0 Args: name (:obj:`str`): The name used as a link for the chat. Defaults to :attr:`full_name`. Returns: :obj:`str`: The inline mention for the chat as HTML. Raises: :exc:`TypeError`: If the chat is a private chat and neither the :paramref:`name` nor the :attr:`~Chat.first_name` is set, then throw an :exc:`TypeError`. If the chat is a public chat and neither the :paramref:`name` nor the :attr:`~Chat.title` is set, then throw an :exc:`TypeError`. If chat is a private group chat, then throw an :exc:`TypeError`. rWz zr[r\) r<rLhelpers_mention_htmlr8rQr^r=rUrr;r_rIrIrJrs  z_ChatBase.mention_html) read_timeout write_timeoutconnect_timeout pool_timeoutr?rdrerfrgc$|j|j|||||dIdHS)aShortcut for:: await bot.leave_chat(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.leave_chat`. Returns: :obj:`bool`: On success, :obj:`True` is returned. chat_idrdrerfrgr?N)get_bot leave_chatr8rFrdrerfrgr?rIrIrJleave z_ChatBase.leave)r.crh)a]Shortcut for:: await bot.get_chat_administrators(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.get_chat_administrators`. Returns: tuple[:class:`telegram.ChatMember`]: A tuple of administrators in a chat. An Array of :class:`telegram.ChatMember` objects that contains information about all chat administrators except other bots. If the chat is a group or a supergroup and no administrators were appointed, only the creator will be returned. riN)rkget_chat_administratorsr8rmrIrIrJget_administrators- z_ChatBase.get_administratorscrh)a Shortcut for:: await bot.get_chat_member_count(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.get_chat_member_count`. Returns: :obj:`int` riN)rkget_chat_member_countr8rmrIrIrJget_member_countMroz_ChatBase.get_member_countuser_idrc &|j|j||||||dIdHS)aShortcut for:: await bot.get_chat_member(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.get_chat_member`. Returns: :class:`telegram.ChatMember` rjrurdrerfrgr?N)rkget_chat_memberr8rFrurdrerfrgr?rIrIrJrBis z_ChatBase.get_memberrevoke_messages until_datec s*|j|j||||||||d IdHS)a$Shortcut for:: await bot.ban_chat_member(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.ban_chat_member`. Returns: :obj:`bool`: On success, :obj:`True` is returned. ) rjrurdrerfrgr{r?rzN)rkban_chat_memberr8) rFrurzr{rdrerfrgr?rIrIrJ ban_member z_ChatBase.ban_membersender_chat_idc rv)aWShortcut for:: await bot.ban_chat_sender_chat(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.ban_chat_sender_chat`. .. versionadded:: 13.9 Returns: :obj:`bool`: On success, :obj:`True` is returned. rjrrdrerfrgr?Nrkban_chat_sender_chatr8rFrrdrerfrgr?rIrIrJban_sender_chat z_ChatBase.ban_sender_chatrjc &|j||j|||||dIdHS)a~Shortcut for:: await bot.ban_chat_sender_chat( sender_chat_id=update.effective_chat.id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.ban_chat_sender_chat`. .. versionadded:: 13.9 Returns: :obj:`bool`: On success, :obj:`True` is returned. rNrrFrjrdrerfrgr?rIrIrJban_chat z_ChatBase.ban_chatc rv)a[Shortcut for:: await bot.unban_chat_sender_chat(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.unban_chat_sender_chat`. .. versionadded:: 13.9 Returns: :obj:`bool`: On success, :obj:`True` is returned. rNrkunban_chat_sender_chatr8rrIrIrJunban_sender_chatrz_ChatBase.unban_sender_chatc r)aShortcut for:: await bot.unban_chat_sender_chat( sender_chat_id=update.effective_chat.id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.unban_chat_sender_chat`. .. versionadded:: 13.9 Returns: :obj:`bool`: On success, :obj:`True` is returned. rNrrrIrIrJ unban_chatrz_ChatBase.unban_chatonly_if_bannedc (|j|j|||||||dIdHS)a!Shortcut for:: await bot.unban_chat_member(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.unban_chat_member`. Returns: :obj:`bool`: On success, :obj:`True` is returned. )rjrurdrerfrgr?rN)rkunban_chat_memberr8)rFrurrdrerfrgr?rIrIrJ unban_member1s z_ChatBase.unban_membercan_change_infocan_post_messagescan_edit_messagescan_delete_messagescan_invite_userscan_restrict_memberscan_pin_messagescan_promote_members is_anonymouscan_manage_chatcan_manage_video_chatscan_manage_topicscan_post_storiescan_edit_storiescan_delete_storiescs|jdid|jd|d|d|d|d|d|d|d |d | d |d |d |d|d|d| d| d| d| d|d|d|IdHS)aShortcut for:: await bot.promote_chat_member(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.promote_chat_member`. .. versionadded:: 13.2 .. versionchanged:: 20.0 The argument ``can_manage_voice_chats`` was renamed to :paramref:`~telegram.Bot.promote_chat_member.can_manage_video_chats` in accordance to Bot API 6.0. .. versionchanged:: 20.6 The arguments `can_post_stories`, `can_edit_stories` and `can_delete_stories` were added. Returns: :obj:`bool`: On success, :obj:`True` is returned. rjrurrrrrrrrrdrerfrgr?rrrrrrrNrI)rkpromote_chat_memberr8)rFrurrrrrrrrrrrrrrrrdrerfrgr?rIrIrJpromote_memberQs\-      z_ChatBase.promote_member permissions use_independent_chat_permissionsc s,|j|j||||||||| d IdHS)aShortcut for:: await bot.restrict_chat_member(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.restrict_chat_member`. .. versionadded:: 13.2 .. versionadded:: 20.1 Added :paramref:`~telegram.Bot.restrict_chat_member.use_independent_chat_permissions`. Returns: :obj:`bool`: On success, :obj:`True` is returned. ) rjrurr{rrdrerfrgr?N)rkrestrict_chat_memberr8) rFrurr{rrdrerfrgr?rIrIrJrestrict_members z_ChatBase.restrict_memberc (|j|j|||||||dIdHS)aShortcut for:: await bot.set_chat_permissions(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.set_chat_permissions`. .. versionadded:: 20.1 Added :paramref:`~telegram.Bot.set_chat_permissions.use_independent_chat_permissions`. Returns: :obj:`bool`: On success, :obj:`True` is returned. )rjrrrdrerfrgr?N)rkset_chat_permissionsr8)rFrrrdrerfrgr?rIrIrJset_permissionss z_ChatBase.set_permissions custom_titlec r)amShortcut for:: await bot.set_chat_administrator_custom_title( update.effective_chat.id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.set_chat_administrator_custom_title`. Returns: :obj:`bool`: On success, :obj:`True` is returned. )rjrurrdrerfrgr?N)rk#set_chat_administrator_custom_titler8)rFrurrdrerfrgr?rIrIrJset_administrator_custom_titles z(_ChatBase.set_administrator_custom_titlephotoc rv)akShortcut for:: await bot.set_chat_photo( chat_id=update.effective_chat.id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.set_chat_photo`. .. versionadded:: 20.0 Returns: :obj:`bool`: On success, :obj:`True` is returned. )rjrrdrerfrgr?N)rkset_chat_photor8)rFrrdrerfrgr?rIrIrJ set_photo z_ChatBase.set_photocrh)aqShortcut for:: await bot.delete_chat_photo( chat_id=update.effective_chat.id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.delete_chat_photo`. .. versionadded:: 20.0 Returns: :obj:`bool`: On success, :obj:`True` is returned. riN)rkdelete_chat_photor8rmrIrIrJ delete_photo+s z_ChatBase.delete_photoc rv)akShortcut for:: await bot.set_chat_title( chat_id=update.effective_chat.id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.set_chat_title`. .. versionadded:: 20.0 Returns: :obj:`bool`: On success, :obj:`True` is returned. )rjr;rdrerfrgr?N)rkset_chat_titler8)rFr;rdrerfrgr?rIrIrJ set_titleLrz_ChatBase.set_title descriptionc rv)awShortcut for:: await bot.set_chat_description( chat_id=update.effective_chat.id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.set_chat_description`. .. versionadded:: 20.0 Returns: :obj:`bool`: On success, :obj:`True` is returned. )rjrrdrerfrgr?N)rkset_chat_descriptionr8)rFrrdrerfrgr?rIrIrJset_descriptionorz_ChatBase.set_description message_iddisable_notificationbusiness_connection_idc *|j|j||||||||d IdHS)a0Shortcut for:: await bot.pin_chat_message(chat_id=update.effective_chat.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. ) rjrrrdrerfrgr?rN)rkpin_chat_messager8) rFrrrrdrerfrgr?rIrIrJ pin_message z_ChatBase.pin_messagec s(|j|j|||||||dIdHS)a4Shortcut for:: await bot.unpin_chat_message(chat_id=update.effective_chat.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. )rjrdrerfrgr?rrN)rkunpin_chat_messager8)rFrrrdrerfrgr?rIrIrJ unpin_messages z_ChatBase.unpin_messagecrh)a>Shortcut for:: await bot.unpin_all_chat_messages(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.unpin_all_chat_messages`. Returns: :obj:`bool`: On success, :obj:`True` is returned. riN)rkunpin_all_chat_messagesr8rmrIrIrJunpin_all_messagess z_ChatBase.unpin_all_messages)reply_to_message_idallow_sending_without_replydisable_web_page_previewrdrerfrgr?text parse_mode reply_markupentitiesr,protect_contentmessage_thread_idlink_preview_optionsr)reply_parametersr/message_effect_idallow_paid_broadcastrrrr+c s|jdid|jd|d|d|d|d| d|d| d |d |d |d |d |d|d|d|d|d|d| d| d| IdHS)a6Shortcut for:: await bot.send_message(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_message`. Returns: :class:`telegram.Message`: On success, instance representing the message posted. rjrrrrrrrrrrrrrdrerfrgr?rrrNrI)rk send_messager8)rFrrrrrrrrrrrrrrrrdrerfrgr?rIrIrJrX"      z_ChatBase.send_messagec rv)a;Shortcut for:: await bot.delete_message(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.delete_message`. .. versionadded:: 20.8 Returns: :obj:`bool`: On success, :obj:`True` is returned. )rjrrdrerfrgr?N)rkdelete_messager8)rFrrdrerfrgr?rIrIrJr- z_ChatBase.delete_message message_idsc rv)a=Shortcut for:: await bot.delete_messages(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.delete_messages`. .. versionadded:: 20.8 Returns: :obj:`bool`: On success, :obj:`True` is returned. )rjrrdrerfrgr?N)rkdelete_messagesr8)rFrrdrerfrgr?rIrIrJrMrz_ChatBase.delete_messages) rrrdrerfrgr?captionrcaption_entitiesmedia)r"r#r$r%rr)r+.c s|jdid|jd|d|d| d| d| d| d|d |d | d |d |d |d|d|d|d|d|d|IdHS)asShortcut for:: await bot.send_media_group(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_media_group`. Returns: tuple[:class:`telegram.Message`]: On success, a tuple of :class:`~telegram.Message` instances that were sent is returned. rjrrrrdrerfrgr?rrrrrrrrrrNrI)rksend_media_groupr8)rFrrrrrrrrrrrdrerfrgr?rrrrIrIrJrmsP#      z_ChatBase.send_media_groupactionc r)aShortcut for:: await bot.send_chat_action(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_chat_action`. Returns: :obj:`bool`: On success, :obj:`True` is returned. ) rjrrrdrerfrgr?rN)rksend_chat_actionr8) rFrrrrdrerfrgr?rIrIrJrr~z_ChatBase.send_chat_action)rrfilenamerdrerfrgr?r. has_spoilershow_caption_above_mediarcs|jdid|jd|d|d|d|d| d|d|d |d |d |d |d |d|d|d|d|d|d| d| d| d| d|IdHS)a2Shortcut for:: await bot.send_photo(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_photo`. Returns: :class:`telegram.Message`: On success, instance representing the message posted. rjrrrrrrrrrrrrrdrerfrgr?rrrrrNrI)rk send_photor8)rFrrrrrrrrrrrrrrrrrrdrerfrgr?rIrIrJr`$      z_ChatBase.send_photo)rrcontactrdrerfrgr? phone_numbervcardrrc s|jdid|jd|d|d|d|d| d| d|d |d |d |d |d |d|d|d|d|d|d| d| d| IdHS)a6Shortcut for:: await bot.send_contact(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_contact`. Returns: :class:`telegram.Message`: On success, instance representing the message posted. rjrr7r:rrrrrdrerfrgrrr?rrrrrrNrI)rk send_contactr8)rFrr7r:rrrrrrrrrrrrrdrerfrgr?rIrIrJr rz_ChatBase.send_contactaudiorduration performer thumbnailcs|jdid|jd|d|d|d|d|d|d|d | d |d |d |d | d|d| d| d|d|d|d|d|d| d|d|d|IdHS)a2Shortcut for:: await bot.send_audio(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_audio`. Returns: :class:`telegram.Message`: On success, instance representing the message posted. rjrrrr;rrrrrrrrrrrrdrerfrgr?rrrrNrI)rk send_audior8)rFrrrr;rrrrrrrrrrrrrrrrdrerfrgr?rIrIrJrCh&      z_ChatBase.send_audiodocumentrdisable_content_type_detectioncs|jdid|jd|d|d|d|d|d| d|d |d |d |d |d |d| d|d|d|d|d|d| d| d| d|IdHS)a8Shortcut for:: await bot.send_document(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_document`. Returns: :class:`telegram.Message`: On success, instance representing the message posted. rjrrrrrrrrdrerfrgrrr?rrrrrrrrNrI)rk send_documentr8)rFrrrrrrrrrrrrrrrrrrdrerfrgr?rIrIrJrrz_ChatBase.send_document)rrrdrerfrgr? checklistr!r cs6|j|j||||||||| | | | | |dIdHS)abShortcut for:: await bot.send_checklist(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_checklist`. .. versionadded:: 22.3 Returns: :class:`telegram.Message`: On success, instance representing the message posted. )rjrrrrrrrrrrdrerfrgr?N)rksend_checklistr8)rFrrrrrrrrrrdrerfrgr?rIrIrJrs$ z_ChatBase.send_checklistemojic s|jdid|jd|d| d|d|d| d| d|d |d |d |d | d |d|d|d|d| IdHS)a0Shortcut for:: await bot.send_dice(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_dice`. Returns: :class:`telegram.Message`: On success, instance representing the message posted. rjrrrrrdrerfrgrr?rrrrrrNrI)rk send_dicer8)rFrrrrrrrrrrrrdrerfrgr?rIrIrJrH      z_ChatBase.send_dicegame_short_namec s|jdid|jd|d|d| d|d|d| d| d |d |d |d | d |d|d|d|d| IdHS)a0Shortcut for:: await bot.send_game(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_game`. Returns: :class:`telegram.Message`: On success, instance representing the message posted. rjrrrrrrdrerfrgr?rrrrrrNrI)rk send_gamer8)rFrrrrrrrrrrrrdrerfrgr?rIrIrJr%rz_ChatBase.send_gamepayloadcurrencypricesr(provider_tokenstart_parameter photo_url photo_size photo_width photo_height need_nameneed_phone_number need_emailneed_shipping_address is_flexible provider_datasend_phone_number_to_providersend_email_to_providermax_tip_amountsuggested_tip_amountsc$s|jd&id|jd|d|d|d|d|d|d|d |d | d | d | d | d| d|d|d|d|d|d|d|d|d|d|d| d|!d|"d|#d|d|d|d |d!|d"|d#|d$|Id%HS)'aShortcut for:: await bot.send_invoice(update.effective_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. .. versionchanged:: 13.5 As of Bot API 5.2, the parameter :paramref:`start_parameter ` is optional. Returns: :class:`telegram.Message`: On success, instance representing the message posted. rjr;rrrrrrrrrrrrrrrrrrrrrrdrerfrgr?rrrrrrrrNrI)rk send_invoicer8)$rFr;rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrdrerfrgr?rIrIrJrWs;      !"#$ z_ChatBase.send_invoice)rrlocationrdrerfrgr?latitude longitude live_periodhorizontal_accuracyheadingproximity_alert_radiusr r*cs|jdid|jd|d|d|d|d| d|d|d |d |d |d |d |d|d|d|d|d|d| d| d| d| d|IdHS)a8Shortcut for:: await bot.send_location(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_location`. Returns: :class:`telegram.Message`: On success, instance representing the message posted. rjr r rrrrrdrerfrgr r r?r rrrrrrrrNrI)rk send_locationr8)rFr r rrr r rrrrrrrrrrr rdrerfrgr?rIrIrJrrz_ChatBase.send_location animationrwidthheightcs|jdid|jd|d|d|d|d|d|d|d |d |d |d |d |d|d|d|d|d| d|d| d| d| d| d|d|d|d|IdHS)a:Shortcut for:: await bot.send_animation(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_animation`. Returns: :class:`telegram.Message`: On success, instance representing the message posted. rjrrrrrrrrrrrdrerfrgr?rrrrrrrrrrrNrI)rksend_animationr8)rFrrrrrrrrrrrrrrrrrrrrrrdrerfrgr?rIrIrJrsp(      z_ChatBase.send_animationstickerr0c s|jdid|jd|d|d| d|d|d| d|d |d |d |d | d |d|d|d|d| d| IdHS)a6Shortcut for:: await bot.send_sticker(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_sticker`. Returns: :class:`telegram.Message`: On success, instance representing the message posted. rjrrrrrrdrerfrgr?rrrrrrrNrI)rk send_stickerr8)rFrrrrrrrrrrrrrdrerfrgr?rIrIrJr=sL      z_ChatBase.send_sticker)rrvenuerdrerfrgr?address foursquare_idfoursquare_typegoogle_place_idgoogle_place_typerr2cs|jdid|jd|d|d|d|d|d|d|d | d |d |d |d |d|d|d|d|d| d| d|d| d| d|d|d|IdHS)a2Shortcut for:: await bot.send_venue(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_venue`. Returns: :class:`telegram.Message`: On success, instance representing the message posted. rjr r r;rrrrrrrdrerfrgrrr?rrrrrrrrNrI)rk send_venuer8)rFr r r;rrrrrrrrrrrrrrrrrdrerfrgr?rIrIrJrqrz_ChatBase.send_venuevideor3supports_streamingcoverstart_timestampcs|jd id|jd|d|d|d|d|d|d|d |d |d |d |d |d|d|d| d|d|d|d|d|d| d|d| d| d| d|d|d|d|IdHS)!a2Shortcut for:: await bot.send_video(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_video`. Returns: :class:`telegram.Message`: On success, instance representing the message posted. rjrrrrrrrrdrerfrgrrrrrr r!r?rrrrrrrrrrNrI)rk send_videor8)rFrrrrrrrrrrrrrrrrrrrr r!rrrrdrerfrgr?rIrIrJr"|+      z_ChatBase.send_video video_noter4lengthc s|jdid|jd|d|d|d|d| d| d|d |d |d |d |d |d|d|d|d|d|d| d| d| IdHS)a<Shortcut for:: await bot.send_video_note(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_video_note`. Returns: :class:`telegram.Message`: On success, instance representing the message posted. rjr$rr%rrrrrdrerfrgrr?rrrrrrrNrI)rksend_video_noter8)rFr$rr%rrrrrrrrrrrrrdrerfrgr?rIrIrJr&rz_ChatBase.send_video_notevoicer5cs|jdid|jd|d|d|d|d|d| d|d |d |d |d |d |d|d|d|d|d|d| d| d| d| IdHS)a2Shortcut for:: await bot.send_voice(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_voice`. Returns: :class:`telegram.Message`: On success, instance representing the message posted. rjr'rrrrrrrdrerfrgrr?rrrrrrrrNrI)rk send_voicer8)rFr'rrrrrrrrrrrrrrrrdrerfrgr?rIrIrJr(9s\#      z_ChatBase.send_voicequestionoptionsr'allows_multiple_answerscorrect_option_id is_closed explanationexplanation_parse_mode open_period close_dateexplanation_entitiesquestion_parse_modequestion_entitiescs|jd id|jd|d|d|d|d|d|d|d |d |d |d | d |d|d|d|d|d|d| d| d| d| d|d|d|d|d|d|d|d|IdHS)!a0Shortcut for:: await bot.send_poll(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_poll`. Returns: :class:`telegram.Message`: On success, instance representing the message posted. rjr)r*rr<r+r,r-rrrrrdrerfrgrrr.r/r0r1r?rr2rrrr3r4NrI)rk send_pollr8)rFr)r*rr<r+r,r-rrr.r/r0r1r2rrrrr3r4rrrrrdrerfrgr?rIrIrJr5ur#z_ChatBase.send_poll from_chat_idvideo_start_timestampr-c|jdid|jd|d|d|d| d|d|d|d |d | d |d |d |d|d|d|d|d|d| d| d| IdHS)aShortcut for:: await bot.copy_message(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.copy_message`. .. seealso:: :meth:`copy_message`, :meth:`send_copies`, :meth:`copy_messages`. Returns: :class:`telegram.Message`: On success, instance representing the message posted. rjr6rrr7rrrrrrrrdrerfrgr?rrrrNrIrk copy_messager8)rFr6rrrrrrrrrrrr7rrrdrerfrgr?rIrIrJ send_copyX$      z_ChatBase.send_copycr8)aShortcut for:: await bot.copy_message(from_chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.copy_message`. .. seealso:: :meth:`send_copy`, :meth:`send_copies`, :meth:`copy_messages`. Returns: :class:`telegram.MessageId`: On success, returns the MessageId of the sent message. r6rjrrr7rrrrrrrrdrerfrgr?rrrrNrIr9)rFrjrrrrrrrrrrrr7rrrdrerfrgr?rIrIrJr:r<z_ChatBase.copy_messageremove_caption)r-.c 0|j|j||||||||| | | d IdHS)aShortcut for:: await bot.copy_messages(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.copy_messages`. .. seealso:: :meth:`copy_message`, :meth:`send_copy`, :meth:`copy_messages`. .. versionadded:: 20.8 Returns: tuple[:class:`telegram.MessageId`]: On success, a tuple of :class:`~telegram.MessageId` of the sent messages is returned. ) rjr6rrrrr=rdrerfrgr?Nrk copy_messagesr8) rFr6rrrrr=rdrerfrgr?rIrIrJ send_copies9  z_ChatBase.send_copiesc r>)aShortcut for:: await bot.copy_messages(from_chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.copy_messages`. .. seealso:: :meth:`copy_message`, :meth:`send_copy`, :meth:`send_copies`. .. versionadded:: 20.8 Returns: tuple[:class:`telegram.MessageId`]: On success, a tuple of :class:`~telegram.MessageId` of the sent messages is returned. ) r6rjrrrrr=rdrerfrgr?Nr?) rFrjrrrrr=rdrerfrgr?rIrIrJr@f rBz_ChatBase.copy_messagesc 0|j|j||||||| | | ||d IdHS)aShortcut for:: await bot.forward_message(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.forward_message`. .. seealso:: :meth:`forward_to`, :meth:`forward_messages_from`, :meth:`forward_messages_to` .. versionadded:: 20.0 Returns: :class:`telegram.Message`: On success, instance representing the message posted. ) rjr6rr7rrdrerfrgr?rrNrkforward_messager8) rFr6rrrrr7rdrerfrgr?rIrIrJ forward_from s z_ChatBase.forward_fromc rC)aShortcut for:: await bot.forward_message(from_chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.forward_message`. .. seealso:: :meth:`forward_from`, :meth:`forward_messages_from`, :meth:`forward_messages_to` .. versionadded:: 20.0 Returns: :class:`telegram.Message`: On success, instance representing the message posted. ) r6rjrr7rrdrerfrgr?rrNrD) rFrjrrrrr7rdrerfrgr?rIrIrJ forward_to rBz_ChatBase.forward_toc .|j|j||||||||| | d IdHS)aShortcut for:: await bot.forward_messages(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.forward_messages`. .. seealso:: :meth:`forward_to`, :meth:`forward_from`, :meth:`forward_messages_to`. .. versionadded:: 20.8 Returns: tuple[:class:`telegram.MessageId`]: On success, a tuple of :class:`~telegram.MessageId` of sent messages is returned. ) rjr6rrrrrdrerfrgr?Nrkforward_messagesr8) rFr6rrrrrdrerfrgr?rIrIrJforward_messages_from  z_ChatBase.forward_messages_fromc rH)aShortcut for:: await bot.forward_messages(from_chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.forward_messages`. .. seealso:: :meth:`forward_from`, :meth:`forward_to`, :meth:`forward_messages_from`. .. versionadded:: 20.8 Returns: tuple[:class:`telegram.MessageId`]: On success, a tuple of :class:`~telegram.MessageId` of sent messages is returned. ) r6rjrrrrrdrerfrgr?NrI) rFrjrrrrrdrerfrgr?rIrIrJforward_messages_to rLz_ChatBase.forward_messages_tocrh)aSShortcut for:: await bot.export_chat_invite_link(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.export_chat_invite_link`. .. versionadded:: 13.4 Returns: :obj:`str`: New invite link on success. riN)rkexport_chat_invite_linkr8rmrIrIrJexport_invite_linkB  z_ChatBase.export_invite_link expire_date member_limitcreates_join_requestrc s,|j|j||||||| ||d IdHS)aShortcut for:: await bot.create_chat_invite_link(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.create_chat_invite_link`. .. versionadded:: 13.4 .. versionchanged:: 13.8 Edited signature according to the changes of :meth:`telegram.Bot.create_chat_invite_link`. Returns: :class:`telegram.ChatInviteLink` ) rjrQrRrdrerfrgr?rVrSN)rkcreate_chat_invite_linkr8) rFrQrRrVrSrdrerfrgr?rIrIrJcreate_invite_linka s z_ChatBase.create_invite_link invite_linkc s.|j|j||||||| | ||d IdHS)aShortcut for:: await bot.edit_chat_invite_link(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.edit_chat_invite_link`. .. versionadded:: 13.4 .. versionchanged:: 13.8 Edited signature according to the changes of :meth:`telegram.Bot.edit_chat_invite_link`. Returns: :class:`telegram.ChatInviteLink` ) rjrVrQrRrdrerfrgr?rVrSN)rkedit_chat_invite_linkr8) rFrVrQrRrVrSrdrerfrgr?rIrIrJedit_invite_link s z_ChatBase.edit_invite_linkc rv)aLShortcut for:: await bot.revoke_chat_invite_link(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.revoke_chat_invite_link`. .. versionadded:: 13.4 Returns: :class:`telegram.ChatInviteLink` )rjrVrdrerfrgr?N)rkrevoke_chat_invite_linkr8)rFrVrdrerfrgr?rIrIrJrevoke_invite_link rz_ChatBase.revoke_invite_linksubscription_periodsubscription_pricec *|j|j||||||||d IdHS)aShortcut for:: await bot.create_chat_subscription_invite_link( chat_id=update.effective_chat.id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.create_chat_subscription_invite_link`. .. versionadded:: 21.5 Returns: :class:`telegram.ChatInviteLink` ) rjr[r\rVrdrerfrgr?N)rk$create_chat_subscription_invite_linkr8) rFr[r\rVrdrerfrgr?rIrIrJcreate_subscription_invite_link s z)_ChatBase.create_subscription_invite_linkc r)aShortcut for:: await bot.edit_chat_subscription_invite_link( chat_id=update.effective_chat.id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.edit_chat_subscription_invite_link`. .. versionadded:: 21.5 Returns: :class:`telegram.ChatInviteLink` )rjrVrdrerfrgr?rVN)rk"edit_chat_subscription_invite_linkr8)rFrVrVrdrerfrgr?rIrIrJedit_subscription_invite_link s z'_ChatBase.edit_subscription_invite_linkc rv)aaShortcut for:: await bot.approve_chat_join_request(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.approve_chat_join_request`. .. versionadded:: 13.8 Returns: :obj:`bool`: On success, :obj:`True` is returned. rwN)rkapprove_chat_join_requestr8ryrIrIrJapprove_join_request$ rz_ChatBase.approve_join_requestc rv)aaShortcut for:: await bot.decline_chat_join_request(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.decline_chat_join_request`. .. versionadded:: 13.8 Returns: :obj:`bool`: On success, :obj:`True` is returned. rwN)rkdecline_chat_join_requestr8ryrIrIrJdecline_join_requestE rz_ChatBase.decline_join_request menu_buttonc rv)aShortcut for:: await bot.set_chat_menu_button(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.set_chat_menu_button`. Caution: Can only work, if the chat is a private chat. .. seealso:: :meth:`get_menu_button` .. versionadded:: 20.0 Returns: :obj:`bool`: On success, :obj:`True` is returned. )rjrfrdrerfrgr?N)rkset_chat_menu_buttonr8)rFrfrdrerfrgr?rIrIrJset_menu_buttonf s z_ChatBase.set_menu_button icon_coloricon_custom_emoji_idc r])a=Shortcut for:: await bot.create_forum_topic(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.create_forum_topic`. .. versionadded:: 20.0 Returns: :class:`telegram.ForumTopic` ) rjrVrirjrdrerfrgr?N)rkcreate_forum_topicr8) rFrVrirjrdrerfrgr?rIrIrJrk  z_ChatBase.create_forum_topicc r])aNShortcut for:: await bot.edit_forum_topic(chat_id=update.effective_chat.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. ) rjrrVrjrdrerfrgr?N)rkedit_forum_topicr8) rFrrVrjrdrerfrgr?rIrIrJrm rlz_ChatBase.edit_forum_topicc rv)aPShortcut for:: await bot.close_forum_topic(chat_id=update.effective_chat.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. rjrrdrerfrgr?N)rkclose_forum_topicr8rFrrdrerfrgr?rIrIrJro rz_ChatBase.close_forum_topicc rv)aRShortcut for:: await bot.reopen_forum_topic(chat_id=update.effective_chat.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. rnN)rkreopen_forum_topicr8rprIrIrJrq rz_ChatBase.reopen_forum_topicc rv)aRShortcut for:: await bot.delete_forum_topic(chat_id=update.effective_chat.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. rnN)rkdelete_forum_topicr8rprIrIrJrr rz_ChatBase.delete_forum_topicc rv)azShortcut for:: await bot.unpin_all_forum_topic_messages(chat_id=update.effective_chat.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. rnN)rkunpin_all_forum_topic_messagesr8rprIrIrJrs3 rz(_ChatBase.unpin_all_forum_topic_messagescrh)aShortcut for:: await bot.unpin_all_general_forum_topic_messages(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.unpin_all_general_forum_topic_messages`. .. versionadded:: 20.5 Returns: :obj:`bool`: On success, :obj:`True` is returned. riN)rk&unpin_all_general_forum_topic_messagesr8rmrIrIrJrtT rPz0_ChatBase.unpin_all_general_forum_topic_messagesc rv)a}Shortcut for:: await bot.edit_general_forum_topic( chat_id=update.effective_chat.id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.edit_general_forum_topic`. .. versionadded:: 20.0 Returns: :obj:`bool`: On success, :obj:`True` is returned. )rjrVrdrerfrgr?N)rkedit_general_forum_topicr8)rFrVrdrerfrgr?rIrIrJrus s z"_ChatBase.edit_general_forum_topiccrh)a`Shortcut for:: await bot.close_general_forum_topic(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.close_general_forum_topic`. .. versionadded:: 20.0 Returns: :obj:`bool`: On success, :obj:`True` is returned. riN)rkclose_general_forum_topicr8rmrIrIrJrv  z#_ChatBase.close_general_forum_topiccrh)aShortcut for:: await bot.reopen_general_forum_topic( chat_id=update.effective_chat.id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.reopen_general_forum_topic`. .. versionadded:: 20.0 Returns: :obj:`bool`: On success, :obj:`True` is returned. riN)rkreopen_general_forum_topicr8rmrIrIrJrx rrz$_ChatBase.reopen_general_forum_topiccrh)a^Shortcut for:: await bot.hide_general_forum_topic(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.hide_general_forum_topic`. .. versionadded:: 20.0 Returns: :obj:`bool`: On success, :obj:`True` is returned. riN)rkhide_general_forum_topicr8rmrIrIrJry rwz"_ChatBase.hide_general_forum_topiccrh)aShortcut for:: await bot.unhide_general_forum_topic ( chat_id=update.effective_chat.id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.unhide_general_forum_topic`. .. versionadded:: 20.0 Returns: :obj:`bool`: On success, :obj:`True` is returned. riN)rkunhide_general_forum_topicr8rmrIrIrJrz rrz$_ChatBase.unhide_general_forum_topiccrh)aShortcut for:: await bot.get_chat_menu_button(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.get_chat_menu_button`. Caution: Can only work, if the chat is a private chat. .. seealso:: :meth:`set_menu_button` .. versionadded:: 20.0 Returns: :class:`telegram.MenuButton`: On success, the current menu button is returned. riN)rkget_chat_menu_buttonr8rmrIrIrJget_menu_button s z_ChatBase.get_menu_buttonr1c s&|j|j||||||dIdHS)azShortcut for:: await bot.get_user_chat_boosts(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.get_user_chat_boosts`. .. versionadded:: 20.8 Returns: :class:`telegram.UserChatBoosts`: On success, returns the boosts applied in the chat. )rjrur?rdrerfrgN)rkget_user_chat_boostsr8ryrIrIrJr}4 rz_ChatBase.get_user_chat_boostsreactionis_bigc r])aUShortcut for:: await bot.set_message_reaction(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.set_message_reaction`. .. versionadded:: 20.8 Returns: :obj:`bool` On success, :obj:`True` is returned. ) rjrr~rrdrerfrgr?N)rkset_message_reactionr8) rFrr~rrdrerfrgr?rIrIrJrT rlz_ChatBase.set_message_reaction)rrrdrerfrgr? star_countr&cs|jdid|jd|d|d|d|d|d|d|d |d | d | d |d |d|d|d|d|d|d| d| d| IdHS)akShortcut for:: await bot.send_paid_media(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_paid_media`. .. versionadded:: 21.4 Returns: :class:`telegram.Message`: On success, instance representing the message posted. rjrrrrrrrrrrrrrdrerfrgr?rrrNrI)rksend_paid_mediar8)rFrrrrrrrrrrrrrrrrdrerfrgr?rIrIrJrx r<z_ChatBase.send_paid_mediagift_idrtext_parse_mode text_entitiespay_for_upgradec sH|jd||||||||| | d |jtjkrdnd|jiIdHS)aVShortcut for:: await bot.send_gift(user_id=update.effective_chat.id, *args, **kwargs ) or:: await bot.send_gift(chat_id=update.effective_chat.id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.send_gift`. Caution: Will only work if the chat is a private or channel chat, see :attr:`type`. .. versionadded:: 21.8 .. versionchanged:: 21.11 Added support for channel chats. Returns: :obj:`bool`: On success, :obj:`True` is returned. ) rrrrrrdrerfrgr?rjruNrI)rk send_giftr<ChatrOr8) rFrrrrrrdrerfrgr?rIrIrJr s $ z_ChatBase.send_gift owned_gift_idc r])aKShortcut for:: await bot.transfer_gift(new_owner_chat_id=update.effective_chat.id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.transfer_gift`. .. versionadded:: 22.1 Returns: :obj:`bool`: On success, :obj:`True` is returned. ) new_owner_chat_idrrrrdrerfrgr?N)rk transfer_giftr8) rFrrrrdrerfrgr?rIrIrJr rz_ChatBase.transfer_giftcustom_descriptionc rv)aEShortcut for:: await bot.verify_chat(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.verify_chat`. .. versionadded:: 21.10 Returns: :obj:`bool`: On success, :obj:`True` is returned. )rjrrdrerfrgr?N)rk verify_chatr8)rFrrdrerfrgr?rIrIrJverify rz_ChatBase.verifycrh)a_Shortcut for:: await bot.remove_chat_verification(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.remove_chat_verification`. .. versionadded:: 21.10 Returns: :obj:`bool`: On success, :obj:`True` is returned. riN)rkremove_chat_verificationr8rmrIrIrJremove_verification)rwz_ChatBase.remove_verificationc r)aXShortcut for:: await bot.read_business_message(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.read_business_message`. .. versionadded:: 22.1 Returns: :obj:`bool`: On success, :obj:`True` is returned. )rjrrrdrerfrgr?N)rkread_business_messager8)rFrrrdrerfrgr?rIrIrJrGs z_ChatBase.read_business_message)NNNNN)N)NN)NNNNNNNNNNNNNNN)NNNN)~__name__ __module__ __qualname____doc__ __slots__intstrrboolrrArrCrKr__annotations__rLrMrNrOpropertyrSrQrUrrbrrrfloatrntuplerqrtrBrdtmdatetimer}rrrrrrr rrrrrrrrrrrrrrrrrr send_actionrrrrrrrrobjectrrrrrr"r&r(rr5r;r:rAr@rFrGrKrMrOrUrXrZr_rarcrer rhr rkrmrorqrrrsrtrurvrxryrzr|r}r rrrrrrr __classcell__rIrIrGrJr6Ps    &!#  #   !   & %  ' %  &  #      J    -  )  ' & % % &   %  $         > $ %       <   "        @      =       E        B      2      5      9       !"#$%& d      A       I       6      E       O       =        @        P       @       @       1       1       0       1      /      .!    .      0  %   )   ) % # (   '   ( $ $ $ $# %!#!#' #   (       ?       6   % ##  r6c@seZdZdZdZdS)raN This object represents a chat. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`id` is equal. .. versionchanged:: 20.0 * Removed the deprecated methods ``kick_member`` and ``get_members_count``. * The following are now keyword-only arguments in Bot methods: ``location``, ``filename``, ``contact``, ``{read, write, connect, pool}_timeout``, ``api_kwargs``. Use a named argument for those, and notice that some positional arguments changed position as a result. .. versionchanged:: 20.0 Removed the attribute ``all_members_are_administrators``. As long as Telegram provides this field for backwards compatibility, it is available through :attr:`~telegram.TelegramObject.api_kwargs`. .. versionchanged:: 21.3 As per Bot API 7.3, most of the arguments and attributes of this class have now moved to :class:`telegram.ChatFullInfo`. Args: id (:obj:`int`): Unique identifier for this chat. type (:obj:`str`): Type of chat, can be either :attr:`PRIVATE`, :attr:`GROUP`, :attr:`SUPERGROUP` or :attr:`CHANNEL`. title (:obj:`str`, optional): Title, for supergroups, channels and group chats. username (:obj:`str`, optional): Username, for private chats, supergroups and channels if available. first_name (:obj:`str`, optional): First name of the other party in a private chat. last_name (:obj:`str`, optional): Last name of the other party in a private chat. is_forum (:obj:`bool`, optional): :obj:`True`, if the supergroup chat is a forum (has topics_ enabled). .. versionadded:: 20.0 Attributes: id (:obj:`int`): Unique identifier for this chat. type (:obj:`str`): Type of chat, can be either :attr:`PRIVATE`, :attr:`GROUP`, :attr:`SUPERGROUP` or :attr:`CHANNEL`. title (:obj:`str`): Optional. Title, for supergroups, channels and group chats. username (:obj:`str`): Optional. Username, for private chats, supergroups and channels if available. first_name (:obj:`str`): Optional. First name of the other party in a private chat. last_name (:obj:`str`): Optional. Last name of the other party in a private chat. is_forum (:obj:`bool`): Optional. :obj:`True`, if the supergroup chat is a forum (has topics_ enabled). .. versionadded:: 20.0 .. _topics: https://telegram.org/blog/topics-in-groups-collectible-usernames#topics-in-groups rIN)rrrrrrIrIrIrJrjs5r)Hrrrcollections.abcrhtmlrtypingrrrrtelegramrtelegram._chatpermissionsr telegram._forumtopicr telegram._menubuttonr telegram._reactionr telegram._telegramobjectr telegram._utilsrtelegram._utils.defaultvaluertelegram._utils.typesrrrrrrtelegram.helpersrrrcrr]rrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6rrIrIrIrJsb              |!6