o Xzj.F@sDddlmZmZmZddlmZddlmZeGdddeZdS)) EventBuilder EventCommonname_inner_event)utils)typesc@s.eZdZdZedddZGdddeZdS) ChatActionaO Occurs on certain chat actions: * Whenever a new chat is created. * Whenever a chat's title or photo is changed or removed. * Whenever a new message is pinned. * Whenever a user scores in a game. * Whenever a user joins or is added to the group. * Whenever a user is removed or leaves a group if it has less than 50 members or the removed user was a bot. Note that "chat" refers to "small group, megagroup and broadcast channel", whereas "group" refers to "small group and megagroup" only. Example .. code-block:: python from telethon import events @client.on(events.ChatAction) async def handler(event): # Welcome every new user if event.user_joined: await event.reply('Welcome to the group!') NcCst|tjr|js|jt|j|j|jdSt|tjr+|js+|j|j |j|jdSt|tj rA|jt |j |j p`_): The message invoked by this Chat Action. new_pin (`bool`): `True` if there is a new pin. new_photo (`bool`): `True` if there's a new chat photo (or it was removed). photo (:tl:`Photo`, optional): The new photo (or `None` if it was removed). user_added (`bool`): `True` if the user was added by some other. user_joined (`bool`): `True` if the user joined on their own. user_left (`bool`): `True` if the user left on their own. user_kicked (`bool`): `True` if the user was kicked by some other. created (`bool`, optional): `True` if this chat was just created. new_title (`str`, optional): The new title string for the chat, if applicable. new_score (`str`, optional): The new score string for the game, if applicable. unpin (`bool`): `True` if the existing pin gets unpinned. Nc sPt|tjr ||_|j}nd|_tj||r|dndd|du|_||_d|_ |du|_ t|tj r6|nd|_ d|_ d|_d|_|_|_|_|_|durVd|_n|r^d|_||_ |dusj|durn||krnd|_n|rvd|_||_t||_t|trdd|D|_n |rt|g|_ng|_d|_d|_||_| |_| |_dS)N) chat_peermsg_idFTcSsg|]}t|qSrB)rr+.0urBrBrC sz-ChatAction.Event.__init__..)rrr$action_messagepeer_idsuper__init__new_pin_pin_ids_pinned_messagesrPhotor1 _added_by _kicked_by user_added user_joined user_left user_kickedunpinr9rlist _user_idsrr+_users _input_usersrr) selfwhererr r rr rr r r __class__rBrCrOsJ      zChatAction.Event.__init__cs,t||jr|j||jddSdS)N)rN _set_clientrL _finish_init _entities)r_clientrarBrCrcs zChatAction.Event._set_clientcs,|jj|IdHg|Ri|IdHS)z Responds to the chat action message (not as a reply). Shorthand for `telethon.client.messages.MessageMethods.send_message` with ``entity`` already set. N)_client send_messageget_input_chatr_argskwargsrBrBrCresponds  zChatAction.Event.respondcsT|js|j|i|IdHS|jj|d<|jj|IdHg|Ri|IdHS)a  Replies to the chat action message (as a reply). Shorthand for `telethon.client.messages.MessageMethods.send_message` with both ``entity`` and ``reply_to`` already set. Has the same effect as `respond` if there is no message. Nr4)rLrmidrgrhrirjrBrBrCreplys   zChatAction.Event.replycs<|jsdS|jj|IdH|jgg|Ri|IdHS)a Deletes the chat action message. You're responsible for checking whether you have the permission to do so, or to except the error otherwise. Shorthand for `telethon.client.messages.MessageMethods.delete_messages` with ``entity`` and ``message_ids`` already set. Does nothing if no message action triggered this event. N)rLrgdelete_messagesrirjrBrBrCdeletes  zChatAction.Event.deletecs.|jdur |IdH|jr|jdSdS)z If ``new_pin`` is `True`, this returns the `Message ` object that was pinned. NrE)rRget_pinned_messagesr_rBrBrCget_pinned_message s   z#ChatAction.Event.get_pinned_messagecsB|js|jS|IdH}|r|jj|j|jdIdH|_|jS)z If ``new_pin`` is `True`, this returns a `list` of `Message ` objects that were pinned. N)ids)rQrirg get_messages _input_chatrR)r_chatrBrBrCrrsz$ChatAction.Event.get_pinned_messagescC8|jrt|jtjs|jt|j}|r||_|jS)zY The user who added ``users``, if applicable (`None` otherwise). )rTrrUserregetrr+)r_abyrBrBrCr $ zChatAction.Event.added_byc*|js|jr|j|jIdH|_|jS)zT Returns `added_by` but will make an API call if necessary. N)r rTrg get_entityrsrBrBrC get_added_by0 zChatAction.Event.get_added_bycCry)zZ The user who kicked ``users``, if applicable (`None` otherwise). )rUrrrzrer{rr+)r_kbyrBrBrCr 9r}zChatAction.Event.kicked_bycr~)zU Returns `kicked_by` but will make an API call if necessary. N)r rUrgrrsrBrBrC get_kicked_byErzChatAction.Event.get_kicked_bycC|jr|jdSdS)z The first user that takes part in this action. For example, who joined. Might be `None` if the information can't be retrieved or there is no user taking part. rEN)r r]rsrBrBrCuserNs zChatAction.Event.userc$|js |IdHr|jdSdS)zP Returns `user` but will make an API call if necessary. NrE)r get_usersr]rsrBrBrCget_userY zChatAction.Event.get_usercCr)zF Input version of the ``self.user`` property. rEN) input_usersr^rsrBrBrC input_user` zChatAction.Event.input_usercr)zV Returns `input_user` but will make an API call if necessary. NrE)rget_input_usersr^rsrBrBrCget_input_userhrzChatAction.Event.get_input_usercCs|jr|jdSdS)zQ Returns the marked signed ID of the first user, if any. rENr\rsrBrBrCrorzChatAction.Event.user_idcs0jsgSjdurfddjD_jS)z A list of users that take part in this action. For example, who joined. Might be empty if the information can't be retrieved or there are no users taking part. Ncs g|] }|jvrj|qSrB)re)rIrrsrBrCrKs  z*ChatAction.Event.users..)r\r]rsrBrsrCr ws  zChatAction.Event.userscsZ|jsgS|jdust|jt|jkr*|jr*|jIdHdd|jjD|_|jS)zQ Returns `users` but will make an API call if necessary. NcSs"g|] }t|tjtjfr|qSrB)rrrz UserEmptyrHrBrBrCrKs z.ChatAction.Event.get_users..)r\r lenr]rL_reload_messageaction_entitiesrsrBrBrCrs$zChatAction.Event.get_usersc Cs|jdurH|jrHg|_|jD]9}z|jt|j|Wqttfy)Ynwz|j|jj t |d Wqt yGYqw|jpLgS)zG Input version of the ``self.users`` property. NrE)r^r\appendrget_input_peerreKeyError TypeErrorrg_mb_entity_cacher{ resolve_id_as_input_peerAttributeError)r_rrBrBrCrs(    zChatAction.Event.input_userscsN|jsgS|jdust|jt|jkr"|jr"dd|jjD|_|jp&gS)zW Returns `input_users` but will make an API call if necessary. NcSs(g|]}t|tjtjfrt|qSrB)rrrzrrrrHrBrBrCrKs z4ChatAction.Event.get_input_users..)r\rrr^rLrrsrBrBrCrs$ z ChatAction.Event.get_input_userscCs|jr |jddSdS)zL Returns the marked signed ID of the users, if any. NrrsrBrBrCuser_idsszChatAction.Event.user_ids) NNNNNNNNN)__name__ __module__ __qualname____doc__rOrcrmrorqrtrrpropertyr rr rrrrrrr rrrr __classcell__rBrBrarCrzsD) 7            r)NN)rrrr classmethodrDrrrBrBrBrCrs  WrN) commonrrrrtlrrrBrBrBrCs