U h.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|tjrV|jsV|j|j |j|jdSt|tj r|jt |j |j pxd|jdSt|tjr|jt |j d|jdSt|tjtjfrXt|jtjrX|j}|jj}t|tjr|j|d|jdSt|tjr0|jg|jkp|j}|j|||jdSt|tjrd|j||jrXt|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$r8|j%r8|j||j&gd St|tj'r|j||j(d Sn\t|tj)rt*|j+t*|j,kr|jt|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)clsupdateZothersself_idmsgrr r">/tmp/pip-unpacked-wheel-c81u5j2r/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*t|g|_ng|_d|_d|_||_| |_| |_dS)N)Z chat_peerZmsg_idFTcSsg|]}t|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,sL     zChatAction.Event.__init__cs(t||jr$|j||jddS)N)r+ _set_clientr*Z _finish_init _entities)r5clientr7r"r#r9s zChatAction.Event._set_clientcs$|jj|IdHf||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_chatr5argskwargsr"r"r#responds zChatAction.Event.respondcsH|js|j||IdHS|jj|d<|jj|IdHf||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*rBidr<r=r>r?r"r"r#replys  zChatAction.Event.replycs4|js dS|jj|IdH|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*r<Zdelete_messagesr>r?r"r"r#deletes  zChatAction.Event.deletecs,|jdkr|IdH|jr(|jdSdS)z If ``new_pin`` is `True`, this returns the `Message ` object that was pinned. Nr%)r.get_pinned_messagesr5r"r"r#get_pinned_message s z#ChatAction.Event.get_pinned_messagecs@|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)r-r>r<Z get_messagesZ _input_chatr.)r5Zchatr"r"r#rFsz$ChatAction.Event.get_pinned_messagescCs8|jr2t|jtjs2|jt|j}|r2||_|jS)zY The user who added ``users``, if applicable (`None` otherwise). )r/rrUserr:getrr)r5Zabyr"r"r#r $s zChatAction.Event.added_bycs(|js"|jr"|j|jIdH|_|jS)zT Returns `added_by` but will make an API call if necessary. N)r r/r< get_entityrGr"r"r# get_added_by0s zChatAction.Event.get_added_bycCs8|jr2t|jtjs2|jt|j}|r2||_|jS)zZ The user who kicked ``users``, if applicable (`None` otherwise). )r0rrrJr:rKrr)r5Zkbyr"r"r#r 9s zChatAction.Event.kicked_bycs(|js"|jr"|j|jIdH|_|jS)zU Returns `kicked_by` but will make an API call if necessary. N)r r0r<rLrGr"r"r# get_kicked_byEs zChatAction.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 r3rGr"r"r#userNszChatAction.Event.usercs"|js|IdHr|jdSdS)zP Returns `user` but will make an API call if necessary. Nr%)r get_usersr3rGr"r"r#get_userYszChatAction.Event.get_usercCs|jr|jdSdS)zF Input version of the ``self.user`` property. r%N) input_usersr4rGr"r"r# input_user`szChatAction.Event.input_usercs"|js|IdHr|jdSdS)zV Returns `input_user` but will make an API call if necessary. Nr%)rRget_input_usersr4rGr"r"r#get_input_userhszChatAction.Event.get_input_usercCs|jr|jdSdS)zQ Returns the marked signed ID of the first user, if any. r%Nr2rGr"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")r:)r'rrGr"r#r)s z*ChatAction.Event.users..)r2r3rGr"rGr#r ws  zChatAction.Event.userscsX|js gS|jdks(t|jt|jkrR|jrR|jIdHdd|jjD|_|jS)zQ Returns `users` but will make an API call if necessary. NcSs"g|]}t|tjtjfr|qSr")rrrJ UserEmptyr&r"r"r#r)sz.ChatAction.Event.get_users..)r2r lenr3r*Z_reload_messageaction_entitiesrGr"r"r#rPs$zChatAction.Event.get_usersc Cs|jdkr|jrg|_|jD]}z |jt|j|WqWnttfk rXYnXz,|j|jj t |d WqWqt k rYqXq|jpgS)zG Input version of the ``self.users`` property. Nr%)r4r2appendrget_input_peerr:KeyError TypeErrorr<Z_mb_entity_cacherKZ resolve_idZ_as_input_peerAttributeError)r5rr"r"r#rRs   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|tjtjfrt|qSr")rrrJrWrr[r&r"r"r#r)sz4ChatAction.Event.get_input_users..)r2rRrXr4r*rYrGr"r"r#rTs$z ChatAction.Event.get_input_userscCs|jr|jddSdS)zL Returns the marked signed ID of the users, if any. NrVrGr"r"r#user_idsszChatAction.Event.user_ids) NNNNNNNNN)__name__ __module__ __qualname____doc__r,r9rBrDrErHrFpropertyr rMr rNrOrQrSrUrr rPrRrTr_ __classcell__r"r"r7r#rzsN)7            r)NN)r`rarbrc classmethodr$rrr"r"r"r#rs WrN) commonrrrrtlrrr"r"r"r#s