U 2tc @s"dZddlZddlmZddlmZmZmZmZmZm Z m Z ddl m Z m Z mZmZddlmZmZmZmZddlmZdd lmZdd lmZdd lmZmZerdd l mZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5Gd dde Z6dS)z?This module contains an object that represents a Telegram Chat.N)datetime) TYPE_CHECKINGListOptionalClassVarUnionTupleAny) ChatPhotoTelegramObject constants MenuButton)JSONDict FileInputODVInputDVInput)TelegramDeprecationWarning)ChatPermissions) ChatLocation) DEFAULT_NONE DEFAULT_20)Bot ChatMemberChatInviteLinkMessage MessageId ReplyMarkupContactInlineKeyboardMarkupLocationVenue MessageEntityInputMediaAudioInputMediaDocumentInputMediaPhotoInputMediaVideo PhotoSizeAudioDocument Animation LabeledPriceStickerVideo VideoNoteVoicec@sJ eZdZUdZdZejZee e d<ej Z ee e d<ej Zee e d<ejZee e d<ejZee e d<dee e e e e d ee e d ee eee eeeeeeeeed d d Zeee dddZeee dddZeeed eddddZ e!dfe"e#eedddZ$e!dfe"e#ee%ddddZ&e!dfe"e#eedddZ'e!dfe"e#eedddZ(e!dfe)e efe"e#edd d!d"Z*e!dddfe)e efe"e#e)ee+feeed#d$d%Z,e!dddfe)e efe"e#e)ee+feeed#d&d'Z-e!dfee"e#eed(d)d*Z.e!dfe)e efe"e#eed+d,d-Z/e!dfee"e#eed(d.d/Z0e!dfe)e efe"e#eed+d0d1Z1e!ddfe)e efe"e#eeed2d3d4Z2dddddddde!dddddfe)e efeeeeeeeee"e#eeeeeed5d6d7Z3de!dfe)e efee)ee+fe"e#eed8d9d:Z4e!dfee"e#eed;dd?d@Z6e!e!dfee"ee"e#eedAdBdCZ7e!ddfe"e#eeedDdEdFZ8e!dfe"e#eeddGdHZ9e!e!e!dde!de!ddf e e"e e"ee:eedIe"e#ee"ee)e%dJe;dKfed dL dMdNZe!dfe e"e#eedSdTdUZ?e?Z@de!dde=e!de!dddf e)eAdVfe e:eedIe:e#e"e ee"ee)e%dJe;dKfe ed dW dXdYZBddde!dde!ddde!df e e e e:eedIe"e#dZe ee"eed d[ d\d]ZCdddde!dde=e!dde!dddfe)eAd^fee e e e:eedIe:e#e"e eAee"ee)e%dJe;dKfe ed d_d`daZDdde!dde=e!ddde!ddf e)eAdbfe e e:eedIe:e#e"e eAeee"ee)e%dJe;dKfed dcdddeZEe!dde!dde!dfe"eedIe"e#e ee"eed df dgdhZFe!dde!de!dfe e:eedie"e#ee"eed dj dkdlZGdddddddddde!ddddde!de!dddfe e e e e e%dme e eeeeeeeee:eedie)e eHfeee"e#ee"eee%eed dndodpZIdde!dde!dddddde!dfe#e#e:eedIe"e#dqeee#eee"eed drdsdtZJddddde!e!dde=de!dddfe)eAdufeeeeAe e"e e:eedIe:e#ee"ee)e%dJe;dKfe ed dvdwdxZKe!dde=de!dfe)eAdyfe:eedIe:e#ee"eed dz d{d|ZLddddde!dde!ddddde!dfe#e#e e e e:eedIe"e#d}e ee e e"eed d~ddZMdde!dde=dde!ddde!dddfe)eAdfee e:eedIe:e#eee"e eeAee"ee)e%dJe;dKfe ed dddZNdde!dde=dde!ddf e)eAdfeee:eedIe:e#eAee"ee ed d ddZOdde!dde=e!de!dddf e)eAdfee e:eedIe:e#e"e ee"ee)e%dJe;dKfe ed dddZPdejQddde!dde!de!ddde!ddfe e%e ee eeee"eedIe"e#e e"e ee)ee+fee"ee)e%dJe;dKfed dddZRde!de!de!de!ddf e)e efee e"e e)e;dKe%dJfe:eee:edIe"e#eedd ddZSde!de!de!de!ddf e)ee fee e"e e)e;dKe%dJfe:eee:edIe"e#eedd ddZTe!dfe"e#ee dddZUdde!dddfe)ee+fee"e#ee eddddZVdde!dddfe e)ee+fee"e#ee eddddZWe!dfe e"e#eddddZXe!dfee"e#eed ddZYe!dfee"e#eed ddZZde!dfe[e"e#eedddZ\e!dfe"e#ee[dddZ]dS)Chata 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. Args: id (:obj:`int`): Unique identifier for this chat. This number may be greater than 32 bits and some programming languages may have difficulty/silent defects in interpreting it. But it is smaller than 52 bits, so a signed 64 bit integer or double-precision float type are safe for storing this identifier. type (:obj:`str`): Type of chat, can be either 'private', 'group', 'supergroup' or '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. photo (:class:`telegram.ChatPhoto`, optional): Chat photo. Returned only in :meth:`telegram.Bot.get_chat`. bio (:obj:`str`, optional): Bio of the other party in a private chat. Returned only in :meth:`telegram.Bot.get_chat`. has_private_forwards (:obj:`bool`, optional): :obj:`True`, if privacy settings of the other party in the private chat allows to use ``tg://user?id=`` links only in chats with the user. Returned only in :meth:`telegram.Bot.get_chat`. .. versionadded:: 13.9 description (:obj:`str`, optional): Description, for groups, supergroups and channel chats. Returned only in :meth:`telegram.Bot.get_chat`. invite_link (:obj:`str`, optional): Primary invite link, for groups, supergroups and channel. Returned only in :meth:`telegram.Bot.get_chat`. pinned_message (:class:`telegram.Message`, optional): The most recent pinned message (by sending date). Returned only in :meth:`telegram.Bot.get_chat`. permissions (:class:`telegram.ChatPermissions`): Optional. Default chat member permissions, for groups and supergroups. Returned only in :meth:`telegram.Bot.get_chat`. slow_mode_delay (:obj:`int`, optional): For supergroups, the minimum allowed delay between consecutive messages sent by each unprivileged user. Returned only in :meth:`telegram.Bot.get_chat`. message_auto_delete_time (:obj:`int`, optional): The time after which all messages sent to the chat will be automatically deleted; in seconds. Returned only in :meth:`telegram.Bot.get_chat`. .. versionadded:: 13.4 has_protected_content (:obj:`bool`, optional): :obj:`True`, if messages from the chat can't be forwarded to other chats. Returned only in :meth:`telegram.Bot.get_chat`. .. versionadded:: 13.9 bot (:class:`telegram.Bot`, optional): The Bot to use for instance methods. sticker_set_name (:obj:`str`, optional): For supergroups, name of group sticker set. Returned only in :meth:`telegram.Bot.get_chat`. can_set_sticker_set (:obj:`bool`, optional): :obj:`True`, if the bot can change group the sticker set. Returned only in :meth:`telegram.Bot.get_chat`. linked_chat_id (:obj:`int`, optional): Unique identifier for the linked chat, i.e. the discussion group identifier for a channel and vice versa; for supergroups and channel chats. Returned only in :meth:`telegram.Bot.get_chat`. location (:class:`telegram.ChatLocation`, optional): For supergroups, the location to which the supergroup is connected. Returned only in :meth:`telegram.Bot.get_chat`. join_to_send_messages (:obj:`bool`, optional): :obj:`True`, if users need to join the supergroup before they can send messages. Returned only in :meth:`telegram.Bot.get_chat`. .. versionadded:: 13.13 join_by_request (:obj:`bool`, optional): :obj:`True`, if all users directly joining the supergroup need to be approved by supergroup administrators. Returned only in :meth:`telegram.Bot.get_chat`. .. versionadded:: 13.13 has_restricted_voice_and_video_messages (:obj:`bool`, optional): :obj:`True`, if the privacy settings of the other party restrict sending voice and video note messages in the private chat. Returned only in :meth:`telegram.Bot.get_chat`. .. versionadded:: 13.14 **kwargs (:obj:`dict`): Arbitrary keyword arguments. Attributes: id (:obj:`int`): Unique identifier for this chat. type (:obj:`str`): Type of chat. title (:obj:`str`): Optional. Title, for supergroups, channels and group chats. username (:obj:`str`): Optional. Username. 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. photo (:class:`telegram.ChatPhoto`): Optional. Chat photo. bio (:obj:`str`): Optional. Bio of the other party in a private chat. Returned only in :meth:`telegram.Bot.get_chat`. has_private_forwards (:obj:`bool`): Optional. :obj:`True`, if privacy settings of the other party in the private chat allows to use ``tg://user?id=`` links only in chats with the user. .. versionadded:: 13.9 description (:obj:`str`): Optional. Description, for groups, supergroups and channel chats. invite_link (:obj:`str`): Optional. Primary invite link, for groups, supergroups and channel. Returned only in :meth:`telegram.Bot.get_chat`. pinned_message (:class:`telegram.Message`): Optional. The most recent pinned message (by sending date). Returned only in :meth:`telegram.Bot.get_chat`. permissions (:class:`telegram.ChatPermissions`): Optional. Default chat member permissions, for groups and supergroups. Returned only in :meth:`telegram.Bot.get_chat`. slow_mode_delay (:obj:`int`): Optional. For supergroups, the minimum allowed delay between consecutive messages sent by each unprivileged user. Returned only in :meth:`telegram.Bot.get_chat`. message_auto_delete_time (:obj:`int`): Optional. The time after which all messages sent to the chat will be automatically deleted; in seconds. Returned only in :meth:`telegram.Bot.get_chat`. .. versionadded:: 13.4 has_protected_content (:obj:`bool`): Optional. :obj:`True`, if messages from the chat can't be forwarded to other chats. .. versionadded:: 13.9 sticker_set_name (:obj:`str`): Optional. For supergroups, name of Group sticker set. can_set_sticker_set (:obj:`bool`): Optional. :obj:`True`, if the bot can change group the sticker set. linked_chat_id (:obj:`int`): Optional. Unique identifier for the linked chat, i.e. the discussion group identifier for a channel and vice versa; for supergroups and channel chats. Returned only in :meth:`telegram.Bot.get_chat`. location (:class:`telegram.ChatLocation`): Optional. For supergroups, the location to which the supergroup is connected. Returned only in :meth:`telegram.Bot.get_chat`. join_to_send_messages (:obj:`bool`): Optional. :obj:`True`, if users need to join the supergroup before they can send messages. Returned only in :meth:`telegram.Bot.get_chat`. .. versionadded:: 13.13 join_by_request (:obj:`bool`): Optional. :obj:`True`, if all users directly joining the supergroup need to be approved by supergroup administrators. Returned only in :meth:`telegram.Bot.get_chat`. .. versionadded:: 13.13 has_restricted_voice_and_video_messages (:obj:`bool`): Optional. :obj:`True`, if the privacy settings of the other party restrict sending voice and video note messages in the private chat. Returned only in :meth:`telegram.Bot.get_chat`. .. versionadded:: 13.14 )bioidtype last_namebotsticker_set_nameslow_mode_delaylocation first_name permissions invite_linkpinned_message descriptioncan_set_sticker_setusernametitlephotolinked_chat_idall_members_are_administratorsmessage_auto_delete_timehas_protected_contenthas_private_forwardsjoin_to_send_messagesjoin_by_request'has_restricted_voice_and_video_messages _id_attrsSENDERPRIVATEGROUP SUPERGROUPCHANNELNrr)r2r3r@r?r9r4r5rAr=r;r<r:r6r>r7r1rBr8rDrFrErGrHrI_kwargscKst||_||_||_||_||_||_|d|_||_ ||_ ||_ | |_ | |_ | |_| |_||_|dk rtt|nd|_||_| |_||_||_||_||_||_||_||_|jf|_dS)NrC)intr2r3r@r?r9r4getrCrAr1rFr=r;r<r:r7rDrEr6r>rBr8rGrHrIr5rJ)selfr2r3r@r?r9r4r5rAr=r;r<r:r6r>r7r1rBr8rDrFrErGrHrIrPrT1/tmp/pip-unpacked-wheel-2u9rcp5s/telegram/chat.py__init__s6  z Chat.__init__)returncCs(|js dS|jr"|jd|jS|jS)aK :obj:`str`: Convenience property. If :attr:`first_name` is not :obj:`None` gives, :attr:`first_name` followed by (if available) :attr:`last_name`. Note: :attr:`full_name` will always be :obj:`None`, if the chat is a (super)group or channel. .. versionadded:: 13.2 N )r9r4rSrTrTrU full_name+s zChat.full_namecCs|jrd|jSdS)zw:obj:`str`: Convenience property. If the chat has a :attr:`username`, returns a t.me link of the chat. z https://t.me/N)r?rYrTrTrUlink=s z Chat.link)datar5rWcCs||}|sdSt|d||d<ddlm}||d||d<t|d||d<t|d||d<|fd|i|S) z,See :meth:`telegram.TelegramObject.de_json`.NrAr)rr<r:r8r5)Z _parse_datar de_jsonrRtelegramrrr)clsr\r5rrTrTrUr]Fs  z Chat.de_json)timeout api_kwargsrWcCs|jj|j||dS)a Shortcut for:: 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_idr`ra)r5Z leave_chatr2rSr`rarTrTrUleaveWs z Chat.leavercCs|jj|j||dS)aTShortcut for:: 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: List[:class:`telegram.ChatMember`]: A list 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. rb)r5Zget_chat_administratorsr2rdrTrTrUget_administratorshs zChat.get_administratorscCstjdtdd|j||dS)zp Deprecated, use :func:`~telegram.Chat.get_member_count` instead. .. deprecated:: 13.7 zL`Chat.get_members_count` is deprecated. Use `Chat.get_member_count` instead. stacklevel)r`ra)warningswarnrget_member_countrdrTrTrUget_members_countszChat.get_members_countcCs|jj|j||dS)aShortcut for:: 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` rb)r5Zget_chat_member_countr2rdrTrTrUrls zChat.get_member_count)user_idr`rarWcCs|jj|j|||dS)aShortcut for:: 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` rcrnr`ra)r5Zget_chat_memberr2rSrnr`rarTrTrU get_members zChat.get_member)rnr` until_daterarevoke_messagesrWcCs$tjdtdd|j|||||dS)zj Deprecated, use :func:`~telegram.Chat.ban_member` instead. .. deprecated:: 13.7 z@`Chat.kick_member` is deprecated. Use `Chat.ban_member` instead.rgrh)rnr`rrrars)rjrkr ban_memberrSrnr`rrrarsrTrTrU kick_members zChat.kick_membercCs|jj|j|||||dS)aShortcut for:: 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. )rcrnr`rrrars)r5Zban_chat_memberr2rurTrTrUrtszChat.ban_member)sender_chat_idr`rarWcCs|jj|j|||dS)aPShortcut for:: 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. rcrwr`rar5Zban_chat_sender_chatr2rSrwr`rarTrTrUban_sender_chats zChat.ban_sender_chat)rcr`rarWcCs|jj||j||dS)aWShortcut for:: 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. rxryrSrcr`rarTrTrUban_chat s z Chat.ban_chatcCs|jj|j|||dS)aTShortcut for:: 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. rxr5Zunban_chat_sender_chatr2rzrTrTrUunban_sender_chat s zChat.unban_sender_chatcCs|jj||j||dS)a[Shortcut for:: 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. rxr~r|rTrTrU unban_chat7s zChat.unban_chat)rnr`raonly_if_bannedrWcCs|jj|j||||dS)aShortcut for:: 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. )rcrnr`rar)r5Zunban_chat_memberr2)rSrnr`rarrTrTrU unban_memberNszChat.unban_member)rncan_change_infocan_post_messagescan_edit_messagescan_delete_messagescan_invite_userscan_restrict_memberscan_pin_messagescan_promote_membersr`ra is_anonymouscan_manage_chatcan_manage_voice_chatscan_manage_video_chatsrWcCs.|jj|j||||||||| | | | | ||dS)aShortcut for:: 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:: 13.12 Since Bot API 6.0, voice chat was renamed to video chat. Returns: :obj:`bool`: On success, :obj:`True` is returned. )rcrnrrrrrrrrr`rarrrr)r5Zpromote_chat_memberr2)rSrnrrrrrrrrr`rarrrrrTrTrUpromote_membergs$"zChat.promote_member)rnr:rrr`rarWcCs|jj|j|||||dS)aHShortcut for:: 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 Returns: :obj:`bool`: On success, :obj:`True` is returned. )rcrnr:rrr`ra)r5Zrestrict_chat_memberr2)rSrnr:rrr`rarTrTrUrestrict_memberszChat.restrict_member)r:r`rarWcCs|jj|j|||dS)a(Shortcut for:: bot.set_chat_permissions(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.set_chat_permissions`. Returns: :obj:`bool`: On success, :obj:`True` is returned. )rcr:r`ra)r5Zset_chat_permissionsr2)rSr:r`rarTrTrUset_permissionss zChat.set_permissions)rn custom_titler`rarWcCs|jj|j||||dS)aFShortcut for:: 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. )rcrnrr`ra)r5Z#set_chat_administrator_custom_titler2)rSrnrr`rarTrTrUset_administrator_custom_titlesz#Chat.set_administrator_custom_title) message_iddisable_notificationr`rarWcCs|jj|j||||dS)amShortcut for:: 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. )rcrrr`ra)r5Zpin_chat_messager2)rSrrr`rarTrTrU pin_messageszChat.pin_message)r`rarrWcCs|jj|j|||dS)auShortcut for:: 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. )rcr`rar)r5Zunpin_chat_messager2)rSr`rarrTrTrU unpin_messages zChat.unpin_messagecCs|jj|j||dS)aShortcut for:: 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. rb)r5Zunpin_all_chat_messagesr2rdrTrTrUunpin_all_messages"s zChat.unpin_all_messagesrr")r".) text parse_modedisable_web_page_previewrreply_to_message_id reply_markupr`raallow_sending_without_replyentitiesprotect_contentrWc Cs&|jj|j||||||||| | | d S)a/Shortcut for:: 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. ) rcrrrrrrr`rarrr)r5 send_messager2) rSrrrrrrr`rarrrrTrTrUr:szChat.send_message)r#r$r%r&)mediarrr`rarrrWc Cs|jj|j|||||||dS)a=Shortcut for:: 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: List[:class:`telegram.Message`]: On success, instance representing the message posted. )rcrrrr`rarr)r5send_media_groupr2)rSrrrr`rarrrTrTrUraszChat.send_media_group)actionr`rarWcCs|jj|j|||dS)aShortcut for:: 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. )rcrr`ra)r5send_chat_actionr2)rSrr`rarTrTrUrs zChat.send_chat_actionr') rAcaptionrrrr`rrarcaption_entitiesfilenamerrWc Cs(|jj|j||||||||| | | | d S)a+Shortcut for:: 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. ) rcrArrrrr`rrarrrr)r5 send_photor2) rSrArrrrr`rrarrrrrTrTrUrszChat.send_photor) phone_numberr9r4rrrr`contactvcardrarrrWc Cs(|jj|j||||||||| | | | d S)a/Shortcut for:: 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. ) rcrr9r4rrrr`rrrarr)r5 send_contactr2) rSrr9r4rrrr`rrrarrrTrTrUrszChat.send_contactr()audioduration performerr@rrrrr`rthumbrarrrrrWcCs0|jj|j||||||||| | | | | |||dS)a+Shortcut for:: 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. )rcrrrr@rrrrr`rrrarrrr)r5 send_audior2)rSrrrr@rrrrr`rrrarrrrrTrTrUrs&zChat.send_audior))documentrrrrrr`rrradisable_content_type_detectionrrrrWcCs,|jj|j||||||||| | | | | |dS)a1Shortcut for:: 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. )rcrrrrrrr`rrrarrrr)r5 send_documentr2)rSrrrrrrr`rrrarrrrrTrTrUrs"zChat.send_document) rrrr`emojirarrrWc Cs |jj|j||||||||d S)a)Shortcut for:: 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. ) rcrrrr`rrarr)r5 send_dicer2) rSrrrr`rrarrrTrTrUrLszChat.send_dicer) game_short_namerrrr`rarrrWc Cs |jj|j||||||||d S)a)Shortcut for:: 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. ) rcrrrrr`rarr)r5 send_gamer2) rSrrrrr`rarrrTrTrUrmszChat.send_gamer+)r@r=payloadprovider_tokencurrencypricesstart_parameter photo_url photo_size photo_width photo_height need_nameneed_phone_number need_emailneed_shipping_address is_flexiblerrr provider_datasend_phone_number_to_providersend_email_to_providerr`rarmax_tip_amountsuggested_tip_amountsrrWcCsH|jj|j||||||||| | | | | |||||||||||||||dS)aShortcut for:: 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 :attr:`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 :attr:`start_parameter` is optional. Returns: :class:`telegram.Message`: On success, instance representing the message posted. )rcr@r=rrrrrrrrrrrrrrrrrrrrr`rarrrr)r5 send_invoicer2)rSr@r=rrrrrrrrrrrrrrrrrrrrr`rarrrrrTrTrUrs>1zChat.send_invoicer )latitude longituderrrr`r8 live_periodrahorizontal_accuracyheadingproximity_alert_radiusrrrWcCs,|jj|j||||||||| | | | | |dS)a1Shortcut for:: 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. )rcrrrrrr`r8rrarrrrr)r5 send_locationr2)rSrrrrrr`r8rrarrrrrrTrTrUrs"zChat.send_locationr*) animationrwidthheightrrrrrrr`rarrrrrWcCs0|jj|j||||||||| | | | | |||dS)a3Shortcut for:: 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. )rcrrrrrrrrrrr`rarrrr)r5send_animationr2)rSrrrrrrrrrrr`rarrrrrTrTrUr s&zChat.send_animationr,) stickerrrrr`rarrrWc Cs |jj|j||||||||d S)a/Shortcut for:: 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. ) rcrrrrr`rarr)r5 send_stickerr2) rSrrrrr`rarrrTrTrUr=szChat.send_stickerr!)rrr@address foursquare_idrrrr`venuefoursquare_typeragoogle_place_idgoogle_place_typerrrWcCs0|jj|j||||||||| | | | | |||dS)a+Shortcut for:: 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. )rcrrr@rrrrrr`rrrarrrr)r5 send_venuer2)rSrrr@rrrrrr`rrrarrrrrTrTrUr^s&zChat.send_venuer-)videorrrrrr`rrrsupports_streamingrrarrrrrWcCs2|jj|j||||||||| | | | | ||||dS)a+Shortcut for:: 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. )rcrrrrrrr`rrrrrrarrrr)r5 send_videor2)rSrrrrrrr`rrrrrrarrrrrTrTrUrs(zChat.send_videor.) video_noterlengthrrrr`rrarrrrWc Cs(|jj|j||||||||| | | | d S)a5Shortcut for:: 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. ) rcrrrrrrr`rrarrr)r5send_video_noter2) rSrrrrrrr`rrarrrrTrTrUrszChat.send_video_noter/)voicerrrrrr`rrarrrrrWcCs*|jj|j||||||||| | | | | dS)a+Shortcut for:: 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. )rcrrrrrrr`rrarrrr)r5 send_voicer2)rSrrrrrrr`rrarrrrrTrTrUrs zChat.send_voiceTF)questionoptionsrr3allows_multiple_answerscorrect_option_id is_closedrrrr` explanationexplanation_parse_mode open_period close_daterarexplanation_entitiesrrWcCs6|jj|j||||||||| | | | | ||||||dS)a)Shortcut for:: 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. )rcrrrr3rrrrrrr`rrrrrarrr)r5 send_pollr2)rSrrrr3rrrrrrr`rrrrrarrrrTrTrUrs,!zChat.send_pollr) from_chat_idrrrrrrrrr`rarrWc Cs(|jj|j||||||||| | | | d S)a7Shortcut for:: bot.copy_message(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.copy_message`. Returns: :class:`telegram.Message`: On success, instance representing the message posted. ) rcrrrrrrrrrr`rarr5 copy_messager2) rSrrrrrrrrrr`rarrTrTrU send_copyNszChat.send_copy) rcrrrrrrrrr`rarrWc Cs(|jj|j||||||||| | | | d S)a<Shortcut for:: 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`. Returns: :class:`telegram.Message`: On success, instance representing the message posted. ) rrcrrrrrrrrr`rarr) rSrcrrrrrrrrr`rarrTrTrUrwszChat.copy_messagecCs|jj|j||dS)aLShortcut for:: 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. rb)r5Zexport_chat_invite_linkr2rdrTrTrUexport_invite_links zChat.export_invite_linkr) expire_date member_limitr`ranamecreates_join_requestrWc Cs|jj|j||||||dS)aShortcut for:: 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` )rcrrr`rarr)r5Zcreate_chat_invite_linkr2)rSrrr`rarrrTrTrUcreate_invite_linkszChat.create_invite_link)r;rrr`rarrrWc Cs|jj|j|||||||dS)aShortcut for:: 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` )rcr;rrr`rarr)r5Zedit_chat_invite_linkr2)rSr;rrr`rarrrTrTrUedit_invite_linkszChat.edit_invite_link)r;r`rarWcCs|jj|j|||dS)aEShortcut for:: 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` )rcr;r`ra)r5Zrevoke_chat_invite_linkr2)rSr;r`rarTrTrUrevoke_invite_links zChat.revoke_invite_linkcCs|jj|j|||dS)aZShortcut for:: 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. ro)r5Zapprove_chat_join_requestr2rprTrTrUapprove_join_requests zChat.approve_join_requestcCs|jj|j|||dS)aZShortcut for:: 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. ro)r5Zdecline_chat_join_requestr2rprTrTrUdecline_join_request-s zChat.decline_join_request) menu_buttonr`rarWcCs|jj|j|||dS)aShortcut for:: 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:: 13.12 Returns: :obj:`bool`: On success, :obj:`True` is returned. )rcrr`ra)r5Zset_chat_menu_buttonr2)rSrr`rarTrTrUset_menu_buttonDs zChat.set_menu_buttoncCs|jj|j||dS)aShortcut for:: bot.get_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:`set_menu_button` .. versionadded:: 13.12 Returns: :class:`telegram.MenuButton`: On success, the current menu button is returned. rb)r5Zget_chat_menu_buttonr2rdrTrTrUget_menu_buttonbs zChat.get_menu_button)NNNNNNNNNNNNNNNNNNNNNN)^__name__ __module__ __qualname____doc__ __slots__r Z CHAT_SENDERrKrstr__annotations__Z CHAT_PRIVATErLZ CHAT_GROUPrMZCHAT_SUPERGROUPrNZ CHAT_CHANNELrOrQr rboolrr rVpropertyrrZr[ classmethodrr]rrfloatrerrfrmrlrrqrrvrtr{r}rrrrrrrrrrrrrrrrZ send_actionrrrrrrrobjectrrrrrrrrZ POLL_REGULARrrrrrrrrrr rrrTrTrTrUr0>s  =                     9   !       , $   + ,  4  / $ )  S 0  4  # 4  6  ,  /  <  -  +   '  (    r0)7r rjrtypingrrrrrrr r^r r r r Ztelegram.utils.typesrrrrZtelegram.utils.deprecaterZchatpermissionsrZ chatlocationrZ utils.helpersrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0rTrTrTrUs $   h