ei|1dZddlmZddlmZddlmZddlmZddl m Z erddl m Z Gdd eZ Gd d eZd S) z8This module contains two objects to request chats/users.) TYPE_CHECKING)ChatAdministratorRights)TelegramObject)de_json_optional)JSONDict)BotceZdZdZdZ ddddededzdedzdedzd edzd edzd edzd edzffd ZxZ S)KeyboardButtonRequestUsersu This object defines the criteria used to request a suitable user. The identifier of the selected user will be shared with the bot when the corresponding button is pressed. `More about requesting users » `_. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`request_id` is equal. .. versionadded:: 20.8 This class was previously named ``KeyboardButtonRequestUser``. Args: request_id (:obj:`int`): Signed 32-bit identifier of the request, which will be received back in the :class:`telegram.UsersShared` object. Must be unique within the message. user_is_bot (:obj:`bool`, optional): Pass :obj:`True` to request a bot, pass :obj:`False` to request a regular user. If not specified, no additional restrictions are applied. user_is_premium (:obj:`bool`, optional): Pass :obj:`True` to request a premium user, pass :obj:`False` to request a non-premium user. If not specified, no additional restrictions are applied. max_quantity (:obj:`int`, optional): The maximum number of users to be selected; :tg-const:`telegram.constants.KeyboardButtonRequestUsersLimit.MIN_QUANTITY` - :tg-const:`telegram.constants.KeyboardButtonRequestUsersLimit.MAX_QUANTITY`. Defaults to :tg-const:`telegram.constants.KeyboardButtonRequestUsersLimit.MIN_QUANTITY` . .. versionadded:: 20.8 request_name (:obj:`bool`, optional): Pass :obj:`True` to request the users' first and last name. .. versionadded:: 21.1 request_username (:obj:`bool`, optional): Pass :obj:`True` to request the users' username. .. versionadded:: 21.1 request_photo (:obj:`bool`, optional): Pass :obj:`True` to request the users' photo. .. versionadded:: 21.1 Attributes: request_id (:obj:`int`): Identifier of the request. user_is_bot (:obj:`bool`): Optional. Pass :obj:`True` to request a bot, pass :obj:`False` to request a regular user. If not specified, no additional restrictions are applied. user_is_premium (:obj:`bool`): Optional. Pass :obj:`True` to request a premium user, pass :obj:`False` to request a non-premium user. If not specified, no additional restrictions are applied. max_quantity (:obj:`int`): Optional. The maximum number of users to be selected; :tg-const:`telegram.constants.KeyboardButtonRequestUsersLimit.MIN_QUANTITY` - :tg-const:`telegram.constants.KeyboardButtonRequestUsersLimit.MAX_QUANTITY`. Defaults to :tg-const:`telegram.constants.KeyboardButtonRequestUsersLimit.MIN_QUANTITY` . .. versionadded:: 20.8 request_name (:obj:`bool`): Optional. Pass :obj:`True` to request the users' first and last name. .. versionadded:: 21.1 request_username (:obj:`bool`): Optional. Pass :obj:`True` to request the users' username. .. versionadded:: 21.1 request_photo (:obj:`bool`): Optional. Pass :obj:`True` to request the users' photo. .. versionadded:: 21.1 ) max_quantity request_id request_name request_photorequest_username user_is_botuser_is_premiumN api_kwargsr rrr r rrrct|||_||_||_||_||_||_||_|jf|_ | dSNr) super__init__r rrr r rr _id_attrs_freeze) selfr rrr r rrr __class__s c/home/div/.hermes/hermes-agent/venv/lib/python3.11/site-packages/telegram/_keyboardbuttonrequest.pyrz#KeyboardButtonRequestUsers.__init__jsv J///))4,;(4)5-=*7/+ )NNNNNN) __name__ __module__ __qualname____doc__ __slots__intboolrr __classcell__rs@rr r s==~I$('+#'$((,%)'+D[  Dj  Tk +d{tOrr ceZdZdZdZ ddddedededzdedzd edzd edzd edzd edzd edzdedzdedzdedzffdZ e ddeddddffd Z xZ S)KeyboardButtonRequestChatuThis object defines the criteria used to request a suitable chat. The identifier of the selected user will be shared with the bot when the corresponding button is pressed. `More about requesting users » `_. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`request_id` is equal. .. versionadded:: 20.1 Args: request_id (:obj:`int`): Signed 32-bit identifier of the request, which will be received back in the :class:`telegram.ChatShared` object. Must be unique within the message. chat_is_channel (:obj:`bool`): Pass :obj:`True` to request a channel chat, pass :obj:`False` to request a group or a supergroup chat. chat_is_forum (:obj:`bool`, optional): Pass :obj:`True` to request a forum supergroup, pass :obj:`False` to request a non-forum chat. If not specified, no additional restrictions are applied. chat_has_username (:obj:`bool`, optional): Pass :obj:`True` to request a supergroup or a channel with a username, pass :obj:`False` to request a chat without a username. If not specified, no additional restrictions are applied. chat_is_created (:obj:`bool`, optional): Pass :obj:`True` to request a chat owned by the user. Otherwise, no additional restrictions are applied. user_administrator_rights (:class:`ChatAdministratorRights`, optional): Specifies the required administrator rights of the user in the chat. If not specified, no additional restrictions are applied. bot_administrator_rights (:class:`ChatAdministratorRights`, optional): Specifies the required administrator rights of the bot in the chat. The rights must be a subset of :paramref:`user_administrator_rights`. If not specified, no additional restrictions are applied. bot_is_member (:obj:`bool`, optional): Pass :obj:`True` to request a chat with the bot as a member. Otherwise, no additional restrictions are applied. request_title (:obj:`bool`, optional): Pass :obj:`True` to request the chat's title. .. versionadded:: 21.1 request_username (:obj:`bool`, optional): Pass :obj:`True` to request the chat's username. .. versionadded:: 21.1 request_photo (:obj:`bool`, optional): Pass :obj:`True` to request the chat's photo. .. versionadded:: 21.1 Attributes: request_id (:obj:`int`): Identifier of the request. chat_is_channel (:obj:`bool`): Pass :obj:`True` to request a channel chat, pass :obj:`False` to request a group or a supergroup chat. chat_is_forum (:obj:`bool`): Optional. Pass :obj:`True` to request a forum supergroup, pass :obj:`False` to request a non-forum chat. If not specified, no additional restrictions are applied. chat_has_username (:obj:`bool`): Optional. Pass :obj:`True` to request a supergroup or a channel with a username, pass :obj:`False` to request a chat without a username. If not specified, no additional restrictions are applied. chat_is_created (:obj:`bool`) Optional. Pass :obj:`True` to request a chat owned by the user. Otherwise, no additional restrictions are applied. user_administrator_rights (:class:`ChatAdministratorRights`) Optional. Specifies the required administrator rights of the user in the chat. If not specified, no additional restrictions are applied. bot_administrator_rights (:class:`ChatAdministratorRights`) Optional. Specifies the required administrator rights of the bot in the chat. The rights must be a subset of :attr:`user_administrator_rights`. If not specified, no additional restrictions are applied. bot_is_member (:obj:`bool`) Optional. Pass :obj:`True` to request a chat with the bot as a member. Otherwise, no additional restrictions are applied. request_title (:obj:`bool`): Optional. Pass :obj:`True` to request the chat's title. .. versionadded:: 21.1 request_username (:obj:`bool`): Optional. Pass :obj:`True` to request the chat's username. .. versionadded:: 21.1 request_photo (:obj:`bool`): Optional. Pass :obj:`True` to request the chat's photo. .. versionadded:: 21.1 ) bot_administrator_rights bot_is_memberchat_has_usernamechat_is_channelchat_is_created chat_is_forumr r request_titleruser_administrator_rightsNrr r,r.r+r-r0r)r*r/rrrc (t| ||_||_||_||_||_||_||_||_ | |_ | |_ | |_ |jf|_ |dSr)rrr r,r.r+r-r0r)r*r/rrrr)rr r,r.r+r-r0r)r*r/rrrrs rrz"KeyboardButtonRequestChat.__init__s J///)%4+8.?,;Ib&H`%*7*7-=*7/+ rdatabotz Bot | Nonereturnc$||}t|dt||d<t|dt||d<t ||S)z,See :meth:`telegram.TelegramObject.de_json`.r0r))r2r3) _parse_datargetrrde_json)clsr2r3rs rr8z!KeyboardButtonRequestChat.de_jsonst$$,< HH0 1 13JC- -  (),< HH/ 0 02I3, ,  '(wwDc222r) NNNNNNNNN)N) rrr r!r"r#r$rrr classmethodr8r%r&s@rr(r(shFFP I$&*)-'+DHCG%)%)(,%)"'+"""""d{ "  $; "  "$;T#A"#:D"@"d{"d{"+"d{"tO""""""H 3 38 3, 3B] 3 3 3 3 3[ 3 3 3 3 3rr(N)r!typingr!telegram._chatadministratorrightsrtelegram._telegramobjectrtelegram._utils.argumentparsingrtelegram._utils.typesrtelegramrr r(rrrBs&?> EEEEEE333333<<<<<<******ddddddddNG3G3G3G3G3G3G3G3G3G3r