Separate, update, and improve exceptions documentation

Automatically use docstrings for documentation

diff --git a/docs/api.rst b/docs/api.rst
index f724d9430b8193c844fd3cf91bf19de67946cca5..e28d0a42b94eba0a637aa21936ed3ae72314149a 100644 (file)
--- a/docs/api.rst
+++ b/docs/api.rst
@@ -281,35 +281,6 @@ Get app rate limit status
 .. automethod:: API.rate_limit_status
 
 
-:mod:`tweepy.error` --- Exceptions
-==================================
-
-The exceptions are available in the ``tweepy`` module directly, which means
-``tweepy.error`` itself does not need to be imported. For example,
-``tweepy.error.TweepError`` is available as ``tweepy.TweepError``.
-
-
-.. exception:: TweepError
-
-   The main exception Tweepy uses. Is raised for a number of things.
-
-   When a ``TweepError`` is raised due to an error Twitter responded with,
-   the error code (`as described in the API documentation
-   <https://developer.twitter.com/en/docs/basics/response-codes>`_) can be
-   accessed at ``TweepError.response.text``. Note, however, that
-   ``TweepError``\ s also may be raised with other things as message
-   (for example plain error reason strings).
-
-
-.. exception:: RateLimitError
-
-   Is raised when an API method fails due to hitting Twitter's rate limit.
-   Makes for easy handling of the rate limit specifically.
-
-   Inherits from :exc:`TweepError`, so ``except TweepError`` will catch a
-   ``RateLimitError`` too.
-
-
 .. rubric:: Footnotes
 
 .. [#] https://web.archive.org/web/20170829051949/https://dev.twitter.com/rest/reference/get/search/tweets

diff --git a/docs/exceptions.rst b/docs/exceptions.rst
new file mode 100644 (file)
index 0000000..09bf4ff
--- /dev/null
+++ b/docs/exceptions.rst
@@ -0,0 +1,30 @@
+.. _exceptions:
+
+.. currentmodule:: tweepy
+
+**********
+Exceptions
+**********
+
+.. autoexception:: TweepyException
+
+.. autoexception:: HTTPException
+   :show-inheritance:
+
+.. autoexception:: BadRequest
+   :show-inheritance:
+
+.. autoexception:: Unauthorized
+   :show-inheritance:
+
+.. autoexception:: Forbidden
+   :show-inheritance:
+
+.. autoexception:: NotFound
+   :show-inheritance:
+
+.. autoexception:: TooManyRequests
+   :show-inheritance:
+
+.. autoexception:: TwitterServerError
+   :show-inheritance:

diff --git a/docs/index.rst b/docs/index.rst
index c669799acf2d1db3c215b425887dea8c4743f734..1454693a20e521ceb4aef5632979b9561a3efb90 100644 (file)
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -19,6 +19,7 @@ Contents:
    extended_tweets.rst
    streaming_how_to.rst
    api.rst
+   exceptions.rst
    running_tests.rst
 
 Indices and tables