Add support for Groups API method transfer_group.

sattlerc · sattlerc · commit 80101d478c1d · 2022-01-05T18:29:11.000+01:00
diff --git a/gitlab/exceptions.py b/gitlab/exceptions.py
@@ -107,6 +107,10 @@ class GitlabTransferProjectError(GitlabOperationError):
     pass
 
 
+class GitlabTransferGroupError(GitlabOperationError):
+    pass
+
+
 class GitlabProjectDeployKeyError(GitlabOperationError):
     pass
 
diff --git a/gitlab/v4/objects/groups.py b/gitlab/v4/objects/groups.py
@@ -93,6 +93,30 @@ def transfer_project(self, project_id: int, **kwargs: Any) -> None:
         path = f"/groups/{self.id}/projects/{project_id}"
         self.manager.gitlab.http_post(path, **kwargs)
 
+    @cli.register_custom_action("Group", tuple(), ("group_id",))
+    @exc.on_http_error(exc.GitlabTransferProjectError)
+    def transfer_group(self, group_id: Optional[int] = None, **kwargs: Any) -> None:
+        """Transfer a project to this group.
+
+        Requires GitLab ≥14.6.
+
+        Args:
+            group_id: ID of the new parent group. When not specified,
+                the group to transfer is instead turned into a top-level group.
+            **kwargs: Extra options to send to the server (e.g. sudo)
+
+        Raises:
+            GitlabAuthenticationError: If authentication is not correct
+            GitlabTransferProjectError: If the group could not be transferred
+        """
+        path = f"/groups/{self.id}/transfer"
+
+        def data():
+            if group_id is not None:
+                yield ("group_id", group_id)
+
+        self.manager.gitlab.http_post(path, post_data=dict(data()), **kwargs)
+
     @cli.register_custom_action("Group", ("scope", "search"))
     @exc.on_http_error(exc.GitlabSearchError)
     def search(
