Merge branch 'laromicas-migration-repository' into master

gitea/__init__.py

@@ -16,6 +16,7 @@ from .apiobject import (
     Commit,
     Comment,
     Content,
+    MigrationServices,
 )
 
 __all__ = [

gitea/apiobject.py

@@ -334,6 +334,7 @@ class Branch(ReadonlyApiObject):
 
 class Repository(ApiObject):
     API_OBJECT = """/repos/{owner}/{name}"""  # <owner>, <reponame>
+    REPO_MIGRATE = """/repos/migrate"""
     REPO_IS_COLLABORATOR = (
         """/repos/%s/%s/collaborators/%s"""  # <owner>, <reponame>, <username>
     )
@@ -564,7 +565,7 @@ class Repository(ApiObject):
         self.gitea.requests_post(url, data=data)
         # TODO: make sure this instance is either updated or discarded
 
-    def get_git_content(self: str = None, commit: "Commit" = None) -> List["Content"]:
+    def get_git_content(self, commit: "Commit" = None) -> List["Content"]:
         """https://try.gitea.io/api/swagger#/repository/repoGetContentsList"""
         url = f"/repos/{self.owner.username}/{self.name}/contents"
         data = {"ref": commit.sha} if commit else {}
@@ -612,6 +613,71 @@ class Repository(ApiObject):
         )
         self.deleted = True
 
+    @classmethod
+    def migrate_repo(
+        cls,
+        gitea: "Gitea",
+        service: str,
+        clone_addr: str,
+        repo_name: str,
+        description: str = "",
+        private: bool = False,
+        auth_token: str = None,
+        auth_username: str = None,
+        auth_password: str = None,
+        mirror: bool = False,
+        mirror_interval: str = None,
+        lfs: bool = False,
+        lfs_endpoint: str = "",
+        wiki: bool = False,
+        labels: bool = False,
+        issues: bool = False,
+        pull_requests: bool = False,
+        releases: bool = False,
+        milestones: bool = False,
+        repo_owner: str = None,
+    ):
+        """Migrate a Repository from another service.
+
+        Throws:
+            AlreadyExistsException: If the Repository exists already.
+            Exception: If something else went wrong.
+        """
+        result = gitea.requests_post(
+            cls.REPO_MIGRATE,
+            data={
+                "auth_password": auth_password,
+                "auth_token": auth_token,
+                "auth_username": auth_username,
+                "clone_addr": clone_addr,
+                "description": description,
+                "issues": issues,
+                "labels": labels,
+                "lfs": lfs,
+                "lfs_endpoint": lfs_endpoint,
+                "milestones": milestones,
+                "mirror": mirror,
+                "mirror_interval": mirror_interval,
+                "private": private,
+                "pull_requests": pull_requests,
+                "releases": releases,
+                "repo_name": repo_name,
+                "repo_owner": repo_owner,
+                "service": service,
+                "wiki": wiki,
+            },
+        )
+        if "id" in result:
+            gitea.logger.info(
+                "Successfully created Job to Migrate Repository %s " % result["name"]
+            )
+        else:
+            gitea.logger.error(result["message"])
+            raise Exception(
+                "Repository not Migrated... (gitea: %s)" % result["message"]
+            )
+        return Repository.parse_response(gitea, result)
+
 
 class Milestone(ApiObject):
     API_OBJECT = """/repos/{owner}/{repo}/milestones/{number}"""  # <owner, repo>
@@ -904,3 +970,14 @@ class Util:
             return datetime.strptime(time[:-3] + "00", "%Y-%m-%dT%H:%M:%S%z")
         except ValueError:
             return datetime.strptime(time[:-3] + "00", "%Y-%m-%dT%H:%M:%S")
+
+
+class MigrationServices:
+    GIT = "1"
+    GITHUB = "2"
+    GITEA = "3"
+    GITLAB = "4"
+    GOGS = "5"
+    ONEDEV = "6"
+    GITBUCKET = "7"
+    CODEBASE = "8"

tests/test_api.py

@@ -3,7 +3,16 @@ import base64
 import pytest
 import uuid
 
-from gitea import Gitea, User, Organization, Team, Repository, Issue, Milestone
+from gitea import (
+    Gitea,
+    User,
+    Organization,
+    Team,
+    Repository,
+    Issue,
+    Milestone,
+    MigrationServices,
+)
 from gitea import NotFoundException, AlreadyExistsException
 
 
@@ -422,3 +431,37 @@ def test_delete_user(instance):
     user.delete()
     with pytest.raises(NotFoundException) as e:
         User.request(instance, user_name)
+
+
+def test_migrate_repo_gitea(instance):
+    repo = Repository.migrate_repo(
+        instance,
+        MigrationServices.GITEA,
+        "https://gitea.com/gitea/awesome-gitea.git",
+        test_repo,
+        "user owned repo",
+    )
+    assert repo.name == test_repo
+    assert repo.description == "user owned repo"
+    assert not repo.private
+    assert repo.owner.username == "test"
+    assert "README.md" in [f.name for f in repo.get_git_content()]
+    repo = Repository.request(instance, "test", test_repo)
+    repo.delete()
+
+
+def test_migrate_repo_github(instance):
+    repo = Repository.migrate_repo(
+        instance,
+        MigrationServices.GITHUB,
+        "https://github.com/Langenfeld/py-gitea",
+        test_repo,
+        "cloning py-gitea to test py-gitea",
+    )
+    assert repo.name == test_repo
+    assert repo.description == "cloning py-gitea to test py-gitea"
+    assert not repo.private
+    assert repo.owner.username == "test"
+    assert "README.md" in [f.name for f in repo.get_git_content()]
+    repo = Repository.request(instance, "test", test_repo)
+    repo.delete()