U 2tcB@sdZddlmZmZmZddlmZmZmZm Z m Z m Z m Z m Z mZmZmZddlmZddlmZer|ddlmZmZmZGddde Zd S) zAThis module contains an object that represents a Telegram Update.) TYPE_CHECKINGAnyOptional) CallbackQueryChosenInlineResult InlineQueryMessagePollPreCheckoutQuery ShippingQueryTelegramObjectChatMemberUpdated constantsChatJoinRequest) PollAnswer)JSONDict)BotChatUserc@seZdZdZdZejZejZ ej Z ej Z ejZejZejZejZejZejZejZejZejZej Z!ej"Z#de$e%e%e%e%e&e'e(e)e*e+e,e-e-e.e/dddZ0e1e2ddd d Z3e1e2d dd d Z4e1e2e%dddZ5e6e2e7de2ddddZ8dS)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. 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 ``'chat_member'`` in the list of ``'allowed_updates'`` to receive these updates (see :meth:`telegram.Bot.get_updates`, :meth:`telegram.Bot.set_webhook`, :meth:`telegram.ext.Updater.start_polling` and :meth:`telegram.ext.Updater.start_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 **kwargs (:obj:`dict`): Arbitrary keyword arguments. Attributes: update_id (:obj:`int`): The update's unique identifier. message (:class:`telegram.Message`): Optional. New incoming message. edited_message (:class:`telegram.Message`): Optional. New version of a message. channel_post (:class:`telegram.Message`): Optional. New incoming channel post. edited_channel_post (:class:`telegram.Message`): Optional. New version of a channel post. 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. callback_query (:class:`telegram.CallbackQuery`): Optional. New incoming callback query. shipping_query (:class:`telegram.ShippingQuery`): Optional. New incoming shipping query. pre_checkout_query (:class:`telegram.PreCheckoutQuery`): Optional. New incoming pre-checkout query. 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 ``'chat_member'`` in the list of ``'allowed_updates'`` to receive these updates (see :meth:`telegram.Bot.get_updates`, :meth:`telegram.Bot.set_webhook`, :meth:`telegram.ext.Updater.start_polling` and :meth:`telegram.ext.Updater.start_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 ``'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_request _id_attrsN)rrr!rr rrrrrrrr%r&r'_kwargscKs~t||_||_||_||_||_||_| |_| |_||_ ||_ | |_ | |_ | |_ ||_||_d|_d|_d|_|jf|_dS)N)intrrr!rrrrrrr rrr%r&r'r"r#r$r()selfrrr!rr rrrrrrrr%r&r'r)r,3/tmp/pip-unpacked-wheel-2u9rcp5s/telegram/update.py__init__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)z :class:`telegram.User`: The user that sent this update, no matter what kind of update this is. Will be :obj:`None` for :attr:`channel_post` and :attr:`poll`. N)r"rZ from_userr!rrrrrruserr%r&r')r+r0r,r,r-effective_user s6          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)a{ :class:`telegram.Chat`: The chat that this update was sent in, no matter what kind of update this is. Will be :obj:`None` for :attr:`inline_query`, :attr:`chosen_inline_result`, :attr:`callback_query` from inline messages, :attr:`shipping_query`, :attr:`pre_checkout_query`, :attr:`poll` and :attr:`poll_answer`. N) r#rchatr!rrr r%r&r')r+r2r,r,r-effective_chat:s*        zUpdate.effective_chatcCs`|jr |jSd}|jr|j}n8|jr,|j}n*|jr<|jj}n|jrJ|j}n |jrV|j}||_|S)aT :class:`telegram.Message`: The message included in this update, no matter what kind of update this is. Will be :obj:`None` for :attr:`inline_query`, :attr:`chosen_inline_result`, :attr:`callback_query` from inline messages, :attr:`shipping_query`, :attr:`pre_checkout_query`, :attr:`poll`, :attr:`poll_answer`, :attr:`my_chat_member`, :attr:`chat_member` as well as :attr:`chat_join_request` in case the bot is missing the :attr:`telegram.ChatPermissions.can_invite_users` administrator right in the chat. N)r$rr!rrr )r+rr,r,r-effective_messageds  zUpdate.effective_messager)databotr/cCsP||}|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<|f|S)z,See :meth:`telegram.TelegramObject.de_json`.Nrr!rrrrrrr rrr%r&r') Z _parse_datarde_jsongetrrrr r r rr r)clsr5r6r,r,r-r7s* zUpdate.de_json)NNNNNNNNNNNNNN)9__name__ __module__ __qualname____doc__ __slots__rZUPDATE_MESSAGEZMESSAGEZUPDATE_EDITED_MESSAGEZEDITED_MESSAGEZUPDATE_CHANNEL_POSTZ CHANNEL_POSTZUPDATE_EDITED_CHANNEL_POSTZEDITED_CHANNEL_POSTZUPDATE_INLINE_QUERYZ INLINE_QUERYZUPDATE_CHOSEN_INLINE_RESULTZCHOSEN_INLINE_RESULTZUPDATE_CALLBACK_QUERYZCALLBACK_QUERYZUPDATE_SHIPPING_QUERYZSHIPPING_QUERYZUPDATE_PRE_CHECKOUT_QUERYZPRE_CHECKOUT_QUERYZ UPDATE_POLLZPOLLZUPDATE_POLL_ANSWERZ POLL_ANSWERZUPDATE_MY_CHAT_MEMBERZMY_CHAT_MEMBERZUPDATE_CHAT_MEMBERZ CHAT_MEMBERZUPDATE_CHAT_JOIN_REQUESTZCHAT_JOIN_REQUESTZUPDATE_ALL_TYPESZ ALL_TYPESr*rrrrr r r rr rrr.propertyrr1r3r4 classmethodrr7r,r,r,r-r+sr` +/)"rN)r=typingrrrZtelegramrrrrr r r r r rrZ telegram.pollrZtelegram.utils.typesrrrrrr,r,r,r-s4