Merge pull request #1275 from laymonage/base-vwsexception

Create base VWSException for erroneous responses from VWS

Author: adamtheturtle

docs/source/conf.py

@@ -97,6 +97,7 @@ def _custom_warning_handler(msg: str, *args: Iterable, **kwargs: Dict) -> None:
     # Requests documentation exposes ``requests.Response``, not
     # ``requests.models.response``.
     ('py:class', 'requests.models.Response'),
+    ('py:class', 'requests.exceptions.ConnectionError'),
 ]
 
 html_show_copyright = False

docs/source/exceptions.rst

@@ -3,3 +3,6 @@ Exceptions
 
 .. automodule:: vws.exceptions
    :members:
+   :show-inheritance:
+   :inherited-members: Exception
+   :exclude-members: errno, filename, filename2, strerror

src/vws/_result_codes.py

@@ -49,7 +49,7 @@ def raise_for_result_code(
         result_code = response.json()['result_code']
     except json.decoder.JSONDecodeError as exc:
         assert 'Oops' in response.text
-        raise UnknownVWSErrorPossiblyBadName() from exc
+        raise UnknownVWSErrorPossiblyBadName(response=response) from exc
 
     if result_code == expected_result_code:
         return