Update doc-strings and replace use of None for Comparisons

sigmavirus24 · sigmavirus24 · commit 97c262ce52f6 · 2014-11-23T21:03:20.000-06:00
diff --git a/github3/repos/comparison.py b/github3/repos/comparison.py
@@ -64,13 +64,21 @@ def _repr(self):
         return '<Comparison of {0} commits>'.format(self.total_commits)
 
     def diff(self):
-        """Return the diff"""
+        """Retrieve the diff for this comparison.
+
+        :returns: the diff as a bytes object
+        :rtype: bytes
+        """
         resp = self._get(self._api,
                          headers={'Accept': 'application/vnd.github.diff'})
-        return resp.content if self._boolean(resp, 200, 404) else None
+        return resp.content if self._boolean(resp, 200, 404) else b''
 
     def patch(self):
-        """Return the patch"""
+        """Retrieve the patch formatted diff for this commit.
+
+        :returns: the patch as a bytes object
+        :rtype: bytes
+        """
         resp = self._get(self._api,
                          headers={'Accept': 'application/vnd.github.patch'})
-        return resp.content if self._boolean(resp, 200, 404) else None
+        return resp.content if self._boolean(resp, 200, 404) else b''
