feat(api): Add support for new runner creation API

lgatellier · JohnVillalovos · commit 69ed79840e3b · 2023-08-18T23:20:25.000-07:00
diff --git a/gitlab/client.py b/gitlab/client.py
@@ -189,6 +189,8 @@ def __init__(
         """See :class:`~gitlab.v4.objects.PagesDomainManager`"""
         self.user_activities = objects.UserActivitiesManager(self)
         """See :class:`~gitlab.v4.objects.UserActivitiesManager`"""
+        self.user_runners = objects.UserRunnerManager(self)
+        """See :class:`~gitlab.v4.objects.UserRunnerManager`"""
         self.applications = objects.ApplicationManager(self)
         """See :class:`~gitlab.v4.objects.ApplicationManager`"""
         self.variables = objects.VariableManager(self)
diff --git a/gitlab/v4/objects/users.py b/gitlab/v4/objects/users.py
@@ -63,6 +63,8 @@
     "UserMembershipManager",
     "UserProject",
     "UserProjectManager",
+    "UserRunner",
+    "UserRunnerManager",
 ]
 
 
@@ -678,3 +680,28 @@ class UserFollowingManager(ListMixin, RESTManager):
     _path = "/users/{user_id}/following"
     _obj_cls = User
     _from_parent_attrs = {"user_id": "id"}
+
+
+class UserRunner(RESTObject):
+    pass
+
+
+class UserRunnerManager(CreateMixin, RESTManager):
+    _path = "/user/runners"
+    _obj_cls = UserRunner
+    _types = {"tag_list": types.CommaSeparatedListAttribute}
+    _create_attrs = RequiredOptional(
+        required=("runner_type",),
+        optional=(
+            "group_id",
+            "project_id",
+            "description",
+            "paused",
+            "locked",
+            "run_untagged",
+            "tag_list",
+            "access_level",
+            "maximum_timeout",
+            "maintenance_note",
+        ),
+    )
diff --git a/tests/unit/objects/test_runners.py b/tests/unit/objects/test_runners.py
@@ -258,6 +258,12 @@ def test_create_runner(gl: gitlab.Gitlab, resp_runner_register):
     assert runner.token == "6337ff461c94fd3fa32ba3b1ff4125"
 
 
+def test_create_user_runner(gl: gitlab.Gitlab, resp_runner_register):
+    runner = gl.user_runners.create({"runner_type": "instance_type"})
+    assert runner.id == "6"
+    assert runner.token == "6337ff461c94fd3fa32ba3b1ff4125"
+
+
 def test_get_update_runner(gl: gitlab.Gitlab, resp_runner_detail):
     runner = gl.runners.get(6)
     assert runner.active is True
