aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/gists.rst37
-rw-r--r--docs/services.rst1
2 files changed, 38 insertions, 0 deletions
diff --git a/docs/gists.rst b/docs/gists.rst
new file mode 100644
index 0000000..3b2915f
--- /dev/null
+++ b/docs/gists.rst
@@ -0,0 +1,37 @@
+.. _Gists service:
+
+Gists services
+===============
+
+**Fast sample**::
+
+ from pygithub3 import Github
+
+ auth = dict(login='octocat', password='pass')
+ gh = Github(**auth)
+
+ octocat_gists = gh.gists.list()
+ the_first_gist = gh.gists.get(1)
+
+ the_first_gist_comments = gh.gists.comments.list(1)
+
+Gist
+-----
+
+.. autoclass:: pygithub3.services.gists.Gist
+ :members:
+
+ .. attribute:: comments
+
+ :ref:`Comments service`
+
+.. _Comments service:
+
+Comments
+----------
+
+.. autoclass:: pygithub3.services.gists.Comments
+ :members:
+
+.. _github gists doc: http://developer.github.com/v3/gists
+.. _github comments doc: http://developer.github.com/v3/gists/comments
diff --git a/docs/services.rst b/docs/services.rst
index a0fd894..e686a6e 100644
--- a/docs/services.rst
+++ b/docs/services.rst
@@ -61,5 +61,6 @@ List of services
users
repos
+ gists
.. _mimetypes: http://developer.github.com/v3/mime