iC{dZddlZddlmZddlmZddlmZddl m Z m Z ddl m Z ddlmZdd lmZdd lmZdd lmZdd lmZdd lmZddlmZmZmZmZddlm Z m!Z!m"Z"ddl#m$Z$m%Z%erddl&m'Z'm(Z(m)Z)m*Z*m+Z+Gdde Z,dS)zGThis module contains an object that represents a Telegram ChatFullInfo.N)Sequence) TYPE_CHECKING) Birthdate)Chat _ChatBase) ChatLocation)ChatPermissions) ChatPhoto)AcceptedGiftTypes) ReactionType)UniqueGiftColors) UserRating)de_json_optionalde_list_optionalparse_sequence_arg to_timedelta)extract_tzinfo_from_defaultsfrom_timestampget_timedelta_value)JSONDict TimePeriod)Bot BusinessIntroBusinessLocationBusinessOpeningHoursMessagecieZdZdZdZ dEdddedededed ed edzd edzd edzd edzdedzde dzde edzde dzddddddddde e dzdedzdedzdedzdedzde jdzd edzd!edzd"edzd#edzd$edzd%edzd&edzd'd(d)edzd*edzd+edzd,edzd-edzd.edzd/edzd0edzd1edzd2edzd3edzd4edzd5edzd6edzd7edzd8edzd9edzd:edzd;edzdee jzdzfd?Zed>ee jzdzfd@ZedFdAedBdCd>dffdD ZxZS)G ChatFullInfoaL This object contains full information about a chat. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`~telegram.Chat.id` is equal. .. versionadded:: 21.2 .. versionchanged:: 21.3 Explicit support for all shortcut methods known from :class:`telegram.Chat` on this object. Previously those were only available because this class inherited from :class:`telegram.Chat`. .. versionremoved:: 22.3 Removed argument and attribute ``can_send_gift`` deprecated by API 9.0. Args: id (:obj:`int`): Unique identifier for this chat. type (:obj:`str`): Type of chat, can be either :attr:`PRIVATE`, :attr:`GROUP`, :attr:`SUPERGROUP` or :attr:`CHANNEL`. accent_color_id (:obj:`int`, optional): Identifier of the :class:`accent color ` for the chat name and backgrounds of the chat photo, reply header, and link preview. See `accent colors`_ for more details. .. versionadded:: 20.8 max_reaction_count (:obj:`int`): The maximum number of reactions that can be set on a message in the chat. .. versionadded:: 21.2 accepted_gift_types (:class:`telegram.AcceptedGiftTypes`): Information about types of gifts that are accepted by the chat or by the corresponding user for private chats. .. versionadded:: 22.1 title (:obj:`str`, optional): Title, for supergroups, channels and group chats. username (:obj:`str`, optional): Username, for private chats, supergroups and channels if available. first_name (:obj:`str`, optional): First name of the other party in a private chat. last_name (:obj:`str`, optional): Last name of the other party in a private chat. is_forum (:obj:`bool`, optional): :obj:`True`, if the supergroup chat is a forum (has topics_ enabled). .. versionadded:: 20.0 photo (:class:`telegram.ChatPhoto`, optional): Chat photo. active_usernames (Sequence[:obj:`str`], optional): If set, the list of all `active chat usernames `_; for private chats, supergroups and channels. .. versionadded:: 20.0 birthdate (:class:`telegram.Birthdate`, optional): For private chats, the date of birth of the user. .. versionadded:: 21.1 business_intro (:class:`telegram.BusinessIntro`, optional): For private chats with business accounts, the intro of the business. .. versionadded:: 21.1 business_location (:class:`telegram.BusinessLocation`, optional): For private chats with business accounts, the location of the business. .. versionadded:: 21.1 business_opening_hours (:class:`telegram.BusinessOpeningHours`, optional): For private chats with business accounts, the opening hours of the business. .. versionadded:: 21.1 personal_chat (:class:`telegram.Chat`, optional): For private chats, the personal channel of the user. .. versionadded:: 21.1 available_reactions (Sequence[:class:`telegram.ReactionType`], optional): List of available reactions allowed in the chat. If omitted, then all of :const:`telegram.constants.ReactionEmoji` are allowed. .. versionadded:: 20.8 background_custom_emoji_id (:obj:`str`, optional): Custom emoji identifier of emoji chosen by the chat for the reply header and link preview background. .. versionadded:: 20.8 profile_accent_color_id (:obj:`int`, optional): Identifier of the :class:`accent color ` for the chat's profile background. See profile `accent colors`_ for more details. .. versionadded:: 20.8 profile_background_custom_emoji_id (:obj:`str`, optional): Custom emoji identifier of the emoji chosen by the chat for its profile background. .. versionadded:: 20.8 emoji_status_custom_emoji_id (:obj:`str`, optional): Custom emoji identifier of emoji status of the chat or the other party in a private chat. .. versionadded:: 20.0 emoji_status_expiration_date (:class:`datetime.datetime`, optional): Expiration date of emoji status of the chat or the other party in a private chat, as a datetime object, if any. |datetime_localization| .. versionadded:: 20.5 bio (:obj:`str`, optional): Bio of the other party in a private chat. has_private_forwards (:obj:`bool`, optional): :obj:`True`, if privacy settings of the other party in the private chat allows to use ``tg://user?id=`` links only in chats with the user. .. versionadded:: 13.9 has_restricted_voice_and_video_messages (:obj:`bool`, optional): :obj:`True`, if the privacy settings of the other party restrict sending voice and video note messages in the private chat. .. versionadded:: 20.0 join_to_send_messages (:obj:`bool`, optional): :obj:`True`, if users need to join the supergroup before they can send messages. .. versionadded:: 20.0 join_by_request (:obj:`bool`, optional): :obj:`True`, if all users directly joining the supergroup without using an invite link need to be approved by supergroup administrators. .. versionadded:: 20.0 description (:obj:`str`, optional): Description, for groups, supergroups and channel chats. invite_link (:obj:`str`, optional): Primary invite link, for groups, supergroups and channel. pinned_message (:class:`telegram.Message`, optional): The most recent pinned message (by sending date). permissions (:class:`telegram.ChatPermissions`): Optional. Default chat member permissions, for groups and supergroups. slow_mode_delay (:obj:`int` | :class:`datetime.timedelta`, optional): For supergroups, the minimum allowed delay between consecutive messages sent by each unprivileged user. .. versionchanged:: v22.2 |time-period-input| unrestrict_boost_count (:obj:`int`, optional): For supergroups, the minimum number of boosts that a non-administrator user needs to add in order to ignore slow mode and chat permissions. .. versionadded:: 21.0 message_auto_delete_time (:obj:`int` | :class:`datetime.timedelta`, optional): The time after which all messages sent to the chat will be automatically deleted; in seconds. .. versionadded:: 13.4 .. versionchanged:: v22.2 |time-period-input| has_aggressive_anti_spam_enabled (:obj:`bool`, optional): :obj:`True`, if aggressive anti-spam checks are enabled in the supergroup. The field is only available to chat administrators. .. versionadded:: 20.0 has_hidden_members (:obj:`bool`, optional): :obj:`True`, if non-administrators can only get the list of bots and administrators in the chat. .. versionadded:: 20.0 has_protected_content (:obj:`bool`, optional): :obj:`True`, if messages from the chat can't be forwarded to other chats. .. versionadded:: 13.9 has_visible_history (:obj:`bool`, optional): :obj:`True`, if new chat members will have access to old messages; available only to chat administrators. .. versionadded:: 20.8 sticker_set_name (:obj:`str`, optional): For supergroups, name of group sticker set. can_set_sticker_set (:obj:`bool`, optional): :obj:`True`, if the bot can change group the sticker set. custom_emoji_sticker_set_name (:obj:`str`, optional): For supergroups, the name of the group's custom emoji sticker set. Custom emoji from this set can be used by all users and bots in the group. .. versionadded:: 21.0 linked_chat_id (:obj:`int`, optional): Unique identifier for the linked chat, i.e. the discussion group identifier for a channel and vice versa; for supergroups and channel chats. location (:class:`telegram.ChatLocation`, optional): For supergroups, the location to which the supergroup is connected. can_send_paid_media (:obj:`bool`, optional): :obj:`True`, if paid media messages can be sent or forwarded to the channel chat. The field is available only for channel chats. .. versionadded:: 21.4 is_direct_messages (:obj:`bool`, optional): :obj:`True`, if the chat is the direct messages chat of a channel. .. versionadded:: 22.4 parent_chat (:obj:`telegram.Chat`, optional): Information about the corresponding channel chat; for direct messages chats only. .. versionadded:: 22.4 rating (:class:`telegram.UserRating`, optional): For private chats, the rating of the user if any. .. versionadded:: 22.6 unique_gift_colors (:class:`telegram.UniqueGiftColors`, optional): The color scheme based on a unique gift that must be used for the chat's name, message replies and link previews .. versionadded:: 22.6 paid_message_star_count (:obj:`int`, optional): The number of Telegram Stars a general user have to pay to send a message to the chat .. versionadded:: 22.6 Attributes: id (:obj:`int`): Unique identifier for this chat. type (:obj:`str`): Type of chat, can be either :attr:`PRIVATE`, :attr:`GROUP`, :attr:`SUPERGROUP` or :attr:`CHANNEL`. accent_color_id (:obj:`int`): Optional. Identifier of the :class:`accent color ` for the chat name and backgrounds of the chat photo, reply header, and link preview. See `accent colors`_ for more details. .. versionadded:: 20.8 max_reaction_count (:obj:`int`): The maximum number of reactions that can be set on a message in the chat. .. versionadded:: 21.2 accepted_gift_types (:class:`telegram.AcceptedGiftTypes`): Information about types of gifts that are accepted by the chat or by the corresponding user for private chats. .. versionadded:: 22.1 title (:obj:`str`, optional): Title, for supergroups, channels and group chats. username (:obj:`str`, optional): Username, for private chats, supergroups and channels if available. first_name (:obj:`str`, optional): First name of the other party in a private chat. last_name (:obj:`str`, optional): Last name of the other party in a private chat. is_forum (:obj:`bool`, optional): :obj:`True`, if the supergroup chat is a forum (has topics_ enabled). .. versionadded:: 20.0 photo (:class:`telegram.ChatPhoto`): Optional. Chat photo. active_usernames (tuple[:obj:`str`]): Optional. If set, the list of all `active chat usernames `_; for private chats, supergroups and channels. This list is empty if the chat has no active usernames or this chat instance was not obtained via :meth:`~telegram.Bot.get_chat`. .. versionadded:: 20.0 birthdate (:class:`telegram.Birthdate`): Optional. For private chats, the date of birth of the user. .. versionadded:: 21.1 business_intro (:class:`telegram.BusinessIntro`): Optional. For private chats with business accounts, the intro of the business. .. versionadded:: 21.1 business_location (:class:`telegram.BusinessLocation`): Optional. For private chats with business accounts, the location of the business. .. versionadded:: 21.1 business_opening_hours (:class:`telegram.BusinessOpeningHours`): Optional. For private chats with business accounts, the opening hours of the business. .. versionadded:: 21.1 personal_chat (:class:`telegram.Chat`): Optional. For private chats, the personal channel of the user. .. versionadded:: 21.1 available_reactions (tuple[:class:`telegram.ReactionType`]): Optional. List of available reactions allowed in the chat. If omitted, then all of :const:`telegram.constants.ReactionEmoji` are allowed. .. versionadded:: 20.8 background_custom_emoji_id (:obj:`str`): Optional. Custom emoji identifier of emoji chosen by the chat for the reply header and link preview background. .. versionadded:: 20.8 profile_accent_color_id (:obj:`int`): Optional. Identifier of the :class:`accent color ` for the chat's profile background. See profile `accent colors`_ for more details. .. versionadded:: 20.8 profile_background_custom_emoji_id (:obj:`str`): Optional. Custom emoji identifier of the emoji chosen by the chat for its profile background. .. versionadded:: 20.8 emoji_status_custom_emoji_id (:obj:`str`): Optional. Custom emoji identifier of emoji status of the chat or the other party in a private chat. .. versionadded:: 20.0 emoji_status_expiration_date (:class:`datetime.datetime`): Optional. Expiration date of emoji status of the chat or the other party in a private chat, as a datetime object, if any. |datetime_localization| .. versionadded:: 20.5 bio (:obj:`str`): Optional. Bio of the other party in a private chat. has_private_forwards (:obj:`bool`): Optional. :obj:`True`, if privacy settings of the other party in the private chat allows to use ``tg://user?id=`` links only in chats with the user. .. versionadded:: 13.9 has_restricted_voice_and_video_messages (:obj:`bool`): Optional. :obj:`True`, if the privacy settings of the other party restrict sending voice and video note messages in the private chat. .. versionadded:: 20.0 join_to_send_messages (:obj:`bool`): Optional. :obj:`True`, if users need to join the supergroup before they can send messages. .. versionadded:: 20.0 join_by_request (:obj:`bool`): Optional. :obj:`True`, if all users directly joining the supergroup without using an invite link need to be approved by supergroup administrators. .. versionadded:: 20.0 description (:obj:`str`): Optional. Description, for groups, supergroups and channel chats. invite_link (:obj:`str`): Optional. Primary invite link, for groups, supergroups and channel. pinned_message (:class:`telegram.Message`): Optional. The most recent pinned message (by sending date). permissions (:class:`telegram.ChatPermissions`): Optional. Default chat member permissions, for groups and supergroups. slow_mode_delay (:obj:`int` | :class:`datetime.timedelta`): Optional. For supergroups, the minimum allowed delay between consecutive messages sent by each unprivileged user. .. deprecated:: v22.2 |time-period-int-deprecated| unrestrict_boost_count (:obj:`int`): Optional. For supergroups, the minimum number of boosts that a non-administrator user needs to add in order to ignore slow mode and chat permissions. .. versionadded:: 21.0 message_auto_delete_time (:obj:`int` | :class:`datetime.timedelta`): Optional. The time after which all messages sent to the chat will be automatically deleted; in seconds. .. versionadded:: 13.4 .. deprecated:: v22.2 |time-period-int-deprecated| has_aggressive_anti_spam_enabled (:obj:`bool`): Optional. :obj:`True`, if aggressive anti-spam checks are enabled in the supergroup. The field is only available to chat administrators. .. versionadded:: 20.0 has_hidden_members (:obj:`bool`): Optional. :obj:`True`, if non-administrators can only get the list of bots and administrators in the chat. .. versionadded:: 20.0 has_protected_content (:obj:`bool`): Optional. :obj:`True`, if messages from the chat can't be forwarded to other chats. .. versionadded:: 13.9 has_visible_history (:obj:`bool`): Optional. :obj:`True`, if new chat members will have access to old messages; available only to chat administrators. .. versionadded:: 20.8 sticker_set_name (:obj:`str`): Optional. For supergroups, name of Group sticker set. can_set_sticker_set (:obj:`bool`): Optional. :obj:`True`, if the bot can change group the sticker set. custom_emoji_sticker_set_name (:obj:`str`): Optional. For supergroups, the name of the group's custom emoji sticker set. Custom emoji from this set can be used by all users and bots in the group. .. versionadded:: 21.0 linked_chat_id (:obj:`int`): Optional. Unique identifier for the linked chat, i.e. the discussion group identifier for a channel and vice versa; for supergroups and channel chats. location (:class:`telegram.ChatLocation`): Optional. For supergroups, the location to which the supergroup is connected. can_send_paid_media (:obj:`bool`): Optional. :obj:`True`, if paid media messages can be sent or forwarded to the channel chat. The field is available only for channel chats. .. versionadded:: 21.4 is_direct_messages (:obj:`bool`): Optional. :obj:`True`, if the chat is the direct messages chat of a channel. .. versionadded:: 22.4 parent_chat (:obj:`telegram.Chat`): Optional. Information about the corresponding channel chat; for direct messages chats only. .. versionadded:: 22.4 rating (:class:`telegram.UserRating`): Optional. For private chats, the rating of the user if any. .. versionadded:: 22.6 unique_gift_colors (:class:`telegram.UniqueGiftColors`): Optional. The color scheme based on a unique gift that must be used for the chat's name, message replies and link previews .. versionadded:: 22.6 paid_message_star_count (:obj:`int`): Optional. The number of Telegram Stars a general user have to pay to send a message to the chat .. versionadded:: 22.6 .. _accent colors: https://core.telegram.org/bots/api#accent-colors .. _topics: https://telegram.org/blog/topics-in-groups-collectible-usernames#topics-in-groups )*_message_auto_delete_time_slow_mode_delayaccent_color_idaccepted_gift_typesactive_usernamesavailable_reactionsbackground_custom_emoji_idbio birthdatebusiness_introbusiness_locationbusiness_opening_hourscan_send_paid_mediacan_set_sticker_setcustom_emoji_sticker_set_name descriptionemoji_status_custom_emoji_idemoji_status_expiration_date has_aggressive_anti_spam_enabledhas_hidden_membershas_private_forwardshas_protected_content'has_restricted_voice_and_video_messageshas_visible_history invite_linkjoin_by_requestjoin_to_send_messageslinked_chat_idlocationmax_reaction_countpaid_message_star_count parent_chat permissions personal_chatphotopinned_messageprofile_accent_color_id"profile_background_custom_emoji_idratingsticker_set_nameunique_gift_colorsunrestrict_boost_countN) api_kwargsidtyper!r<r"titleusername first_name last_nameis_forumrAr#r'r(zBusinessIntro | Noner)zBusinessLocation | Noner*zBusinessOpeningHours | Noner@z Chat | Noner$r%rCrDr/r0r&r3r5r9r8r.r7rBzMessage | Noner?slow_mode_delayrHmessage_auto_delete_timer1r2r4r6rFr,r-r:r;r+is_direct_messagesr>rErGr=rIc3 jt|||||| | |.|3 |5||_| |_||_||_||_||_||_ | |_ t|!|_ t|#|_ |&|_|'|_|(|_|)|_|+|_|,|_||_||_||_t/| |_||_||_|$|_|%|_t/||_||_||_||_ ||_!|"|_"|*|_#| |_$||_%||_&||_'||_(|-|_)||_*|/|_+|0|_,|1|_-|2|_.ddddS#1swxYwYdS)N) rJrKrLrMrNrOrPrSrI)/super__init__ _unfrozenr<rAr&r3r.r7rBr?rr rr4r6rFr,r:r;r9r8r5rr#r/r0r1r2r$r!r%rCrDrHr-r'r@r(r)r*r+r"r>rErGr=)5selfrJrKr!r<r"rLrMrNrOrPrAr#r'r(r)r*r@r$r%rCrDr/r0r&r3r5r9r8r.r7rBr?rQrHrRr1r2r4r6rFr,r-r:r;r+rSr>rErGr=rI __class__s5 V/Users/shanyulin/my-agent/.venv/lib/python3.11/site-packages/telegram/_chatfullinfo.pyrVzChatFullInfo.__init__sXn !1!  ^^  2 O2 O+=D #+0DJ#&DH5ID %+6D +6D 2@D 7BD :F:W:WD !CO(DDD *7LD &4GD $0@D !4GD $.OD "G]D '4GD $:MD $,7D -3DK?QD #7ND (e2 O2 O2 O2 O2 O2 O2 O2 O2 O2 O2 O2 O2 O2 O2 O2 O2 O2 OsEF((F,/F,returnc.t|jdS)NrQ attribute)rr rXs rZrQzChatFullInfo.slow_mode_delay\s"4#8DUVVVVc.t|jdS)NrRr])rrr_s rZrRz%ChatFullInfo.message_auto_delete_time`s""  *6P    r`databotz Bot | Nonec||}t|}t|d||d<t |dt ||d<t |dt ||d<ddlm}m }m }m }t |d|||d<t |dt||d<t |d t||d <t|d t||d <t |d t ||d <t |d t"||d <t |d |||d <t |d|||d<t |d|||d<t |dt"||d<t |dt$||d<t |dt&||d<t)||S)z,See :meth:`telegram.TelegramObject.de_json`.r0)tzinforAr"r)rrrrrBr?r;r$r'r@r(r)r*r>rErG)rbrc) _parse_datarrgetrr r telegramrrrrr rrr rrrr rUde_json) clsrbrc loc_tzinforrrrrYs rZrizChatFullInfo.de_jsonfst$$2#66 /= HH3 4 4Z0 0 0  +,)'):):IsKKW &6 HH* + +->' '  "#            "2$((;K2L2LgWZ![![ .txx /F/FY\]]]+DHHZ,@,@,PSTTZ&6 HH* + +\3' '  "#-TXXk-B-BIsSS[ 0/1J1JDRU V V_!1$((;K2L2Lm]`!a!a $4 HH( ) )+;S% %  !*: HH- . .0Dc* *  %&/txx /F/FcRR])$((8*<*#uO$%%uO&&l3d:'uO(%($J)uO*"%t+uO,-0$J-uO.'*Dj/uO0'*lT&91uO24Z3uO4#Tk5uO6267uO8 $d{9uO:;uO<4Z=uO>4Z?uO@)AuOB%t+CuOD$d*EuOF!$d GuOH#-t"3IuOJ+/+KuOL!4KMuON $d{OuOP"D[QuOR*SuOT"D[UuOV(+TzWuOXd YuOZ%[uO\"D[]uO^!4K_uO`D[auObT!cuOd-t3euOf"%tguOjtOkuOuOuOuOuOuOnWs}!4t!;WWWXW # *=*D   X -3-38-3,-3.-3-3-3-3-3[-3-3-3-3-3r`r)-rorurtcollections.abcrtypingrtelegram._birthdatertelegram._chatrrtelegram._chatlocationrtelegram._chatpermissionsr telegram._files.chatphotor telegram._giftsr telegram._reactionr telegram._uniquegiftr telegram._userratingrtelegram._utils.argumentparsingrrrrtelegram._utils.datetimerrrtelegram._utils.typesrrrhrrrrrrr`rZrs(NM$$$$$$ ))))))********//////555555//////------++++++111111++++++  76666666]\\\\\\\\\\\\\\` 3` 3` 3` 3` 39` 3` 3` 3` 3` 3r`