o GCh S@sdZddlmZddlmZddlmZmZmZddlm Z ddl m Z ddl m Z ddlmZdd lmZmZmZmZmZdd lmZdd lmZerdd lmZmZmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4Gd dde Z5dS)z?This module contains an object that represents a Telegram User.)Sequence)datetime) TYPE_CHECKINGOptionalUnion)InlineKeyboardButton) MenuButton)TelegramObject) DEFAULT_NONE)CorrectOptionID FileInputJSONDictODVInput ReplyMarkup) mention_html)mention_markdown) AnimationAudioContactDocumentInlineKeyboardMarkupInputMediaAudioInputMediaDocumentInputMediaPhotoInputMediaVideoInputPollOption LabeledPriceLinkPreviewOptionsLocationMessage MessageEntity MessageId PhotoSizeReplyParametersStickerUserChatBoostsUserProfilePhotosVenueVideo VideoNoteVoicecJs:eZdZdZdZ          ddddedededeed eed eed eed eed eedeedeedeedeedee ffddZ e defddZ e defddZ e deefddZ  deeeedddeedeedeed eed!eed"eedee ded#fd$d%Zdd&eedefd'd(Zdd&eedefd)d*Zdd&eedefd+d,Zdd&eedefd-d.Zedfeeeeddd/ed0eed1eedeed eed!eed"eedee defd2d3Z  deeeeddd/eed1eedeed eed!eed"eedee defd4d5Zeeeedddeed eed!eed"eedee def d6d7Zeeddededdddf ddeeeeedd8d9ed:eed0eed;eedeed?eed@edAdBedCd1eedDeedEeedFeedGeedHeedeed eed!eed"eedee ddIf*dJdKZeeeeddd/edeed eed!eed"eedee defdLdMZeeeedddNeedeed eed!eed"eedee defdOdPZdedededddddddf dedeeeeddQdRe e!dSfdTeed0eed;eed:eedUeed=d>eed?eedVeedBedCd1eedDeedEeedWeedFeedHeedXeedeed eed!eed"eedee ddIf.dYdZZ"eedddddfdeeeeeddedd[ d\ee d]d0eed>eed?eedBedCd1eedDeedEeedFeedHeedeed eed!eed"eedee dTeed:eedUeed=de#d^f&d_d`Z$ddddedededdddddfdedeeeeddQdae e!dbfdceeddeedeeedTeed0eed;eed:eedUeed=d>eed?eedfee!dBedCd1eedDeedEeedFeedHeedXeedeed eed!eed"eedee ddIf2dgdhZ%  deeeedddied?eed1eedeed eed!eed"eedee defdjdkZ&e&Z' dddeddedddddf dedeeeeddldmeedeedeed0eed;eedneed>eed?eedBedCd1eedDeedEeedFeedHeedoedpdeed eed!eed"eedee ddIf*dqdrZ(eddedddddf deeeeeddsd0eed;eedteed>eed?eedBedCd1eedDeedEeedFeedHeedeed eed!eed"eedee ddIf"dudvZ)dededdeddddddf dedeeeeddQdwe e!dxfdTeed0eed;eed:eedyeedUeed=d>eed?eedfee!dBedCd1eedDeedEeedFeedHeedXeedeed eed!eed"eedee ddIf.dzd{Z*ededddddfdeeeeeddsd|ed0eed;ed}d>eed?eedBedCd1eedDeedEeedFeedHeedeed eed!eed"eedee ddIf"d~dZ+ddddddddddeddddddeddddfdeeeeeddsdeedededeedededdeedeedeedeedeedeedeedeedeedeed0eed;ed}dee ee,fdeedeedeedeeed>eed?eedBedCdDeedEeedFeedHeedeed eed!eed"eedee ddIfHddZ-ddedddddedddddfdedeeeedddeedeed0eed;eedeedeedeedeed>eed?eedBedCd1eedDeedEeedFeedHeededdeed eed!eed"eedee ddIf.ddZ.ddddeeddeddddddddfdedeeeeddQde e!dfdceedeedeedTeed:eed0eed;eedUeed=d>eed?eedVeedfee!dBedCd1eedDeedEeedWeedFeedHeedXeedeed eed!eed"eedee ddIf6ddZ/ededdddddf deeeeeddsde e!dfd0eed;eed>eed?eedteedBedCd1eedDeedEeedFeedHeedeed eed!eed"eedee ddIf$ddZ0ddedddeddeddddddddfdedeeeeddQde e!dfdceedTeed0eed;eedeedeed:eedeedUeed=d>eed?eedVeedfee!dBedCd1eedDeedEeedWeedFeedHeedXeedeed eed!eed"eedee ddIf8ddZ1dddddeddddedddddfdedeeeedddeedeedeeedeedeed0eed;eedeedeedeed>eed?eedBedCd1eedDeedEeedFeedHeededdeed eed!eed"eedee ddIf2ddZ2ddededdddddf dedeeeeddQde e!dfdceedeed0eed;eed>eed?eedfee!dBedCd1eedDeedEeedFeedHeedXeedeed eed!eed"eedee ddIf*ddZ3ddedededddddf dedeeeeddQde e!dfdceedTeed0eed;eed:eedUeed=d>eed?eedBedCd1eedDeedEeedFeedHeedXeedeed eed!eed"eedee ddIf,ddÄZ4dddddeddedddedddedddfdeeeeeddsdedee edfdeedeedeedee5deed0eed;eedeedeedeedee ee6fdeed=d>eed?eedBedCd1eedeedeed=dDeedEeedFeedHeedeed eed!eed"eedee ddIfeed?eedBedCdWeedEeedFeedHeedeed eed!eed"eedee ddf(dd؄Z8dedededdddf deeeeeddsde eefd/edTeed:eedUeed=d0eed;eed>eed?eedBedCdWeedEeedFeedHeedeed eed!eed"eedee ddf(ddۄZ9eeddfeeeeddde eefdNeed0eed>eed?eedeedeed eed!eed"eedee de#dfdd߄Z:eeddfeeeeddde eefdNeed0eed>eed?eedeedeed eed!eed"eedee de#dfddZ;eedfeeeeddde eefd/ed0eed>eed?eedeed eed!eed"eedee ddIfddZeed?eedeed eed!eed"eedee ddIfddZ=eedfeeeeddde eefdNeed0eed>eed?eedeed eed!eed"eedee de#dfddZ>eedfeeeeddde eefdNeed0eed>eed?eedeed eed!eed"eedee de#dfddZ?eeeeddde eefdeed eed!eed"eedee defddZ@eeeeddde eefdeed eed!eed"eedee defddZA deeeedddeeBdeed eed!eed"eedee defddZCeeeedddeed eed!eed"eedee deBf ddZDeeeeddde eefdeed eed!eed"eedee ddfddZEeeeedddedeed eed!eed"eedee defddZFZGS)UseraeThis object represents a Telegram user or bot. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`id` is equal. .. versionchanged:: 20.0 The following are now keyword-only arguments in Bot methods: ``location``, ``filename``, ``venue``, ``contact``, ``{read, write, connect, pool}_timeout`` ``api_kwargs``. Use a named argument for those, and notice that some positional arguments changed position as a result. Args: id (:obj:`int`): Unique identifier for this user or bot. is_bot (:obj:`bool`): :obj:`True`, if this user is a bot. first_name (:obj:`str`): User's or bot's first name. last_name (:obj:`str`, optional): User's or bot's last name. username (:obj:`str`, optional): User's or bot's username. language_code (:obj:`str`, optional): IETF language tag of the user's language. can_join_groups (:obj:`str`, optional): :obj:`True`, if the bot can be invited to groups. Returned only in :meth:`telegram.Bot.get_me`. can_read_all_group_messages (:obj:`str`, optional): :obj:`True`, if privacy mode is disabled for the bot. Returned only in :meth:`telegram.Bot.get_me`. supports_inline_queries (:obj:`str`, optional): :obj:`True`, if the bot supports inline queries. Returned only in :meth:`telegram.Bot.get_me`. is_premium (:obj:`bool`, optional): :obj:`True`, if this user is a Telegram Premium user. .. versionadded:: 20.0 added_to_attachment_menu (:obj:`bool`, optional): :obj:`True`, if this user added the bot to the attachment menu. .. versionadded:: 20.0 can_connect_to_business (:obj:`bool`, optional): :obj:`True`, if the bot can be connected to a Telegram Business account to receive its messages. Returned only in :meth:`telegram.Bot.get_me`. .. versionadded:: 21.1 has_main_web_app (:obj:`bool`, optional): :obj:`True`, if the bot has the main Web App. Returned only in :meth:`telegram.Bot.get_me`. .. versionadded:: 21.5 Attributes: id (:obj:`int`): Unique identifier for this user or bot. is_bot (:obj:`bool`): :obj:`True`, if this user is a bot. first_name (:obj:`str`): User's or bot's first name. last_name (:obj:`str`): Optional. User's or bot's last name. username (:obj:`str`): Optional. User's or bot's username. language_code (:obj:`str`): Optional. IETF language tag of the user's language. can_join_groups (:obj:`str`): Optional. :obj:`True`, if the bot can be invited to groups. Returned only in :attr:`telegram.Bot.get_me` requests. can_read_all_group_messages (:obj:`str`): Optional. :obj:`True`, if privacy mode is disabled for the bot. Returned only in :attr:`telegram.Bot.get_me` requests. supports_inline_queries (:obj:`str`): Optional. :obj:`True`, if the bot supports inline queries. Returned only in :attr:`telegram.Bot.get_me` requests. is_premium (:obj:`bool`): Optional. :obj:`True`, if this user is a Telegram Premium user. .. versionadded:: 20.0 added_to_attachment_menu (:obj:`bool`): Optional. :obj:`True`, if this user added the bot to the attachment menu. .. versionadded:: 20.0 can_connect_to_business (:obj:`bool`): Optional. :obj:`True`, if the bot can be connected to a Telegram Business account to receive its messages. Returned only in :meth:`telegram.Bot.get_me`. .. versionadded:: 21.1 has_main_web_app (:obj:`bool`) Optional. :obj:`True`, if the bot has the main Web App. Returned only in :meth:`telegram.Bot.get_me`. .. versionadded:: 21.5 .. |user_chat_id_note| replace:: This shortcuts build on the assumption that :attr:`User.id` coincides with the :attr:`Chat.id` of the private chat with the user. This has been the case so far, but Telegram does not guarantee that this stays this way. ) added_to_attachment_menucan_connect_to_businesscan_join_groupscan_read_all_group_messages first_namehas_main_web_appidis_bot is_premium language_code last_namesupports_inline_queriesusernameN api_kwargsr2r0r3r6r8r5r.r/r7r4r,r-r1r:csrtj|d||_||_||_||_||_||_||_||_ | |_ | |_ | |_ | |_ | |_|jf|_|dS)Nr9)super__init__r2r0r3r6r8r5r.r/r7r4r,r-r1 _id_attrs_freeze)selfr2r0r3r6r8r5r.r/r7r4r,r-r1r: __class__G/var/www/html/govbot/env/lib/python3.10/site-packages/telegram/_user.pyr<s   z User.__init__returncCs|jr d|jS|jS)z:obj:`str`: Convenience property. If available, returns the user's :attr:`username` prefixed with "@". If :attr:`username` is not available, returns :attr:`full_name`. @)r8 full_namer?rBrBrCnames z User.namecCs|jr |jd|jS|jS)z:obj:`str`: Convenience property. The user's :attr:`first_name`, followed by (if available) :attr:`last_name`.  )r6r0rGrBrBrCrFszUser.full_namecCs|jr d|jSdS)zu:obj:`str`: Convenience property. If :attr:`username` is available, returns a t.me link of the user. z https://t.me/N)r8rGrBrBrClinks z User.link) read_timeout write_timeoutconnect_timeout pool_timeoutr:offsetlimitrKrLrMrNr&c s(|j|j|||||||dIdHS)zShortcut for:: await bot.get_user_profile_photos(update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.get_user_profile_photos`. )user_idrOrPrKrLrMrNr:N)get_botget_user_profile_photosr2)r?rOrPrKrLrMrNr:rBrBrCget_profile_photoss zUser.get_profile_photosrHcC|rt|j|St|j|jS)a Note: :tg-const:`telegram.constants.ParseMode.MARKDOWN` is a legacy mode, retained by Telegram for backward compatibility. You should use :meth:`mention_markdown_v2` instead. Args: name (:obj:`str`): The name used as a link for the user. Defaults to :attr:`full_name`. Returns: :obj:`str`: The inline mention for the user as markdown (version 1). helpers_mention_markdownr2rFr?rHrBrBrCrs zUser.mention_markdowncCs&|r t|j|ddSt|j|jddS)z Args: name (:obj:`str`): The name used as a link for the user. Defaults to :attr:`full_name`. Returns: :obj:`str`: The inline mention for the user as markdown (version 2). )versionrVrXrBrBrCmention_markdown_v2s zUser.mention_markdown_v2cCrU)z Args: name (:obj:`str`): The name used as a link for the user. Defaults to :attr:`full_name`. Returns: :obj:`str`: The inline mention for the user as HTML. )helpers_mention_htmlr2rFrXrBrBrCrs zUser.mention_htmlcCst|p|jd|jdS)a{Shortcut for:: InlineKeyboardButton(text=name, url=f"tg://user?id={update.effective_user.id}") .. versionadded:: 13.9 Args: name (:obj:`str`): The name used as a link for the user. Defaults to :attr:`full_name`. Returns: :class:`telegram.InlineKeyboardButton`: InlineButton with url set to the user mention z tg://user?id=)texturl)rrFr2rXrBrBrCmention_button*s zUser.mention_button message_iddisable_notificationbusiness_connection_idc s*|j|j||||||||d IdHS)aWShortcut for:: await bot.pin_chat_message(chat_id=update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.pin_chat_message`. Note: |user_chat_id_note| Returns: :obj:`bool`: On success, :obj:`True` is returned. ) chat_idr`rarKrLrMrNrbr:N)rRpin_chat_messager2) r?r`rarbrKrLrMrNr:rBrBrC pin_message9 zUser.pin_messagec s(|j|j|||||||dIdHS)a[Shortcut for:: await bot.unpin_chat_message(chat_id=update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.unpin_chat_message`. Note: |user_chat_id_note| Returns: :obj:`bool`: On success, :obj:`True` is returned. )rcrKrLrMrNr:r`rbN)rRunpin_chat_messager2)r?r`rbrKrLrMrNr:rBrBrC unpin_message^s zUser.unpin_messagec$|j|j|||||dIdHS)amShortcut for:: await bot.unpin_all_chat_messages(chat_id=update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.unpin_all_chat_messages`. Note: |user_chat_id_note| Returns: :obj:`bool`: On success, :obj:`True` is returned. rcrKrLrMrNr:N)rRunpin_all_chat_messagesr2r?rKrLrMrNr:rBrBrCunpin_all_messagess zUser.unpin_all_messages)reply_to_message_iddisable_web_page_previewallow_sending_without_replyrKrLrMrNr:r] parse_mode reply_markupentitiesr protect_contentmessage_thread_idlink_preview_optionsrreply_parametersr#message_effect_idallow_paid_broadcastrnrorprc s|jdid|jd|d|d|d|d|d| d| d |d |d |d |d |d|d|d|d|d|d| d| d| IdHS)aeShortcut for:: await bot.send_message(update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_message`. Note: |user_chat_id_note| Returns: :class:`telegram.Message`: On success, instance representing the message posted. rcr]rqrorvrarnrwrrrprsrtrurKrLrMrNr:rbrxryNrB)rR send_messager2)r?r]rqrarrrsrtrurvrwrbrxryrnrorprKrLrMrNr:rBrBrCrzX%      zUser.send_messagec &|j|j||||||dIdHS)a<Shortcut for:: await bot.delete_message(update.effective_user.id, *argss, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.delete_message`. .. versionadded:: 20.8 Returns: :obj:`bool`: On success, :obj:`True` is returned. )rcr`rKrLrMrNr:N)rRdelete_messager2)r?r`rKrLrMrNr:rBrBrCr} zUser.delete_message message_idsc r|)a>Shortcut for:: await bot.delete_messages(update.effective_user.id, *argss, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.delete_messages`. .. versionadded:: 20.8 Returns: :obj:`bool`: On success, :obj:`True` is returned. )rcrrKrLrMrNr:N)rRdelete_messagesr2)r?rrKrLrMrNr:rBrBrCrr~zUser.delete_messages)rnrpfilenamerKrLrMrNr:photor"captioncaption_entities has_spoilershow_caption_above_mediarcs|jdid|jd|d|d|d|d| d|d|d |d |d |d |d |d|d|d|d|d|d| d| d| d| d|IdHS)aaShortcut for:: await bot.send_photo(update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_photo`. Note: |user_chat_id_note| Returns: :class:`telegram.Message`: On success, instance representing the message posted. rcrrrarnrwrrrqrprrrtrurKrLrMrNr:rrbrxryrNrB)rR send_photor2)r?rrrarrrqrrtrurrwrbrxryrrnrprrKrLrMrNr:rBrBrCr`'      zUser.send_photo) rnrprKrLrMrNr:rrqrmedia)rrrr)r.c s|jdid|jd|d|d| d|d| d| d| d |d |d | d |d |d|d|d|d|d|d|IdHS)aShortcut for:: await bot.send_media_group(update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_media_group`. Note: |user_chat_id_note| Returns: tuple[:class:`telegram.Message`:] On success, a tuple of :class:`~telegram.Message` instances that were sent is returned. rcrrarnrwrKrLrMrNr:rprtrurrqrrbrxryNrB)rRsend_media_groupr2)r?rrartrurwrbrxryrnrprKrLrMrNr:rrqrrBrBrCr_sP&      zUser.send_media_groupaudiorduration performertitle thumbnailcs|jdid|jd|d|d|d|d|d|d|d | d |d |d |d | d|d| d| d|d|d|d|d|d| d|d|d|IdHS)aaShortcut for:: await bot.send_audio(update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_audio`. Note: |user_chat_id_note| Returns: :class:`telegram.Message`: On success, instance representing the message posted. rcrrrrrrarnrwrrrqrprrrtrurKrLrMrNr:rrbrxryNrB)rR send_audior2)r?rrrrrrarrrqrrtrurrwrbrxryrnrprrKrLrMrNr:rBrBrCrh)      zUser.send_audioactionc s*|j|j||||||||d IdHS)a5Shortcut for:: await bot.send_chat_action(update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_chat_action`. Note: |user_chat_id_note| Returns: :obj:`True`: On success. ) rcrrurKrLrMrNr:rbN)rRsend_chat_actionr2) r?rrurbrKrLrMrNr:rBrBrCrrfzUser.send_chat_action)rnrpcontactrKrLrMrNr: phone_numbervcardrrc s|jdid|jd|d|d|d|d| d| d|d |d |d |d |d |d|d|d|d|d|d| d| d| IdHS)aeShortcut for:: await bot.send_contact(update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_contact`. Note: |user_chat_id_note| Returns: :class:`telegram.Message`: On success, instance representing the message posted. rcrr0r6rarnrwrrrKrLrMrNrrr:rprtrurbrxryNrB)rR send_contactr2)r?rr0r6rarrrrtrurwrbrxryrnrprrKrLrMrNr:rBrBrCrr{zUser.send_contact)rnrprKrLrMrNr:emojic s|jdid|jd|d| d|d|d| d| d|d |d |d |d | d |d|d|d|d| IdHS)a_Shortcut for:: await bot.send_dice(update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_dice`. Note: |user_chat_id_note| Returns: :class:`telegram.Message`: On success, instance representing the message posted. rcrarnrwrrrKrLrMrNrr:rprtrurbrxryNrB)rR send_dicer2)r?rarrrrtrurwrbrxryrnrprKrLrMrNr:rBrBrCrEH!      zUser.send_dicedocumentrdisable_content_type_detectioncs|jdid|jd|d|d|d|d|d| d|d |d |d |d |d |d| d|d|d|d|d|d| d| d| d|IdHS)agShortcut for:: await bot.send_document(update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_document`. Note: |user_chat_id_note| Returns: :class:`telegram.Message`: On success, instance representing the message posted. rcrrrrarnrwrrrKrLrMrNrqrr:rrprrtrurbrxryNrB)rR send_documentr2)r?rrrarrrqrrrtrurrwrbrxryrnrprrKrLrMrNr:rBrBrCrzrzUser.send_documentgame_short_namerc s|jdid|jd|d|d| d|d|d| d| d |d |d |d | d |d|d|d|d| IdHS)a_Shortcut for:: await bot.send_game(update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_game`. Note: |user_chat_id_note| Returns: :class:`telegram.Message`: On success, instance representing the message posted. rcrrarnrwrrrKrLrMrNr:rprtrurbrxryNrB)rR send_gamer2)r?rrarrrtrurwrbrxryrnrprKrLrMrNr:rBrBrCrrzUser.send_game descriptionpayloadprovider_tokencurrencypricesrstart_parameter photo_url photo_size photo_width photo_height need_nameneed_phone_number need_emailneed_shipping_address is_flexible provider_datasend_phone_number_to_providersend_email_to_providermax_tip_amountsuggested_tip_amountsc$s|jd&id|jd|d|d|d|d|d|d|d |d | d | d | d | d| d|d|d|d|d|d|d|d|d|d|d|d| d|!d|"d|#d|d|d |d!|d"|d#|d$|Id%HS)'aMShortcut for:: await bot.send_invoice(update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_invoice`. Warning: As of API 5.2 :paramref:`start_parameter ` is an optional argument and therefore the order of the arguments had to be changed. Use keyword arguments to make sure that the arguments are passed correctly. Note: |user_chat_id_note| .. versionchanged:: 13.5 As of Bot API 5.2, the parameter :paramref:`start_parameter ` is optional. Returns: :class:`telegram.Message`: On success, instance representing the message posted. rcrrrrrrrrrrrrrrrrrarnrwrrrrrrKrLrMrNr:rprrrtrurxryNrB)rR send_invoicer2)$r?rrrrrrrrrrrrrrrrrarrrrrrrrtrurwrxryrnrprKrLrMrNr:rBrBrCrs>      !"#$ zUser.send_invoice)rnrplocationrKrLrMrNr:latitude longitude live_periodhorizontal_accuracyheadingproximity_alert_radiusrrcs|jdid|jd|d|d|d|d| d|d|d |d |d |d |d |d|d|d|d|d|d| d| d| d| d|IdHS)agShortcut for:: await bot.send_location(update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_location`. Note: |user_chat_id_note| Returns: :class:`telegram.Message`: On success, instance representing the message posted. rcrrrarnrwrrrKrLrMrNrrr:rrrrprtrurbrxryNrB)rR send_locationr2)r?rrrarrrrrrrtrurwrbrxryrnrprrKrLrMrNr:rBrBrCrUrzUser.send_location animationrwidthheightcs|jdid|jd|d|d|d|d|d|d|d |d |d |d |d |d|d|d|d|d| d|d| d| d| d| d|d|d|d|IdHS)aiShortcut for:: await bot.send_animation(update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_animation`. Note: |user_chat_id_note| Returns: :class:`telegram.Message`: On success, instance representing the message posted. rcrrrrrrqrarnrwrrrKrLrMrNr:rprrrtrurrrbrxryrNrB)rRsend_animationr2)r?rrrrrrqrarrrrtrurrrwrbrxryrrnrprrKrLrMrNr:rBrBrCrsp+      zUser.send_animationstickerr$c s|jdid|jd|d|d| d|d|d| d|d |d |d |d | d |d|d|d|d| d| IdHS)aeShortcut for:: await bot.send_sticker(update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_sticker`. Note: |user_chat_id_note| Returns: :class:`telegram.Message`: On success, instance representing the message posted. rcrrarnrwrrrKrLrMrNr:rprtrurrbrxryNrB)rR send_stickerr2)r?rrarrrtrurrwrbrxryrnrprKrLrMrNr:rBrBrCrsL"      zUser.send_stickervideor(supports_streamingcs|jdid|jd|d|d|d|d|d|d|d |d |d |d |d |d|d|d| d|d|d|d| d|d| d| d| d|d|d|d|IdHS)aaShortcut for:: await bot.send_video(update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_video`. Note: |user_chat_id_note| Returns: :class:`telegram.Message`: On success, instance representing the message posted. rcrrrrarnrwrrrKrLrMrNrrrqrrr:rprrrtrurrbrxryrNrB)rR send_videor2)r?rrrrarrrrrqrrrtrurrrwrbrxryrrnrprrKrLrMrNr:rBrBrCrst,      zUser.send_video)rnrpvenuerKrLrMrNr:address foursquare_idfoursquare_typegoogle_place_idgoogle_place_typerr'cs|jdid|jd|d|d|d|d|d|d|d | d |d |d |d |d|d|d|d|d| d| d|d| d| d|d|d|IdHS)aaShortcut for:: await bot.send_venue(update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_venue`. Note: |user_chat_id_note| Returns: :class:`telegram.Message`: On success, instance representing the message posted. rcrrrrrrarnrwrrrKrLrMrNrrr:rrrprtrurbrxryNrB)rR send_venuer2)r?rrrrrrarrrrrrtrurwrbrxryrnrprrKrLrMrNr:rBrBrCrarzUser.send_venue video_noter)lengthc s|jdid|jd|d|d|d|d| d| d|d |d |d |d |d |d|d|d|d|d|d| d| d| IdHS)akShortcut for:: await bot.send_video_note(update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_video_note`. Note: |user_chat_id_note| Returns: :class:`telegram.Message`: On success, instance representing the message posted. rcrrrrarnrwrrrKrLrMrNr:rprrtrurrbrxryNrB)rRsend_video_noter2)r?rrrrarrrtrurrwrbrxryrnrprrKrLrMrNr:rBrBrCrr{zUser.send_video_notevoicer*cs|jdid|jd|d|d|d|d|d| d|d |d |d |d |d |d|d|d|d|d|d| d| d| d| IdHS)aaShortcut for:: await bot.send_voice(update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_voice`. Note: |user_chat_id_note| Returns: :class:`telegram.Message`: On success, instance representing the message posted. rcrrrrarnrwrrrKrLrMrNrqr:rprrrtrurbrxryNrB)rR send_voicer2)r?rrrrarrrqrrtrurwrbrxryrnrprrKrLrMrNr:rBrBrCrs\&      zUser.send_voicequestionoptionsr is_anonymoustypeallows_multiple_answerscorrect_option_id is_closed explanationexplanation_parse_mode open_period close_dateexplanation_entitiesquestion_parse_modequestion_entitiescs|jd id|jd|d|d|d|d|d|d|d |d |d |d | d |d|d|d|d| d| d| d| d|d|d|d|d|d|d|d|d|d|IdHS)!a_Shortcut for:: await bot.send_poll(update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.send_poll`. Note: |user_chat_id_note| Returns: :class:`telegram.Message`: On success, instance representing the message posted. rcrrrrrrrrarnrwrrrKrLrMrNrrrrr:rprrtrurbrrrxryNrB)rR send_pollr2)r?rrrrrrrrarrrrrrrrtrurwrbrrrxryrnrprKrLrMrNr:rBrBrCr"s|.      zUser.send_poll from_chat_idr!c |jdid|jd|d|d|d|d|d|d| d | d |d |d |d |d|d|d|d|d| d| d| IdHS)amShortcut for:: await bot.copy_message(chat_id=update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.copy_message`. Note: |user_chat_id_note| Returns: :class:`telegram.Message`: On success, instance representing the message posted. rcrr`rrqrrarnrwrprrrKrLrMrNr:rtrurryNrBrR copy_messager2)r?rr`rrqrrarrrtrurwrryrnrprKrLrMrNr:rBrBrC send_copyqT$      zUser.send_copyrcc r)auShortcut for:: await bot.copy_message(from_chat_id=update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.copy_message`. Note: |user_chat_id_note| Returns: :class:`telegram.MessageId`: On success, returns the MessageId of the sent message. rrcr`rrqrrarnrwrprrrKrLrMrNr:rtrurryNrBr)r?rcr`rrqrrarrrtrurwrryrnrprKrLrMrNr:rBrBrCrrzUser.copy_messageremove_caption)r!.c 0|j|j||||||||| | | d IdHS)aShortcut for:: await bot.copy_messages(chat_id=update.effective_user.id, *argss, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.copy_messages`. .. seealso:: :meth:`copy_message`, :meth:`send_copy`, :meth:`copy_messages`. .. versionadded:: 20.8 Returns: tuple[:class:`telegram.MessageId`]: On success, a tuple of :class:`~telegram.MessageId` of the sent messages is returned. ) rcrrrartrurrKrLrMrNr:NrR copy_messagesr2) r?rrrartrurrKrLrMrNr:rBrBrC send_copies zUser.send_copiesc r)aShortcut for:: await bot.copy_messages(from_chat_id=update.effective_user.id, *argss, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.copy_messages`. .. seealso:: :meth:`copy_message`, :meth:`send_copy`, :meth:`send_copies`. .. versionadded:: 20.8 Returns: tuple[:class:`telegram.MessageId`]: On success, a tuple of :class:`~telegram.MessageId` of the sent messages is returned. ) rrcrrartrurrKrLrMrNr:Nr) r?rcrrartrurrKrLrMrNr:rBrBrCrrzUser.copy_messagesc .|j|j||||||| | ||d IdHS)aShortcut for:: await bot.forward_message(chat_id=update.effective_user.id, *argss, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.forward_message`. .. seealso:: :meth:`forward_to`, :meth:`forward_messages_from`, :meth:`forward_messages_to` .. versionadded:: 20.0 Returns: :class:`telegram.Message`: On success, instance representing the message posted. ) rcrr`rarKrLrMrNr:rtruNrRforward_messager2) r?rr`rartrurKrLrMrNr:rBrBrC forward_fromAs zUser.forward_fromc r)aShortcut for:: await bot.forward_message(from_chat_id=update.effective_user.id, *argss, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.forward_message`. .. seealso:: :meth:`forward_from`, :meth:`forward_messages_from`, :meth:`forward_messages_to` .. versionadded:: 20.0 Returns: :class:`telegram.Message`: On success, instance representing the message posted. ) rrcr`rarKrLrMrNr:rtruNr) r?rcr`rartrurKrLrMrNr:rBrBrC forward_tok zUser.forward_toc .|j|j||||||||| | d IdHS)aShortcut for:: await bot.forward_messages(chat_id=update.effective_user.id, *argss, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.forward_messages`. .. seealso:: :meth:`forward_to`, :meth:`forward_from`, :meth:`forward_messages_to`. .. versionadded:: 20.8 Returns: tuple[:class:`telegram.MessageId`]: On success, a tuple of :class:`~telegram.MessageId` of sent messages is returned. ) rcrrrartrurKrLrMrNr:NrRforward_messagesr2) r?rrrartrurKrLrMrNr:rBrBrCforward_messages_fromrzUser.forward_messages_fromc r)aShortcut for:: await bot.forward_messages(from_chat_id=update.effective_user.id, *argss, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.forward_messages`. .. seealso:: :meth:`forward_from`, :meth:`forward_to`, :meth:`forward_messages_from`. .. versionadded:: 20.8 Returns: tuple[:class:`telegram.MessageId`]: On success, a tuple of :class:`~telegram.MessageId` of sent messages is returned. ) rrcrrartrurKrLrMrNr:Nr) r?rcrrartrurKrLrMrNr:rBrBrCforward_messages_torzUser.forward_messages_toc r|)aShortcut for:: await bot.approve_chat_join_request(user_id=update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.approve_chat_join_request`. Note: |user_chat_id_note| .. versionadded:: 13.8 Returns: :obj:`bool`: On success, :obj:`True` is returned. rQrcrKrLrMrNr:N)rRapprove_chat_join_requestr2r?rcrKrLrMrNr:rBrBrCapprove_join_request zUser.approve_join_requestc r|)aShortcut for:: await bot.decline_chat_join_request(user_id=update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.decline_chat_join_request`. Note: |user_chat_id_note| .. versionadded:: 13.8 Returns: :obj:`bool`: On success, :obj:`True` is returned. rN)rRdecline_chat_join_requestr2rrBrBrCdecline_join_requestrzUser.decline_join_request menu_buttonc r|)aShortcut for:: await bot.set_chat_menu_button(chat_id=update.effective_user.id, *argss, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.set_chat_menu_button`. .. seealso:: :meth:`get_menu_button` Note: |user_chat_id_note| .. versionadded:: 20.0 Returns: :obj:`bool`: On success, :obj:`True` is returned. )rcrrKrLrMrNr:N)rRset_chat_menu_buttonr2)r?rrKrLrMrNr:rBrBrCset_menu_button4s zUser.set_menu_buttoncri)aShortcut for:: await bot.get_chat_menu_button(chat_id=update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.get_chat_menu_button`. .. seealso:: :meth:`set_menu_button` Note: |user_chat_id_note| .. versionadded:: 20.0 Returns: :class:`telegram.MenuButton`: On success, the current menu button is returned. rjN)rRget_chat_menu_buttonr2rlrBrBrCget_menu_buttonYs zUser.get_menu_buttonr%c s&|j||j|||||dIdHS)azShortcut for:: await bot.get_user_chat_boosts(user_id=update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.get_user_chat_boosts`. .. versionadded:: 20.8 Returns: :class:`telegram.UserChatBoosts`: On success, returns the boosts applied by the user. )rcrQrKrLrMrNr:N)rRget_user_chat_boostsr2rrBrBrCget_chat_boosts|s zUser.get_chat_booststelegram_payment_charge_idc r|)aTShortcut for:: await bot.refund_star_payment(user_id=update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.refund_star_payment`. .. versionadded:: 21.3 Returns: :obj:`bool`: On success, :obj:`True` is returned. )rQrrKrLrMrNr:N)rRrefund_star_paymentr2)r?rrKrLrMrNr:rBrBrCrr~zUser.refund_star_payment) NNNNNNNNNN)NN)N)H__name__ __module__ __qualname____doc__ __slots__intstrboolrr r<propertyrHrFrJr rfloatrTrr[rrr_rerhrmrrrzr}rrr rtuplerrr send_actionrrrrobjectrrrrrrrrr rrrrrrrrrrrrrrrrr __classcell__rBrBr@rCr+?sdN     '        '  & #       A $ #        F       ?       H   %      ?      8        D      =       !"#$%& g      D       L       :       M      H       @        C        S        ?        ?        1        1      .      /      /      /  (  & ( '  $ r+N)6r collections.abcrrtypingrrr%telegram._inline.inlinekeyboardbuttonrtelegram._menubuttonrtelegram._telegramobjectr telegram._utils.defaultvaluer telegram._utils.typesr r r rrtelegram.helpersrr\rrWtelegramrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+rBrBrBrCs        l