git. Клиент gcli

git. Клиент gcli.

1 Общая информация

• Репозиторий: https://github.com/herrhotzenplotz/gcli
• Сайт: https://herrhotzenplotz.de/gcli/
• Взаимодействует с API нескольких сервисов git-хостинга.
• Поддерживает API: GitHub, GitLab, Gitea, Bugzilla.

2 Установка

• Gentoo (репозиторий karma, см. Gentoo. Репозиторий karma):

  1emerge -v dev-vcs/gcli
  

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

3.1 Подключение учётной записи

3.1.1 github

1. Создайте токен аутентификации для gcli

   • Войдите в свою учетную запись GitHub.
   • Щелкните значок своей учетной записи (верхний правый угол).
   • Выберите вариант Settings.
   • Прокрутите вниз и выберите Developer settings в нижней части левого столбца.
   • В пункте Personal access tokens выберите Tokens (classic).
   • Нажмите на Generate new token (classic).
   • Задайте имя, например gcli в поле Note.
   • Установите срок действия в No expiration.
   • Разрешите следующее Scopes:
     • repo
     • workflow
     • admin:public_key
     • gist
   • Создайте токен. Он будет напечатан зеленым цветом.

2. Конфигурация gcli

   • Создайте файл конфигурации для gcli:

     1mkdir -p $HOME/.config/gcli
     2touch $HOME/.config/gcli/config
     

   • Запишите в этот файл ($HOME/.config/gcli/config):

      1defaults {
      2    editor=vi
      3    github-default-account=my-github-account
      4}
      5
      6my-github-account {
      7    token=<token-goes-here>
      8    account=<account-name>
      9    forge-type=github
     10}
     

   • Замените <token-goes-here> ранее сгенерированным токеном, <account> именем вашей учётной записи.
   • Запустите:

     1gcli -t github repos
     

   • Вы должны получить список ваших репозиториев.

3.1.2 gitea

1. Создайте токен аутентификации для gcli

   • Нажмите на свой аватар в правом верхнем углу.
   • Выбирите Settings во всплывающем меню.
   • Выбирите Applications в меню слева.
   • Под Generate new token введите имя токена (например, gcli).
   • Установите все разрешения.
   • Нажмите кнопку Generate token.

3.1.3 Конфигурация gcli

• Создайте файл конфигурации для gcli:

  1mkdir -p $HOME/.config/gcli
  2touch $HOME/.config/gcli/config
  

• Запишите в этот файл ($HOME/.config/gcli/config):

   1defaults {
   2        gitea-default-account=codeberg-org
   3        ...
   4}
   5
   6codeberg-org {
   7        account=<your-username-at-gitea>
   8        token=<the-token-you-just-created>
   9        forge-type=gitea
  10        api-base=https://codeberg.org/api/v1
  11}
  

  • В примере используется хостер Codeberg.

• Запустите:

  1gcli -t gitea repos
  

• Вы должны получить список ваших репозиториев.

3.2 Создание репозитория

3.2.1 Создание репозитория

• Создадим репозиторий:

  1gcli -t gitea repos create -r <repo_name> -d <repo_description>