U g@szdZddlmZddlmZddlmZmZmZmZm Z m Z ddl m Z ddl mZddlmZddlmZdd lmZdd lmZdd lmZdd lmZdd lmZmZmZmZm Z ddl!m"Z"ddl!m#Z$ddl!m%Z&erVddl m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;mZ>m?Z?m@Z@mAZAGdddeZBGdddeBZCdS)z?This module contains an object that represents a Telegram Chat.)datetime)escape) TYPE_CHECKINGFinalOptionalSequenceTupleUnion) constants)ChatPermissions) ForumTopic) MenuButton) ReactionType)TelegramObject)enum) DEFAULT_NONE)CorrectOptionID FileInputJSONDictODVInput ReplyMarkup)escape_markdown) mention_html)mention_markdown) AnimationAudioChatInviteLink ChatMemberContactDocumentInlineKeyboardMarkupInputMediaAudioInputMediaDocumentInputMediaPhotoInputMediaVideoInputPaidMediaInputPollOption LabeledPriceLinkPreviewOptionsLocationMessage MessageEntity MessageId PhotoSizeReplyParametersStickerUserChatBoostsVenueVideo VideoNoteVoicec&speZdZUdZdZd ddeeeeeeeeeeeeee dfddZ e j j Z eeed<e j jZeeed <e j jZeeed <e j jZeeed <e j jZeeed <eeed ddZeeed ddZeeed ddZd eeedddZd eeedddZd eeedddZeeeeddeeeeeeeeee edddZeeeeddeeeeeeeeee eddd d!Z eeeeddeeeeeeeeee edd"d#Z!eeeeddeeeeeeeeeee d$d%d&d'Z"deeeeddeeeee#ee$feeeeeeeeee ed( d)d*Z%eeeeddeeeeeeeeeee ed+d,d-Z&eeeedde#eefeeeeeeeeee ed.d/d0Z'eeeeddeeeeeeeeeee ed+d1d2Z(eeeedde#eefeeeeeeeeee ed.d3d4Z)deeeeddeeeeeeeeeeeee ed5d6d7Z*deeeeddeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee ed8d9d:Z+deeeeddee,ee#ee$feeeeeeeeeeee ed; dd?d@Z.eeeeddeeeeeeeeeeee edAdBdCZ/eeeedde0eeeeeeeeee edDdEdFZ1eeeeddeeeeeeeeee eddGdHZ2eeeeddeeeeeeeeeee edIdJdKZ3deeeeddeeeeeeeeeeee edLdMdNZ4edfeeeeddeeeeeeeeeeeeeee edO dPdQZ5deeeeddeeeeeeeeeeeeee edRdSdTZ6eeeeddeeeeeeeeee eddUdVZ7eeddededddf dedeeeeddWeeeeeee8ee9dXeeeeedYedZeeeeeeeeeeeeeeeeeeee d[d\d]d^Z:eeeeddeeeeeeeeeee ed_d`daZ;eeeedde9eeeeeeeeeee edbdcddZe>Z?dedededdddddf dedeeeeddne#e0dofeeeeee8eeee9dXeeeeeeedZeeeeeeeeeeeeeeeeeeeeee d[dpdqdrZ@dddeddeddddf dedeeeeddseeeeeeeeee8eeeeeeedZeeeeeeeeedteeeeeeeeee d[dudvdwZAddddedededddddfdedeeeeddne#e0dxfeeeeeeeeeeee8eeee9dXeeeeee0edZeeeeeeeeeeeeeeeeeeee d[dydzd{ZBdededdedddddf dedeeeeddne#e0d|feeeeee8eeeeee9dXeeeeee0edZeeeeeeeeeeeeeeeeeeee d[d}d~dZCeddeddddfdeeeeeddeeee8eeeeeeedZeeeeeeeeeeeeeeeeee d[dddZDededdddfdeeeeeddeeeedeeeeedZeeeeeeeeeeeeeeeeee d[dddZEddddddddddeddddddedddfdeeeeeddeeeeeee9deeeeeeeeeeeeeeeeeeeeeeedee#eeFfeeeeeeee9eeeeeedZeeeeeeeeeeeeeeee d[d#ddZGddedddddeddddf dedeeeeddeeeeeeee8eeeeeeeeeeeeedZeeeeeeeeedeeeeeeeeee d[dddZHddddeeddedddddddfdedeeeeddne#e0dfeeeeeeeeeeeeee8ee9dXeeeeeeee0edZeeeeeeeeeeeeeeeeeeeeee d[dddZIededddddfdeeeeedde#e0dfeeee8eeeeeeedZeeeeeeeeeeeeeeeeee d[dddZJdddddeddddeddddfdedeeeeddeeeeeeeeeeeeee8eeeeeeeeeeedZeeeeeeeeedeeeeeeeeee d[dddZKddedddeddedddddddfdedeeeeddne#e0dfeeeeeeee8eeeeeeeeee9dXeeeeeeee0edZeeeeeeeeeeeeeeeeeeeeee d[dddZLddededddddf dedeeeeddne#e0dfeeeeeeee8eeeeee0edZeeeeeeeeeeeeeeeeeeee d[dddZMddedededdddf dedeeeeddne#e0dfeeeeeeee8eeee9dXeeeeedZeeeeeeeeeeeeeeeeeeee d[dddZNdddddeddedddedddeddfdeeeeeddee9e#edfeeeeeeeeOeeeeee8eeeeeeee#ee$fee9dXeeeeedZeeeeee9dXeeeeeeeeeeeeeeee d[dddZPdedededddf deeeeedde#eefeeeeeee9dXeeee8eeeeedZeeeeeeeeeeeeeeee ddddZQdedededddf deeeeedde#eefeeeeeee9dXeeee8eeeeedZeeeeeeeeeeeeeeee ddddZReeddfeeeedde#eefe9eeeeeeeeeeeeeeeeeee edd ddZSeeddfeeeedde#eefe9eeeeeeeeeeeeeeeeeee edd ddZTeedfeeeedde#eefeeeeeeeeeeeeeeeee d[d ddZUeedfeeeedde#eefeeeeeeeeeeeeeeeee d[d ddZVeedfeeeedde#eefe9eeeeeeeeeeeeeeeee eddœ ddĄZWeedfeeeedde#eefe9eeeeeeeeeeeeeeeee eddŜ ddDŽZXeeeeddeeeeeeeeee edddɄZYdeeeeddee#ee$feeeeeeeeeeeeeeee dd˜ dd̈́ZZdeeeedde#edfee#ee$feeeeeeeeeeeeeeee ddΜ ddЄZ[eeeedde#edfeeeeeeeeee ddќddӄZ\deeeeddeeeeeeeeeeeeee ddԜ ddքZ]deeeedde#edfeeeeeeeeeeee ddלddلZ^eeeeddeeeeeeeeeee ed%ddۄZ_eeeeddeeeeeeeeeee ed%dd݄Z`deeeeddeeaeeeeeeeeee edޜddZbdeeeeddeeeeeeeeeeeeeee ecd ddZddeeeeddeeeeeeeeeeeeeee ed ddZeeeeeddeeeeeeeeeee edddZfeeeeddeeeeeeeeeee edddZgeeeeddeeeeeeeeeee edddZheeeeddeeeeeeeeeee edddZieeeeddeeeeeeeeee edddZjeeeeddeeeeeeeeeee edddZkeeeeddeeeeeeeeee edddZleeeeddeeeeeeeeee edddZmeeeeddeeeeeeeeee edddZneeeeddeeeeeeeeee edddZoeeeeddeeeeeeeeee eadddZpeeeeddeeeeeeeeeee dd%ddZqdeeeeddeee#e9e#ereferefeeeeeeeeeeee ed ddZsdeddeeddddf edeeeeddee9deeeeee9dXeeeeeeedZee8eeeeeeeeeeeeeeeeee d[ddd ZtZuS( _ChatBasezjBase class for :class:`telegram.Chat` and :class:`telegram.ChatFullInfo`. .. versionadded:: 21.3 ) first_nameidis_forum last_nametitletypeusernameN api_kwargs)r7r;r:r<r6r9r8r>c sZtj|d||_ttj|||_||_||_ ||_ ||_ ||_ |jf|_ |dS)Nr=)super__init__r7r get_memberr ChatTyper;r:r<r6r9r8Z _id_attrsZ_freeze) selfr7r;r:r<r6r9r8r> __class__2/tmp/pip-unpacked-wheel-swnnwir2/telegram/_chat.pyr@Ns  z_ChatBase.__init__SENDERPRIVATEGROUP SUPERGROUPCHANNEL)returncCs$|jdk r|jS|jdk r |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_namerCrFrFrGeffective_namews   z_ChatBase.effective_namecCs(|js dS|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 )r6r9rOrFrFrGrNs z_ChatBase.full_namecCs|jrd|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<rOrFrFrGlinks z_ChatBase.link)namerMcCs|j|jkr8|rt|j|S|jr0t|j|jStd|jrz|rVd|d|jdS|jrrd|jd|jdStdtddS)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 chatN) r;rIhelpers_mention_markdownr7rN TypeErrorr<rRr:rCrSrFrFrGrs  z_ChatBase.mention_markdowncCs|j|jkr@|r t|j|ddS|jr8t|j|jddStd|jr|rfdt|ddd|jdS|j rdt|j ddd|jdStdtdd S) 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`. )versionrTrUrVrWrXrYN) r;rIrZr7rNr[r<rrRr:r\rFrFrGmention_markdown_v2s z_ChatBase.mention_markdown_v2cCs|j|jkr8|rt|j|S|jr0t|j|jStd|jr|rZd|jdt|dS|j rzd|jdt|j dStdtddS)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`. rTz zrXrYN) r;rIhelpers_mention_htmlr7rNr[r<rRrr:r\rFrFrGrs  z_ChatBase.mention_html) read_timeout write_timeoutconnect_timeout pool_timeoutr>)rarbrcrdr>rMcs"|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_idrarbrcrdr>N)get_botZ leave_chatr7rCrarbrcrdr>rFrFrGleavesz_ChatBase.leave)r.cs"|j|j|||||dIdHS)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. reN)rgZget_chat_administratorsr7rhrFrFrGget_administrators#sz_ChatBase.get_administratorscs"|j|j|||||dIdHS)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` reN)rgZget_chat_member_countr7rhrFrFrGget_member_countCsz_ChatBase.get_member_countr)user_idrarbrcrdr>rMc s$|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` rfrlrarbrcrdr>N)rgZget_chat_memberr7rCrlrarbrcrdr>rFrFrGrA_sz_ChatBase.get_member) rlrevoke_messages until_daterarbrcrdr>rMc 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. ) rfrlrarbrcrdrpr>roN)rgZban_chat_memberr7) rCrlrorprarbrcrdr>rFrFrG ban_member}sz_ChatBase.ban_member)sender_chat_idrarbrcrdr>rMc s$|j|j||||||dIdHS)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. rfrrrarbrcrdr>NrgZban_chat_sender_chatr7rCrrrarbrcrdr>rFrFrGban_sender_chatsz_ChatBase.ban_sender_chat)rfrarbrcrdr>rMc s$|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. rsNrtrCrfrarbrcrdr>rFrFrGban_chatsz_ChatBase.ban_chatc s$|j|j||||||dIdHS)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. rsNrgZunban_chat_sender_chatr7rurFrFrGunban_sender_chatsz_ChatBase.unban_sender_chatc s$|j||j|||||dIdHS)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. rsNryrwrFrFrG unban_chatsz_ChatBase.unban_chat)rlonly_if_bannedrarbrcrdr>rMc s&|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. )rfrlrarbrcrdr>r|N)rgZunban_chat_memberr7)rCrlr|rarbrcrdr>rFrFrG unban_member'sz_ChatBase.unban_member)rlcan_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_storiesrarbrcrdr>rMcsB|j|j||||||||| |||||| | | | |||dIdHS)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. )rfrlr~rrrrrrrrarbrcrdr>rrrrrrrN)rgZpromote_chat_memberr7)rCrlr~rrrrrrrrrrrrrrrarbrcrdr>rFrFrGpromote_memberGs0-z_ChatBase.promote_member) rl permissionsrp use_independent_chat_permissionsrarbrcrdr>rMc 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. ) rfrlrrprrarbrcrdr>N)rgZrestrict_chat_memberr7) rCrlrrprrarbrcrdr>rFrFrGrestrict_membersz_ChatBase.restrict_member)rrrarbrcrdr>rMc s&|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. )rfrrrarbrcrdr>N)rgZset_chat_permissionsr7)rCrrrarbrcrdr>rFrFrGset_permissionssz_ChatBase.set_permissions)rl custom_titlerarbrcrdr>rMc s&|j|j|||||||dIdHS)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. )rfrlrrarbrcrdr>N)rgZ#set_chat_administrator_custom_titler7)rCrlrrarbrcrdr>rFrFrGset_administrator_custom_titlesz(_ChatBase.set_administrator_custom_title)photorarbrcrdr>rMc s$|j|j||||||dIdHS)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. )rfrrarbrcrdr>N)rgZset_chat_photor7)rCrrarbrcrdr>rFrFrG set_photosz_ChatBase.set_photocs"|j|j|||||dIdHS)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. reN)rgZdelete_chat_photor7rhrFrFrG delete_photo!sz_ChatBase.delete_photo)r:rarbrcrdr>rMc s$|j|j||||||dIdHS)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. )rfr:rarbrcrdr>N)rgZset_chat_titler7)rCr:rarbrcrdr>rFrFrG set_titleBsz_ChatBase.set_title) descriptionrarbrcrdr>rMc s$|j|j||||||dIdHS)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. )rfrrarbrcrdr>N)rgZset_chat_descriptionr7)rCrrarbrcrdr>rFrFrGset_descriptionesz_ChatBase.set_description) message_iddisable_notificationbusiness_connection_idrarbrcrdr>rMc s(|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. ) rfrrrarbrcrdr>rN)rgZpin_chat_messager7) rCrrrrarbrcrdr>rFrFrG pin_messagesz_ChatBase.pin_message)rrrarbrcrdr>rMc 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. )rfrarbrcrdr>rrN)rgZunpin_chat_messager7)rCrrrarbrcrdr>rFrFrG unpin_messagesz_ChatBase.unpin_messagecs"|j|j|||||dIdHS)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. reN)rgZunpin_all_chat_messagesr7rhrFrFrGunpin_all_messagessz_ChatBase.unpin_all_messages)reply_to_message_idallow_sending_without_replydisable_web_page_previewrarbrcrdr>r+r(r.r*)text parse_moder reply_markupentitiesprotect_contentmessage_thread_idlink_preview_optionsreply_parametersrmessage_effect_idrrrrarbrcrdr>rMc s>|j|j||||| || || ||||||||| | dIdHS)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. )rfrrrrrrrrrrrrrarbrcrdr>rrN)rg send_messager7)rCrrrrrrrrrrrrrrrarbrcrdr>rFrFrGrs,!z_ChatBase.send_message)rrarbrcrdr>rMc s$|j|j||||||dIdHS)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. )rfrrarbrcrdr>N)rgdelete_messager7)rCrrarbrcrdr>rFrFrGr!sz_ChatBase.delete_message) message_idsrarbrcrdr>rMc s$|j|j||||||dIdHS)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. )rfrrarbrcrdr>N)rgdelete_messagesr7)rCrrarbrcrdr>rFrFrGrAsz_ChatBase.delete_messages) rrrarbrcrdr>captionrcaption_entities)r!r"r#r$)r*.)mediarrrrrrrrrarbrcrdr>rrrrMc s:|j|j|||| | | | || ||||||||dIdHS)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. )rfrrrrarbrcrdr>rrrrrrrrrN)rgsend_media_groupr7)rCrrrrrrrrrrarbrcrdr>rrrrFrFrGras("z_ChatBase.send_media_group) actionrrrarbrcrdr>rMc s(|j|j||||||||d IdHS)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. ) rfrrrarbrcrdr>rN)rgsend_chat_actionr7) rCrrrrarbrcrdr>rFrFrGrsz_ChatBase.send_chat_action)rrfilenamerarbrcrdr>r-)rrrrrrrr has_spoilerrrrshow_caption_above_mediarrrrarbrcrdr>rMcsB|j|j||||| ||||||||||||| | | | dIdHS)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. )rfrrrrrrrrrrrrrarbrcrdr>rrrrN)rg send_photor7)rCrrrrrrrrrrrrrrrrrarbrcrdr>rFrFrGrs0#z_ChatBase.send_photo)rrcontactrarbrcrdr>r) phone_numberr6r9rrvcardrrrrrrrrrarbrcrdr>rMc s>|j|j||||| | ||||||||| ||| | dIdHS)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. )rfrr6r9rrrrrarbrcrdrrr>rrrrrN)rg send_contactr7)rCrr6r9rrrrrrrrrrrrarbrcrdr>rFrFrGrs,!z_ChatBase.send_contactr)audioduration performerr:rrrrrrr thumbnailrrrrrrrarbrcrdr>rMcsF|j|j|||||||| |||| || | |||||| ||dIdHS)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. )rfrrrr:rrrrrrrrrrrrarbrcrdr>rrrN)rg send_audior7)rCrrrr:rrrrrrrrrrrrrrrarbrcrdr>rFrFrGr1s4%z_ChatBase.send_audior)documentrrrrdisable_content_type_detectionrrrrrrrrrrrarbrcrdr>rMcsB|j|j|||||| ||||||| |||||| | | dIdHS)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. )rfrrrrrrrrarbrcrdrrr>rrrrrrrN)rg send_documentr7)rCrrrrrrrrrrrrrrrrrarbrcrdr>rFrFrGrqs0#z_ChatBase.send_document)rrrarbrcrdr>)rremojirrrrrrrrarbrcrdr>rMc s6|j|j|| ||| | | |||| ||||dIdHS)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. )rfrrrrrarbrcrdrr>rrrrrN)rg send_dicer7)rCrrrrrrrrrrrarbrcrdr>rFrFrGrs$z_ChatBase.send_dicer )game_short_namerrrrrrrrrrarbrcrdr>rMc s6|j|j||| ||| | | ||| ||||dIdHS)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. )rfrrrrrrarbrcrdr>rrrrrN)rg send_gamer7)rCrrrrrrrrrrrarbrcrdr>rFrFrGrs$z_ChatBase.send_gamer')#r:rpayloadprovider_tokencurrencypricesstart_parameter photo_url photo_size photo_width photo_height need_nameneed_phone_number need_emailneed_shipping_address is_flexiblerr provider_datasend_phone_number_to_providersend_email_to_providermax_tip_amountsuggested_tip_amountsrrrrrrrarbrcrdr>rMc#%s\|j|j||||||||| | | | | |||||||||||| |!|"|||||||d#IdHS)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. )#rfr:rrrrrrrrrrrrrrrrrrrrrrarbrcrdr>rrrrrrrN)rg send_invoicer7)#rCr:rrrrrrrrrrrrrrrrrrrrrrrrrrrrrarbrcrdr>rFrFrGr sJ:z_ChatBase.send_invoice)rrlocationrarbrcrdr>r))latitude longituderr live_periodhorizontal_accuracyheadingproximity_alert_radiusrrrrrrrrrarbrcrdr>rMcsB|j|j||||| ||||||||||||| | | | dIdHS)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. )rfrrrrrrrarbrcrdrrr>rrrrrrrrN)rg send_locationr7)rCrrrrrrrrrrrrrrrrrarbrcrdr>rFrFrGrms0#z_ChatBase.send_locationr) animationrwidthheightrrrrrrrrrrrrrrrrrarbrcrdr>rMcsJ|j|j||||||||||||||||| || | | | |||dIdHS)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. )rfrrrrrrrrrrrarbrcrdr>rrrrrrrrrrN)rgsend_animationr7)rCrrrrrrrrrrrrrrrrrrrrrarbrcrdr>rFrFrGrs8'z_ChatBase.send_animationr/)stickerrrrrrrrrrrrarbrcrdr>rMc s8|j|j||| ||| | |||| ||||| dIdHS)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. )rfrrrrrrarbrcrdr>rrrrrrN)rg send_stickerr7)rCrrrrrrrrrrrrarbrcrdr>rFrFrGrs&z_ChatBase.send_sticker)rrvenuerarbrcrdr>r1)rrr:address foursquare_idrrfoursquare_typegoogle_place_idgoogle_place_typerrrrrrrrrarbrcrdr>rMcsF|j|j|||||||| ||||||||| | || | ||dIdHS)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. )rfrrr:rrrrrrrarbrcrdrrr>rrrrrrrN)rg send_venuer7)rCrrr:rrrrrrrrrrrrrrrrarbrcrdr>rFrFrGrs4%z_ChatBase.send_venuer2)videorrrrrrrsupports_streamingrrrrrrrrrrrrrarbrcrdr>rMcsL|j|j||||||||||||||| |||| || | | |||dIdHS)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. )rfrrrrrrrrarbrcrdrrrrrr>rrrrrrrrrN)rg send_videor7)rCrrrrrrrrrrrrrrrrrrrrrrarbrcrdr>rFrFrGr_s:(z_ChatBase.send_videor3) video_noterlengthrrrrrrrrrrrrarbrcrdr>rMc s>|j|j||||| | |||||||| |||| | dIdHS)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. )rfrrrrrrrrarbrcrdrr>rrrrrrN)rgsend_video_noter7)rCrrrrrrrrrrrrrrrarbrcrdr>rFrFrGrs,!z_ChatBase.send_video_noter4)voicerrrrrrrrrrrrrrrarbrcrdr>rMc s@|j|j||||| | |||||||||||| | | dIdHS)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. )rfrrrrrrrrarbrcrdrr>rrrrrrrN)rg send_voicer7)rCrrrrrrrrrrrrrrrrarbrcrdr>rFrFrGrs."z_ChatBase.send_voicer&)questionoptionsrr;allows_multiple_answerscorrect_option_id is_closedrr explanationexplanation_parse_mode open_period close_dateexplanation_entitiesrrrrquestion_parse_modequestion_entitiesrrrrarbrcrdr>rMcsP|j|j||||||||||| |||||| | | | ||||||||dIdHS)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. )rfrrrr;rrrrrrrrarbrcrdrrrrrr>rrrrrrrN)rg send_pollr7)rCrrrr;rrrrrrrrrrrrrrrrrrrrarbrcrdr>rFrFrGrs>*z_ChatBase.send_pollr,) from_chat_idrrrrrrrrrrrrrarbrcrdr>rMc s<|j|j||||||| | | |||||||| | dIdHS)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. )rfrrrrrrrrrrrarbrcrdr>rrrNrg copy_messager7)rCrrrrrrrrrrrrrrarbrcrdr>rFrFrG send_copyas*"z_ChatBase.send_copy)rfrrrrrrrrrrrrrarbrcrdr>rMc s<|j|j||||||| | | |||||||| | dIdHS)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. )rrfrrrrrrrrrrarbrcrdr>rrrNr )rCrfrrrrrrrrrrrrrarbrcrdr>rFrFrGr s*"z_ChatBase.copy_message)r,.) rrrrrremove_captionrarbrcrdr>rMc s.|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. ) rfrrrrrr rarbrcrdr>Nrg copy_messagesr7) rCrrrrrr rarbrcrdr>rFrFrG send_copiessz_ChatBase.send_copies) rfrrrrr rarbrcrdr>rMc s.|j|j||||||||| | | d IdHS)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. ) rrfrrrrr rarbrcrdr>Nr ) rCrfrrrrr rarbrcrdr>rFrFrGrsz_ChatBase.copy_messages) rrrrrrarbrcrdr>rMc s,|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. ) rfrrrrarbrcrdr>rrNrgZforward_messager7) rCrrrrrrarbrcrdr>rFrFrG forward_from+ sz_ChatBase.forward_from) rfrrrrrarbrcrdr>rMc s,|j|j||||||| | ||d IdHS)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. ) rrfrrrarbrcrdr>rrNr) rCrfrrrrrarbrcrdr>rFrFrG forward_toU sz_ChatBase.forward_to) rrrrrrarbrcrdr>rMc s,|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. ) rfrrrrrrarbrcrdr>NrgZforward_messagesr7) rCrrrrrrarbrcrdr>rFrFrGforward_messages_from sz_ChatBase.forward_messages_from) rfrrrrrarbrcrdr>rMc s,|j|j||||||||| | d IdHS)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. ) rrfrrrrrarbrcrdr>Nr) rCrfrrrrrarbrcrdr>rFrFrGforward_messages_to sz_ChatBase.forward_messages_tocs"|j|j|||||dIdHS)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. reN)rgZexport_chat_invite_linkr7rhrFrFrGexport_invite_link sz_ChatBase.export_invite_linkr) expire_date member_limitrScreates_join_requestrarbrcrdr>rMc 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` ) rfrrrarbrcrdr>rSrN)rgZcreate_chat_invite_linkr7) rCrrrSrrarbrcrdr>rFrFrGcreate_invite_link sz_ChatBase.create_invite_link) invite_linkrrrSrrarbrcrdr>rMc 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` ) rfrrrrarbrcrdr>rSrN)rgZedit_chat_invite_linkr7) rCrrrrSrrarbrcrdr>rFrFrGedit_invite_link sz_ChatBase.edit_invite_link)rrarbrcrdr>rMc s$|j|j||||||dIdHS)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` )rfrrarbrcrdr>N)rgZrevoke_chat_invite_linkr7)rCrrarbrcrdr>rFrFrGrevoke_invite_linkL sz_ChatBase.revoke_invite_link) subscription_periodsubscription_pricerSrarbrcrdr>rMc s(|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` ) rfrrrSrarbrcrdr>N)rgZ$create_chat_subscription_invite_linkr7) rCrrrSrarbrcrdr>rFrFrGcreate_subscription_invite_linkm sz)_ChatBase.create_subscription_invite_link)rrSrarbrcrdr>rMc s&|j|j|||||||dIdHS)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` )rfrrarbrcrdr>rSN)rgZ"edit_chat_subscription_invite_linkr7)rCrrSrarbrcrdr>rFrFrGedit_subscription_invite_link sz'_ChatBase.edit_subscription_invite_linkc s$|j|j||||||dIdHS)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. rmN)rgZapprove_chat_join_requestr7rnrFrFrGapprove_join_request sz_ChatBase.approve_join_requestc s$|j|j||||||dIdHS)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. rmN)rgZdecline_chat_join_requestr7rnrFrFrGdecline_join_request sz_ChatBase.decline_join_request) menu_buttonrarbrcrdr>rMc s$|j|j||||||dIdHS)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. )rfr$rarbrcrdr>N)rgZset_chat_menu_buttonr7)rCr$rarbrcrdr>rFrFrGset_menu_button sz_ChatBase.set_menu_button) rS icon_coloricon_custom_emoji_idrarbrcrdr>rMc s(|j|j||||||||d IdHS)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` ) rfrSr&r'rarbrcrdr>N)rgcreate_forum_topicr7) rCrSr&r'rarbrcrdr>rFrFrGr( sz_ChatBase.create_forum_topic) rrSr'rarbrcrdr>rMc s(|j|j||||||||d IdHS)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. ) rfrrSr'rarbrcrdr>N)rgedit_forum_topicr7) rCrrSr'rarbrcrdr>rFrFrGr)C sz_ChatBase.edit_forum_topic)rrarbrcrdr>rMc s$|j|j||||||dIdHS)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. rfrrarbrcrdr>N)rgclose_forum_topicr7rCrrarbrcrdr>rFrFrGr+g sz_ChatBase.close_forum_topicc s$|j|j||||||dIdHS)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. r*N)rgreopen_forum_topicr7r,rFrFrGr- sz_ChatBase.reopen_forum_topicc s$|j|j||||||dIdHS)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. r*N)rgdelete_forum_topicr7r,rFrFrGr. sz_ChatBase.delete_forum_topicc s$|j|j||||||dIdHS)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. r*N)rgunpin_all_forum_topic_messagesr7r,rFrFrGr/ sz(_ChatBase.unpin_all_forum_topic_messagescs"|j|j|||||dIdHS)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. reN)rg&unpin_all_general_forum_topic_messagesr7rhrFrFrGr0 sz0_ChatBase.unpin_all_general_forum_topic_messages)rSrarbrcrdr>rMc s$|j|j||||||dIdHS)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. )rfrSrarbrcrdr>N)rgedit_general_forum_topicr7)rCrSrarbrcrdr>rFrFrGr1 sz"_ChatBase.edit_general_forum_topiccs"|j|j|||||dIdHS)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. reN)rgclose_general_forum_topicr7rhrFrFrGr2) sz#_ChatBase.close_general_forum_topiccs"|j|j|||||dIdHS)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. reN)rgreopen_general_forum_topicr7rhrFrFrGr3G sz$_ChatBase.reopen_general_forum_topiccs"|j|j|||||dIdHS)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. reN)rghide_general_forum_topicr7rhrFrFrGr4g sz"_ChatBase.hide_general_forum_topiccs"|j|j|||||dIdHS)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. reN)rgunhide_general_forum_topicr7rhrFrFrGr5 sz$_ChatBase.unhide_general_forum_topiccs"|j|j|||||dIdHS)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. reN)rgZget_chat_menu_buttonr7rhrFrFrGget_menu_button sz_ChatBase.get_menu_buttonr0c 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. )rfrlr>rarbrcrdN)rgget_user_chat_boostsr7rnrFrFrGr7 sz_ChatBase.get_user_chat_boosts) rreactionis_bigrarbrcrdr>rMc s(|j|j||||||||d IdHS)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. ) rfrr8r9rarbrcrdr>N)rgset_message_reactionr7) rCrr8r9rarbrcrdr>rFrFrGr: sz_ChatBase.set_message_reaction)rrrarbrcrdr>r%) star_countrrrrrrrrrrrrrrarbrcrdr>rMc s>|j|j||||||||| | | ||||||| | dIdHS)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. )rfr;rrrrrrrrrrrrarbrcrdr>rrN)rgsend_paid_mediar7)rCr;rrrrrrrrrrrrrrarbrcrdr>rFrFrGr< s,#z_ChatBase.send_paid_media)NNNNN)N)N)N)NN)N)NNNNNNNNNNNNNNN)NN)N)N)NN)NN)NNNN)NNNN)N)N)N)NN)NN)NN)v__name__ __module__ __qualname____doc__ __slots__intstrrboolrr@r rBrHr__annotations__rIrJrKrLpropertyrPrNrRrr_rrrfloatrirrjrkrAr rrqrvrxrzr{r}rr rrrrrrrrrrrrrrrrrrZ send_actionrrrrrrobjectrrrrrrrrrrr r rrrrrrrrrrr r!r"r#r r%r r(r)r+r-r.r/r0r1r2r3r4r5r6r7rr:r< __classcell__rFrFrDrGr5FsF   &!#  #  ! & %  ' %  & # J - ) ' & % % & % $   < $ %   : "   > ;   C   >  3  8  b ?   G   4 C   I  ;   >   N   <   <   1   1  .  /  /  . ! .  0  % )  ) % # ( ' ( $ $ $ $ # % ! # ! # '#( r5c@seZdZdZdZdS)ChataN 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 rFN)r=r>r?r@rArFrFrFrGrJG s5rJN)Dr@rhtmlrtypingrrrrrr Ztelegramr Ztelegram._chatpermissionsr Ztelegram._forumtopicr Ztelegram._menubuttonr Ztelegram._reactionrZtelegram._telegramobjectrZtelegram._utilsrZtelegram._utils.defaultvaluerZtelegram._utils.typesrrrrrZtelegram.helpersrrr`rrZrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5rJrFrFrFrGsZ              t