Add some exapmles of using the issues API.

sigmavirus24 · sigmavirus24 · commit 4c58f572c4ee · 2012-09-29T17:42:52.000-04:00
diff --git a/docs/examples/issue.rst b/docs/examples/issue.rst
@@ -1,7 +1,7 @@
 Issue Code Examples
 ===================
 
-Examples using :class:`Issue <github3.issue.Issue>`\ s
+Examples using ``Issue``\ s
 
 Administrating Issues
 ---------------------
@@ -26,3 +26,14 @@ of the issue you're concerned with in ``num``.
     # Assuming issue is the same as above ...
     issue.create_comment('This should be fixed in 6d4oe5. Closing as fixed.')
     issue.close()
+
+The following shows how you could use github3.py to fetch and display your
+issues in your own style and in your webbrowser.
+
+.. include:: source/browser.py
+    :code: python
+
+Or how to do the same by wrapping the lines in your terminal.
+
+.. include:: source/wrap_text.py
+    :code: python
diff --git a/docs/examples/source/browser.py b/docs/examples/source/browser.py
@@ -0,0 +1,11 @@
+import webbrowser
+import tempfile
+import github3
+
+template = """<html><head></head><body>{0}</body></html>"""
+
+i = github3.issue('kennethreitz', 'requests', 868)
+
+with tempfile.NamedTemporaryFile() as tmpfd:
+    tmpfd.write(template.format(i.body_html))
+    webbrowser.open('file://' + tmpfd.name)
diff --git a/docs/examples/source/wrap_text.py b/docs/examples/source/wrap_text.py
@@ -0,0 +1,6 @@
+import github3
+import textwrap
+
+i = github3.issue('kennethreitz', 'requests', 868)
+for line in textwrap.wrap(i.body_text, 78, replace_whitespace=False):
+    print line
