o ZzjD@sdZddlmZddlmZmZddlmZddlm Z ddl m Z m Z ddl mZddlmZdd lmZdd lmZdd lmZmZmZerjdd lmZmZmZmZmZmZmZm Z m!Z!dd l"m#Z#ddlm$Z$GdddeZ%dS)zGThis module contains an object that represents a Telegram CallbackQuery)Sequence) TYPE_CHECKINGFinal) constants)InputChecklist)MaybeInaccessibleMessageMessage)TelegramObject)User)de_json_optional) DEFAULT_NONE)JSONDictODVInput TimePeriod) Bot GameHighScoreInlineKeyboardMarkup InputMediaLinkPreviewOptions MessageEntity MessageIdReplyParametersSuggestedPostParameters)Location) ReplyMarkupc.s>eZdZUdZdZ    dldddededededBd edBd edBd edBd edBffd dZ e dmd eddddffdd Z    dle e e e dddedBde dBdedBdedBdeedeedeedeed edBde fddZdnd edefd!d"Ze dde fde e e e dd#ded$eed%d&d'ed(dBd)ed*d+e dBdeedeedeedeed edBdd,fd-d.Zdde ddfe e e e ddd/edBd%d&d$eed0ed(dBd1e dBdeedeedeedeed edBdd,fd2d3Z dme e e e ddd4ed%d&deedeedeedeed edBdd,fd5d6Z dme e e e ddd%d&deedeedeedeed edBdd,fd7d8Z dme e e e ddd9d:d%d&deedeedeedeed edBdd,fd;d<Z       dode e e e dd=d>edBd?edBd%d&d@edBdAedBdBedBdCedBdDdEdeedeedeedeed edBdd,fdFdGZ dme e e e ddd%d&deedeedeedeed edBdd,fdHdIZ  dpe e e e dddJedKedLe dBdMe dBdeedeedeedeed edBdd,fdNdOZe e e e dddJedeedeedeedeed edBdedPfdQdRZ e e e e dddeedeedeedeed edBde f dSdTZ!e fe e e e dddUee deedeedeedeed edBde fdVdWZ"e e e e dddeedeedeedeed edBde f dXdYZ#de de de dddddddf e de e e e ddZd[eeBd/edBd$eed0ed(dBdUee d%d\d]ee d^edBd_d`d1e dBdae dBdbedBdcdddeedBdfee dgedBdeedeedeedeed edBddhf,didjZ$e%j&j'Z(e)ee*dk<Z+S)q 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!rr$c sNtj|d||_||_||_||_||_||_||_|jf|_ | dS)Nr#) super__init__r rrr"rr!r _id_attrs_freeze) selfr rrr"rr!rr$ __class__R/var/www/kodo/tsheker/venv/lib/python3.10/site-packages/telegram/_callbackquery.pyr&s   zCallbackQuery.__init__botz Bot | NonereturncsH||}t|ddt||d<t|dt||d<tj||dS)z,See :meth:`telegram.TelegramObject.de_json`.fromNrr")rr.) _parse_datar popr getrr%de_json)clsrr.r*r,r-r4s zCallbackQuery.de_json read_timeout write_timeoutconnect_timeout pool_timeoutr$text show_alerturl cache_timer7r8r9r:c s,|j|j||||||||| d IdHS)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>r7r8r9r:r$N)get_botanswer_callback_queryr ) r)r;r<r=r>r7r8r9r:r$r,r,r-answers zCallbackQuery.answereditactioncCs"t|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)rDr,r,r- _get_messages zCallbackQuery._get_message)disable_web_page_previewr7r8r9r:r$ parse_mode reply_markupzInlineKeyboardMarkup | Noneentitiesrlink_preview_optionsrrHzMessage | boolc sf|jr|j|j|||||||| | | |ddddIdHS|j|||||||| | | |d IdHS)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;rIrHrLrJr7r8r9r:r$rKchat_id message_idbusiness_connection_id) r;rIrHrLrJr7r8r9r:r$rK)r!r@edit_message_textrG edit_text) r)r;rIrJrKrLrHr7r8r9r:r$r,r,r-rPs@'  zCallbackQuery.edit_message_textcaptioncaption_entitiesshow_caption_above_mediac sb|jr|j||j||||| || |dd|ddIdHS|j|||||| || ||d IdHS)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)rRr!rJr7r8r9r:rIr$rSrMrNrTrO) rRrJr7r8r9r:rIr$rSrT)r!r@edit_message_captionrG edit_caption) r)rRrJrIrSrTr7r8r9r:r$r,r,r-rUs<&  z"CallbackQuery.edit_message_caption checklistc s$|j|||||||dIdHS)aShortcut for:: await update.callback_query.message.edit_checklist(*args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Message.edit_checklist`. .. versionadded:: 22.3 Returns: :class:`telegram.Message`: On success, the edited Message is returned. Raises: :exc:`TypeError` if :attr:`message` is not accessible. )rWrJr7r8r9r:r$N)rGedit_checklist)r)rWrJr7r8r9r:r$r,r,r-edit_message_checklist`s z$CallbackQuery.edit_message_checklistc sR|jr|j||j|||||dddd IdHS|j||||||dIdHS)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) rJr!r7r8r9r:r$rMrNrOrJr7r8r9r:r$)r!r@edit_message_reply_markuprGedit_reply_markupr)rJr7r8r9r:r$r,r,r-r[s,#   z'CallbackQuery.edit_message_reply_markupmediarc sV|jr|j|j|||||||dddd IdHS|j|||||||dIdHS)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!r^rJr7r8r9r:r$rMrNrO)r^rJr7r8r9r:r$)r!r@edit_message_mediarG edit_media)r)r^rJr7r8r9r:r$r,r,r-r_s0#  z CallbackQuery.edit_message_media)locationr7r8r9r:r$latitude longitudehorizontal_accuracyheadingproximity_alert_radius live_periodrazLocation | Nonecs|jrC|jdid|jd|d|d|d|d| d| d| d | d | d |d |d |d|ddddddIdHS|j||||| | | | | ||||d IdHS)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. r!rbrcrarJr7r8r9r:r$rdrerfrgrMNrNrO) rbrcrarJr7r8r9r:r$rdrerfrgr,)r!r@edit_message_live_locationrGedit_live_location)r)rbrcrJrdrerfrgrar7r8r9r:r$r,r,r-rhsh*       z(CallbackQuery.edit_message_live_locationc sR|jr|j|j||||||dddd IdHS|j||||||dIdHS)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!rJr7r8r9r:r$rMrNrOrZ)r!r@stop_message_live_locationrGstop_live_locationr]r,r,r-rjJs,#   z(CallbackQuery.stop_message_live_locationuser_idscoreforcedisable_edit_messagec s\|jr|j|j||||||||| ddd IdHS|j||||||||| d IdHS)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!rlrmrnror7r8r9r:r$rMrN) rlrmrnror7r8r9r:r$)r!r@set_game_scorerG) r)rlrmrnror7r8r9r:r$r,r,r-rps6%  zCallbackQuery.set_game_score)r.c sP|jr|j|j||||||ddd IdHS|j||||||dIdHS)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!rlr7r8r9r:r$rMrN)rlr7r8r9r:r$)r!r@get_game_high_scoresrG)r)rlr7r8r9r:r$r,r,r-rqs*"   z"CallbackQuery.get_game_high_scoresc$|jddj|||||dIdHS)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. deleterDr6N)rGrsr)r7r8r9r:r$r,r,r-delete_messages  zCallbackQuery.delete_messagedisable_notificationcs&|jddj||||||dIdHS)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. pinrt)rwr7r8r9r:r$N)rGrx)r)rwr7r8r9r:r$r,r,r- pin_messages  zCallbackQuery.pin_messagecrr)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. unpinrtr6N)rGrzrur,r,r- unpin_message>s  zCallbackQuery.unpin_message)allow_sending_without_replyreply_to_message_idr7r8r9r:r$rMzReplyMarkup | Noneprotect_contentmessage_thread_idreply_parameterszReplyParameters | Noneallow_paid_broadcastvideo_start_timestampsuggested_post_parameterszSuggestedPostParameters | Nonemessage_effect_idr|r}rcs|jddjdid|d|d|d| d|d|d |d |d |d |d |d|d|d|d|d|d| d| d| d| d|IdHS)aShortcut for:: await update.callback_query.message.copy( from_chat_id=update.message.chat_id, message_id=update.message.message_id, direct_messages_topic_id=update.message.direct_messages_topic.topic_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. copyrtrMrRrIrrSrwr}r|rJr7r8r9r:r$r~rrrTrrrNr,)rGr)r)rMrRrIrSrwrJr~rrrTrrrrr|r}r7r8r9r:r$r,r,r- copy_message^sX.      zCallbackQuery.copy_messageMAX_ANSWER_TEXT_LENGTH)NNNN)N)rC)NNNNNNN)NN),__name__ __module__ __qualname____doc__ __slots__strr rr r& classmethodr4r boolrrfloatrBrrGrrPrUrrYr[r_intrhrjrptuplerqrvryr{rrCallbackQueryLimit!ANSWER_CALLBACK_QUERY_TEXT_LENGTHrr__annotations__ __classcell__r,r,r*r-r2sr D       %        J      H  ' =  >      Q >    D : # % #       GrN)&rcollections.abcrtypingrrtelegramrtelegram._inputchecklistrtelegram._messagerrtelegram._telegramobjectr telegram._userr telegram._utils.argumentparsingr telegram._utils.defaultvaluer telegram._utils.typesr rrrrrrrrrrrtelegram._files.locationrrrr,r,r,r-s        ,