U ddK@sdZddlmZmZmZmZddlmZddlm Z ddl m Z ddl m Z ddlmZddlmZdd lmZdd lmZdd lmZdd lmZmZdd lmZddlmZerddlmZm Z m!Z!GdddeZ"dS)zAThis module contains an object that represents a Telegram Update.) TYPE_CHECKINGClassVarListOptional) constants) CallbackQuery)ChatJoinRequest)ChatMemberUpdated)ChosenInlineResult) InlineQuery)Message)PreCheckoutQuery) ShippingQuery)Poll PollAnswer)TelegramObject)JSONDict)BotChatUsercseZdZUdZdZejjZee e d<ejj Z ee e d<ejj Z ee e d<ejj Z ee e d<ejjZee e d<ejjZee e d<ejjZee e d <ejjZee e d <ejjZee e d <ejjZee e d <ejjZee e d <ejjZee e d<ejjZee e d<ejjZeejZeee e d<d#ddeeeeeeeee e!e"e#e$e$e%e&dfddZ'e(e)ddddZ*e(e)ddddZ+e(e)edddZ,e-e)e&de)dd fd!d" Z.Z/S)$UpdateaThis object represents an incoming update. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`update_id` is equal. Note: At most one of the optional parameters can be present in any given update. .. seealso:: :wiki:`Your First Bot ` Args: update_id (:obj:`int`): The update's unique identifier. Update identifiers start from a certain positive number and increase sequentially. This ID becomes especially handy if you're using Webhooks, since it allows you to ignore repeated updates or to restore the correct update sequence, should they get out of order. If there are no new updates for at least a week, then identifier of the next update will be chosen randomly instead of sequentially. message (:class:`telegram.Message`, optional): New incoming message of any kind - text, photo, sticker, etc. edited_message (:class:`telegram.Message`, optional): New version of a message that is known to the bot and was edited. channel_post (:class:`telegram.Message`, optional): New incoming channel post of any kind - text, photo, sticker, etc. edited_channel_post (:class:`telegram.Message`, optional): New version of a channel post that is known to the bot and was edited. inline_query (:class:`telegram.InlineQuery`, optional): New incoming inline query. chosen_inline_result (:class:`telegram.ChosenInlineResult`, optional): The result of an inline query that was chosen by a user and sent to their chat partner. callback_query (:class:`telegram.CallbackQuery`, optional): New incoming callback query. shipping_query (:class:`telegram.ShippingQuery`, optional): New incoming shipping query. Only for invoices with flexible price. pre_checkout_query (:class:`telegram.PreCheckoutQuery`, optional): New incoming pre-checkout query. Contains full information about checkout. poll (:class:`telegram.Poll`, optional): New poll state. Bots receive only updates about stopped polls and polls, which are sent by the bot. poll_answer (:class:`telegram.PollAnswer`, optional): A user changed their answer in a non-anonymous poll. Bots receive new votes only in polls that were sent by the bot itself. my_chat_member (:class:`telegram.ChatMemberUpdated`, optional): The bot's chat member status was updated in a chat. For private chats, this update is received only when the bot is blocked or unblocked by the user. .. versionadded:: 13.4 chat_member (:class:`telegram.ChatMemberUpdated`, optional): A chat member's status was updated in a chat. The bot must be an administrator in the chat and must explicitly specify :attr:`CHAT_MEMBER` in the list of :paramref:`telegram.ext.Application.run_polling.allowed_updates` to receive these updates (see :meth:`telegram.Bot.get_updates`, :meth:`telegram.Bot.set_webhook`, :meth:`telegram.ext.Application.run_polling` and :meth:`telegram.ext.Application.run_webhook`). .. versionadded:: 13.4 chat_join_request (:class:`telegram.ChatJoinRequest`, optional): A request to join the chat has been sent. The bot must have the :attr:`telegram.ChatPermissions.can_invite_users` administrator right in the chat to receive these updates. .. versionadded:: 13.8 Attributes: update_id (:obj:`int`): The update's unique identifier. Update identifiers start from a certain positive number and increase sequentially. This ID becomes especially handy if you're using Webhooks, since it allows you to ignore repeated updates or to restore the correct update sequence, should they get out of order. If there are no new updates for at least a week, then identifier of the next update will be chosen randomly instead of sequentially. message (:class:`telegram.Message`): Optional. New incoming message of any kind - text, photo, sticker, etc. edited_message (:class:`telegram.Message`): Optional. New version of a message that is known to the bot and was edited. channel_post (:class:`telegram.Message`): Optional. New incoming channel post of any kind - text, photo, sticker, etc. edited_channel_post (:class:`telegram.Message`): Optional. New version of a channel post that is known to the bot and was edited. inline_query (:class:`telegram.InlineQuery`): Optional. New incoming inline query. chosen_inline_result (:class:`telegram.ChosenInlineResult`): Optional. The result of an inline query that was chosen by a user and sent to their chat partner. callback_query (:class:`telegram.CallbackQuery`): Optional. New incoming callback query. Examples: :any:`Arbitrary Callback Data Bot ` shipping_query (:class:`telegram.ShippingQuery`): Optional. New incoming shipping query. Only for invoices with flexible price. pre_checkout_query (:class:`telegram.PreCheckoutQuery`): Optional. New incoming pre-checkout query. Contains full information about checkout. poll (:class:`telegram.Poll`): Optional. New poll state. Bots receive only updates about stopped polls and polls, which are sent by the bot. poll_answer (:class:`telegram.PollAnswer`): Optional. A user changed their answer in a non-anonymous poll. Bots receive new votes only in polls that were sent by the bot itself. my_chat_member (:class:`telegram.ChatMemberUpdated`): Optional. The bot's chat member status was updated in a chat. For private chats, this update is received only when the bot is blocked or unblocked by the user. .. versionadded:: 13.4 chat_member (:class:`telegram.ChatMemberUpdated`): Optional. A chat member's status was updated in a chat. The bot must be an administrator in the chat and must explicitly specify :attr:`CHAT_MEMBER` in the list of :paramref:`telegram.ext.Application.run_polling.allowed_updates` to receive these updates (see :meth:`telegram.Bot.get_updates`, :meth:`telegram.Bot.set_webhook`, :meth:`telegram.ext.Application.run_polling` and :meth:`telegram.ext.Application.run_webhook`). .. versionadded:: 13.4 chat_join_request (:class:`telegram.ChatJoinRequest`): Optional. A request to join the chat has been sent. The bot must have the :attr:`telegram.ChatPermissions.can_invite_users` administrator right in the chat to receive these updates. .. versionadded:: 13.8 )callback_querychosen_inline_resultpre_checkout_query inline_query update_idmessageshipping_querypoll poll_answer channel_postedited_channel_postedited_message_effective_user_effective_chat_effective_messagemy_chat_member chat_memberchat_join_requestMESSAGEEDITED_MESSAGE CHANNEL_POSTEDITED_CHANNEL_POST INLINE_QUERYCHOSEN_INLINE_RESULTCALLBACK_QUERYSHIPPING_QUERYPRE_CHECKOUT_QUERYPOLL POLL_ANSWERMY_CHAT_MEMBER CHAT_MEMBER ALL_TYPESN api_kwargs)rrr"r r!rrrrrrrr&r'r(r8cstj|d||_||_||_||_||_||_| |_| |_ ||_ ||_ | |_ | |_ | |_||_||_d|_d|_d|_|jf|_|dS)Nr7)super__init__rrr"rrrrrr r!rrr&r'r(r#r$r%Z _id_attrsZ_freeze)selfrrr"r r!rrrrrrrr&r'r(r8 __class__4/tmp/pip-unpacked-wheel-e3anp165/telegram/_update.pyr:s* zUpdate.__init__r)returncCs|jr |jSd}|jr |jj}n|jr0|jj}n|jr@|jj}n~|jrP|jj}nn|jr`|jj}n^|jrp|jj}nN|jr|jj}n>|j r|j j }n.|j r|j j}n|j r|j j}n|j r|j j}||_|S)a :class:`telegram.User`: The user that sent this update, no matter what kind of update this is. If no user is associated with this update, this gives :obj:`None`. This is the case if :attr:`channel_post`, :attr:`edited_channel_post` or :attr:`poll` is present. Example: * If :attr:`message` is present, this will give :attr:`telegram.Message.from_user`. * If :attr:`poll_answer` is present, this will give :attr:`telegram.PollAnswer.user`. N)r#rZ from_userr"rrrrrruserr&r'r()r;rAr>r>r?effective_users6           zUpdate.effective_userrcCs|jr |jSd}|jr |jj}nx|jr0|jj}nh|jrJ|jjrJ|jjj}nN|jrZ|jj}n>|jrj|jj}n.|jrz|jj}n|jr|jj}n|j r|j j}||_|S)a0 :class:`telegram.Chat`: The chat that this update was sent in, no matter what kind of update this is. If no chat is associated with this update, this gives :obj:`None`. This is the case, if :attr:`inline_query`, :attr:`chosen_inline_result`, :attr:`callback_query` from inline messages, :attr:`shipping_query`, :attr:`pre_checkout_query`, :attr:`poll` or :attr:`poll_answer` is present. Example: If :attr:`message` is present, this will give :attr:`telegram.Message.chat`. N) r$rchatr"rr r!r&r'r()r;rCr>r>r?effective_chatPs*       zUpdate.effective_chatcCs`|jr |jSd}|jr|j}n8|jr,|j}n*|jr<|jj}n|jrJ|j}n |jrV|j}||_|S)a :class:`telegram.Message`: The message included in this update, no matter what kind of update this is. More precisely, this will be the message contained in :attr:`message`, :attr:`edited_message`, :attr:`channel_post`, :attr:`edited_channel_post` or :attr:`callback_query` (i.e. :attr:`telegram.CallbackQuery.message`) or :obj:`None`, if none of those are present. N)r%rr"rr r!)r;rr>r>r?effective_messages  zUpdate.effective_messager)databotr@csV||}|sdSt|d||d<t|d||d<t|d||d<t|d||d<t|d||d<t|d||d<t|d||d<t|d ||d <t|d ||d <t |d ||d <t |d ||d <t |d ||d <t |d||d<t |d||d<t j||dS)z,See :meth:`telegram.TelegramObject.de_json`.Nrr"rrrrrr r!rrr&r'r()rFrG)Z _parse_datar de_jsongetr r rrr rrr rr9)clsrFrGr<r>r?rHs* zUpdate.de_json)NNNNNNNNNNNNNN)0__name__ __module__ __qualname____doc__ __slots__rZ UpdateTyper)rstr__annotations__r*r+r,r-r.r/r0r1r2r3r4r5ZCHAT_JOIN_REQUESTlistr6rintr r r rrr rrr rrr:propertyrrBrDrE classmethodrH __classcell__r>r>r<r?r(sv p/5. rN)#rNtypingrrrrZtelegramrZtelegram._callbackqueryrZtelegram._chatjoinrequestrZtelegram._chatmemberupdatedr Ztelegram._choseninlineresultr Ztelegram._inline.inlinequeryr Ztelegram._messager Z"telegram._payment.precheckoutqueryr Ztelegram._payment.shippingqueryrZtelegram._pollrrZtelegram._telegramobjectrZtelegram._utils.typesrrrrrr>r>r>r?s