up2GitX — удобный и быстрый инструмент для пакетного управления Git

Позволяет массово загружать локальные репозитории на платформы Gitee, GitHub и GitLab (в настоящее время поддерживается только Gitee).

Инструмент написан на языке Go. Это первый опыт работы с Go.

Особенности:

• Простота. Автоматически создаёт одноимённые репозитории и загружает их на платформу.
• Надёжность. Можно выбрать, заменять ли удалённые данные при наличии одноимённых репозиториев.
• Удобство. Можно выбирать между загрузкой в существующую организацию Gitee или созданием новой организации.
• Гибкость. Есть несколько способов импортировать источники репозитория (каталог, текстовый список, источник Github).
• Скорость. Одновременно можно выполнять до 5 операций (на каждой платформе есть ограничение, но 5 одновременных операций обеспечивают высокую скорость и успешность выполнения).

Важные моменты:

• Инструмент автоматически создаёт временный Remote up2GitX-{timestamp} для отправки данных, не влияя на существующие настройки Remote.
• Для создания репозиториев используется OAuth-авторизация, которую можно отменить в сторонних приложениях.
• Во время обработки инструмент может запрашивать дополнительную информацию, поэтому необходимо внимательно читать инструкции и тщательно выбирать параметры.
• При работе с зеркальным отображением Github создаются временные каталоги для хранения временных голых репозиториев, которые удаляются после синхронизации.

Процесс разработки:

[Здесь представлен рисунок, который не удалось распознать.]

Использование:

Скачайте соответствующий пакет для вашей платформы и запустите его.

• up2-macos-v1.1.0.zip
• up2-linux-v1.1.0.zip

Например, для Gitee выполните команду:

./up2 gitee -h

Пример использования:

Здесь приведён пример загрузки данных на Gitee (см. также пример зеркального отображения Github на Gitee).

1. Укажите RepoSource. Это может быть каталог с несколькими репозиториями Git или текстовый файл с абсолютными путями к нескольким репозиториям Git. В примере используется каталог.

   [Здесь представлен рисунок, который не удалось распознать.]

   Убедитесь, что эти репозитории соответствуют вашим ожиданиям.

2. Введите информацию о вашем аккаунте Gitee и выберите, куда загружать данные.

   Введите адрес электронной почты и пароль, используемые для регистрации на Gitee. После успешной аутентификации вы увидите доступные пространства имён. Вы также можете создать новую организацию. На Gitee это может быть личная учётная запись, организация или корпоративный аккаунт (в данный момент поддерживается только загрузка в личные и организационные пространства, поддержка корпоративных аккаунтов будет добавлена позже).

3. Подтвердите создание репозиториев и выберите их публичный статус.

   Проверьте ожидаемые ссылки на репозитории. В этом примере есть китайские символы для демонстрации обработки ошибок. Если всё верно, выберите приватный или публичный доступ к репозиторию.

4. Создайте репозитории на Gitee и проверьте результаты.

   Вы увидите, что один репозиторий создан успешно, один — неудачно, а один уже существует с таким же именем.

   Для неудачного репозитория вам предложат пропустить ошибку или исправить её. Здесь мы пропускаем ошибку.

5. Синхронизируйте код с Gitee.

   После завершения синхронизации вы получите подробную информацию о состоянии каждого репозитория.

   Перейдите на Gitee, чтобы увидеть изменения.

6. Построение.

   Используйте go build up2.go для сборки проекта. Обратите внимание, что необходимо изменить соответствующие идентификаторы и ключи OAuth в файле gitee.go.

params := fmt.Sprintf(`{
                    "grant_type": "password",
                    "username": "%s",
                    "password": "%s",
                    "client_id": "xxxx", // client id from Gitee

``` ```
client_secret: "xxxx", // client secret from Gitee
scope: "user_info projects groups enterprises"

Изменения информации о клиенте позволяют поддерживать клиентов публичных облаков Gitee и большинство клиентов частных облаков Gitee.

Благодарности

• gCli — библиотека инструментов командной строки Go.

Вклад кода

Приглашаем вносить свой вклад в поддержку загрузки на GitHub и Gitlab!

1. Форкните репозиторий.
2. Создайте локальную ветку (git checkout -b my-new-feature).
3. Зафиксируйте изменения (git commit -am 'Add some feature').
4. Отправьте изменения в ветку (git push origin my-new-feature).
5. Создайте Pull Request.

Автор

@Zoker