o /hJ@sdZddlmZddlmZmZmZmZmZddlm Z ddl m Z ddl m Z ddlmZddlmZmZmZmZmZdd 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 d d e Z5dS)z?This module contains an object that represents a Telegram User.)datetime) TYPE_CHECKINGOptionalSequenceTupleUnion)InlineKeyboardButton) MenuButton)TelegramObject) DEFAULT_NONE)CorrectOptionID FileInputJSONDictODVInput ReplyMarkup) mention_html)mention_markdown) AnimationAudioContactDocumentInlineKeyboardMarkupInputMediaAudioInputMediaDocumentInputMediaPhotoInputMediaVideoInputPollOption LabeledPriceLinkPreviewOptionsLocationMessage MessageEntity MessageId PhotoSizeReplyParametersStickerUserChatBoostsUserProfilePhotosVenueVideo VideoNoteVoicecHs|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 d6d7Zeeddededddf ddeeeeedd8d9ed:eed0eed;eedeed?eed@edAdBedCd1eedDeedEeedFeedGeedeed eed!eed"eedee ddHf(dIdJZeeeeddd/edeed eed!eed"eedee defdKdLZeeeedddMeedeed eed!eed"eedee defdNdOZdedededdddddf dedeeeeddPdQe e!dRfdSeed0eed;eed:eedTeed=d>eed?eedUeedBedCd1eedDeedVeedEeedGeedWeedeed eed!eed"eedee ddHf,dXdYZ"eeddddfdeeeeeddeddZ d[ee d\d0eed>eed?eedBedCd1eedDeedEeedGeedeed eed!eed"eedee dSeed:eedTeed=de#d]f$d^d_Z$ddddedededddddfdedeeeeddPd`e e!dafdbeedceeddeedSeed0eed;eed:eedTeed=d>eed?eedeee!dBedCd1eedDeedEeedGeedWeedeed eed!eed"eedee ddHf0dfdgZ%  deeeedddhed?eed1eedeed eed!eed"eedee defdidjZ&e&Z' dddeddeddddf dedeeeeddkdleedeedeed0eed;eedmeed>eed?eedBedCd1eedDeedEeedGeednedodeed eed!eed"eedee ddHf(dpdqZ(eddeddddfdeeeeeddrd0eed;eedseed>eed?eedBedCd1eedDeedEeedGeedeed eed!eed"eedee ddHf dtduZ)dededdedddddf dedeeeeddPdve e!dwfdSeed0eed;eed:eedxeedTeed=d>eed?eedeee!dBedCd1eedDeedEeedGeedWeedeed eed!eed"eedee ddHf,dydzZ*ededdddfdeeeeeddrd{ed0eed;ed|d>eed?eedBedCd1eedDeedEeedGeedeed eed!eed"eedee ddHf d}d~Z+ddddddddddeddddddedddfdeeeeeddrddedededeedededdeedeedeedeedeedeedeedeedeedeed0eed;ed|dee ee,fdeedeedeedeeed>eed?eedBedCdDeedEeedGeedeed eed!eed"eedee ddHfFddZ-ddedddddeddddf dedeeeedddeedeed0eed;eedeedeedeedeed>eed?eedBedCd1eedDeedEeedGeededdeed eed!eed"eedee ddHf,ddZ.ddddeeddedddddddfdedeeeeddPde e!dfdbeedeedeedSeed:eed0eed;eedTeed=d>eed?eedUeedeee!dBedCd1eedDeedVeedEeedGeedWeedeed eed!eed"eedee ddHf4ddZ/ededddddfdeeeeeddrde e!dfd0eed;eed>eed?eedseedBedCd1eedDeedEeedGeedeed eed!eed"eedee ddHf"ddZ0ddedddeddedddddddfdedeeeeddPde e!dfdbeedSeed0eed;eedeedeed:eedeedTeed=d>eed?eedUeedeee!dBedCd1eedDeedVeedEeedGeedWeedeed eed!eed"eedee ddHf6ddZ1dddddeddddeddddfdedeeeedddeedeeddeedeedeed0eed;eedeedeedeed>eed?eedBedCd1eedDeedEeedGeededdeed eed!eed"eedee ddHf0ddZ2ddededddddf dedeeeeddPde e!dfdbeedeed0eed;eed>eed?eedeee!dBedCd1eedDeedEeedGeedWeedeed eed!eed"eedee ddHf(ddZ3ddedededdddf dedeeeeddPde e!dfdbeedSeed0eed;eed:eedTeed=d>eed?eedBedCd1eedDeedEeedGeedWeedeed eed!eed"eedee ddHf*dd„Z4dddddeddedddedddeddfdeeeeeddrdedee edfdeedeedeedee5deed0eed;eedeedeedeedee ee6fdeed=d>eed?eedBedCd1eedeedeed=dDeedEeedGeedeed eed!eed"eedee ddHf:ddӄZ7dedededddf deeeeeddrde eefd/edSeed:eedTeed=d0eed;eed>eed?eedBedCdVeedEeedGeedeed eed!eed"eedee ddf&ddׄZ8dedededddf deeeeeddrde eefd/edSeed:eedTeed=d0eed;eed>eed?eedBedCdVeedEeedGeedeed eed!eed"eedee ddf&ddڄZ9eeddfeeeeddde eefdMeed0eed>eed?eedeedeed eed!eed"eedee de#dfddބZ:eeddfeeeeddde eefdMeed0eed>eed?eedeedeed eed!eed"eedee de#dfddZ;eedfeeeeddde eefd/ed0eed>eed?eedeed eed!eed"eedee ddHfddZeed?eedeed eed!eed"eedee ddHfddZ=eedfeeeeddde eefdMeed0eed>eed?eedeed eed!eed"eedee de#dfddZ>eedfeeeeddde eefdMeed0eed>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_kwargsr3r1r4r7r9r6r/r0r8r5r-r.r2r;csrtj|d||_||_||_||_||_||_||_||_ | |_ | |_ | |_ | |_ | |_|jf|_|dS)Nr:)super__init__r3r1r4r7r9r6r/r0r8r5r-r.r2 _id_attrs_freeze)selfr3r1r4r7r9r6r/r0r8r5r-r.r2r; __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`. @)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)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_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@rIrCrCrDrs 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_htmlr3rGrYrCrCrDrs 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_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_idrarbrLrMrNrOrcr;N)rSpin_chat_messager3) r@rarbrcrLrMrNrOr;rCrCrD pin_message8 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_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. 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_idrorprqr c s|jdid|jd|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;rcryNrC)rS send_messager3)r@r^rrrbrsrtrurvrwrxrcryrorprqrLrMrNrOr;rCrCrDrzT$      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;rCrCrDrr~zUser.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| 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;rrcryrNrC)rS send_photor3)r@rrrbrsrrrrurvrrxrcryrrorqrrLrMrNrOr;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|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;rqrurvrrrrrcryNrC)rSsend_media_groupr3)r@rrbrurvrxrcryrorqrLrMrNrOr;rrrrrCrCrDrZsL%      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|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;rrcryNrC)rS send_audior3)r@rrrrrrbrsrrrrurvrrxrcryrorqrrLrMrNrOr;rCrCrDrd(      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| 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;rqrurvrcryNrC)rS send_contactr3)r@rr1r7rbrsrrurvrxrcryrorqrrLrMrNrOr;rCrCrDrr{zUser.send_contact)rorqrLrMrNrOr;emojic sz|jdid|jd|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;rqrurvrcryNrC)rS send_dicer3)r@rbrsrrurvrxrcryrorqrLrMrNrOr;rCrCrDr:D       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| 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;rrqrrurvrcryNrC)rS send_documentr3)r@rrrbrsrrrrrurvrrxrcryrorqrrLrMrNrOr;rCrCrDrmrzUser.send_documentgame_short_namerc sz|jdid|jd|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;rqrurvrcryNrC)rS send_gamer3)r@rrbrsrurvrxrcryrorqrLrMrNrOr;rCrCrDrrzUser.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#|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;rqrrrurvryNrC)rS send_invoicer3)#r@rrrrrrrrrrrrrrrrrbrsrrrrrrurvrxryrorqrLrMrNrOr;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| 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;rrrrqrurvrcryNrC)rS send_locationr3)r@rrrbrsrrrrrurvrxrcryrorqrrLrMrNrOr;rCrCrDrBrzUser.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|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;rqrrrurvrrrcryrNrC)rSsend_animationr3)r@rrrrrrrrbrsrrurvrrrxrcryrrorqrrLrMrNrOr;rCrCrDrsl*      zUser.send_animationstickerr%c s|jdid|jd|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;rqrurvrrcryNrC)rS send_stickerr3)r@rrbrsrurvrrxrcryrorqrLrMrNrOr;rCrCrDrsH!      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|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. rdrrrrbrorxrsrLrMrNrOrrrrrrr;rqrrrurvrrcryrNrC)rS send_videor3)r@rrrrbrsrrrrrrrurvrrrxrcryrrorqrrLrMrNrOr;rCrCrDrsp+      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|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;rrrqrurvrcryNrC)rS send_venuer3)r@rrrrrrbrsrrrrurvrxrcryrorqrrLrMrNrOr;rCrCrDrFrzUser.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| 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;rqrrurvrrcryNrC)rSsend_video_noter3)r@rrrrbrsrurvrrxrcryrorqrrLrMrNrOr;rCrCrDrr{zUser.send_video_notevoicer+c s|jdid|jd|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;rqrrrurvrcryNrC)rS send_voicer3)r@rrrrbrsrrrrurvrxrcryrorqrrLrMrNrOr;rCrCrDrsX%      zUser.send_voicequestionoptionsr is_anonymoustypeallows_multiple_answerscorrect_option_id is_closed explanationexplanation_parse_mode open_period close_dateexplanation_entitiesquestion_parse_modequestion_entitiescs|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|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;rqrrurvrcrrryNrC)rS send_pollr3)r@rrrrrrrrbrsrrrrrrurvrxrcrrryrorqrLrMrNrOr;rCrCrDrsx-      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| 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. rdrrarrrrrbrorxrqrsrLrMrNrOr;rurvrNrCrS copy_messager3)r@rrarrrrrbrsrurvrxrrorqrLrMrNrOr;rCrCrD send_copyNP#      zUser.send_copyrdc 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. rrdrarrrrrbrorxrqrsrLrMrNrOr;rurvrNrCr)r@rdrarrrrrbrsrurvrxrrorqrLrMrNrOr;rCrCrDrrzUser.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_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. ) rrdrrbrurvrrLrMrNrOr;Nr) r@rdrrbrurvrrLrMrNrOr;rCrCrDrrzUser.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. ) rdrrarbrLrMrNrOr;rurvNrSforward_messager3) r@rrarbrurvrLrMrNrOr;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. ) rrdrarbrLrMrNrOr;rurvNr) r@rdrarbrurvrLrMrNrOr;rCrCrD forward_toD 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. ) rdrrrbrurvrLrMrNrOr;NrSforward_messagesr3) r@rrrbrurvrLrMrNrOr;rCrCrDforward_messages_fromorzUser.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_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. rRrdrLrMrNrOr;N)rSapprove_chat_join_requestr3r@rdrLrMrNrOr;rCrCrDapprove_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)rSdecline_chat_join_requestr3rrCrCrDdecline_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. )rdrrLrMrNrOr;N)rSset_chat_menu_buttonr3)r@rrLrMrNrOr;rCrCrDset_menu_button s 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_button2s 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_boostsUs 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;rCrCrDrur~zUser.refund_star_payment) NNNNNNNNNN)NN)N)H__name__ __module__ __qualname____doc__ __slots__intstrboolrrr=propertyrIrGrKr rfloatrUrr\rrr`rfrirnrrrzr}rrr rrrrr send_actionrrrrobjectrrrrrrrrr rrrrrrrrrrrrr rrrr __classcell__rCrCrArDr,>s N     '        '  & #      ? $ #        D       =       F   %     =      6        B      ;       !"#$% e      B       J       8       K      F      >        A        Q       =       =        1        1      .      /      /      /  (  & ( '  $ r,N)6r rtypingrrrrr%telegram._inline.inlinekeyboardbuttonrtelegram._menubuttonr telegram._telegramobjectr telegram._utils.defaultvaluer telegram._utils.typesr r rrrtelegram.helpersrr]rrXtelegramrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,rCrCrCrDs       l