from .common import EventBuilder, EventCommon, name_inner_event from .. import utils from ..tl import types, functions @name_inner_event class ChatAction(EventBuilder): """ Occurs whenever a user joins or leaves a chat, or a message is pinned. """ @classmethod def build(cls, update, others=None, self_id=None): if isinstance(update, types.UpdateChannelPinnedMessage) and update.id == 0: # Telegram does not always send # UpdateChannelPinnedMessage for new pins # but always for unpin, with update.id = 0 return cls.Event(types.PeerChannel(update.channel_id), unpin=True) elif isinstance(update, types.UpdateChatParticipantAdd): return cls.Event(types.PeerChat(update.chat_id), added_by=update.inviter_id or True, users=update.user_id) elif isinstance(update, types.UpdateChatParticipantDelete): return cls.Event(types.PeerChat(update.chat_id), kicked_by=True, users=update.user_id) elif (isinstance(update, ( types.UpdateNewMessage, types.UpdateNewChannelMessage)) and isinstance(update.message, types.MessageService)): msg = update.message action = update.message.action if isinstance(action, types.MessageActionChatJoinedByLink): return cls.Event(msg, added_by=True, users=msg.from_id) elif isinstance(action, types.MessageActionChatAddUser): # If a user adds itself, it means they joined added_by = ([msg.from_id] == action.users) or msg.from_id return cls.Event(msg, added_by=added_by, users=action.users) elif isinstance(action, types.MessageActionChatDeleteUser): return cls.Event(msg, kicked_by=msg.from_id or True, users=action.user_id) elif isinstance(action, types.MessageActionChatCreate): return cls.Event(msg, users=action.users, created=True, new_title=action.title) elif isinstance(action, types.MessageActionChannelCreate): return cls.Event(msg, created=True, users=msg.from_id, new_title=action.title) elif isinstance(action, types.MessageActionChatEditTitle): return cls.Event(msg, users=msg.from_id, new_title=action.title) elif isinstance(action, types.MessageActionChatEditPhoto): return cls.Event(msg, users=msg.from_id, new_photo=action.photo) elif isinstance(action, types.MessageActionChatDeletePhoto): return cls.Event(msg, users=msg.from_id, new_photo=True) elif isinstance(action, types.MessageActionPinMessage): # Telegram always sends this service message for new pins return cls.Event(msg, users=msg.from_id, new_pin=msg.reply_to_msg_id) class Event(EventCommon): """ 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. unpin (`bool`): `True` if the existing pin gets unpinned. """ def __init__(self, where, new_pin=None, new_photo=None, added_by=None, kicked_by=None, created=None, users=None, new_title=None, unpin=None): if isinstance(where, types.MessageService): self.action_message = where where = where.to_id else: self.action_message = None super().__init__(chat_peer=where, msg_id=new_pin) self.new_pin = isinstance(new_pin, int) self._pinned_message = new_pin self.new_photo = new_photo is not None self.photo = \ new_photo if isinstance(new_photo, types.Photo) else None self._added_by = None self._kicked_by = None self.user_added = self.user_joined = self.user_left = \ self.user_kicked = self.unpin = False if added_by is True: self.user_joined = True elif added_by: self.user_added = True self._added_by = added_by # If `from_id` was not present (it's `True`) or the affected # user was "kicked by itself", then it left. Else it was kicked. if kicked_by is True or kicked_by == users: self.user_left = True elif kicked_by: self.user_kicked = True self._kicked_by = kicked_by self.created = bool(created) self._user_peers = users if isinstance(users, list) else [users] self._users = None self._input_users = None self.new_title = new_title self.unpin = unpin def _set_client(self, client): super()._set_client(client) if self.action_message: self.action_message._finish_init(client, self._entities, None) async def respond(self, *args, **kwargs): """ Responds to the chat action message (not as a reply). Shorthand for `telethon.client.messages.MessageMethods.send_message` with ``entity`` already set. """ return await self._client.send_message( await self.get_input_chat(), *args, **kwargs) async def reply(self, *args, **kwargs): """ 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. """ if not self.action_message: return await self.respond(*args, **kwargs) kwargs['reply_to'] = self.action_message.id return await self._client.send_message( await self.get_input_chat(), *args, **kwargs) async def delete(self, *args, **kwargs): """ 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. """ if not self.action_message: return return await self._client.delete_messages( await self.get_input_chat(), [self.action_message], *args, **kwargs ) async def get_pinned_message(self): """ If ``new_pin`` is `True`, this returns the `Message ` object that was pinned. """ if self._pinned_message == 0: return None if isinstance(self._pinned_message, int)\ and await self.get_input_chat(): r = await self._client(functions.channels.GetMessagesRequest( self._input_chat, [self._pinned_message] )) try: self._pinned_message = next( x for x in r.messages if isinstance(x, types.Message) and x.id == self._pinned_message ) except StopIteration: pass if isinstance(self._pinned_message, types.Message): return self._pinned_message @property def added_by(self): """ The user who added ``users``, if applicable (`None` otherwise). """ if self._added_by and not isinstance(self._added_by, types.User): aby = self._entities.get(utils.get_peer_id(self._added_by)) if aby: self._added_by = aby return self._added_by async def get_added_by(self): """ Returns `added_by` but will make an API call if necessary. """ if not self.added_by and self._added_by: self._added_by = await self._client.get_entity(self._added_by) return self._added_by @property def kicked_by(self): """ The user who kicked ``users``, if applicable (`None` otherwise). """ if self._kicked_by and not isinstance(self._kicked_by, types.User): kby = self._entities.get(utils.get_peer_id(self._kicked_by)) if kby: self._kicked_by = kby return self._kicked_by async def get_kicked_by(self): """ Returns `kicked_by` but will make an API call if necessary. """ if not self.kicked_by and self._kicked_by: self._kicked_by = await self._client.get_entity(self._kicked_by) return self._kicked_by @property def user(self): """ The first user that takes part in this action (e.g. joined). Might be `None` if the information can't be retrieved or there is no user taking part. """ if self.users: return self._users[0] async def get_user(self): """ Returns `user` but will make an API call if necessary. """ if self.users or await self.get_users(): return self._users[0] @property def input_user(self): """ Input version of the ``self.user`` property. """ if self.input_users: return self._input_users[0] async def get_input_user(self): """ Returns `input_user` but will make an API call if necessary. """ if self.input_users or await self.get_input_users(): return self._input_users[0] @property def user_id(self): """ Returns the marked signed ID of the first user, if any. """ if self._user_peers: return utils.get_peer_id(self._user_peers[0]) @property def users(self): """ A list of users that take part in this action (e.g. joined). Might be empty if the information can't be retrieved or there are no users taking part. """ if not self._user_peers: return [] if self._users is None: self._users = [ self._entities[utils.get_peer_id(peer)] for peer in self._user_peers if utils.get_peer_id(peer) in self._entities ] return self._users async def get_users(self): """ Returns `users` but will make an API call if necessary. """ if not self._user_peers: return [] if self._users is None or len(self._users) != len(self._user_peers): await self.action_message._reload_message() self._users = [ u for u in self.action_message.action_entities if isinstance(u, (types.User, types.UserEmpty))] return self._users @property def input_users(self): """ Input version of the ``self.users`` property. """ if self._input_users is None and self._user_peers: self._input_users = [] for peer in self._user_peers: try: self._input_users.append(self._client._entity_cache[peer]) except KeyError: pass return self._input_users or [] async def get_input_users(self): """ Returns `input_users` but will make an API call if necessary. """ self._input_users = None if self._input_users is None: await self.action_message._reload_message() self._input_users = [ utils.get_input_peer(u) for u in self.action_message.action_entities if isinstance(u, (types.User, types.UserEmpty))] return self._input_users or [] @property def user_ids(self): """ Returns the marked signed ID of the users, if any. """ if self._user_peers: return [utils.get_peer_id(u) for u in self._user_peers]