o Zzjzr@sdZddlZddlmZddlmZddlmZm Z ddl m Z ddl m Z ddlmZdd lmZdd lmZdd lmZdd lmZdd lmZddlmZmZmZmZmZm Z ddl!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/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;mZ>m?Z?m@Z@mAZAmBZBmCZCmDZDmEZEmFZFmGZGmHZHmIZImJZJmKZKmLZLddlmMZMGdddeZNGdddeNZOdS)z?This module contains an object that represents a Telegram Chat.N)Sequence)escape) TYPE_CHECKINGFinal) constants)ChatPermissions) ForumTopic) MenuButton) ReactionType)TelegramObject)enum) DEFAULT_NONE)CorrectOptionIDCorrectOptionIds FileInputJSONDictODVInput TimePeriod) get_full_nameget_link)escape_markdown) mention_html)mention_markdown)# AnimationAudioChatInviteLink ChatMemberContactDocumentGiftInlineKeyboardMarkupInputChecklistInputMediaAudioInputMediaDocumentInputMediaLivePhotoInputMediaPhotoInputMediaVideoInputPaidMediaInputPollMediaInputPollOption LabeledPriceLinkPreviewOptions LivePhotoLocationMessage MessageEntity MessageId OwnedGifts PhotoSizeReplyParametersStickerStorySuggestedPostParametersUserChatBoostsVenueVideo VideoNoteVoice) ReplyMarkupcVs0eZdZUdZdZ      ddddedededBdedBd edBd edBd edBd edBd edBffddZ e j j Z e eed< e j jZe eed< e j jZe eed< e j jZe eed< e j jZe eed< ededBfddZededBfddZededBfddZddedBdefddZddedBdefdd ZddedBdefd!d"Zeeeedd#d$eed%eed&eed'eed edBdef d(d)Z deeeedd#d*edBd$eed%eed&eed'eed edBded+fd,d-Zeeeedd#d$eed%eed&eed'eed edBdef d.d/Z eeeedd#d0ed$eed%eed&eed'eed edBdd1fd2d3Z!  deeeedd#d0ed4edBd5ee"j#BdBd$eed%eed&eed'eed edBdefd6d7Z$eeeedd#d8ed$eed%eed&eed'eed edBdefd9d:Z%eeeedd#d;eeBd$eed%eed&eed'eed edBdefdd?Z'eeeedd#d;eeBd$eed%eed&eed'eed edBdefd@dAZ( deeeedd#d0edBedBd$eed%eed&eed'eed edBdefdCdDZ)                 deeeedd#d0edEedBdFedBdGedBdHedBdIedBdJedBdKedBdLedBdMedBdNedBdOedBdPedBdQedBdRedBdSedBdTedBdUedBd$eed%eed&eed'eed edBdef0dVdWZ*  deeeedd#d0edXe+d5ee"j#BdBdYedBd$eed%eed&eed'eed edBdefdZd[Z, deeeedd#dXe+dYedBd$eed%eed&eed'eed edBdefd\d]Z-eeeedd#d0ed^ed$eed%eed&eed'eed edBdefd_d`Z.eeeedd#dae/d$eed%eed&eed'eed edBdefdbdcZ0eeeedd#d$eed%eed&eed'eed edBdef dddeZ1eeeedd#ded$eed%eed&eed'eed edBdefdfdgZ2 deeeedd#dhedBd$eed%eed&eed'eed edBdefdidjZ3edfeeeedd#dkedleedmedBd$eed%eed&eed'eed edBdefdndoZ4  deeeedd#dkedBdmedBd$eed%eed&eed'eed edBdefdpdqZ5eeeedd#d$eed%eed&eed'eed edBdef drdsZ6eeddededdddddf dedeeeeddtduedveedleedwdxdye7dzdBd{eed|edBd}ed~dddmedBdedBdedBdedBdddedBdeededBd$eed%eed&eed'eed edBddf.ddZ8ddedfeeeedd#deduedBd|edBdveedye7dzdBd$eed%eed&eed'eed edBdefddZ9eeeedd#dked$eed%eed&eed'eed edBdefddZ:eeeedd#de7ed$eed%eed&eed'eed edBdefddZ;eeddddddfdeeeeeddedd de7ddleed{eed|edBdddmedBdedBdedBdedBdedBdeed$eed%eed&eed'eed edBdedBdveede7dzdBdedf(ddZ<  deeeedd#ded|edBdmedBd$eed%eed&eed'eed edBdefddZ=e=Z> dedededddddddddfdedeeeedddaddedBdleedwdxdveede7dzdBd{eed|edBdedBdddmedBdedBdedBdedBdedBdddedBdeededBd$eed%eed&eed'eed edBddf2ddZ?ddddedddeedddddfeddeeeedddddaddmedBd|edBdedBdedBdveede7dzdBdedBdedBdleed{eededBdedBdddddwdxdeededBdedBd$eed%eed&eed'eed edBddf4ddZ@dddeddedddddddfdedeeeedddedBd edBd edBdleedwdxdedBd{eed|edBdddmedBdedBdedBdedBdddedBdeeddd$eed%eed&eed'eed edBddf.ddZAddddedededdddddddfdedeeeedddddeBdBdedBdedBdedBdleedwdxdveede7dzdBd{eed|edBdddddmedBdedBdedBdedBdddedBdeededBd$eed%eed&eed'eed edBddf6ddZCdededdeddddddddfdedeeeedddddedBdleedwdxdveededBde7dzdBd{eed|edBdddddmedBdedBdedBdedBdddedBdeededBd$eed%eed&eed'eed edBddf2ddZDededdfdeeeeedddmedddleedwdd{eedddedBdedBdeed$eed%eed&eed'eed edBddfddĄZEeddedddddddf deeeeedddleedwdxdedBd{eed|edBdddmedBdedBdedBdedBdddedBdeed$eed%eed&eed'eed edBddf&ddDŽZFededddddfdeeeeedddedleedwdd{eed|edBdddmedBdedBdedBdedBdeed$eed%eed&eed'eed edBddf"ddʄZGdddddddddddeddddddeddddddfdeeeeedddedhededede7ddedBdedBdedBdedBdedBdedBdedBdedBdedBdedBdedBdleedwddeeHBdBdedBdedBdedBde7edBd{eed|edBdddedBdedBdedBdddedBdeed$eed%eed&eed'eed edBddfLddZIddedddddedddddddfdedeeeedddedBdedBdleedwdxdeBdBdedBdedBdedBd{eed|edBdddmedBdedBdedBdedBdddedBdeeddd$eed%eed&eed'eed edBddf2ddZJddddeeddeddddddddddfdedeeeedddddeBdBdedBdedBdedBdveedleedwdxde7dzdBd{eed|edBdedBdddddmedBdedBdedBdedBdedBdddedBdeededBd$eed%eed&eed'eed edBddf:ddZKededdddddddf deeeeedddddleedwdxd{eed|edBdedBdddmedBdedBdedBdedBdddedBdeed$eed%eed&eed'eed edBddf(ddZLdddddeddddedddddddfdedeeeedddedBdedBdedBdedBdedBdleedwdxdedBdedBdedBd{eed|edBdddmedBdedBdedBdedBdddedBdeeddd$eed%eed&eed'eed edBddf6ddZMddedddeddeddddddddddddfdedeeeedddddeBdBdedBdleedwdxdedBdedBdveededBde7dzdBd{eed|edBdedBdddddmedBdedBdedBdedBdddedBdedBdddedBdeededBd$eed%eed&eed'eed edBddf@ddZNddededdddddddf dedeeeedddddeBdBd edBdleedwdxd{eed|edBdddddmedBdedBdedBdedBdddedBdeededBd$eed%eed&eed'eed edBddf.d d ZOddedededddddddfdedeeeeddd d deBdBdedBdleedwdxdveede7dzdBd{eed|edBdddmedBdedBdedBdedBdddedBdeededBd$eed%eed&eed'eed edBddf0ddZPdddddeddedddedddedddddddddddddddf deeeeedddede7ddMedBdedBdedBdeQdBdedBdleedwdxdedBdeedeBdBdee"j#BdBde7dzdBd{eed|edBdddmedBdeede7dzdBdedBdedBdedBdedBdeRdBd edBd!edBdhedBd"eedBd#e7dzdBd$edBd%e7edBd&d'dd'dedBdeed$eed%eed&eed'eed edBddfTd(d)ZSdedededdddddddfdeeeeeddd*eeBdkededBdveede7dzdBdleedwdxd{eed|edBdddedBdedBd+edBdedBdddedBdedBdeed$eed%eed&eed'eed edBdd,f0d-d.ZTdedededdddddddfdeeeeeddd;eeBdkededBdveede7dzdBdleedwdxd{eed|edBdddedBdedBd+edBdedBdddedBdedBdeed$eed%eed&eed'eed edBdd,f0d/d0ZUeedddfeeeedd#d*eeBde7edleed{eed|edBd1edBdedBd$eed%eed&eed'eed edBded2fd3d4ZVeedddfeeeedd#d;eeBde7edleed{eed|edBd1edBdedBd$eed%eed&eed'eed edBded2fd5d6ZWeedddddfeeeedd#d*eeBdkedleed{eed|edBd+edBdedBdddedBd$eed%eed&eed'eed edBddfd7d8ZXeedddddfeeeedd#d;eeBdkedleed{eed|edBd+edBdedBdddedBd$eed%eed&eed'eed edBddfd9d:ZYeeddfeeeedd#d*eeBde7edleed{eed|edBdedBd$eed%eed&eed'eed edBded2fd;d<ZZeeddfeeeedd#d;eeBde7edleed{eed|edBdedBd$eed%eed&eed'eed edBded2fd=d>Z[eeeedd#d$eed%eed&eed'eed edBdef d?d@Z\    deeeedd#dAee"j#BdBdBedBdedBdCedBd$eed%eed&eed'eed edBddDfdEdFZ]    deeeedd#dGdHdAee"j#BdBdBedBdedBdCedBd$eed%eed&eed'eed edBddDfdIdJZ^eeeedd#dGdHd$eed%eed&eed'eed edBddDfdKdLZ_ deeeedd#dMeBdNededBd$eed%eed&eed'eed edBddDfdOdPZ` deeeedd#dGdHdedBd$eed%eed&eed'eed edBddDfdQdRZaeeeedd#d0ed$eed%eed&eed'eed edBdefdSdTZbeeeedd#d0ed$eed%eed&eed'eed edBdefdUdVZc deeeedd#dWeddBd$eed%eed&eed'eed edBdefdXdYZe  deeeedd#dedZedBd[edBd$eed%eed&eed'eed edBdeffd\d]Zg  deeeedd#d|ededBd[edBd$eed%eed&eed'eed edBdefd^d_Zheeeedd#d|ed$eed%eed&eed'eed edBdefd`daZieeeedd#d|ed$eed%eed&eed'eed edBdefdbdcZjeeeedd#d|ed$eed%eed&eed'eed edBdefdddeZkeeeedd#d|ed$eed%eed&eed'eed edBdefdfdgZleeeedd#d$eed%eed&eed'eed edBdef dhdiZmeeeedd#ded$eed%eed&eed'eed edBdefdjdkZneeeedd#d$eed%eed&eed'eed edBdef dldmZoeeeedd#d$eed%eed&eed'eed edBdef dndoZpeeeedd#d$eed%eed&eed'eed edBdef dpdqZqeeeedd#d$eed%eed&eed'eed edBdef drdsZreeeedd#d$eed%eed&eed'eed edBdedf dtduZseeeedd#d0ed$eed%eed&eed'eed edBddvfdwdxZt  deeeedd#dkedye7eueBeuBeBdBdzedBd$eed%eed&eed'eed edBdefd{d|Zvdeddeeddddddddfedeeeedd}d~ede7ddedBdveede7dzdBdedBdleed{eedddwdxdmedBdedBdedBdedBddd|edBdeededBd$eed%eed&eed'eed edBddf0ddZwdeddfeeeedd#ddduedBdeede7dzdBdedBd$eed%eed&eed'eed edBdefddZx deeeedd#dmeded~edBd$eed%eed&eed'eed edBdefddZy deeeedd#dedBd$eed%eed&eed'eed edBdefddZzeeeedd#d$eed%eed&eed'eed edBdef ddZ{eeeedd#dmedked$eed%eed&eed'eed edBdefddZ| deeeedd#dkedee"j#BdBd$eed%eed&eed'eed edBdefddZ} deeeedd#dkededBd$eed%eed&eed'eed edBdefddZ~defeeeedd#dmededeBdedBd{eed$eed%eed&eed'eed edBddfddZ          deeeedd#dedBdedBdedBdedBdedBdedBdedBdedBdedBdedBd$eed%eed&eed'eed edBddf ddZ deeeedd#d0ededBd$eed%eed&eed'eed edBdefddZ  deeeedd#dked0edBdedBd$eed%eed&eed'eed edBdefddZ  deeeedd#d0edBdedBd$eed%eed&eed'eed edBdefddZZS( _ChatBasezjBase class for :class:`telegram.Chat` and :class:`telegram.ChatFullInfo`. .. versionadded:: 21.3 ) first_nameidis_direct_messagesis_forum last_nametitletypeusernameN api_kwargsr?rDrCrEr>rBrAr@rGc  s`tj| d||_ttj|||_||_||_ ||_ ||_ ||_ ||_ |jf|_|dS)NrF)super__init__r?r get_memberrChatTyperDrCrEr>rBrAr@ _id_attrs_freeze) selfr?rDrCrEr>rBrAr@rG __class__I/var/www/kodo/tsheker/venv/lib/python3.10/site-packages/telegram/_chat.pyrIjs   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)rC full_namerNrQrQrReffective_names  z_ChatBase.effective_namecCt|S)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 )rrZrQrQrRrYs z_ChatBase.full_namecCr\)z}:obj:`str`: Convenience property. If the chat has a :attr:`~Chat.username`, returns a t.me link of the chat. )rrZrQrQrRlinksz_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) rDrThelpers_mention_markdownr?rY TypeErrorrEr]rCrNr^rQrQrRrs  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`. )versionr_r`rarbrcrd) rDrTrer?rYrfrErr]rCrgrQrQrRmention_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`. r_z zrcrd) rDrThelpers_mention_htmlr?rYrfrEr]rrCrgrQrQrRrs  z_ChatBase.mention_html) read_timeout write_timeoutconnect_timeout pool_timeoutrGrlrmrnroc$|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_idrlrmrnrorGN)get_bot leave_chatr?rNrlrmrnrorGrQrQrRleave z_ChatBase.leave return_bots)r.c &|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. )rrrxrlrmrnrorGN)rsget_chat_administratorsr?)rNrxrlrmrnrorGrQrQrRget_administrators; z_ChatBase.get_administratorscrp)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` rqN)rsget_chat_member_countr?rurQrQrRget_member_count]rwz_ChatBase.get_member_countuser_idrc ry)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` rrrrlrmrnrorGN)rsget_chat_memberr?rNrrlrmrnrorGrQrQrRrJys 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. ) rrrrlrmrnrorrGrN)rsban_chat_memberr?) rNrrrrlrmrnrorGrQrQrR ban_member z_ChatBase.ban_membersender_chat_idc ry)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. rrrrlrmrnrorGNrsban_chat_sender_chatr?rNrrlrmrnrorGrQrQrRban_sender_chat z_ChatBase.ban_sender_chatrrc &|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. rNrrNrrrlrmrnrorGrQrQrRban_chat z_ChatBase.ban_chatc ry)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. rNrsunban_chat_sender_chatr?rrQrQrRunban_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. rNrrrQrQrR unban_chatrz_ChatBase.unban_chatonly_if_bannedc (|j|j|||||||dIdHS)a!Shortcut for:: await bot.unban_chat_member(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.unban_chat_member`. Returns: :obj:`bool`: On success, :obj:`True` is returned. )rrrrlrmrnrorGrN)rsunban_chat_memberr?)rNrrrlrmrnrorGrQrQrR unban_memberAs 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_storiescan_manage_direct_messagescan_manage_tagscs|jdid|jd|d|d|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. rrrrrrrrrrrrlrmrnrorGrrrrrrrrrNrQ)rspromote_chat_memberr?)rNrrrrrrrrrrrrrrrrrrrlrmrnrorGrQrQrRpromote_memberasd/      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. ) rrrrrrrlrmrnrorGN)rsrestrict_chat_memberr?) rNrrrrrlrmrnrorGrQrQrRrestrict_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. )rrrrrlrmrnrorGN)rsset_chat_permissionsr?)rNrrrlrmrnrorGrQrQrRset_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. )rrrrrlrmrnrorGN)rs#set_chat_administrator_custom_titler?)rNrrrlrmrnrorGrQrQrRset_administrator_custom_title z(_ChatBase.set_administrator_custom_titlephotoc ry)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. )rrrrlrmrnrorGN)rsset_chat_photor?)rNrrlrmrnrorGrQrQrR set_photo z_ChatBase.set_photocrp)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. rqN)rsdelete_chat_photor?rurQrQrR delete_photo?s z_ChatBase.delete_photoc ry)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. )rrrCrlrmrnrorGN)rsset_chat_titler?)rNrCrlrmrnrorGrQrQrR set_title`rz_ChatBase.set_title descriptionc ry)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. )rrrrlrmrnrorGN)rsset_chat_descriptionr?)rNrrlrmrnrorGrQrQrRset_descriptionrz_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. ) rrrrrlrmrnrorGrN)rspin_chat_messager?) rNrrrrlrmrnrorGrQrQrR 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. )rrrlrmrnrorGrrN)rsunpin_chat_messager?)rNrrrlrmrnrorGrQrQrR unpin_messages z_ChatBase.unpin_messagecrp)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. rqN)rsunpin_all_chat_messagesr?rurQrQrRunpin_all_messagess z_ChatBase.unpin_all_messages)reply_to_message_idallow_sending_without_replydisable_web_page_previewrlrmrnrorGtext parse_mode reply_markupzReplyMarkup | Noneentitiesr/protect_contentmessage_thread_idlink_preview_optionsr+reply_parameterszReplyParameters | Nonemessage_effect_idallow_paid_broadcastdirect_messages_topic_idsuggested_post_parameterszSuggestedPostParameters | Nonerrrr.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)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. rrrrrrrrrrrrrrrlrmrnrorGrrrrrNrQ)rs send_messager?)rNrrrrrrrrrrrrrrrrrrlrmrnrorGrQrQrRr`$      z_ChatBase.send_messagedraft_idc s.|j|j||||||||| | d IdHS)aShortcut for:: await bot.send_message_draft(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_message_draft`. .. versionchanged:: 22.8 Bot API 10.0 makes the ``text`` argument optional. Returns: :obj:`bool`: On success, :obj:`True` is returned. ) rrrrrrrrlrmrnrorGN)rssend_message_draftr?) rNrrrrrrlrmrnrorGrQrQrRrEs z_ChatBase.send_message_draftc ry)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. )rrrrlrmrnrorGN)rsdelete_messager?)rNrrlrmrnrorGrQrQrRrn z_ChatBase.delete_message message_idsc ry)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. )rrrrlrmrnrorGN)rsdelete_messagesr?)rNrrlrmrnrorGrQrQrRrrz_ChatBase.delete_messages) rrrlrmrnrorGcaptionrcaption_entitiesmediaz^InputMediaAudio | InputMediaDocument | InputMediaPhoto | InputMediaVideo | InputMediaLivePhotorr)r..c s|jdid|jd|d|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. rrrrrrlrmrnrorGrrrrrrrrrrrNrQ)rssend_media_groupr?)rNrrrrrrrrrrrrlrmrnrorGrrrrQrQrRrsT$      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. ) rrrrrlrmrnrorGrN)rssend_chat_actionr?) rNrrrrlrmrnrorGrQrQrRrrz_ChatBase.send_chat_action)rrfilenamerlrmrnrorGzFileInput | PhotoSize 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|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. rrrrrrrrrrrrrrrlrmrnrorGrrrrrrrNrQ)rs send_photor?)rNrrrrrrrrrrrrrrrrrrrrlrmrnrorGrQrQrRrh&      z_ChatBase.send_photo)rrrrlrmrnrorG live_photozFileInput | LivePhotocs|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|IdHS)a\Shortcut for:: await bot.send_live_photo(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_live_photo`. .. versionadded:: 22.8 Returns: :class:`telegram.Message`: On success, instance representing the message posted. rrrrrrrrrrrrrrrrrrrrrrrlrmrnrorGNrQ)rssend_live_photor?)rNrrrrrrrrrrrrrrrrrrrrrlrmrnrorGrQrQrRrPsl)      z_ChatBase.send_live_photo)rrcontactrlrmrnrorG phone_numbervcardrzContact | Nonecs|jdid|jd|d|d|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. rrrr>rBrrrrrlrmrnrorrrGrrrrrrrrNrQ)rs send_contactr?)rNrr>rBrrrrrrrrrrrrrrrlrmrnrorGrQrQrRrrz_ChatBase.send_contactaudiozFileInput | Audioduration performer thumbnailzFileInput | Nonecs|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)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. rrrrrrCrrrrrrrrrrrrlrmrnrorGrrrrrrNrQ)rs send_audior?)rNrrrrCrrrrrrrrrrrrrrrrrrlrmrnrorGrQrQrRrp(      z_ChatBase.send_audiodocumentzFileInput | Documentdisable_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|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. rrrrrrrrrrlrmrnrorrrGrrrrrrrrrrNrQ)rs send_documentr?)rNrrrrrrrrrrrrrrrrrrrrlrmrnrorGrQrQrRrrz_ChatBase.send_document)rrrlrmrnrorG checklistr!zInlineKeyboardMarkup | Nonecs6|j|j||||||||| | | | | |dIdHS)abShortcut for:: await bot.send_checklist(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_checklist`. .. versionadded:: 22.3 Returns: :class:`telegram.Message`: On success, instance representing the message posted. )rrrrrrrrrrrrlrmrnrorGN)rssend_checklistr?)rNrrrrrrrrrrlrmrnrorGrQrQrRr\s$ z_ChatBase.send_checklistemojic s|jdid|jd|d| d|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. rrrrrrrlrmrnrorrGrrrrrrrrNrQ)rs send_dicer?)rNrrrrrrrrrrrrrrlrmrnrorGrQrQrRrsP       z_ChatBase.send_dicegame_short_namec s|jdid|jd|d|d| d|d|d| d| d |d |d |d | d |d|d|d|d| IdHS)a0Shortcut for:: await bot.send_game(update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_game`. Returns: :class:`telegram.Message`: On success, instance representing the message posted. rrrrrrrrlrmrnrorGrrrrrrNrQ)rs send_gamer?)rNrrrrrrrrrrrrlrmrnrorGrQrQrRrsH      z_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$|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. rrrCrrr rrr r r r rrrrrrrrrrrrrlrmrnrorGrrrrrrrrrrNrQ)rs send_invoicer?)&rNrCrrrrr r r r r rrrrrrrrrrrrrrrrrrrrrrrlrmrnrorGrQrQrRrs=      !"#$%& z_ChatBase.send_invoice)rrlocationrlrmrnrorGlatitude longitude live_periodhorizontal_accuracyheadingproximity_alert_radiusrzLocation | Nonecs|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)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. rrrrrrrrrlrmrnrorrrGrrr rrrrrrrrNrQ)rs send_locationr?)rNrrrrrrrr rrrrrrrrrrrrlrmrnrorGrQrQrRr!Zrz_ChatBase.send_location animationzFileInput | Animationwidthheightcs|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|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. rrr"rr#r$rrrrrrrlrmrnrorGrrrrrrrrrrrrrNrQ)rssend_animationr?)rNr"rr#r$rrrrrrrrrrrrrrrrrrrrlrmrnrorGrQrQrRr%sx*      z_ChatBase.send_animationstickerzFileInput | Stickerc s|jdid|jd|d|d| 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. rrr&rrrrrlrmrnrorGrrrrrrrrrNrQ)rs send_stickerr?)rNr&rrrrrrrrrrrrrrlrmrnrorGrQrQrRr'sT!      z_ChatBase.send_sticker)rrvenuerlrmrnrorGaddress foursquare_idfoursquare_typegoogle_place_idgoogle_place_typer(z Venue | Nonecs|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)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. rrrrrCr)r*rrrrrlrmrnror(r+rGr,r-rrrrrrrrNrQ)rs send_venuer?)rNrrrCr)r*rrr+r,r-rrrrrrrrrrr(rlrmrnrorGrQrQrRr.rz_ChatBase.send_venuevideozFileInput | Videosupports_streamingcoverstart_timestampc 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 |Id!HS)#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. rrr/rrrrrrrlrmrnror#r$rr0rr1r2rGrrrrrrrrrrrrNrQ)rs send_videor?) rNr/rrrrr#r$rr0rrrrrrrrrrr1r2rrrrrrlrmrnrorGrQrQrRr3ds-      z_ChatBase.send_video video_notezFileInput | VideoNotelengthcs|jdid|jd|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_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. rrr4rr5rrrrrlrmrnrorrGrrrrrrrrrNrQ)rssend_video_noter?)rNr4rr5rrrrrrrrrrrrrrrlrmrnrorGrQrQrRr6rz_ChatBase.send_video_notevoicezFileInput | Voicecs|jdid|jd|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_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. rrr7rrrrrrrlrmrnrorrGrrrrrrrrrrNrQ)rs send_voicer?)rNr7rrrrrrrrrrrrrrrrrrlrmrnrorGrQrQrRr8sd%      z_ChatBase.send_voicequestionoptionszstr | InputPollOptionallows_multiple_answerscorrect_option_id is_closed explanationexplanation_parse_mode open_period close_dateexplanation_entitiesquestion_parse_modequestion_entitiesshuffle_optionsallows_revotingcorrect_option_idsallow_adding_optionshide_results_until_closesdescription_parse_modedescription_entities members_only country_codesexplanation_mediazInputPollMedia | Nonec#*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$|d%|d&|d'|d(| d)|!d*|"Id+HS)-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. rrr9r:rrDr;r<rFrErGr=rrrrrlrmrnrorrr>r?r@rArGrrBrrrrCrDrrJrKrIrHrLrMrNrNrQ)rs send_pollr?)*rNr9r:rrDr;r<r=rrr>r?r@rArBrrrrrCrDrrrErFrGrHrIrrJrKrLrMrNrrrrlrmrnrorGrQrQrRrO2 s7      !"#$%&'()* z_ChatBase.send_poll from_chat_idvideo_start_timestampr0c|jdid|jd|d|d|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.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. rrrPrrrQrrrrrrrrlrmrnrorGrrrrrrrNrQrs copy_messager?)rNrPrrrrrrrrrrrrQrrrrrrlrmrnrorGrQrQrR send_copy d'      z_ChatBase.send_copycrR)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. rPrrrrrQrrrrrrrrlrmrnrorGrrrrrrrNrQrS)rNrrrrrrrrrrrrrrQrrrrrrlrmrnrorGrQrQrRrT rVz_ChatBase.copy_messageremove_caption)r0.c 2|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. ) rrrPrrrrrWrlrmrnrorGrNrs copy_messagesr?) rNrPrrrrrWrrlrmrnrorGrQrQrR send_copies  z_ChatBase.send_copiesc rX)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. ) rPrrrrrrrWrlrmrnrorGrNrY) rNrrrrrrrWrrlrmrnrorGrQrQrRrZI r\z_ChatBase.copy_messagesc 6|j|j||||| | | | |||||| dIdHS)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. )rrrPrrQrrlrmrnrorGrrrrrNrsforward_messager?)rNrPrrrrrQrrrrlrmrnrorGrQrQrR forward_fromx 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. )rPrrrrQrrlrmrnrorGrrrrrNr^)rNrrrrrrrQrrrrlrmrnrorGrQrQrR forward_to s$! z_ChatBase.forward_toc 0|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. ) rrrPrrrrrlrmrnrorGrNrsforward_messagesr?) rNrPrrrrrrlrmrnrorGrQrQrRforward_messages_from  z_ChatBase.forward_messages_fromc rb)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. ) rPrrrrrrrlrmrnrorGrNrc) rNrrrrrrrrlrmrnrorGrQrQrRforward_messages_to rfz_ChatBase.forward_messages_tocrp)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. rqN)rsexport_chat_invite_linkr?rurQrQrRexport_invite_link7  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` ) rrrkrlrlrmrnrorGr^rmN)rscreate_chat_invite_linkr?) rNrkrlr^rmrlrmrnrorGrQrQrRcreate_invite_linkV s z_ChatBase.create_invite_link invite_linkzstr | ChatInviteLinkc 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` ) rrrprkrlrlrmrnrorGr^rmN)rsedit_chat_invite_linkr?) rNrprkrlr^rmrlrmrnrorGrQrQrRedit_invite_link s z_ChatBase.edit_invite_linkc ry)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` )rrrprlrmrnrorGN)rsrevoke_chat_invite_linkr?)rNrprlrmrnrorGrQrQrRrevoke_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` ) rrrurvr^rlrmrnrorGN)rs$create_chat_subscription_invite_linkr?) rNrurvr^rlrmrnrorGrQrQrRcreate_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` )rrrprlrmrnrorGr^N)rs"edit_chat_subscription_invite_linkr?)rNrpr^rlrmrnrorGrQrQrRedit_subscription_invite_link s z'_ChatBase.edit_subscription_invite_linkc ry)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. rN)rsapprove_chat_join_requestr?rrQrQrRapprove_join_request rz_ChatBase.approve_join_requestc ry)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. rN)rsdecline_chat_join_requestr?rrQrQrRdecline_join_request: rz_ChatBase.decline_join_request menu_buttonc ry)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. )rrrrlrmrnrorGN)rsset_chat_menu_buttonr?)rNrrlrmrnrorGrQrQrRset_menu_button[ s z_ChatBase.set_menu_button icon_coloricon_custom_emoji_idc rw)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` ) rrr^rrrlrmrnrorGN)rscreate_forum_topicr?) rNr^rrrlrmrnrorGrQrQrRr  z_ChatBase.create_forum_topicc rw)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. ) rrrr^rrlrmrnrorGN)rsedit_forum_topicr?) rNrr^rrlrmrnrorGrQrQrRr rz_ChatBase.edit_forum_topicc ry)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. rrrrlrmrnrorGN)rsclose_forum_topicr?rNrrlrmrnrorGrQrQrRr rz_ChatBase.close_forum_topicc ry)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. rN)rsreopen_forum_topicr?rrQrQrRr rz_ChatBase.reopen_forum_topicc ry)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. rN)rsdelete_forum_topicr?rrQrQrRr rz_ChatBase.delete_forum_topicc ry)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. rN)rsunpin_all_forum_topic_messagesr?rrQrQrRr( rz(_ChatBase.unpin_all_forum_topic_messagescrp)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. rqN)rs&unpin_all_general_forum_topic_messagesr?rurQrQrRrI rjz0_ChatBase.unpin_all_general_forum_topic_messagesc ry)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. )rrr^rlrmrnrorGN)rsedit_general_forum_topicr?)rNr^rlrmrnrorGrQrQrRrh r|z"_ChatBase.edit_general_forum_topiccrp)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. rqN)rsclose_general_forum_topicr?rurQrQrRr  z#_ChatBase.close_general_forum_topiccrp)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. rqN)rsreopen_general_forum_topicr?rurQrQrRr  z$_ChatBase.reopen_general_forum_topiccrp)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. rqN)rshide_general_forum_topicr?rurQrQrRr rz"_ChatBase.hide_general_forum_topiccrp)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. rqN)rsunhide_general_forum_topicr?rurQrQrRr rz$_ChatBase.unhide_general_forum_topiccrp)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. rqN)rsget_chat_menu_buttonr?rurQrQrRget_menu_buttons z_ChatBase.get_menu_buttonr7c 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. )rrrrGrlrmrnroN)rsget_user_chat_boostsr?rrQrQrRr)rz_ChatBase.get_user_chat_boostsreactionis_bigc rw)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. ) rrrrrrlrmrnrorGN)rsset_message_reactionr?) rNrrrrlrmrnrorGrQrQrRrIrz_ChatBase.set_message_reaction)rrrlrmrnrorG star_countr'cs|jdid|jd|d|d|d|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. rrrrrrrrrrrrrrrlrmrnrorGrrrrrrNrQ)rssend_paid_mediar?)rNrrrrrrrrrrrrrrrrrrrlrmrnrorGrQrQrRrmrVz_ChatBase.send_paid_mediagift_idz str | Gifttext_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. ) rrrrrrlrmrnrorGrrrNrQ)rs send_giftrDChatrWr?) rNrrrrrrlrmrnrorGrQrQrRrs $ z_ChatBase.send_gift owned_gift_idc rw)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_idrrrrlrmrnrorGN)rs transfer_giftr?) rNrrrrlrmrnrorGrQrQrRrrz_ChatBase.transfer_giftcustom_descriptionc ry)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. )rrrrlrmrnrorGN)rs verify_chatr?)rNrrlrmrnrorGrQrQrRverifyrz_ChatBase.verifycrp)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. rqN)rsremove_chat_verificationr?rurQrQrRremove_verification$rz_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. )rrrrrlrmrnrorGN)rsread_business_messager?)rNrrrlrmrnrorGrQrQrRrBs z_ChatBase.read_business_message send_datec r)ac Shortcut for:: await bot.approve_suggested_post(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.approve_suggested_post`. .. versionadded:: 22.4 Returns: :obj:`bool`: On success, :obj:`True` is returned. )rrrrrlrmrnrorGN)rsapprove_suggested_postr?)rNrrrlrmrnrorGrQrQrRrdrz _ChatBase.approve_suggested_postcommentc r)ac Shortcut for:: await bot.decline_suggested_post(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.decline_suggested_post`. .. versionadded:: 22.4 Returns: :obj:`bool`: On success, :obj:`True` is returned. )rrrrrlrmrnrorGN)rsdecline_suggested_postr?)rNrrrlrmrnrorGrQrQrRrrz _ChatBase.decline_suggested_post from_story_id active_periodpost_to_chat_pager5c s.|j||j|||||||| | d IdHS)axShortcut for:: await bot.repost_story( from_chat_id=update.effective_chat.id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.repost_story`. .. versionadded:: 22.6 Returns: :class:`Story`: On success, :class:`Story` is returned. ) rrPrrrrrlrmrnrorGN)rs repost_storyr?) rNrrrrrrlrmrnrorGrQrQrRrs z_ChatBase.repost_storyexclude_unsaved exclude_savedexclude_unlimitedexclude_limited_upgradableexclude_limited_non_upgradableexclude_from_blockchainexclude_unique sort_by_priceoffsetlimitr1c sz|jdid|jd|d|d|d|d|d|d|d |d | d | d | d | d| d|d|IdHS)aVShortcut for:: await bot.get_chat_gifts(chat_id=update.effective_chat.id) For the documentation of the arguments, please see :meth:`telegram.Bot.get_chat_gifts`. .. versionadded:: 22.6 Returns: :class:`telegram.OwnedGifts`: On success, returns the gifts owned by the chat. rrrrrrrrrrrrrlrmrnrorGNrQ)rsget_chat_giftsr?)rNrrrrrrrrrrrlrmrnrorGrQrQrR get_giftssD      z_ChatBase.get_giftstagc r)a] Shortcut for:: await bot.set_chat_member_tag(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.set_chat_member_tag`. .. versionadded:: 22.7 Returns: :obj:`bool`: On success, :obj:`True` is returned. )rrrrrlrmrnrorGN)rsset_chat_member_tagr?)rNrrrlrmrnrorGrQrQrRrrz_ChatBase.set_chat_member_tag actor_chat_idc rw)ae Shortcut for:: await bot.delete_message_reaction(chat_id=update.effective_chat.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.delete_message_reaction`. .. versionadded:: 22.8 Returns: :obj:`bool`: On success, :obj:`True` is returned. ) rrrrrrlrmrnrorGN)rsdelete_message_reactionr?) rNrrrrlrmrnrorGrQrQrRdelete_reaction*s z_ChatBase.delete_reactionc r)a Shortcut for:: await bot.delete_all_message_reactions( chat_id=update.effective_chat.id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.delete_all_message_reactions`. .. versionadded:: 22.8 Returns: :obj:`bool`: On success, :obj:`True` is returned. )rrrrrlrmrnrorGN)rsdelete_all_message_reactionsr?)rNrrrlrmrnrorGrQrQrRdelete_all_reactionsOs z_ChatBase.delete_all_reactions)NNNNNN)N)NN)NNNNNNNNNNNNNNNNN)NNNN) NNNNNNNNNN)__name__ __module__ __qualname____doc__ __slots__intstrboolrrIrrKrSr__annotations__rTrUrVrWpropertyr[rYr]rrjrr rfloatrvtupler{r~rJdtmdatetimerrrrrrrrrrrrrrrrrrrrrrrrrr send_actionrrrrrrrrrobjectrr!r%r'r.r3r6r8rrrOrUrTr[rZr`rarergrirorrrtryr{r}rr rrrrrrrrrrrrrrrrr rrrrrrrrrrrrrr __classcell__rQrQrOrRr=Ys~      &!#  %   !    & % ' % &  #      N     -  )  ' & % % &   %  $         A      - $ %      >   "       F      H      A      I       F      2     9      9!       !"#$%&'( h      E      M      :      I      !"S     A      D%            !"#%&'()*+,h      F      F     3     3     6     7      1      0!     .      0 %   )  ) % # (   '   ( $ $ $ $# %!#!#' #   (       E      6   % ##  %   &  (     -     5  &   '  r=c@seZdZdZdZdS)ra 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 is_direct_messages (:obj:`bool`, optional): :obj:`True`, if the chat is the direct messages chat of a channel. .. versionadded:: 22.4 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 is_direct_messages (:obj:`bool`): Optional. :obj:`True`, if the chat is the direct messages chat of a channel. .. versionadded:: 22.4 .. _topics: https://telegram.org/blog/topics-in-groups-collectible-usernames#topics-in-groups rQN)rrrrrrQrQrQrRrws=r)Prrrcollections.abcrhtmlrtypingrrtelegramrtelegram._chatpermissionsrtelegram._forumtopicrtelegram._menubuttonr telegram._reactionr telegram._telegramobjectr telegram._utilsr telegram._utils.defaultvaluer telegram._utils.typesrrrrrrtelegram._utils.usernamesrrtelegram.helpersrrrkrrerrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8r9r:r;r<r=rrQrQrQrRsn               %>