diff options
| -rw-r--r-- | discord/client.py | 42 |
1 files changed, 42 insertions, 0 deletions
diff --git a/discord/client.py b/discord/client.py index f56f84bf..b90bb813 100644 --- a/discord/client.py +++ b/discord/client.py @@ -978,6 +978,48 @@ class Client: yield from response.release() @asyncio.coroutine + def delete_messages(self, messages): + """|coro| + + Deletes a list of messages. This is similar to :func:`delete_message` + except it bulk deletes multiple messages. + + The channel to check where the message is deleted from is handled via + the first element of the iterable's ``.channel.id`` attributes. If the + channel is not consistent throughout the entire sequence, then an + :exc:`HTTPException` will be raised. + + Parameters + ----------- + messages : iterable of :class:`Message` + An iterable of messages denoting which ones to bulk delete. + + Raises + ------ + ClientException + The number of messages to delete is less than 2 or more than 100. + Forbidden + You do not have proper permissions to delete the messages. + HTTPException + Deleting the messages failed. + """ + + messages = list(messages) + if len(messages) > 100 or len(messages) < 2: + raise ClientException('Can only delete messages in the range of [2, 100]') + + channel_id = messages[0].channel.id + url = '{0}/{1}/messages/bulk_delete'.format(endpoints.CHANNELS, channel_id) + payload = { + 'messages': [m.id for m in messages] + } + + response = yield from self.session.post(url, headers=self.headers, data=utils.to_json(payload)) + log.debug(request_logging_format.format(method='POST', response=response)) + yield from utils._verify_successful_response(response) + yield from response.release() + + @asyncio.coroutine def edit_message(self, message, new_content): """|coro| |