HTTP exceptions should allow easy access to response data.

Thanks to Stéphane Angel for the suggestion.

Refs ask#62.

Author: JNRowe

github2/request.py

@@ -3,6 +3,7 @@
 import re
 import time
 import httplib2
+from httplib import responses
 try:
     import json as simplejson  # For Python 2.6
 except ImportError:
@@ -41,6 +42,25 @@ class GithubError(Exception):
     """An error occured when making a request to the Github API."""
 
 
+class HttpError(RuntimeError):
+    """A HTTP error occured when making a request to the Github API."""
+    def __init__(self, message, content, code):
+        """Create a HttpError exception
+
+        :param str message: Exception string
+        :param str content: Full content of HTTP request
+        :param int code: HTTP status code
+        """
+        self.args = (message, content, code)
+        self.message = message
+        self.content = content
+        self.code = code
+        if code:
+            self.code_reason = responses[code]
+        else:
+            self.code_reason = ""
+
+
 class GithubRequest(object):
     github_url = GITHUB_URL
     url_format = "%(github_url)s/api/%(api_version)s/%(api_format)s"
@@ -143,8 +163,9 @@ def raw_request(self, url, extra_post_data, method="GET"):
             logging.debug("URL: %r POST_DATA: %r RESPONSE_TEXT: %r", url,
                           post_data, content)
         if response.status >= 400:
-            raise RuntimeError("unexpected response from github.com %d: %r" % (
-                               response.status, content))
+            raise HttpError("Unexpected response from github.com %d: %r"
+                            % (response.status, content), content,
+                            response.status)
         json = simplejson.loads(content.decode(charset_from_headers(response)))
         if json.get("error"):
             raise self.GithubError(json["error"][0]["error"])