You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
103 lines
3.3 KiB
103 lines
3.3 KiB
# -*- coding: utf-8 -*-
|
|
|
|
"""
|
|
The MIT License (MIT)
|
|
|
|
Copyright (c) 2015-2016 Rapptz
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a
|
|
copy of this software and associated documentation files (the "Software"),
|
|
to deal in the Software without restriction, including without limitation
|
|
the rights to use, copy, modify, merge, publish, distribute, sublicense,
|
|
and/or sell copies of the Software, and to permit persons to whom the
|
|
Software is furnished to do so, subject to the following conditions:
|
|
|
|
The above copyright notice and this permission notice shall be included in
|
|
all copies or substantial portions of the Software.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
|
|
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
|
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
|
|
DEALINGS IN THE SOFTWARE.
|
|
"""
|
|
|
|
class DiscordException(Exception):
|
|
"""Base exception class for discord.py
|
|
|
|
Ideally speaking, this could be caught to handle any exceptions thrown from this library.
|
|
"""
|
|
pass
|
|
|
|
class ClientException(DiscordException):
|
|
"""Exception that's thrown when an operation in the :class:`Client` fails.
|
|
|
|
These are usually for exceptions that happened due to user input.
|
|
"""
|
|
pass
|
|
|
|
class GatewayNotFound(DiscordException):
|
|
"""An exception that is usually thrown when the gateway hub
|
|
for the :class:`Client` websocket is not found."""
|
|
def __init__(self):
|
|
message = 'The gateway to connect to discord was not found.'
|
|
super(GatewayNotFound, self).__init__(message)
|
|
|
|
class HTTPException(DiscordException):
|
|
"""Exception that's thrown when an HTTP request operation fails.
|
|
|
|
.. attribute:: response
|
|
|
|
The response of the failed HTTP request. This is an
|
|
instance of `aiohttp.ClientResponse`__.
|
|
|
|
__ http://aiohttp.readthedocs.org/en/stable/client_reference.html#aiohttp.ClientResponse
|
|
|
|
.. attribute:: text
|
|
|
|
The text of the response if it wasn't JSON. Could be None.
|
|
"""
|
|
|
|
def __init__(self, response, message=None, text=None):
|
|
self.response = response
|
|
self.text = text
|
|
|
|
fmt = '{0.reason} (status code: {0.status})'
|
|
if message:
|
|
fmt = fmt + ': {1}'
|
|
|
|
super().__init__(fmt.format(self.response, message))
|
|
|
|
class Forbidden(HTTPException):
|
|
"""Exception that's thrown for when status code 403 occurs.
|
|
|
|
Subclass of :exc:`HTTPException`
|
|
"""
|
|
pass
|
|
|
|
class NotFound(HTTPException):
|
|
"""Exception that's thrown for when status code 404 occurs.
|
|
|
|
Subclass of :exc:`HTTPException`
|
|
"""
|
|
pass
|
|
|
|
|
|
class InvalidArgument(ClientException):
|
|
"""Exception that's thrown when an argument to a function
|
|
is invalid some way (e.g. wrong value or wrong type).
|
|
|
|
This could be considered the analogous of ``ValueError`` and
|
|
``TypeError`` except derived from :exc:`ClientException` and thus
|
|
:exc:`DiscordException`.
|
|
"""
|
|
pass
|
|
|
|
class LoginFailure(ClientException):
|
|
"""Exception that's thrown when the :meth:`Client.login` function
|
|
fails to log you in from improper credentials or some other misc.
|
|
failure.
|
|
"""
|
|
pass
|
|
|