Upgrade requests exceptions to AnymailRequestsAPIError

Catch and re-raise requests.RequestException in
AnymailRequestsBackend.post_to_esp.

* AnymailRequestsAPIError is needed for proper
  fail_silently handling.
* Retain original requests exception type, to avoid
  breaking existing code that might look for specific
  requests exceptions.

Closes #16

anymail/backends/base_requests.py

@@ -65,7 +65,15 @@ class AnymailRequestsBackend(AnymailBaseBackend):
         Can raise AnymailRequestsAPIError for HTTP errors in the post
         """
         params = payload.get_request_params(self.api_url)
-        response = self.session.request(**params)
+        try:
+            response = self.session.request(**params)
+        except requests.RequestException as err:
+            # raise an exception that is both AnymailRequestsAPIError
+            # and the original requests exception type
+            exc_class = type('AnymailRequestsAPIError', (AnymailRequestsAPIError, type(err)), {})
+            raise exc_class(
+                "Error posting to %s:" % params.get('url', '<missing url>'),
+                raised_from=err, email_message=message, payload=payload)
         self.raise_for_status(response, payload, message)
         return response
 

anymail/exceptions.py

@@ -1,4 +1,5 @@
 import json
+from traceback import format_exception_only
 
 from django.core.exceptions import ImproperlyConfigured, SuspiciousOperation
 from requests import HTTPError
@@ -18,11 +19,13 @@ class AnymailError(Exception):
           status_code: HTTP status code of response to ESP send call
           payload: data arg (*not* json-stringified) for the ESP send call
           response: requests.Response from the send call
+          raised_from: original/wrapped Exception
         """
         self.backend = kwargs.pop('backend', None)
         self.email_message = kwargs.pop('email_message', None)
         self.payload = kwargs.pop('payload', None)
         self.status_code = kwargs.pop('status_code', None)
+        self.raised_from = kwargs.pop('raised_from', None)
         if isinstance(self, HTTPError):
             # must leave response in kwargs for HTTPError
             self.response = kwargs.get('response', None)
@@ -33,6 +36,7 @@ class AnymailError(Exception):
     def __str__(self):
         parts = [
             " ".join([str(arg) for arg in self.args]),
+            self.describe_raised_from(),
             self.describe_send(),
             self.describe_response(),
         ]
@@ -68,6 +72,12 @@ class AnymailError(Exception):
                 pass
         return description
 
+    def describe_raised_from(self):
+        """Return the original exception"""
+        if self.raised_from is None:
+            return None
+        return ''.join(format_exception_only(type(self.raised_from), self.raised_from)).strip()
+
 
 class AnymailAPIError(AnymailError):
     """Exception for unsuccessful response from ESP's API."""