՟f}dZddlmZmZmZmZmZmZddlm Z ddl m Z ddl m Z mZddlmZddlmZddlmZdd lmZmZmZerdd lmZmZmZmZmZmZmZm Z Gd d eZ!y )zGThis module contains an object that represents a Telegram CallbackQuery) TYPE_CHECKINGFinalOptionalSequenceTupleUnion) constants)Location)MaybeInaccessibleMessageMessage)TelegramObject)User) DEFAULT_NONE)JSONDictODVInput ReplyMarkup)Bot GameHighScoreInlineKeyboardMarkup InputMediaLinkPreviewOptions MessageEntity MessageIdReplyParametersc&BeZdZUdZdZ dPdddedededeed eed eed eed ee ffd Z e dQd ee deddedffd Z dPe e e e dddeedeedeedeedeedeedeedeed ee defdZdRdedefdZe dde fde e e e dddedeed ed!d"eed#d$ed%d&eedeedeedeedeed ee deeeffd'Zdde ddfe e e e ddd(eed ed!deed)eed#d*eedeedeedeedeed ee deeeffd+Z dQe e e e ddd ed!deedeedeedeed ee deeeffd,Z dQe e e e ddd-d.d ed!deedeedeedeed ee deeeffd/Z dSde e e e dd0d1eed2eed ed!d3eed4eed5eed6eed7eedeedeedeedeed ee deeeffd8Z dQe e e e ddd ed!deedeedeedeed ee deeeffd9Z dTe e e e ddd:ed;edZe e e e ddd:edeedeedeedeed ee ded?fd@Z e e e e dddeedeedeedeed ee def dAZ!e fe e e e dddBeedeedeedeedeed ee defdCZ"e e e e dddeedeedeedeed ee def dDZ#de de de dddf e de e e e ddEdFeeefd(eedeed)eed#dBeed ee$dGeedHeedIedJd*eedKeedLeedeedeedeedeed ee ddMf$dNZ%e&jNjPZ)e*ee+dO<xZ,S)U CallbackQuerya( This object represents an incoming callback query from a callback button in an inline keyboard. If the button that originated the query was attached to a message sent by the bot, the field :attr:`message` will be present. If the button was attached to a message sent via the bot (in inline mode), the field :attr:`inline_message_id` will be present. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`id` is equal. Note: * In Python :keyword:`from` is a reserved word. Use :paramref:`from_user` instead. * Exactly one of the fields :attr:`data` or :attr:`game_short_name` will be present. * After the user presses an inline button, Telegram clients will display a progress bar until you call :attr:`answer`. It is, therefore, necessary to react by calling :attr:`telegram.Bot.answer_callback_query` even if no notification to the user is needed (e.g., without specifying any of the optional parameters). * If you're using :attr:`telegram.ext.ExtBot.callback_data_cache`, :attr:`data` may be an instance of :class:`telegram.ext.InvalidCallbackData`. This will be the case, if the data associated with the button triggering the :class:`telegram.CallbackQuery` was already deleted or if :attr:`data` was manipulated by a malicious client. .. versionadded:: 13.6 Args: id (:obj:`str`): Unique identifier for this query. from_user (:class:`telegram.User`): Sender. chat_instance (:obj:`str`): Global identifier, uniquely corresponding to the chat to which the message with the callback button was sent. Useful for high scores in games. message (:class:`telegram.MaybeInaccessibleMessage`, optional): Message sent by the bot with the callback button that originated the query. .. versionchanged:: 20.8 Accept objects of type :class:`telegram.MaybeInaccessibleMessage` since Bot API 7.0. data (:obj:`str`, optional): Data associated with the callback button. Be aware that the message, which originated the query, can contain no callback buttons with this data. inline_message_id (:obj:`str`, optional): Identifier of the message sent via the bot in inline mode, that originated the query. game_short_name (:obj:`str`, optional): Short name of a Game to be returned, serves as the unique identifier for the game. Attributes: id (:obj:`str`): Unique identifier for this query. from_user (:class:`telegram.User`): Sender. chat_instance (:obj:`str`): Global identifier, uniquely corresponding to the chat to which the message with the callback button was sent. Useful for high scores in games. message (:class:`telegram.MaybeInaccessibleMessage`): Optional. Message sent by the bot with the callback button that originated the query. .. versionchanged:: 20.8 Objects may be of type :class:`telegram.MaybeInaccessibleMessage` since Bot API 7.0. data (:obj:`str` | :obj:`object`): Optional. Data associated with the callback button. Be aware that the message, which originated the query, can contain no callback buttons with this data. Tip: The value here is the same as the value passed in :paramref:`telegram.InlineKeyboardButton.callback_data`. inline_message_id (:obj:`str`): Optional. Identifier of the message sent via the bot in inline mode, that originated the query. game_short_name (:obj:`str`): Optional. Short name of a Game to be returned, serves as the unique identifier for the game. ) chat_instancedata from_usergame_short_nameidinline_message_idmessageN api_kwargsr!rrr#rr"r r%ct ||||_||_||_||_||_||_||_|jf|_ |jy)Nr$) super__init__r!rrr#rr"r _id_attrs_freeze) selfr!rrr#rr"r r% __class__s R/var/www/cvtools/html/venv/lib/python3.12/site-packages/telegram/_callbackquery.pyr(zCallbackQuery.__init__{s_ J/("/;B #' 0A.='' botrreturnc|j|}|sytj|jdd||d<t j|j d||d<t | ||S)z,See :meth:`telegram.TelegramObject.de_json`.Nfromrr#)rr/) _parse_datarde_jsonpopr getr')clsrr/r,s r-r4zCallbackQuery.de_jsonsi t$ LL&$)?E[!//$((9*=sCYwDc22r. read_timeout write_timeoutconnect_timeout pool_timeoutr%text show_alerturl cache_timer9r:r;r<c K|jj|j|||||||||  d{S7w)a1Shortcut for:: await bot.answer_callback_query(update.callback_query.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.answer_callback_query`. Returns: :obj:`bool`: On success, :obj:`True` is returned. ) callback_query_idr=r>r?r@r9r:r;r<r%N)get_botanswer_callback_queryr!) r+r=r>r?r@r9r:r;r<r%s r-answerzCallbackQuery.answersR0\\^99"gg!!%'+%!:    s7A>Aactionclt|jtstd|d|jS)zHelper method to get the message for the shortcut methods. Must be called only if :attr:`inline_message_id` is *not* set. zCannot z an inaccessible message) isinstancer#r TypeError)r+rFs r- _get_messagezCallbackQuery._get_messages1$,,0gfX-EFG G||r.)disable_web_page_previewr9r:r;r<r% parse_mode reply_markuprentitiesrlink_preview_optionsrrKcK|jr@|jj|j|||||||| | | |dddd{S|jj |||||||| | | | d{S767w)aShortcut for either:: await update.callback_query.message.edit_text(*args, **kwargs) or:: await bot.edit_message_text( inline_message_id=update.callback_query.inline_message_id, *args, **kwargs, ) For the documentation of the arguments, please see :meth:`telegram.Bot.edit_message_text` and :meth:`telegram.Message.edit_text`. .. versionchanged:: 20.8 Raises :exc:`TypeError` if :attr:`message` is not accessible. Returns: :class:`telegram.Message`: On success, if edited message is sent by the bot, the edited Message is returned, otherwise :obj:`True` is returned. Raises: :exc:`TypeError` if :attr:`message` is not accessible. N)r"r=rLrKrOrMr9r:r;r<r%rNchat_id message_idbusiness_connection_id) r=rLrKrOrMr9r:r;r<r%rN)r"rCedit_message_textrJ edit_text) r+r=rLrMrNrOrKr9r:r;r<r%s r-rTzCallbackQuery.edit_message_textsN  ! !99"&"8"8%)A%9))+ /)%!'+!: $&&(22!%=!5%%'+%!3   %$  s$AB B 1B<B=BBcaptioncaption_entitiesshow_caption_above_mediac K|jr?|jj||j||||| || |dd|dd{S|jj |||||| || || d{S757w)a%Shortcut for either:: await update.callback_query.message.edit_caption(*args, **kwargs) or:: await bot.edit_message_caption( inline_message_id=update.callback_query.inline_message_id, *args, **kwargs, ) For the documentation of the arguments, please see :meth:`telegram.Bot.edit_message_caption` and :meth:`telegram.Message.edit_caption`. .. versionchanged:: 20.8 Raises :exc:`TypeError` if :attr:`message` is not accessible. Returns: :class:`telegram.Message`: On success, if edited message is sent by the bot, the edited Message is returned, otherwise :obj:`True` is returned. Raises: :exc:`TypeError` if :attr:`message` is not accessible. N)rVr"rMr9r:r;r<rLr%rWrQrRrXrS) rVrMr9r:r;r<rLr%rWrX)r"rCedit_message_captionrJ edit_caption) r+rVrMrLrWrXr9r:r;r<r%s r-rZz"CallbackQuery.edit_message_captionsL  ! !<<"&"8"8))+ /)%%!1)A'+= "&&(55%%'+%!!-%=6   #"  s$AB A? 0B:B;BBc K|jr;|jj||j|||||ddd d{S|jj ||||||d{S717w)a@Shortcut for either:: await update.callback_query.message.edit_reply_markup(*args, **kwargs) or:: await bot.edit_message_reply_markup( inline_message_id=update.callback_query.inline_message_id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.edit_message_reply_markup` and :meth:`telegram.Message.edit_reply_markup`. .. versionchanged:: 20.8 Raises :exc:`TypeError` if :attr:`message` is not accessible. Returns: :class:`telegram.Message`: On success, if edited message is sent by the bot, the edited Message is returned, otherwise :obj:`True` is returned. Raises: :exc:`TypeError` if :attr:`message` is not accessible. N) rMr"r9r:r;r<r%rQrRrSrMr9r:r;r<r%)r"rCedit_message_reply_markuprJedit_reply_markupr+rMr9r:r;r<r%s r-r^z'CallbackQuery.edit_message_reply_markup_sF  ! !AA)"&"8"8)+ /)%'+B   &&(::%%'+%! ;     $AA;A7,A;2A93A;9A;mediarc K|jr<|jj|j|||||||ddd d{S|jj |||||||d{S727w)a"Shortcut for either:: await update.callback_query.message.edit_media(*args, **kwargs) or:: await bot.edit_message_media( inline_message_id=update.callback_query.inline_message_id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.edit_message_media` and :meth:`telegram.Message.edit_media`. .. versionchanged:: 20.8 Raises :exc:`TypeError` if :attr:`message` is not accessible. Returns: :class:`telegram.Message`: On success, if edited message is not an inline message, the edited Message is returned, otherwise :obj:`True` is returned. Raises: :exc:`TypeError` if :attr:`message` is not accessible. N) r"rbrMr9r:r;r<r%rQrRrS)rbrMr9r:r;r<r%)r"rCedit_message_mediarJ edit_media)r+rbrMr9r:r;r<r%s r-rdz CallbackQuery.edit_message_mediasF  ! !::"&"8"8))+ /)%'+;   &&(33%%'+%!4     s$AA=A9-A=4A;5A=;A=)locationr9r:r;r<r%latitude longitudehorizontal_accuracyheadingproximity_alert_radius live_periodrfcK|jrB|jj|j||||| | | | | ||||dddd{S|jj ||||| | | | | |||| d{S787w)aDShortcut for either:: await update.callback_query.message.edit_live_location(*args, **kwargs) or:: await bot.edit_message_live_location( inline_message_id=update.callback_query.inline_message_id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.edit_message_live_location` and :meth:`telegram.Message.edit_live_location`. .. versionchanged:: 20.8 Raises :exc:`TypeError` if :attr:`message` is not accessible. Returns: :class:`telegram.Message`: On success, if edited message is sent by the bot, the edited Message is returned, otherwise :obj:`True` is returned. Raises: :exc:`TypeError` if :attr:`message` is not accessible. N)r"rgrhrfrMr9r:r;r<r%rirjrkrlrQrRrS) rgrhrfrMr9r:r;r<r%rirjrkrl)r"rCedit_message_live_locationrJedit_live_location)r+rgrhrMrirjrkrlrfr9r:r;r<r%s r-rnz(CallbackQuery.edit_message_live_locationsT  ! !BB"&"8"8!#!))+ /)%$7'=''+%C (&&(;;%%'+%! 3#9#<   )( s$A B  B 3B BB B c K|jr;|jj|j||||||ddd d{S|jj ||||||d{S717w)aDShortcut for either:: await update.callback_query.message.stop_live_location(*args, **kwargs) or:: await bot.stop_message_live_location( inline_message_id=update.callback_query.inline_message_id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.stop_message_live_location` and :meth:`telegram.Message.stop_live_location`. .. versionchanged:: 20.8 Raises :exc:`TypeError` if :attr:`message` is not accessible. Returns: :class:`telegram.Message`: On success, if edited message is sent by the bot, the edited Message is returned, otherwise :obj:`True` is returned. Raises: :exc:`TypeError` if :attr:`message` is not accessible. N) r"rMr9r:r;r<r%rQrRrSr])r"rCstop_message_live_locationrJstop_live_locationr`s r-rqz(CallbackQuery.stop_message_live_location$sF  ! !BB"&"8"8))+ /)%'+C   &&(;;%%'+%! <     rauser_idscoreforcedisable_edit_messagecK|jr=|jj|j||||||||| dd d{S|jj|||||||||  d{S747w)aShortcut for either:: await update.callback_query.message.set_game_score(*args, **kwargs) or:: await bot.set_game_score( inline_message_id=update.callback_query.inline_message_id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.set_game_score` and :meth:`telegram.Message.set_game_score`. .. versionchanged:: 20.8 Raises :exc:`TypeError` if :attr:`message` is not accessible. Returns: :class:`telegram.Message`: On success, if edited message is sent by the bot, the edited Message is returned, otherwise :obj:`True` is returned. Raises: :exc:`TypeError` if :attr:`message` is not accessible. N) r"rsrtrurvr9r:r;r<r%rQrR) rsrtrurvr9r:r;r<r%)r"rCset_game_scorerJ) r+rsrtrurvr9r:r;r<r%s r-rxzCallbackQuery.set_game_score^sJ  ! !66"&"8"8%9)+ /)%7   &&(77!5%'+%!8      s$ABA</B7A>8B>B)r.c K|jr:|jj|j||||||dd d{S|jj||||||d{S717w)aShortcut for either:: await update.callback_query.message.get_game_high_score(*args, **kwargs) or:: await bot.get_game_high_scores( inline_message_id=update.callback_query.inline_message_id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.get_game_high_scores` and :meth:`telegram.Message.get_game_high_scores`. .. versionchanged:: 20.8 Raises :exc:`TypeError` if :attr:`message` is not accessible. Returns: Tuple[:class:`telegram.GameHighScore`] Raises: :exc:`TypeError` if :attr:`message` is not accessible. N) r"rsr9r:r;r<r%rQrR)rsr9r:r;r<r%)r"rCget_game_high_scoresrJ)r+rsr9r:r;r<r%s r-rzz"CallbackQuery.get_game_high_scoressD  ! !<<"&"8"8)+ /)%=   &&(==%'+%! >     s$AA:A6,A:1A82A:8A:cjK|jdj|||||d{S7w)aShortcut for:: await update.callback_query.message.delete(*args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Message.delete`. .. versionchanged:: 20.8 Raises :exc:`TypeError` if :attr:`message` is not accessible. Returns: :obj:`bool`: On success, :obj:`True` is returned. Raises: :exc:`TypeError` if :attr:`message` is not accessible. deleterFr8N)rJr|r+r9r:r;r<r%s r-delete_messagezCallbackQuery.delete_messagesG2&&h&7>>%'+%! ?    *313disable_notificationclK|jdj||||||d{S7w)aShortcut for:: await update.callback_query.message.pin(*args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Message.pin`. .. versionchanged:: 20.8 Raises :exc:`TypeError` if :attr:`message` is not accessible. Returns: :obj:`bool`: On success, :obj:`True` is returned. Raises: :exc:`TypeError` if :attr:`message` is not accessible. pinr})rr9r:r;r<r%N)rJr)r+rr9r:r;r<r%s r- pin_messagezCallbackQuery.pin_messagesJ2&&e&488!5%'+%! 9    s +424cjK|jdj|||||d{S7w)aShortcut for:: await update.callback_query.message.unpin(*args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Message.unpin`. .. versionchanged:: 20.8 Raises :exc:`TypeError` if :attr:`message` is not accessible. Returns: :obj:`bool`: On success, :obj:`True` is returned. Raises: :exc:`TypeError` if :attr:`message` is not accessible. unpinr}r8N)rJrr~s r- unpin_messagezCallbackQuery.unpin_messagesG0&&g&6<<%'+%! =    r)allow_sending_without_replyreply_to_message_idr9r:r;r<r%rQprotect_contentmessage_thread_idreply_parametersrrrrc K|jdj|||||| | || ||||||| | d{S7w)aShortcut for:: await update.callback_query.message.copy( from_chat_id=update.message.chat_id, message_id=update.message.message_id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Message.copy`. .. versionchanged:: 20.8 Raises :exc:`TypeError` if :attr:`message` is not accessible. Returns: :class:`telegram.MessageId`: On success, returns the MessageId of the sent message. Raises: :exc:`TypeError` if :attr:`message` is not accessible. copyr})rQrVrLrWrrrrMr9r:r;r<r%rrrrXN)rJr)r+rQrVrLrWrrMrrrrXrrr9r:r;r<r%s r- copy_messagezCallbackQuery.copy_message8slR&&f&5::!-!5 3(C%%'+%!+/-%=#;    s 6?=?MAX_ANSWER_TEXT_LENGTH)NNNN)N)edit)NNNNNNN)NN)-__name__ __module__ __qualname____doc__ __slots__strrrr rr( classmethodr4rboolintrfloatrEr rJrrrTrZr^rdr rnrqrxrrzrrrrrr CallbackQueryLimit!ANSWER_CALLBACK_QUERY_TEXT_LENGTHrr__annotations__ __classcell__)r,s@r-rr,s BHI7;"+/)-*.   23  sm $C="#X&6>B 3H% 3,4UO 3 / " 3 3 #%)!$( # )5)5+7(4)-# sm# TN# c] # SM # uo#  # "%# uo# X&#  # J3G%19=88 )5)5+7(4)-8 568 uo 8   8 "% 8 uo8 X&8  w} 8 z:>: )5)5+7(4)-: : 56: uo :   : "%: uo: X&:  w} : |%)%)9=/3!%04%)M (,(4)5+7(4)-M 5/M E?M 56 M &e_ M # M !) M c]M 8$M uoM  M "%M uoM X&M w} !M b:>8 )5)5+7(4)-8 568 uo 8   8 "% 8 uo8 X&8  w} 8 |!%/3 > )5)5+7(4)-> > > ~ > 'tn > uo>  > "%> uo> X&>  w} > H)5)5+7(4)-5 5 uo 5   5 "% 5 uo5 X&5  # $5 t)5)5+7(4)- uo    "%  uo  X&   F0<  )5)5+7(4)-  &tn  uo     "%  uo  X&     J)5)5+7(4)- uo    "%  uo  X&   F"&$0@D/;.2*6+/8<37; 7C-1(4)5+7(4)-'; sCx; #; SM ; #8O#<= ; 'tn ; {+; "$; $C=; ##45; #+4.; &.d^; &c]; uo;  !; ""%#; $uo%; &X&'; ( ); | $$FFE#Jr.rN)"rtypingrrrrrrtelegramr telegram._files.locationr telegram._messager r telegram._telegramobjectr telegram._userrtelegram._utils.defaultvaluertelegram._utils.typesrrrrrrrrrrrrr.r-rsI(NII-?35AA   P NP r.