Разработчики GitHub выпустили бета-версию консольной утилиты GitHub CLI. Она позволяет создавать пул-реквесты и тикеты на GitHub, не выходя из консоли, где вы уже работаете с git.
Пул-реквесты и issue — самые распространённые команды, поэтому их добавили в первую очередь.
Как и прошлая программа Hub, эта полностью написана на Go. Она тоже запускается в разных ОС, включая Linux, MacOS и Windows, причём гораздо удобнее в использовании.
gh pr [status, list, view, checkout, create]
gh issue [status, list, view, create]
gh help
Для получения справки по любой команде/подкоманде добавьте в конце строки --help
. Например:
$ gh issue create --help
Create a new issue
Usage:
gh issue create [flags]
Flags:
-b, --body string Supply a body. Will prompt for one otherwise.
-t, --title string Supply a title. Will prompt for one otherwise.
-w, --web Open the browser to create an issue
Global Flags:
--help Show help for command
-R, --repo OWNER/REPO Select another repository using the OWNER/REPO format
Глобальные флаги:
--help Show help for command
-R, --repo OWNER/REPO Select another repository using the OWNER/REPO format
--version Show gh version
Примеры команд
Отображение списка тикетов с пометкой "help wanted"
~/Projects/my-project$ gh issue list --label "help wanted"
Создание пул-реквеста
~/Projects/my-project$ gh pr create
Здесь же под флагом -B
указываем ветку, если это не мастер.
Flags:
-B, --base string The branch into which you want your code merged
-b, --body string Supply a body. Will prompt for one otherwise.
-d, --draft Mark pull request as a draft
-t, --title string Supply a title. Will prompt for one otherwise.
-w, --web Open the web browser to create a pull request
Если не ввести тему и содержание пул-реквеста в командной строке, то появится интерактивное поле для ввода прямо в консоли.
При отправке пул-реквеста GitHub CLI автоматически создаёт форк мастера, если он не был создан ранее.
Проверка изменений/статуса
~/Projects/my-project$ gh pr status
Current branch
#12 Remove the test feature [Rexogamer:patch-2]
- All checks failing - review required
Created by you
You have no open pull requests
Requesting a code review from you
#13 Fix tests [branch]
- 3/4 checks failing - review required
#15 New feature [branch]
- Checks passing - approved
Отмена изменений (check out)
~/Projects/my-project$ gh pr checkout 12
remote: Enumerating objects: 66, done.
remote: Counting objects: 100% (66/66), done.
remote: Total 83 (delta 66), reused 66 (delta 66), pack-reused 17
Unpacking objects: 100% (83/83), done.
From https://github.com/owner/repo
* [new ref] refs/pull/8896/head -> patch-2
M README.md
Switched to branch 'patch-2'
Нужно признать, что после покупки со стороны Microsoft разработка новых функций GitHub явно ускорилась. Есть версия, что перед покупкой в проекте накопился очень большой технический долг (старые версии на Rails и прочее), но новый владелец бросил массу ресурсов на его устранение, благо у него есть такие возможности.
Теперь большая часть проблем позади, так что разработчики GitHub могут, наконец, сосредоточиться на развитии продукта. Они ждут отзывов по GitHub CLI в анкете и репозитории.
Автор: ITSumma