Implement runners global API

2 files changed, 31 insertions, 0 deletions

diff --git a/gitlab/__init__.py b/gitlab/__init__.py
index 3875cc8..41ba4df 100644
--- a/gitlab/__init__.py
+++ b/gitlab/__init__.py
@@ -109,6 +109,7 @@ class Gitlab(object):
             snippets
         user_projects (UserProjectManager): Manager for GitLab projects users
         projects (ProjectManager): Manager for GitLab projects
+        runners (RunnerManager): Manager for the CI runners
         settings (ApplicationSettingsManager): manager for the Gitlab settings
         team_members (TeamMemberManager): Manager for GitLab teams members
         team_projects (TeamProjectManager): Manager for GitLab teams projects
@@ -169,6 +170,7 @@ class Gitlab(object):
         self.project_snippets = ProjectSnippetManager(self)
         self.user_projects = UserProjectManager(self)
         self.projects = ProjectManager(self)
+        self.runners = RunnerManager(self)
         self.team_members = TeamMemberManager(self)
         self.team_projects = TeamProjectManager(self)
         self.teams = TeamManager(self)
diff --git a/gitlab/objects.py b/gitlab/objects.py
index dba54f0..a760a16 100644
--- a/gitlab/objects.py
+++ b/gitlab/objects.py
@@ -1965,6 +1965,35 @@ class Project(GitlabObject):
         raise_error_from_response(r, GitlabCreateError, 201)
 
 
+class Runner(GitlabObject):
+    _url = '/runners'
+    canCreate = False
+    optionalUpdateAttrs = ['description', 'active', 'tag_list']
+
+
+class RunnerManager(BaseManager):
+    obj_cls = Runner
+
+    def all(self, scope=None, **kwargs):
+        """List all the runners.
+
+        Args:
+            scope (str): The scope of runners to show, one of: specific,
+                shared, active, paused, online
+
+        Returns:
+            list(Runner): a list of runners matching the scope.
+
+        Raises:
+            GitlabConnectionError: If the server cannot be reached.
+            GitlabListError; If the resource cannot be found
+        """
+        url = '/runners/all'
+        if scope is not None:
+            url += '?scope=' + scope
+        return self.gitlab._raw_list(url, self.obj_cls, **kwargs)
+
+
 class TeamMember(GitlabObject):
     _url = '/user_teams/%(team_id)s/members'
     canUpdate = False