o "hi@sdZddlZddlmZddlmZmZmZddl m Z ddl m Z ddl mZddlmZdd lmZmZmZmZmZmZdd lmZdd lmZerdd lmZmZm 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/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7Gd ddeZ8dS)z?This module contains an object that represents a Telegram User.N)Sequence) TYPE_CHECKINGOptionalUnion)InlineKeyboardButton) MenuButton)TelegramObject) DEFAULT_NONE)CorrectOptionID FileInputJSONDictODVInput ReplyMarkup TimePeriod) mention_html)mention_markdown) AnimationAudioContactDocumentGiftInlineKeyboardMarkupInputMediaAudioInputMediaDocumentInputMediaPhotoInputMediaVideoInputPollOption LabeledPriceLinkPreviewOptionsLocationMessage MessageEntity MessageId PhotoSizeReplyParametersStickerUserChatBoostsUserProfilePhotosVenueVideo VideoNoteVoicecJs(eZdZdZdZ          d dddedededeed eed eed eed eed eedeedeedeedeedee ffddZ e defddZ e defddZ e deefddZ  d eeeedddeedeedeed eed!eed"eedee ded#fd$d%Zdd&eedefd'd(Zdd&eedefd)d*Zdd&eedefd+d,Zdd&eedefd-d.Zedfeeeeddd/ed0eed1eedeed eed!eed"eedee defd2d3Z  d eeeeddd/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!dbfdcee%ddeedeeedTeed0eed;eed:eedUeed=d>eed?eedfee!dBedCd1eedDeedEeedFeedHeedXeedeed eed!eed"eedee ddIf2dgdhZ&  d eeeedddied?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,dddddddddddeddddddeddddfdeeeeeddsdeedededededdeedeedeedeedeedeedeedeedeedeedeed0eed;ed}dee ee-fdeedeedeedeeed>eed?eedBedCdDeedEeedFeedHeedeed eed!eed"eedee ddIfHddZ.ddedddddedddddfdedeeeedddeedeed0eed;eedee%deedeedeed>eed?eedBedCd1eedDeedEeedFeedHeededdeed eed!eed"eedee ddIf.ddZ/ddddeeddeddddddddfdedeeeeddQde e!dfdcee%deedeedTeed:eed0eed;eedUeed=d>eed?eedVeedfee!dBedCd1eedDeedEeedWeedFeedHeedXeedeed eed!eed"eedee ddIf6ddZ0ededdddddf deeeeeddsde e!dfd0eed;eed>eed?eedteedBedCd1eedDeedEeedFeedHeedeed eed!eed"eedee ddIf$ddZ1ddedddeddeddddddddddfdedeeeeddQde e!dfdcee%dTeed0eed;eedeedeed:eedeedUeed=d>eed?eedVeedfee!dBedCd1eedDeedEeedWeedee!deedFeedHeedXeedeed eed!eed"eedee ddIfeed?eedBedCd1eedDeedEeedFeedHeededdeed eed!eed"eedee ddIf2ddZ3ddededdddddf dedeeeeddQde e!dfdcee%deed0eed;eed>eed?eedfee!dBedCd1eedDeedEeedFeedHeedXeedeed eed!eed"eedee ddIf*ddZ4ddedededddddf dedeeeeddQde e!dfdcee%dTeed0eed;eed:eedUeed=d>eed?eedBedCd1eedDeedEeedFeedHeedXeedeed eed!eed"eedee ddIf,ddńZ5dddddeddedddedddedddfdeeeeeddsdedee edfdeedeedeedee6deed0eed;eedeedeedee%dee ee7j8fdeed=d>eed?eedBedCd1eedeedeed=dDeedEeedFeedHeedeed eed!eed"eedee ddIfeed?eedBedCdWeedEeedeedFeedHeedeed eed!eed"eedee ddf*ddZeed?eedBedCdWeedEeedeedFeedHeedeed eed!eed"eedee ddf*ddZ=eeddfeeeeddde eefdNeed0eed>eed?eedeedeed eed!eed"eedee de#dfddZ>eeddfeeeeddde eefdNeed0eed>eed?eedeedeed eed!eed"eedee de#dfddZ?eeddfeeeeddde eefd/ed0eed>eed?eedeedeed eed!eed"eedee ddIfddZ@eeddfeeeeddde eefd/ed0eed>eed?eedeedeed eed!eed"eedee ddIfddZAeedfeeeeddde eefdNeed0eed>eed?eedeed eed!eed"eedee de#dfddZBeedfeeeeddde eefdNeed0eed>eed?eedeed eed!eed"eedee de#dfddZCeeeeddde eefdeed eed!eed"eedee defddZDeeeeddde eefdeed eed!eed"eedee defddZE deeeedddeeFdeed eed!eed"eedee defddZGeeeedddeed eed!eed"eedee deFf ddZHeeeeddde eefdeed eed!eed"eedee ddfddZIeeeedddedeed eed!eed"eedee defddZJ deeeedddeedeed eed!eed"eedee defdd ZKeeeedddeed eed!eed"eedee def d d ZLZMS(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_kwargsr3r1r4r7r9r6r/r0r8r5r-r.r2r;csrtj|d||_||_||_||_||_||_||_||_ | |_ | |_ | |_ | |_ | |_|jf|_|dS)Nr:)super__init__r3r1r4r7r9r6r/r0r8r5r-r.r2 _id_attrs_freeze)selfr3r1r4r7r9r6r/r0r8r5r-r.r2r; __class__A/var/www/html/venv/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`. @)r9 full_namer@rCrCrDnames 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`.  )r7r1rHrCrCrDrGszUser.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)r9rHrCrCrDlinks z User.link) read_timeout write_timeoutconnect_timeout pool_timeoutr;offsetlimitrLrMrNrOr'c s(|j|j|||||||dIdHS)a'Shortcut 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`. Returns: :class:`telegram.UserProfilePhotos` )user_idrPrQrLrMrNrOr;N)get_botget_user_profile_photosr3)r@rPrQrLrMrNrOr;rCrCrDget_profile_photoss zUser.get_profile_photosrIcC|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_markdownr3rGr@rIrCrCrDr s 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). )versionrWrYrCrCrDmention_markdown_v2s zUser.mention_markdown_v2cCrV)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_htmlr3rGrYrCrCrDr(s 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)rrGr3rYrCrCrDmention_button5s 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_idrarbrLrMrNrOrcr;N)rSpin_chat_messager3) r@rarbrcrLrMrNrOr;rCrCrD pin_messageD 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. )rdrLrMrNrOr;rarcN)rSunpin_chat_messager3)r@rarcrLrMrNrOr;rCrCrD unpin_messageis 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. rdrLrMrNrOr;N)rSunpin_all_chat_messagesr3r@rLrMrNrOr;rCrCrDunpin_all_messagess zUser.unpin_all_messages)reply_to_message_iddisable_web_page_previewallow_sending_without_replyrLrMrNrOr;r^ parse_mode reply_markupentitiesr!protect_contentmessage_thread_idlink_preview_optionsrreply_parametersr$message_effect_idallow_paid_broadcastrorprqr c 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. rdr^rrrprwrbrorxrsrqrtrurvrLrMrNrOr;rcryrzNrC)rS send_messager3)r@r^rrrbrsrtrurvrwrxrcryrzrorprqrLrMrNrOr;rCrCrDr{X%      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. )rdrarLrMrNrOr;N)rSdelete_messager3)r@rarLrMrNrOr;rCrCrDr~ 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. )rdrrLrMrNrOr;N)rSdelete_messagesr3)r@rrLrMrNrOr;rCrCrDr rzUser.delete_messages)rorqfilenamerLrMrNrOr;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. rdrrrbrorxrsrrrqrrrurvrLrMrNrOr;rrcryrzrNrC)rS send_photor3)r@rrrbrsrrrrurvrrxrcryrzrrorqrrLrMrNrOr;rCrCrDr)`'      zUser.send_photo) rorqrLrMrNrOr;rrrrmedia)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. rdrrbrorxrLrMrNrOr;rqrurvrrrrrcryrzNrC)rSsend_media_groupr3)r@rrbrurvrxrcryrzrorqrLrMrNrOr;rrrrrCrCrDrjsP&      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. rdrrrrrrbrorxrsrrrqrrrurvrLrMrNrOr;rrcryrzNrC)rS send_audior3)r@rrrrrrbrsrrrrurvrrxrcryrzrorqrrLrMrNrOr;rCrCrDrh)      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. ) rdrrvrLrMrNrOr;rcN)rSsend_chat_actionr3) r@rrvrcrLrMrNrOr;rCrCrDrrgzUser.send_chat_action)rorqcontactrLrMrNrOr; 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. rdrr1r7rbrorxrsrLrMrNrOrrr;rqrurvrcryrzNrC)rS send_contactr3)r@rr1r7rbrsrrurvrxrcryrzrorqrrLrMrNrOr;rCrCrDrr|zUser.send_contact)rorqrLrMrNrOr;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. rdrbrorxrsrLrMrNrOrr;rqrurvrcryrzNrC)rS send_dicer3)r@rbrsrrurvrxrcryrzrorqrLrMrNrOr;rCrCrDrPH!      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. rdrrrrbrorxrsrLrMrNrOrrrr;rrqrrurvrcryrzNrC)rS send_documentr3)r@rrrbrsrrrrrurvrrxrcryrzrorqrrLrMrNrOr;rCrCrDrrzUser.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. rdrrbrorxrsrLrMrNrOr;rqrurvrcryrzNrC)rS send_gamer3)r@rrbrsrurvrxrcryrzrorqrLrMrNrOr;rCrCrDrrzUser.send_game descriptionpayloadcurrencypricesrprovider_tokenstart_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. rdrrrrrrrrrrrrrrrrrbrorxrsrrrrLrMrNrOr;rqrrrurvryrzNrC)rS send_invoicer3)$r@rrrrrrrrrrrrrrrrrbrsrrrrrrurvrxryrzrorqrLrMrNrOr;rCrCrDrs>      !"#$ zUser.send_invoice)rorqlocationrLrMrNrOr;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. rdrrrbrorxrsrLrMrNrOrrr;rrrrqrurvrcryrzNrC)rS send_locationr3)r@rrrbrsrrrrrurvrxrcryrzrorqrrLrMrNrOr;rCrCrDr`rzUser.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. rdrrrrrrrrbrorxrsrLrMrNrOr;rqrrrurvrrrcryrzrNrC)rSsend_animationr3)r@rrrrrrrrbrsrrurvrrrxrcryrzrrorqrrLrMrNrOr;rCrCrDrsp+      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. rdrrbrorxrsrLrMrNrOr;rqrurvrrcryrzNrC)rS send_stickerr3)r@rrbrsrurvrrxrcryrzrorqrLrMrNrOr;rCrCrDrsL"      zUser.send_stickervideor)supports_streamingcoverstart_timestampcs|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)!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. rdrrrrbrorxrsrLrMrNrOrrrrrrrrr;rqrrrurvrrcryrzrNrC)rS send_videor3)r@rrrrbrsrrrrrrrurvrrrxrcryrzrrrrorqrrLrMrNrOr;rCrCrDr!|.      zUser.send_video)rorqvenuerLrMrNrOr;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. rdrrrrrrbrorxrsrLrMrNrOrrr;rrrqrurvrcryrzNrC)rS send_venuer3)r@rrrrrrbrsrrrrurvrxrcryrzrorqrrLrMrNrOr;rCrCrDrprzUser.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. rdrrrrbrorxrsrLrMrNrOr;rqrrurvrrcryrzNrC)rSsend_video_noter3)r@rrrrbrsrurvrrxrcryrzrorqrrLrMrNrOr;rCrCrDrr|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. rdrrrrbrorxrsrLrMrNrOrrr;rqrrrurvrcryrzNrC)rS send_voicer3)r@rrrrbrsrrrrurvrxrcryrzrorqrrLrMrNrOr;rCrCrDrs\&      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. rdrrrrrrrrbrorxrsrLrMrNrOrrrrr;rqrrurvrcrrryrzNrC)rS send_pollr3)r@rrrrrrrrbrsrrrrrrurvrxrcrrryrzrorqrLrMrNrOr;rCrCrDr1rzUser.send_pollgift_idrtext_parse_mode text_entitiespay_for_upgradec s0|jd|j||||||||| | d IdHS)a9Shortcut for:: await bot.send_gift(user_id=update.effective_user.id, *args, **kwargs ) For the documentation of the arguments, please see :meth:`telegram.Bot.send_gift`. .. versionadded:: 21.8 Returns: :obj:`bool`: On success, :obj:`True` is returned. N) rdrRrr^rrrrLrMrNrOr;)rS send_giftr3) r@rr^rrrrLrMrNrOr;rCrCrDrs zUser.send_gift month_count star_countc .|j|j||||||||| | d IdHS)a`Shortcut for:: await bot.gift_premium_subscription(user_id=update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.gift_premium_subscription`. .. versionadded:: 22.1 Returns: :obj:`bool`: On success, :obj:`True` is returned. ) rRrrr^rrrLrMrNrOr;N)rSgift_premium_subscriptionr3) r@rrr^rrrLrMrNrOr;rCrCrDrs zUser.gift_premium_subscription from_chat_idvideo_start_timestampr"c|jdid|jd|d|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. rdrrarrrrrrbrorxrqrsrLrMrNrOr;rurvrrzNrCrS copy_messager3)r@rrarrrrrbrsrurvrxrrzrrorqrLrMrNrOr;rCrCrD send_copyr|zUser.send_copyrdcr)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. rrdrarrrrrrbrorxrqrsrLrMrNrOr;rurvrrzNrCr)r@rdrarrrrrbrsrurvrxrrzrrorqrLrMrNrOr;rCrCrDr r|zUser.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. ) rdrrrbrurvrrLrMrNrOr;NrS copy_messagesr3) r@rrrbrurvrrLrMrNrOr;rCrCrD send_copiesJ 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. ) rrdrrbrurvrrLrMrNrOr;Nr) r@rdrrbrurvrrLrMrNrOr;rCrCrDrwrzUser.copy_messagesc 0|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. ) rdrrarrbrLrMrNrOr;rurvNrSforward_messager3) r@rrarbrurvrrLrMrNrOr;rCrCrD forward_froms 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. ) rrdrarrbrLrMrNrOr;rurvNr) r@rdrarbrurvrrLrMrNrOr;rCrCrD forward_torzUser.forward_toc r)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. ) rdrrrbrurvrLrMrNrOr;NrSforward_messagesr3) r@rrrbrurvrLrMrNrOr;rCrCrDforward_messages_from zUser.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. ) rrdrrbrurvrLrMrNrOr;Nr) r@rdrrbrurvrLrMrNrOr;rCrCrDforward_messages_to(rzUser.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. rRrdrLrMrNrOr;N)rSapprove_chat_join_requestr3r@rdrLrMrNrOr;rCrCrDapprove_join_requestS 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)rSdecline_chat_join_requestr3rrCrCrDdecline_join_requestwrzUser.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. )rdr rLrMrNrOr;N)rSset_chat_menu_buttonr3)r@r rLrMrNrOr;rCrCrDset_menu_buttons zUser.set_menu_buttoncrj)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. rkN)rSget_chat_menu_buttonr3rmrCrCrDget_menu_buttons 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. )rdrRrLrMrNrOr;N)rSget_user_chat_boostsr3rrCrCrDget_chat_boostss 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. )rRrrLrMrNrOr;N)rSrefund_star_paymentr3)r@rrLrMrNrOr;rCrCrDr rzUser.refund_star_paymentcustom_descriptionc r})aEShortcut for:: await bot.verify_user(user_id=update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.verify_user`. .. versionadded:: 21.10 Returns: :obj:`bool`: On success, :obj:`True` is returned. )rRrrLrMrNrOr;N)rS verify_userr3)r@rrLrMrNrOr;rCrCrDverify# rz User.verifycrj)a_Shortcut for:: await bot.remove_user_verification(user_id=update.effective_user.id, *args, **kwargs) For the documentation of the arguments, please see :meth:`telegram.Bot.remove_user_verification`. .. versionadded:: 21.10 Returns: :obj:`bool`: On success, :obj:`True` is returned. )rRrLrMrNrOr;N)rSremove_user_verificationr3rmrCrCrDremove_verificationC s zUser.remove_verification) NNNNNNNNNN)NN)N)N__name__ __module__ __qualname____doc__ __slots__intstrboolrr r=propertyrIrGrKr r floatrUrr\rrr`rfrirnrrr{r~rrr rtuplerrrr send_actionrrrrobjectrrrrrrrrr dtmdatetimerrrrrrrrrrrrr rr rrrrr __classcell__rCrCrArDr,Gs\N     '   !     '  & #       A $ #        F       ?       H   %      ?      8        D      <       !"#$%& g      D       L       :       Q      H       @        C        R       ,      ,        A        A        1        1        0        1      /      /  (  & ( '  $ " #r,)9rr'r&collections.abcrtypingrrr%telegram._inline.inlinekeyboardbuttonrtelegram._menubuttonrtelegram._telegramobjectrtelegram._utils.defaultvaluer telegram._utils.typesr r r r rrtelegram.helpersrr]rrXtelegramrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,rCrCrCrDs        p