# Gigrator

**Repository Path**: ankit20sep/Gigrator

## Basic Information

- **Project Name**: Gigrator
- **Description**: Git代码仓批量迁移，支持GitHub、Gitee、GitLab、Gitea、Coding、Gogs
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://gigrator.com
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 29
- **Created**: 2021-01-06
- **Last Updated**: 2021-08-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Gigrator


Git code warehouse batch migration

## Start

```shell script
git clone git@gitee.com:ankit20sep/Gigrator.git
cd Gigrator
pip3 install -r requirements.txt

# SOURCE_GIT and DEST_GIT need to be configured in the configuration file (settings.py) before migration 
# Configuration reference: settings_example.py
 python3 gigrator.py

```

## Develop

```python
# Base class
class Git:
    pass


# Other GitServer class should inherit Git
class OtherGit(Git):
    pass

```

## Support

* [x] [Gitee](https://gitee.com/)
* [x] [GitLab](https://gitlab.com/)
* [x] [GitHub](https://github.com/)
* [x] [Gitea](https://gitea.io/zh-cn/)
* [x] [Coding](https://coding.net/)
* [x] [Gogs](https://gogs.io/)
* [ ] [Bitbucket](https://bitbucket.org/)

Note:



- 1. Does not support the migration to Coding, from Coding can be migrated to other Gitservers
- 1. Because of Codingthe upgrade, its foundation APIis no longer https://coding.net, and read:https://{username}.coding.net
- 1. Please confirm that it has been added on the Git server before migration SSH Key
- 1. Only the warehouses under the specified users can be migrated, that is {username}/{repo_name}, excluding participating or organized warehouses
- 1. The migration includes commits, branches and tags, but does not include issues, pr and wiki



## Environment

* Git
* Python

Development environment: git version 2.20.1 (Apple Git-117)+Python 3.7.2

## Dependencies

* [Requests](https://2.python-requests.org/en/master/)

## References

### GitLab

* [GitLab API Docs](https://docs.gitlab.com/ee/api/)
* [GitLab Create Repo](https://docs.gitlab.com/ee/api/projects.html#create-project)
* [Project visibility level](https://docs.gitlab.com/ee/api/projects.html#project-visibility-level)

## [GitLab GraphQL API](https://docs.gitlab.com/ee/api/graphql/)

Can not create a project!

It will co-exist with the current v4 REST API. If we have a v5 API, this should be a compatibility layer on top of GraphQL.

* [Introduction to GraphQL](https://developer.github.com/v4/guides/intro-to-graphql/)
* [GraphQL API Resources](https://docs.gitlab.com/ee/api/graphql/reference/index.html)

### [GitHub REST API v3](https://developer.github.com/v3/)

* [GitHub Create Repo](https://developer.github.com/v3/repos/#create)
* [GitHub Personal Access Token](https://github.com/settings/tokens)

## [GitHub GraphQL API v4](https://developer.github.com/v4/)

* [GraphQL resource limitations](https://developer.github.com/v4/guides/resource-limitations/)
* [Forming Calls with GraphQL](https://developer.github.com/v4/guides/forming-calls/)


### Gitee

* [Gitee OpenAPI](https://gitee.com/api/v5/swagger#/getV5ReposOwnerRepoStargazers?ex=no)
* [Gitee Personal Access Token](https://gitee.com/profile/personal_access_tokens)

### Gitea

* [Gitea API](https://gitea.com/api/v1/swagger)
* [Get a repo](https://gitea.com/api/v1/swagger#/repository/repoGet)
* [Create a repo](https://gitea.com/api/v1/swagger#/repository/createCurrentUserRepo)
* [List the repos that the authenticated user owns or has access to](https://gitea.com/api/v1/swagger#/user/userCurrentListRepos)

### Gogs

* [gogs/docs-api](https://github.com/gogs/docs-api)
* [Demo site](https://try.gogs.io/)

### Coding

* [Open API](https://open.coding.net/open-api/?_ga=2.122224323.99121124.1563808661-1235584671.1544277191)

### GraphQL Client

* [sgqlc](https://github.com/profusion/sgqlc)

## License

[MIT](https://github.com/hsowan/Gigrator/blob/master/LICENSE)