jDdZddlmZddlmZmZddlmZddlm Z ddl m Z m Z ddl mZddlmZdd lmZdd lmZdd lmZmZmZer"dd lmZmZmZmZmZmZmZm Z m!Z!dd l"m#Z#ddlm$Z$GddeZ%y)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.0eZdZUdZdZ dZdddededededzd edzd edzd edzd edzffd Z e d[d eddddffd Z dZe e e e dddedzde dzdedzdedzdeedeedeedeed edzde fdZd\dedefdZe dde fde e e e dddedeed d!d"ed#dzd$ed%d&e dzdeedeedeedeed edzdd'fd(Zdde ddfe e e e ddd)edzd d!deed*ed#dzd+e dzdeedeedeedeed edzdd'fd,Z d[e e e e ddd-ed d!deedeedeedeed edzdd'fd.Z d[e e e e ddd d!deedeedeedeed edzdd'fd/Z d[e e e e ddd0d1d d!deedeedeedeed edzdd'fd2Z d]de e e e dd3d4edzd5edzd d!d6edzd7edzd8edzd9edzd:d;deedeedeedeed edzdd'fd<Z d[e e e e ddd d!deedeedeedeed edzdd'fd=Z d^e e e e ddd>ed?ed@e dzdAe dzdeedeedeedeed edzdd'fdBZe e e e ddd>edeedeedeedeed edzdedCfdDZ e e e e dddeedeedeedeed edzde f dEZ!e fe e e e dddFee deedeedeedeed edzde fdGZ"e e e e dddeedeedeedeed edzde f dHZ#de de de dddddddf e de e e e ddIdJeezd)edzdeed*ed#dzdFee d dKdLee dMedzdNdOd+e dzdPe dzdQedzdRdSdTedzdUee dVedzdeedeedeedeed edzddWf,dXZ$e%jLjNZ(e)ee*dY<xZ+S)_ 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"r rr$rr#r!r&ct ||||_||_||_||_||_||_||_|jf|_ |jy)Nr%) super__init__r"r rr$rr#r! _id_attrs_freeze) selfr"r rr$rr#r!r& __class__s V/var/www/html/datingFans/myenv/lib/python3.12/site-packages/telegram/_callbackquery.pyr)zCallbackQuery.__init__s_ J/("/8? $ ->+:'' botz Bot | Nonereturnc|j|}t|jddt||d<t|j dt ||d<t |||S)z,See :meth:`telegram.TelegramObject.de_json`.fromNr r$)rr0) _parse_datar popr getr r(de_json)clsrr0r-s r.r7zCallbackQuery.de_jsons_t$,TXXfd-CT3O[*488I+>MYwDc22r/ read_timeout write_timeoutconnect_timeout pool_timeoutr&text show_alerturl cache_timer:r;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@rAr:r;r<r=r&N)get_botanswer_callback_queryr") r,r>r?r@rAr:r;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,rGs r. _get_messagezCallbackQuery._get_messages1$,,0gfX-EFG G||r/)disable_web_page_previewr:r;r<r=r& parse_mode reply_markupzInlineKeyboardMarkup | Noneentitiesrlink_preview_optionsrrLzMessage | boolcK|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>rMrLrPrNr:r;r<r=r&rOchat_id message_idbusiness_connection_id) r>rMrLrPrNr:r;r<r=r&rO)r#rDedit_message_textrK edit_text) r,r>rMrNrOrPrLr:r;r<r=r&s r.rUzCallbackQuery.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)rWr#rNr:r;r<r=rMr&rXrRrSrYrT) rWrNr:r;r<r=rMr&rXrY)r#rDedit_message_captionrK edit_caption) r,rWrNrMrXrYr:r;r<r=r&s r.r[z"CallbackQuery.edit_message_captionsL  ! !<<"&"8"8))+ /)%%!1)A'+= "&&(55%%'+%!!-%=6   #"  s$AB A? 0B:B;BB checklistc jK|jj|||||||d{S7w)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. )r]rNr:r;r<r=r&N)rKedit_checklist)r,r]rNr:r;r<r=r&s r.edit_message_checklistz$CallbackQuery.edit_message_checklist`sH6&&(77%%'+%!8    *313c 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) rNr#r:r;r<r=r&rRrSrTrNr:r;r<r=r&)r#rDedit_message_reply_markuprKedit_reply_markupr,rNr:r;r<r=r&s r.rdz'CallbackQuery.edit_message_reply_markupsF  ! !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#rhrNr:r;r<r=r&rRrSrT)rhrNr:r;r<r=r&)r#rDedit_message_mediarK edit_media)r,rhrNr:r;r<r=r&s r.rjz CallbackQuery.edit_message_mediasF  ! !::"&"8"8))+ /)%'+;   &&(33%%'+%!4     s$AA=A9-A=4A;5A=;A=)locationr:r;r<r=r&latitude longitudehorizontal_accuracyheadingproximity_alert_radius live_periodrlzLocation | NonecK|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#rmrnrlrNr:r;r<r=r&rorprqrrrRrSrT) rmrnrlrNr:r;r<r=r&rorprqrr)r#rDedit_message_live_locationrKedit_live_location)r,rmrnrNrorprqrrrlr:r;r<r=r&s r.rtz(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#rNr:r;r<r=r&rRrSrTrc)r#rDstop_message_live_locationrKstop_live_locationrfs r.rwz(CallbackQuery.stop_message_live_locationJsF  ! !BB"&"8"8))+ /)%'+C   &&(;;%%'+%! <     rguser_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#ryrzr{r|r:r;r<r=r&rRrS) ryrzr{r|r:r;r<r=r&)r#rDset_game_scorerK) r,ryrzr{r|r:r;r<r=r&s r.r~zCallbackQuery.set_game_scoresJ  ! !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#ryr:r;r<r=r&rRrS)ryr:r;r<r=r&)r#rDget_game_high_scoresrK)r,ryr:r;r<r=r&s r.rz"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. deleterGr9N)rKrr,r:r;r<r=r&s r.delete_messagezCallbackQuery.delete_messagesG2&&h&7>>%'+%! ?    radisable_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)rr:r;r<r=r&N)rKr)r,rr:r;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. unpinrr9N)rKrrs r. unpin_messagezCallbackQuery.unpin_message>sG0&&g&6<<%'+%! =    ra)allow_sending_without_replyreply_to_message_idr:r;r<r=r&rRzReplyMarkup | Noneprotect_contentmessage_thread_idreply_parameterszReplyParameters | Noneallow_paid_broadcastvideo_start_timestampsuggested_post_parameterszSuggestedPostParameters | Nonemessage_effect_idrrrcK|jdj|||| ||||||||||||| | | | |d{S7w)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. copyr)rRrWrMrrXrrrrNr:r;r<r=r&rrrrYrrrN)rKr)r,rRrWrMrXrrNrrrrYrrrrrrr:r;r<r=r&s r. copy_messagezCallbackQuery.copy_message^sx\&&f&5::!"7-!5 3(C%%'+%!+/-%=!5&?/+;    s:AAAMAX_ANSWER_TEXT_LENGTH)NNNN)N)edit)NNNNNNN)NN),__name__ __module__ __qualname____doc__ __slots__strr rrr) classmethodr7r boolrrfloatrFr rKrrUr[rr`rdrjintrtrwr~tuplerrrrrrCallbackQueryLimit!ANSWER_CALLBACK_QUERY_TEXT_LENGTHrr__annotations__ __classcell__)r-s@r.rr2s5 BHI48(,&*'+   *D0  Dj :ttO6383,3/33 "&(, # )5)5+7(4&*# Dj# 4K# 4Z # % # uo#  # "%# uo# tO#  # J3G%16:59?K F 15(4)5+7(4&*F F SMF 4 F ?+d2 F '';< F #'+F uoF  F "%F uoF tOF  F T#6:$0=A04 C )5)5+7(4&*C tC 4C SM C #?3d: C #'+ C uoC  C "%C uoC tOC  C P7;# )5)5+7(4&*# !# 4# uo #   # "%# uo# tO#  # N7;8 )5)5+7(4&*8 38 uo 8   8 "% 8 uo8 tO8  8 z7;: )5)5+7(4&*: : 4: uo :   : "%: uo: tO:  : |"&"&6:,0"-1)-M '+(4)5+7(4&*M $,M 4<M 4 M #T\ M t M !$d M  $&M $M uoM  M "%M uoM tOM !M b7;8 )5)5+7(4&*8 38 uo 8   8 "% 8 uo8 tO8  8 |",0 > )5)5+7(4&*> > > d{ > #Tk > uo>  > "%> uo> tO>  > H)5)5+7(4&*5 5 uo 5   5 "% 5 uo5 tO5  # $5 t)5)5+7(4&* uo    "%  uo  tO   F0<  )5)5+7(4&*  &tn  uo     "%  uo  tO     J)5)5+7(4&* uo    "%  uo  tO   F#$0=A/;-1*6(,5904,0,0FJ(,D "7C*.(4)5+7(4&*/D sD tD SM D #?3d: D 'tn D +D "$D :D 3D #'+D #TkD  #TzD $DD :D "&.d^#D $!4Z%D &uo'D ( )D *"%+D ,uo-D .tO/D 0 1D N $$FFE#Jr/rN)&rcollections.abcrtypingrrtelegramrtelegram._inputchecklistrtelegram._messagerr telegram._telegramobjectr telegram._userr telegram._utils.argumentparsingr telegram._utils.defaultvaluer telegram._utils.typesrrrrrrrrrrrrtelegram._files.locationrrrr/r.rsT(N$'3?3<5@@   21y Ny r/