ОБЪЯВЛЕНИЕ

Вслед за предыдущим объявлением об официальном принятии и переходе на GitLab (см. https://github.com/profclems/glab/issues/983), этот проект больше не поддерживается в этом репозитории. Новый дом этого проекта — https://gitlab.com/gitlab-org/cli. Все новые вклады (включая запросы функций и отчёты об ошибках) следует отправлять в официальный репозиторий на GitLab.

GLab

GLab — это инструмент GitLab CLI с открытым исходным кодом, который переносит GitLab в ваш терминал рядом с тем местом, где вы уже работаете с git и вашим кодом, без переключения между окнами и вкладками браузера. Работайте с задачами, запросами на слияние, наблюдайте за работающими конвейерами прямо из вашего CLI, среди прочих функций. Вдохновлён gh, официальным инструментом GitHub CLI.

glab доступен для репозиториев, размещённых на GitLab.com и собственных экземплярах GitLab. glab поддерживает несколько аутентифицированных экземпляров GitLab и автоматически определяет аутентифицированное имя хоста из удалённых устройств, доступных в рабочем каталоге git.

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

glab <команда> <подкоманда> [флаги]

• Демо:

• Документация: Ознакомьтесь с документацией для получения инструкций по использованию.

• Установка: Скачайте двоичный файл, подходящий для вашей ОС, на странице релизов.

Быстрая установка

Поддерживаемые платформы: Linux и macOS

Homebrew

brew install glab

Обновление (Homebrew):

brew upgrade glab

Альтернативно, вы можете установить glab, используя скрипт оболочки:

curl -sL https://j.mp/glab-cli | sudo sh

или

curl -s https://raw.githubusercontent.com/profclems/glab/trunk/scripts/install.sh | sudo sh

Устанавливается в usr/bin

ПРИМЕЧАНИЕ: Пожалуйста, будьте осторожны при запуске скриптов таким образом. Рассмотрите возможность заглянуть в... Установка

(Установите glab в $GOPATH/bin) и пропустите шаги 3 и 4.

3. Соберите проект:

   make

4. Измените PATH, чтобы найти недавно скомпилированный glab:

   export PATH=$PWD/bin:$PATH

5. Запустите glab version, чтобы убедиться, что всё работает.

Аутентификация

Получите токен доступа GitLab по адресу https://gitlab.com/-/profile/personal_access_tokens или https://gitlab.example.com/-/profile/personal_access_tokens, если используете собственный сервер.

• Начните интерактивную настройку:

  glab auth login

• Пройдите аутентификацию на gitlab.com, прочитав токен из файла:

  glab auth login --stdin < myaccesstoken.txt

• Пройдите аутентификацию с помощью экземпляра GitLab, работающего на собственном сервере, прочитав из файла:

  glab auth login --hostname salsa.debian.org --stdin < myaccesstoken.txt

• Аутентифицируйтесь с токеном и именем хоста (не рекомендуется для общих сред):

  glab auth login --hostname gitlab.example.org --token xxxxx

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

По умолчанию glab следует спецификации XDG Base Directory Spec: глобальный файл конфигурации сохраняется в ~/.config/glab-cli. Локальный файл конфигурации сохраняется в .git/glab-cli в текущем рабочем каталоге git. Расширенные рабочие процессы могут переопределить расположение глобального конфигурационного файла, установив переменную среды GLAB_CONFIG_DIR.

Чтобы установить конфигурацию глобально:

glab config set --global editor vim

Чтобы настроить конфигурацию для текущего каталога (должен быть репозиторий git):

glab config set editor vim

Чтобы настроить конфигурацию для конкретного хоста:

Используйте флаг --host, чтобы настроить конфигурацию для определённого хоста. Это всегда хранится в глобальном файле конфигурации с флагом global или без него.

glab config set editor vim --host gitlab.example.org

Переменные среды

GITLAB_TOKEN: токен аутентификации для запросов API. Установка этой переменной позволяет избежать запроса на аутентификацию и переопределяет любые ранее сохранённые учётные данные. Можно установить в конфиге с помощью 'glab config set token xxxxxx'

GITLAB_URI или GITLAB_HOST: укажите URL сервера gitlab, если он работает на собственном хосте (например, https://gitlab.example.com). По умолчанию используется https://gitlab.com.

GITLAB_API_HOST: укажите хост, где находится конечная точка API. Полезно, когда есть отдельные [под]домены или хосты для git и конечной точки API: по умолчанию соответствует имени хоста в URL git

REMOTE_ALIAS или GIT_REMOTE_URL_VAR: переменная или псевдоним git remote, содержащий URL-адрес gitlab. Можно задать в конфиге с 'glab config set remote_alias origin'

VISUAL, EDITOR (в порядке приоритета): инструмент редактора для создания текста. Можно задать в конфиге с 'glab config set editor vim'

BROWSER: веб-браузер для открытия ссылок. Можно задать в конфиге с 'glab config set browser mybrowser'

GLAMOUR_STYLE: переменная окружения для установки желаемого стиля рендеринга уценки
Доступные варианты: (dark|light|notty) или установите собственный стиль
https://github.com/charmbracelet/glamour#styles

NO_COLOR: установите любое значение, чтобы избежать печати последовательностей ANSI для цветного вывода.

FORCE_HYPERLINKS: установите значение 1, чтобы принудительно выводить гиперссылки, даже если вывод не осуществляется на TTY

Что насчёт Lab?

И glab, и lab — это инструменты с открытым исходным кодом, имеющие одну цель — перенести GitLab в командную строку и упростить рабочий процесс разработчика. Во многих отношениях lab похож на hub, а glab — на gh.

Если вам нужен более самоуверенный инструмент, предназначенный для упрощения рабочих процессов GitLab из командной строки, то glab для вас. Однако, если вы ищете инструмент вроде hub, который ощущается как использование git и позволяет взаимодействовать с GitLab, вы можете рассмотреть возможность использования lab.

Некоторые команды glab, такие как ci view и ci trace, были заимствованы из lab.

Проблемы

Если у вас возникла проблема: сообщите о ней в системе отслеживания проблем.

Вклад

Примечание: в тексте ответа сохранены форматирование и специальные символы.