3 uQh.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|tjr0|j r0|jtj|j|j|jdSt|tjrZ|j rZ|j|j |j|jdSt|tj r|jtj |j |j p|d|jdSt|tjr|jtj |j d|jdSt|tjtjfot|jtjrZ|j}|jj}t|tjr|j|d|jdSt|tjr2|jg|jkp|j}|j|||jdSt|tjrf|j||jrZtj|jnd|jdSt|tjr|j||jd|jdSt|tjr|j|d|j|jdSt|tj r|j||j|jdSt|tj!r|j||j|j"dSt|tj#r|j||jddSt|tj$r:|j%r:|j||j&gd St|tj'r|j||j(d Sn\t|tj)rt*|j+t*|j,kr|jtj|j|j|j+r|j-nd|j,r|j-ndd SdS) N)pin_idspinT)added_byusers) kicked_byr )r created new_title)rr r)r r)r new_photo)r ) new_score)r r r ). isinstancerZUpdatePinnedChannelMessagesZpinnedEventZ PeerChannelZ channel_idmessagesZUpdatePinnedMessagesZpeerZUpdateChatParticipantAddZPeerChatZchat_idZ inviter_iduser_idZUpdateChatParticipantDeleteZUpdateNewMessageZUpdateNewChannelMessagemessageMessageServiceactionZMessageActionChatJoinedByLinkZfrom_idZMessageActionChatAddUserZ sender_idr ZMessageActionChatDeleteUserr get_peer_idZMessageActionChatCreatetitleZMessageActionChannelCreateZMessageActionChatEditTitleZMessageActionChatEditPhotophotoZMessageActionChatDeletePhotoZMessageActionPinMessagereply_toZreply_to_msg_idZMessageActionGameScoreZscoreZUpdateChannelParticipantboolZnew_participantZprev_participantZactor_id)clsupdateZothersZself_idmsgrr r!>/tmp/pip-build-2nz6shyl/telethon/telethon/events/chataction.pybuild"s               zChatAction.buildc seZdZdZd-fdd ZfddZddZd d Zd d Zd dZ ddZ e ddZ ddZ e ddZddZe ddZddZe ddZdd Ze d!d"Ze d#d$Zd%d&Ze d'd(Zd)d*Ze d+d,ZZS).zChatAction.Eventa Represents the event of a new chat action. Members: action_message (`MessageAction `_): 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 sTt|tjr||_|j}nd|_tj||r4|dndd|dk |_||_d|_ |dk |_ t|tj rl|nd|_ d|_ d|_d|_|_|_|_|_|dkrd|_n|rd|_||_ |dks|dk r||krd|_n|rd|_||_t||_t|trdd|D|_n|r*tj|g|_ng|_d|_d|_||_| |_| |_dS)N)Z chat_peerZmsg_idFTcSsg|]}tj|qSr!)rr).0ur!r!r" sz-ChatAction.Event.__init__..)rrraction_messageZpeer_idsuper__init__Znew_pin_pin_ids_pinned_messagesrZPhotor _added_by _kicked_byZ user_addedZ user_joinedZ user_leftZ user_kickedZunpinrrlist _user_idsrr_users _input_usersrr) selfwhererr r rr rr r r) __class__r!r"r*sD     zChatAction.Event.__init__cs(tj||jr$|jj||jddS)N)r) _set_clientr(Z _finish_init _entities)r3client)r5r!r"r6s zChatAction.Event._set_clientcs$|jj|jIdHf||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_chat)r3argskwargsr!r!r"respondszChatAction.Event.respondcsH|js|j||IdHS|jj|d<|jj|jIdHf||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. Nr)r(r>idr9r:r;)r3r<r=r!r!r"replys  zChatAction.Event.replycs4|js dS|jj|jIdH|jgf||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)r(r9Zdelete_messagesr;)r3r<r=r!r!r"deletes zChatAction.Event.deletecs,|jdkr|jIdH|jr(|jdSdS)z If ``new_pin`` is `True`, this returns the `Message ` object that was pinned. Nr$)r,get_pinned_messages)r3r!r!r"get_pinned_message s z#ChatAction.Event.get_pinned_messagecs@|js |jS|jIdH}|r:|jj|j|jdIdH|_|jS)z If ``new_pin`` is `True`, this returns a `list` of `Message ` objects that were pinned. N)ids)r+r;r9Z get_messagesZ _input_chatr,)r3Zchatr!r!r"rBsz$ChatAction.Event.get_pinned_messagescCs:|jr4t|jtj r4|jjtj|j}|r4||_|jS)zY The user who added ``users``, if applicable (`None` otherwise). )r-rrUserr7getrr)r3Zabyr!r!r"r $s zChatAction.Event.added_bycs*|j r$|jr$|jj|jIdH|_|jS)zT Returns `added_by` but will make an API call if necessary. N)r r-r9 get_entity)r3r!r!r" get_added_by0szChatAction.Event.get_added_bycCs:|jr4t|jtj r4|jjtj|j}|r4||_|jS)zZ The user who kicked ``users``, if applicable (`None` otherwise). )r.rrrEr7rFrr)r3Zkbyr!r!r"r 9s zChatAction.Event.kicked_bycs*|j r$|jr$|jj|jIdH|_|jS)zU Returns `kicked_by` but will make an API call if necessary. N)r r.r9rG)r3r!r!r" get_kicked_byEszChatAction.Event.get_kicked_bycCs|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. r$N)r r1)r3r!r!r"userNszChatAction.Event.usercs"|js|jIdHr|jdSdS)zP Returns `user` but will make an API call if necessary. Nr$)r get_usersr1)r3r!r!r"get_userYszChatAction.Event.get_usercCs|jr|jdSdS)zF Input version of the ``self.user`` property. r$N) input_usersr2)r3r!r!r" input_user`szChatAction.Event.input_usercs"|js|jIdHr|jdSdS)zV Returns `input_user` but will make an API call if necessary. Nr$)rMget_input_usersr2)r3r!r!r"get_input_userhszChatAction.Event.get_input_usercCs|jr|jdSdS)zQ Returns the marked signed ID of the first user, if any. r$N)r0)r3r!r!r"roszChatAction.Event.user_idcs0js gSjdkr*fddjD_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|]}|jkrj|qSr!)r7)r%r)r3r!r"r'sz*ChatAction.Event.users..)r0r1)r3r!)r3r"r ws    zChatAction.Event.userscsX|js gS|jdks(t|jt|jkrR|jrR|jjIdHdd|jjD|_|jS)zQ Returns `users` but will make an API call if necessary. NcSs"g|]}t|tjtjfr|qSr!)rrrE UserEmpty)r%r&r!r!r"r'sz.ChatAction.Event.get_users..)r0r lenr1r(Z_reload_messageaction_entities)r3r!r!r"rKs $zChatAction.Event.get_userscCs|jdkr|jrg|_x|jD]|}y|jjtj|j|wWnttfk rXYnXy*|jj|jj j tj |dj wWqt k rYqXqW|jpgS)zG Input version of the ``self.users`` property. Nr$)r2r0appendrget_input_peerr7KeyError TypeErrorr9Z_mb_entity_cacherFZ resolve_idZ_as_input_peerAttributeError)r3rr!r!r"rMs  zChatAction.Event.input_userscsL|js gS|jdks(t|jt|jkrB|jrBdd|jjD|_|jpJgS)zW Returns `input_users` but will make an API call if necessary. NcSs(g|] }t|tjtjfrtj|qSr!)rrrErQrrU)r%r&r!r!r"r'sz4ChatAction.Event.get_input_users..)r0rMrRr2r(rS)r3r!r!r"rOs $z ChatAction.Event.get_input_userscCs|jr|jddSdS)zL Returns the marked signed ID of the users, if any. N)r0)r3r!r!r"user_idsszChatAction.Event.user_ids) NNNNNNNNN)__name__ __module__ __qualname____doc__r*r6r>r@rArCrBpropertyr rHr rIrJrLrNrPrr rKrMrOrY __classcell__r!r!)r5r"rzs0(5          r)NN)rZr[r\r] classmethodr#rrr!r!r!r"rs WrN) commonrrrrtlrrr!r!r!r"s