o f>hg@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@mAZAmBZBmCZCmDZDGdddeZEGdddeEZFdS)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 ChatMemberContactDocumentGiftInlineKeyboardMarkupInputMediaAudioInputMediaDocumentInputMediaPhotoInputMediaVideoInputPaidMediaInputPollOption LabeledPriceLinkPreviewOptionsLocationMessage MessageEntity MessageId PhotoSizeReplyParametersStickerUserChatBoostsVenueVideo VideoNoteVoicecJs)eZdZUdZdZ     drdddededeedeed eed eed eed ee ffd dZ e j j Z eeed< e j jZeeed< e j jZeeed< e j jZeeed< e j jZeeed< edeefddZedeefddZedeefddZdsdeedefddZdsdeedefddZdsdeedefd 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"  dteeeedd"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* dseeeedd"d.ed@eed#eed$eed%eed&eed ee defdAdBZ+               dueeeedd"d.edCeedDeedEeedFeedGeedHeedIeedJeedKeedLeedMeedNeedOeedPeedQeed#eed$eed%eed&eed ee def,dRdSZ,  dteeeedd"d.edTe-d3ee#ee$j%fdUeed#eed$eed%eed&eed ee defdVdWZ. dseeeedd"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 dseeeedd"ddeed#eed$eed%eed&eed ee defdedfZ5edfeeeedd"dgedheedieed#eed$eed%eed&eed ee defdjdkZ6  dteeeedd"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  dteeeedd"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.ddZEeddedddddf deeeeedddheedsee9deedveedweedzed{dieed|eed}eed~eedeed#eed$eed%eed&eed ee ddf"ddZFededddddfdeeeeedddedheedseddveedweedzed{dieed|eed}eed~eedeed#eed$eed%eed&eed ee ddf"ddZGdddddddddddeddddddeddddfdeeeeedddeddededede:ddeedeedeedeedeedeedeedeedeedeedeedheedseddee#eeHfdeedeedeedee:edveedweedzed{d|eed}eed~eedeed#eed$eed%eed&eed ee ddfHdd˄ZIddedddddedddddfdedeeeedd̜deedeedheedsee9deeCdeedeedeedveedweedzed{dieed|eed}eed~eedeededd#eed$eed%eed&eed ee ddf.ddքZJddddeeddeddddddddfdedeeeeddde#e1dfdeeCdeedeedeedreedheedsee9dee:dudveedweedeedee1dzed{dieed|eed}eedeed~eedeedeed#eed$eed%eed&eed ee ddf6dd܄ZKededdddddf deeeeeddde#e1dfdheedsee9dveedweedeedzed{dieed|eed}eed~eedeed#eed$eed%eed&eed ee ddf$ddZLdddddeddddedddddfdedeeeedddeedeedeedeedeedheedsee9deedeedeedveedweedzed{dieed|eed}eed~eedeededd#eed$eed%eed&eed ee ddf2ddZMddedddeddeddddddddddfdedeeeeddde#e1dfdeeCdeedheedsee9deedeedreedeedee:dudveedweedeedee1dzed{dieed|eed}eedeedee1deed~eedeedeed#eed$eed%eed&eed ee ddfZgeeeedd"dwed#eed$eed%eed&eed ee defd?d@Zheeeedd"dwed#eed$eed%eed&eed ee defdAdBZieeeedd"dwed#eed$eed%eed&eed ee defdCdDZjeeeedd"dwed#eed$eed%eed&eed ee defdEdFZkeeeedd"d#eed$eed%eed&eed ee def dGdHZleeeedd"ded#eed$eed%eed&eed ee defdIdJZmeeeedd"d#eed$eed%eed&eed ee def dKdLZneeeedd"d#eed$eed%eed&eed ee def dMdNZoeeeedd"d#eed$eed%eed&eed ee def dOdPZpeeeedd"d#eed$eed%eed&eed ee def dQdRZqeeeedd"d#eed$eed%eed&eed ee decf dSdTZreeeedd"d.ed#eed$eed%eed&eed ee ddUfdVdWZs  dteeeedd"dgedXee#e:e#etefetefdYeed#eed$eed%eed&eed ee defdZd[Zudeddeedddddf edeeeedd\d]ede:d^deedreedee:dudeedheedveedzed{dsee9dieedeed}eedeed~eed#eed$eed%eed&eed ee ddf*d_d`Zvdeddfeeeedd"dae#edbfdqeedceeddee:dudeeed#eed$eed%eed&eed ee defdfdgZw dseeeedd"diedhed]eed#eed$eed%eed&eed ee defdidjZx dseeeedd"dkeed#eed$eed%eed&eed ee defdldmZyeeeedd"d#eed$eed%eed&eed ee def dndoZzeeeedd"diedged#eed$eed%eed&eed ee defdpdqZ{Z|S(w _ChatBasezjBase class for :class:`telegram.Chat` and :class:`telegram.ChatFullInfo`. .. versionadded:: 21.3 ) first_nameidis_forum last_nametitletypeusernameN api_kwargsr7r;r:r<r6r9r8r>c sZtj|d||_ttj|||_||_||_ ||_ ||_ ||_ |jf|_ |dS)Nr=)super__init__r7r get_memberrChatTyper;r:r<r6r9r8 _id_attrs_freeze) selfr7r;r:r<r6r9r8r> __class__A/var/www/html/venv/lib/python3.10/site-packages/telegram/_chat.pyr@Ws   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_namerErHrHrIeffective_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 )r6r9rQrHrHrIrPs  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<rQrHrHrIlinks 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;rKhelpers_mention_markdownr7rP TypeErrorr<rTr:rErUrHrHrIrs  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`. )versionrVrWrXrYrZr[) r;rKr\r7rPr]r<rrTr:r^rHrHrImention_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`. rVz zrZr[) r;rKhelpers_mention_htmlr7rPr]r<rTrr:r^rHrHrIrs  z_ChatBase.mention_html) read_timeout write_timeoutconnect_timeout pool_timeoutr>rcrdrerfc$|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_idrcrdrerfr>N)get_bot leave_chatr7rErcrdrerfr>rHrHrIleave z_ChatBase.leave)r.crg)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. rhN)rjget_chat_administratorsr7rlrHrHrIget_administrators, z_ChatBase.get_administratorscrg)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` rhN)rjget_chat_member_countr7rlrHrHrIget_member_countLrnz_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` rirtrcrdrerfr>N)rjget_chat_memberr7rErtrcrdrerfr>rHrHrIrAhs 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. ) rirtrcrdrerfrzr>ryN)rjban_chat_memberr7) rErtryrzrcrdrerfr>rHrHrI ban_member z_ChatBase.ban_membersender_chat_idc ru)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. rir~rcrdrerfr>Nrjban_chat_sender_chatr7rEr~rcrdrerfr>rHrHrIban_sender_chat z_ChatBase.ban_sender_chatric &|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. rNrrErircrdrerfr>rHrHrIban_chat z_ChatBase.ban_chatc ru)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. rNrjunban_chat_sender_chatr7rrHrHrIunban_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. rNrrrHrHrI unban_chat rz_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. )rirtrcrdrerfr>rN)rjunban_chat_memberr7)rErtrrcrdrerfr>rHrHrI unban_member0s 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. rirtrrrrrrrrrcrdrerfr>rrrrrrrNrH)rjpromote_chat_memberr7)rErtrrrrrrrrrrrrrrrrcrdrerfr>rHrHrIpromote_memberPs\-      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. ) rirtrrzrrcrdrerfr>N)rjrestrict_chat_memberr7) rErtrrzrrcrdrerfr>rHrHrIrestrict_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. )rirrrcrdrerfr>N)rjset_chat_permissionsr7)rErrrcrdrerfr>rHrHrIset_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. )rirtrrcrdrerfr>N)rj#set_chat_administrator_custom_titler7)rErtrrcrdrerfr>rHrHrIset_administrator_custom_titles z(_ChatBase.set_administrator_custom_titlephotoc ru)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. )rirrcrdrerfr>N)rjset_chat_photor7)rErrcrdrerfr>rHrHrI set_photo z_ChatBase.set_photocrg)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. rhN)rjdelete_chat_photor7rlrHrHrI delete_photo*s z_ChatBase.delete_photoc ru)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. )rir:rcrdrerfr>N)rjset_chat_titler7)rEr:rcrdrerfr>rHrHrI set_titleKrz_ChatBase.set_title descriptionc ru)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. )rirrcrdrerfr>N)rjset_chat_descriptionr7)rErrcrdrerfr>rHrHrIset_descriptionnrz_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. ) rirrrcrdrerfr>rN)rjpin_chat_messager7) rErrrrcrdrerfr>rHrHrI 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. )rircrdrerfr>rrN)rjunpin_chat_messager7)rErrrcrdrerfr>rHrHrI unpin_messages z_ChatBase.unpin_messagecrg)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. rhN)rjunpin_all_chat_messagesr7rlrHrHrIunpin_all_messagess z_ChatBase.unpin_all_messages)reply_to_message_idallow_sending_without_replydisable_web_page_previewrcrdrerfr>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. rirrrrrrrrrrrrrcrdrerfr>rrrNrH)rj send_messager7)rErrrrrrrrrrrrrrrrcrdrerfr>rHrHrIrX"      z_ChatBase.send_messagec ru)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. )rirrcrdrerfr>N)rjdelete_messager7)rErrcrdrerfr>rHrHrIr, z_ChatBase.delete_message message_idsc ru)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. )rirrcrdrerfr>N)rjdelete_messagesr7)rErrcrdrerfr>rHrHrIrLrz_ChatBase.delete_messages) rrrcrdrerfr>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. rirrrrcrdrerfr>rrrrrrrrrrNrH)rjsend_media_groupr7)rErrrrrrrrrrrcrdrerfr>rrrrHrHrIrlsP#      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. ) rirrrcrdrerfr>rN)rjsend_chat_actionr7) rErrrrcrdrerfr>rHrHrIrr}z_ChatBase.send_chat_action)rrfilenamercrdrerfr>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. rirrrrrrrrrrrrrcrdrerfr>rrrrrNrH)rj send_photor7)rErrrrrrrrrrrrrrrrrrcrdrerfr>rHrHrIr`$      z_ChatBase.send_photo)rrcontactrcrdrerfr> 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. rirr6r9rrrrrcrdrerfrrr>rrrrrrNrH)rj send_contactr7)rErr6r9rrrrrrrrrrrrrcrdrerfr>rHrHrIrrz_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. rirrrr:rrrrrrrrrrrrcrdrerfr>rrrrNrH)rj send_audior7)rErrrr:rrrrrrrrrrrrrrrrcrdrerfr>rHrHrIrBh&      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. rirrrrrrrrcrdrerfrrr>rrrrrrrrNrH)rj send_documentr7)rErrrrrrrrrrrrrrrrrrcrdrerfr>rHrHrIrrz_ChatBase.send_document)rrrcrdrerfr>emojic 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. rirrrrrcrdrerfrr>rrrrrrNrH)rj send_dicer7)rErrrrrrrrrrrrcrdrerfr>rHrHrIrH      z_ChatBase.send_dicegame_short_namer c 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. rirrrrrrcrdrerfr>rrrrrrNrH)rj send_gamer7)rErrrrrrrrrrrrcrdrerfr>rHrHrIrrz_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. rir:rrrrrrrrrrrrrrrrrrrrrrcrdrerfr>rrrrrrrrNrH)rj send_invoicer7)$rEr:rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrcrdrerfr>rHrHrIr&s;      !"#$ z_ChatBase.send_invoice)rrlocationrcrdrerfr>latitude longitude live_periodhorizontal_accuracyheadingproximity_alert_radiusrr)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. rirrrrrrrcrdrerfrr r>r r r rrrrrrNrH)rj send_locationr7)rErrrrr r r r rrrrrrrrrrcrdrerfr>rHrHrIr rz_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. rirrrrrrrrrrrcrdrerfr>rrrrrrrrrrrNrH)rjsend_animationr7)rErrrrrrrrrrrrrrrrrrrrrrcrdrerfr>rHrHrIrsp(      z_ChatBase.send_animationstickerr/c 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. rirrrrrrcrdrerfr>rrrrrrrNrH)rj send_stickerr7)rErrrrrrrrrrrrrcrdrerfr>rHrHrIr sL      z_ChatBase.send_sticker)rrvenuercrdrerfr>address foursquare_idfoursquare_typegoogle_place_idgoogle_place_typerr1cs|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. rirrr:rrrrrrrcrdrerfrrr>rrrrrrrrNrH)rj send_venuer7)rErrr:rrrrrrrrrrrrrrrrrcrdrerfr>rHrHrIr@rz_ChatBase.send_venuevideor2supports_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. rirrrrrrrrcrdrerfrrrrrrrr>rrrrrrrrrrNrH)rj send_videor7)rErrrrrrrrrrrrrrrrrrrrrrrrrcrdrerfr>rHrHrIr|+      z_ChatBase.send_video video_noter3lengthc 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. rir!rr"rrrrrcrdrerfrr>rrrrrrrNrH)rjsend_video_noter7)rEr!rr"rrrrrrrrrrrrrcrdrerfr>rHrHrIr#rz_ChatBase.send_video_notevoicer4cs|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. rir$rrrrrrrcrdrerfrr>rrrrrrrrNrH)rj send_voicer7)rEr$rrrrrrrrrrrrrrrrcrdrerfr>rHrHrIr%s\#      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. rir&r'rr;r(r)r*rrrrrcrdrerfrrr+r,r-r.r>rr/rrrr0r1NrH)rj send_pollr7)rEr&r'rr;r(r)r*rrr+r,r-r.r/rrrrr0r1rrrrrcrdrerfr>rHrHrIr2Dr 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. rir3rrr4rrrrrrrrcrdrerfr>rrrrNrHrj copy_messager7)rEr3rrrrrrrrrrrr4rrrcrdrerfr>rHrHrI send_copyX$      z_ChatBase.send_copycr5)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. r3rirrr4rrrrrrrrcrdrerfr>rrrrNrHr6)rErirrrrrrrrrrrr4rrrcrdrerfr>rHrHrIr7r9z_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. ) rir3rrrrr:rcrdrerfr>Nrj copy_messagesr7) rEr3rrrrr:rcrdrerfr>rHrHrI send_copies  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. ) r3rirrrrr:rcrdrerfr>Nr<) rErirrrrr:rcrdrerfr>rHrHrIr=5 r?z_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. ) rir3rr4rrcrdrerfr>rrNrjforward_messager7) rEr3rrrrr4rcrdrerfr>rHrHrI forward_fromb s z_ChatBase.forward_fromc r@)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. ) r3rirr4rrcrdrerfr>rrNrA) rErirrrrr4rcrdrerfr>rHrHrI forward_to r?z_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. ) rir3rrrrrcrdrerfr>Nrjforward_messagesr7) rEr3rrrrrcrdrerfr>rHrHrIforward_messages_from  z_ChatBase.forward_messages_fromc rE)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. ) r3rirrrrrcrdrerfr>NrF) rErirrrrrcrdrerfr>rHrHrIforward_messages_to rIz_ChatBase.forward_messages_tocrg)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. rhN)rjexport_chat_invite_linkr7rlrHrHrIexport_invite_link  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` ) rirNrOrcrdrerfr>rUrPN)rjcreate_chat_invite_linkr7) rErNrOrUrPrcrdrerfr>rHrHrIcreate_invite_link0 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` ) rirSrNrOrcrdrerfr>rUrPN)rjedit_chat_invite_linkr7) rErSrNrOrUrPrcrdrerfr>rHrHrIedit_invite_link[ s z_ChatBase.edit_invite_linkc ru)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` )rirSrcrdrerfr>N)rjrevoke_chat_invite_linkr7)rErSrcrdrerfr>rHrHrIrevoke_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` ) rirXrYrUrcrdrerfr>N)rj$create_chat_subscription_invite_linkr7) rErXrYrUrcrdrerfr>rHrHrIcreate_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` )rirSrcrdrerfr>rUN)rj"edit_chat_subscription_invite_linkr7)rErSrUrcrdrerfr>rHrHrIedit_subscription_invite_link s z'_ChatBase.edit_subscription_invite_linkc ru)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. rvN)rjapprove_chat_join_requestr7rxrHrHrIapprove_join_request rz_ChatBase.approve_join_requestc ru)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. rvN)rjdecline_chat_join_requestr7rxrHrHrIdecline_join_request rz_ChatBase.decline_join_request menu_buttonc ru)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. )rircrcrdrerfr>N)rjset_chat_menu_buttonr7)rErcrcrdrerfr>rHrHrIset_menu_button5 s z_ChatBase.set_menu_button icon_coloricon_custom_emoji_idc rZ)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` ) rirUrfrgrcrdrerfr>N)rjcreate_forum_topicr7) rErUrfrgrcrdrerfr>rHrHrIrhZ  z_ChatBase.create_forum_topicc rZ)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. ) rirrUrgrcrdrerfr>N)rjedit_forum_topicr7) rErrUrgrcrdrerfr>rHrHrIrj~ riz_ChatBase.edit_forum_topicc ru)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. rirrcrdrerfr>N)rjclose_forum_topicr7rErrcrdrerfr>rHrHrIrl rz_ChatBase.close_forum_topicc ru)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. rkN)rjreopen_forum_topicr7rmrHrHrIrn rz_ChatBase.reopen_forum_topicc ru)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. rkN)rjdelete_forum_topicr7rmrHrHrIro rz_ChatBase.delete_forum_topicc ru)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. rkN)rjunpin_all_forum_topic_messagesr7rmrHrHrIrp rz(_ChatBase.unpin_all_forum_topic_messagescrg)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. rhN)rj&unpin_all_general_forum_topic_messagesr7rlrHrHrIrq# rMz0_ChatBase.unpin_all_general_forum_topic_messagesc ru)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. )rirUrcrdrerfr>N)rjedit_general_forum_topicr7)rErUrcrdrerfr>rHrHrIrrB s z"_ChatBase.edit_general_forum_topiccrg)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. rhN)rjclose_general_forum_topicr7rlrHrHrIrsd  z#_ChatBase.close_general_forum_topiccrg)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. rhN)rjreopen_general_forum_topicr7rlrHrHrIru rqz$_ChatBase.reopen_general_forum_topiccrg)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. rhN)rjhide_general_forum_topicr7rlrHrHrIrv rtz"_ChatBase.hide_general_forum_topiccrg)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. rhN)rjunhide_general_forum_topicr7rlrHrHrIrw rqz$_ChatBase.unhide_general_forum_topiccrg)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. rhN)rjget_chat_menu_buttonr7rlrHrHrIget_menu_button s z_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. )rirtr>rcrdrerfN)rjget_user_chat_boostsr7rxrHrHrIrz rz_ChatBase.get_user_chat_boostsreactionis_bigc rZ)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. ) rirr{r|rcrdrerfr>N)rjset_message_reactionr7) rErr{r|rcrdrerfr>rHrHrIr}# riz_ChatBase.set_message_reaction)rrrcrdrerfr> 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. rir~rrrrrrrrrrrrcrdrerfr>rrrNrH)rjsend_paid_mediar7)rEr~rrrrrrrrrrrrrrrcrdrerfr>rHrHrIrG r9z_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. ) rrrrrrcrdrerfr>rirtNrH)rj send_giftr;ChatrNr7) rErrrrrrcrdrerfr>rHrHrIr s $ z_ChatBase.send_gift owned_gift_idc rZ)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_idrrr~rcrdrerfr>N)rj transfer_giftr7) rErrr~rcrdrerfr>rHrHrIr rz_ChatBase.transfer_giftcustom_descriptionc ru)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. )rirrcrdrerfr>N)rj verify_chatr7)rErrcrdrerfr>rHrHrIverify rz_ChatBase.verifycrg)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. rhN)rjremove_chat_verificationr7rlrHrHrIremove_verification rtz_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. )rirrrcrdrerfr>N)rjread_business_messager7)rErrrcrdrerfr>rHrHrIrs z_ChatBase.read_business_message)NNNNN)N)NN)NNNNNNNNNNNNNNN)NNNN)}__name__ __module__ __qualname____doc__ __slots__intstrrboolrr@rrBrJr__annotations__rKrLrMrNpropertyrRrPrTrrarrrfloatrmtuplerprsrArdtmdatetimer|rrrrrrr rrrrrrrrrrrrrrrrrr send_actionrrrrrrrobjectrr rrrrr#r%rr2r8r7r>r=rCrDrHrJrLrRrUrWr\r^r`rbr rer rhrjrlrnrorprqrrrsrurvrwryrzr r}rrrrrr __classcell__rHrHrFrIr5Os0    &!#  #   !   & %  ' %  &  #      J    -  )  ' & % % &   %  $         > $ %       <   "        @      =       E        @      5      9       !"#$%& d      A       I       6      E       O       =        @        P       @       @       1       1       0       1      /      .!    .      0  %   )   ) % # (   '   ( $ $ $ $# %!#!#' #   (       ?       6   % ##  r5c@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 rHN)rrrrrrHrHrHrIr9s5r)Grrrcollections.abcrhtmlrtypingrrrrtelegramrtelegram._chatpermissionsr telegram._forumtopicr telegram._menubuttonr telegram._reactionr telegram._telegramobjectr telegram._utilsrtelegram._utils.defaultvaluertelegram._utils.typesrrrrrrtelegram.helpersrrrbrr\rrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5rrHrHrHrIsb              x