Add support for project runners

This API allows to enable/disable specific runners for a project, and to
list the project associated runners.

Fix #205

1 files changed, 38 insertions, 4 deletions

diff --git a/docs/gl_objects/runners.rst b/docs/gl_objects/runners.rst
index 2f7e599..02db9be 100644
--- a/docs/gl_objects/runners.rst
+++ b/docs/gl_objects/runners.rst
@@ -2,11 +2,17 @@
 Runners
 #######
 
-Global runners
-==============
+Runners are external process used to run CI jobs. They are deployed by the
+administrator and registered to the GitLab instance.
 
-Use :class:`~gitlab.objects.Runner` objects to manipulate runners. The
-:attr:`gitlab.Gitlab.runners` manager object provides helper functions.
+Shared runners are available for all projects. Specific runners are enabled for
+a list of projects.
+
+Global runners (admin)
+======================
+
+* Object class: :class:`~gitlab.objects.Runner`
+* Manager objects: :attr:`gitlab.Gitlab.runners`
 
 Examples
 --------
@@ -48,3 +54,31 @@ Remove a runner:
 .. literalinclude:: runners.py
    :start-after: # delete
    :end-before: # end delete
+
+Project runners
+===============
+
+* Object class: :class:`~gitlab.objects.ProjectRunner`
+* Manager objects: :attr:`gitlab.Gitlab.runners`,
+  :attr:`gitlab.Gitlab.Project.runners`
+
+Examples
+--------
+
+List the runners for a project:
+
+.. literalinclude:: runners.py
+   :start-after: # project list
+   :end-before: # end project list
+
+Enable a specific runner for a project:
+
+.. literalinclude:: runners.py
+   :start-after: # project enable
+   :end-before: # end project enable
+
+Disable a specific runner for a project:
+
+.. literalinclude:: runners.py
+   :start-after: # project disable
+   :end-before: # end project disable