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):

  emerge -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:

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

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

     defaults {
         editor=vi
         github-default-account=my-github-account
     }
     
     my-github-account {
         token=<token-goes-here>
         account=<account-name>
         forge-type=github
     }
     

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

     gcli -t github repos
     

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

3.1.2 gitea

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

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

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

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

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

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

  defaults {
          gitea-default-account=codeberg-org
          ...
  }
  
  codeberg-org {
          account=<your-username-at-gitea>
          token=<the-token-you-just-created>
          forge-type=gitea
          api-base=https://codeberg.org/api/v1
  }
  

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

• Запустите:

  gcli -t gitea repos
  

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

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

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

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

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