O GitHub de propriedade da Microsoft é a maior plataforma de compartilhamento de código do planeta e, embora usá-lo por meio do navegador da web seja simples, quando você está interagindo com seu código e arquivos locais, é mais do que provável que esteja usando um terminal.
É aí que entra o GitHub CLI. Uma ferramenta oficial feita pelo GitHub, é boa para usar tanto no Windows 10 quanto no Windows 11 no PowerShell ou dentro do Windows Subsystem for Linux (WSL). Depois de familiarizado com ele, ele pode acelerar várias áreas do fluxo de trabalho do GitHub.
Veja como instalá-lo, configurá-lo e realizar alguns processos básicos.
Configure uma conta GitHub antes de mais nada
Você não precisa de uma conta do GitHub para navegar pelo código e clonar repositórios, mas ainda vale a pena se inscrever. Apenas com sua própria conta e espaço de repositório você pode armazenar seus próprios arquivos e bifurcar outros projetos, seguir outros membros e iniciar repositórios para fácil acesso mais tarde. É totalmente gratuito e não requer que você tenha uma conta da Microsoft.
Uma conta GitHub também permite que você use o aplicativo de terminal GitHub CLI frequentemente esquecido, que devido a algumas mudanças em como o GitHub permite que contas sejam autenticadas, é realmente algo que você deveria ter. Mais sobre isso mais tarde.
Você não ter para interagir com o GitHub por meio do terminal, mas, em muitos casos, é o fluxo de trabalho mais eficiente.
Instalando GitHub CLI no Windows ou WSL
A ferramenta GitHub CLI é um aplicativo oficial do GitHub e, se você for usar o GitHub, vale a pena ter. Por um lado, ele contorna o uso de tokens de acesso pessoais com Git para enviar repositórios locais para o GitHub, já que você pode usar o aplicativo CLI do GitHub para autenticar todo o sistema.
Para instalar a CLI do GitHub no Windows, você pode usar o Gerenciador de Pacotes do Windows novamente inserindo winget install github.cli
ou pegue-o diretamente do GitHub. Alternativamente, está disponível através dos gerenciadores de pacotes Scoop e Chocolately, também, onde você simplesmente precisa instalar gh
.
No WSL, o processo é um pouco mais complicado, mas GitHub tem documentação completa você pode seguir. Como a maioria das pessoas que usam WSL provavelmente tem o Ubuntu ou Debian instalado conforme são oficialmente distribuídos por meio da Microsoft Store, você pode usar os seguintes comandos em seu terminal WSL para instalá-lo.
curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
sudo apt update
sudo apt install gh
Assim como no Git, a instalação WSL do GitHub CLI é separada da instalação do Windows que você usaria no PowerShell. Os dois funcionam da mesma maneira, mas se você alternar entre WSL e PowerShell, precisará instalá-lo em ambos os locais.
Como configurar GitHub CLI e autenticar sua conta
O GitHub CLI, ao contrário do Git, posso use o login e a senha de sua conta para autenticação com o bônus adicional de também permitir que o Git faça push para seus repositórios GitHub. Para autenticar a CLI do GitHub, abra seu terminal e siga estas etapas. Novamente, todas as etapas são iguais, quer você use o Windows ou WSL.
- No terminal entre
gh auth login
- Escolher GitHub.com.
Selecione HTTPS como o protocolo.
- Modelo Y para autenticar com suas credenciais GitHub
Bater Entrar para fazer o login com um navegador da web.
- Anote o código único apresentado a você e pressione Entrar.
- Um navegador será aberto e você precisará fazer login no GitHub, caso ainda não o tenha feito.
- Digite o código de uso único na caixa.
Agora você estará conectado ao cliente GitHub CLI. Para ver a lista completa de comandos disponíveis, basta digitar gh --help
no terminal.
Usando GitHub CLI
Há um modelo de comando básico para usar a CLI do GitHub semelhante a este:
gh [command] [sub-command] [flags]
Todos os comandos que você inserir começarão com gh
para acionar a CLI do GitHub. Existem vários comandos a serem usados, mas aqui estão alguns exemplos de como você executaria algumas funções básicas.
Crie um novo repositório GitHub
A CLI do GitHub oferece a capacidade de criar um novo repositório remoto sem precisar primeiro ir ao site do GitHub e, em seguida, vinculá-lo de volta à sua máquina local. Para fazer isso, você precisa ter o Git inicializado em seu diretório local e navegar até lá no terminal. Em seguida, digite:
gh repo create
Você será solicitado a dar um nome, uma descrição opcional, sua visibilidade e confirmar se deseja criar um remoto Git “de origem” em seu diretório local. Quando tudo estiver concluído, você pode verificar seu novo repositório no site do GitHub. Você pode abrir este ou qualquer outro repositório GitHub em seus diretórios locais digitando gh browse
no terminal.
Clone ou bifurque um repositório GitHub
Na maioria das vezes, você usará o git clone
comando para clonar uma cópia local de um repositório GitHub, mas você pode fazer o mesmo usando a ferramenta GitHub CLI usando este comando.
gh repo clone [user/repo name or URL]
Por exemplo, para clonar o Microsoft Visual Studio, você simplesmente deve inserir:
gh repo clone microsoft/vscode
O resultado final é o mesmo que usar Git, e um novo diretório será criado em sua máquina local com todo o conteúdo do repositório remoto contido nele. Você também pode usar a CLI do GitHub para clonar repos com o URL completo, se você tiver esse, e usar o mesmo comando sem o nome de usuário permitirá que você clonar seus próprios repos facilmente.
gh repo clone [your repo name]
Você também pode usar GitHub CLI para bifurcar um repositório e clonar uma cópia local, se desejar. Você não precisa cloná-lo, no entanto, mas é uma maneira rápida de atingir os dois objetivos com um comando.
gh repo fork [user/repo name or URL]
Por exemplo:
gh repo fork microsoft/winget-pkgs
Depois de pressionar Enter, você será perguntado se deseja clonar o fork ou não, com um simples y
ou n
sendo tudo que você precisa para entrar.
A ferramenta GitHub CLI também tem uma maneira fácil de localizar repositórios que você pode querer clonar, supondo que você conheça a organização ou o nome de usuário. Por exemplo, para ver todos os repositórios da Microsoft no GitHub, você pode inserir:
gh repo list microsoft
Criando um novo problema
Criar problemas é uma parte fundamental do processo do GitHub e você pode fazer isso diretamente na linha de comando usando este comando.
gh issue create
A ferramenta então pedirá que você dê um título ao seu problema, seguido pela abertura de um editor de texto, como o Nano em WSL, para preencher o corpo do problema e, em seguida, a opção de enviar ou continuar no navegador. É muito simples e os prompts irão guiá-lo em cada etapa.
Visualizando e encerrando problemas
Para obter uma lista completa das ferramentas disponíveis para o issue
tipo de comando gh issue --help
no terminal. Um dos problemas mais comuns que você deseja usar é visualizar os problemas e, em seguida, fechá-los se forem resolvidos.
Para visualizar todos os problemas do seu repositório GitHub, digite este comando.
gh issue list
Agora você receberá uma impressão de todos os problemas enviados a esse repositório. Para encerrar os problemas que foram resolvidos, anote o número do problema e digite este comando.
gh issue close 1
Você receberá uma confirmação de que o problema foi resolvido e, para confirmar, pode executar o comando list novamente e ele deve ter desaparecido.
Criação de uma solicitação de pull
Existem várias opções ao criar solicitações pull no GitHub CLI, mas o modelo básico é o seguinte.
gh pr create [subcommand]
A qualquer momento você pode adicionar --help
acima para obter uma análise completa de todas as opções disponíveis. Se quiser criar uma solicitação pull e continuá-la na web, por exemplo, você deve inserir:
gh pr create -w
As solicitações pull se comportam exatamente da mesma maneira que na web, portanto, naturalmente, não funcionarão se você estiver no branch master.
Há um muitos mais para GitHub CLI do que falamos aqui, mas esperançosamente, isso o levará a apontar na direção certa, especialmente se você for um iniciante no uso do GitHub. Temos um guia completo para iniciantes no GitHub que é um bom companheiro para isso, mas quando você estiver confortável com o básico, há muito o que explorar. A maioria dos recursos principais do GitHub podem ser interagidos usando a ferramenta CLI.
Se em algum momento você precisar de um pouco mais de informação, o --help
sinalizar depois de um comando é seu amigo, pois vai quebrar tudo o que você pode fazer com todos os comandos possíveis disponíveis na CLI do GitHub.
Aqui está tudo anunciado durante o The Game Awards 2021
O Game Awards 2021 pode ter celebrado algumas das melhores partes dos videogames em 2021, mas também nos deu uma visão do que está por vir. Aqui está tudo anunciado durante o The Game Awards 2021.