Browse Source

Use "raised" instead of "thrown" for exception documentation

pull/7160/head
Rapptz 4 years ago
parent
commit
0fae0b4995
  1. 25
      discord/errors.py

25
discord/errors.py

@ -42,25 +42,24 @@ __all__ = (
class DiscordException(Exception): class DiscordException(Exception):
"""Base exception class for discord.py """Base exception class for discord.py
Ideally speaking, this could be caught to handle any exceptions thrown from this library. Ideally speaking, this could be caught to handle any exceptions raised from this library.
""" """
pass pass
class ClientException(DiscordException): class ClientException(DiscordException):
"""Exception that's thrown when an operation in the :class:`Client` fails. """Exception that's raised when an operation in the :class:`Client` fails.
These are usually for exceptions that happened due to user input. These are usually for exceptions that happened due to user input.
""" """
pass pass
class NoMoreItems(DiscordException): class NoMoreItems(DiscordException):
"""Exception that is thrown when an async iteration operation has no more """Exception that is raised when an async iteration operation has no more
items.""" items."""
pass pass
class GatewayNotFound(DiscordException): class GatewayNotFound(DiscordException):
"""An exception that is usually thrown when the gateway hub """An exception that is raised when the gateway for Discord could not be found"""
for the :class:`Client` websocket is not found."""
def __init__(self): def __init__(self):
message = 'The gateway to connect to discord was not found.' message = 'The gateway to connect to discord was not found.'
super().__init__(message) super().__init__(message)
@ -83,7 +82,7 @@ def flatten_error_dict(d, key=''):
return dict(items) return dict(items)
class HTTPException(DiscordException): class HTTPException(DiscordException):
"""Exception that's thrown when an HTTP request operation fails. """Exception that's raised when an HTTP request operation fails.
Attributes Attributes
------------ ------------
@ -124,21 +123,21 @@ class HTTPException(DiscordException):
super().__init__(fmt.format(self.response, self.code, self.text)) super().__init__(fmt.format(self.response, self.code, self.text))
class Forbidden(HTTPException): class Forbidden(HTTPException):
"""Exception that's thrown for when status code 403 occurs. """Exception that's raised for when status code 403 occurs.
Subclass of :exc:`HTTPException` Subclass of :exc:`HTTPException`
""" """
pass pass
class NotFound(HTTPException): class NotFound(HTTPException):
"""Exception that's thrown for when status code 404 occurs. """Exception that's raised for when status code 404 occurs.
Subclass of :exc:`HTTPException` Subclass of :exc:`HTTPException`
""" """
pass pass
class DiscordServerError(HTTPException): class DiscordServerError(HTTPException):
"""Exception that's thrown for when a 500 range status code occurs. """Exception that's raised for when a 500 range status code occurs.
Subclass of :exc:`HTTPException`. Subclass of :exc:`HTTPException`.
@ -153,7 +152,7 @@ class InvalidData(ClientException):
pass pass
class InvalidArgument(ClientException): class InvalidArgument(ClientException):
"""Exception that's thrown when an argument to a function """Exception that's raised when an argument to a function
is invalid some way (e.g. wrong value or wrong type). is invalid some way (e.g. wrong value or wrong type).
This could be considered the analogous of ``ValueError`` and This could be considered the analogous of ``ValueError`` and
@ -163,14 +162,14 @@ class InvalidArgument(ClientException):
pass pass
class LoginFailure(ClientException): class LoginFailure(ClientException):
"""Exception that's thrown when the :meth:`Client.login` function """Exception that's raised when the :meth:`Client.login` function
fails to log you in from improper credentials or some other misc. fails to log you in from improper credentials or some other misc.
failure. failure.
""" """
pass pass
class ConnectionClosed(ClientException): class ConnectionClosed(ClientException):
"""Exception that's thrown when the gateway connection is """Exception that's raised when the gateway connection is
closed for reasons that could not be handled internally. closed for reasons that could not be handled internally.
Attributes Attributes
@ -192,7 +191,7 @@ class ConnectionClosed(ClientException):
super().__init__(f'Shard ID {self.shard_id} WebSocket closed with {self.code}') super().__init__(f'Shard ID {self.shard_id} WebSocket closed with {self.code}')
class PrivilegedIntentsRequired(ClientException): class PrivilegedIntentsRequired(ClientException):
"""Exception that's thrown when the gateway is requesting privileged intents """Exception that's raised when the gateway is requesting privileged intents
but they're not ticked in the developer page yet. but they're not ticked in the developer page yet.
Go to https://discord.com/developers/applications/ and enable the intents Go to https://discord.com/developers/applications/ and enable the intents

Loading…
Cancel
Save