O que são pedidos Pull?

8 minutos

Começamos por:

Revisão de filiais e sua importância para puxar solicitações.
Definir o que é um pull request.
Aprender a criar um pull request, revisar os status do pull request e mesclar um pull request.

Ramos

Primeiro, vamos definir o que são ramificações, por que elas são importantes para os desenvolvedores e como elas estão relacionadas às solicitações pull.

As ramificações são espaços de trabalho isolados onde você pode desenvolver seu trabalho sem afetar outras pessoas no repositório. Eles permitem que você desenvolva recursos, corrija bugs e experimente com segurança novas ideias em uma área contida do seu repositório.

Desenvolvedores trabalhando em filiais independentes é um conceito comum no desenvolvimento de software moderno. Ao ter sua própria filial, um desenvolvedor pode fazer quaisquer alterações, chamadas commits, sem se preocupar em como suas confirmações afetam outros desenvolvedores que trabalham em suas próprias ramificações.

Intercalar ramos

Embora ter cada desenvolvedor trabalhando em um ramo separado seja ótimo para a produtividade individual, isso abre um novo desafio. Em algum momento, a ramificação de cada desenvolvedor precisa ser mesclada em uma ramificação comum, como main. À medida que os projetos escalam, pode haver muitas fusões que precisam acontecer, e torna-se cada vez mais importante acompanhar e revisar cada fusão. A necessidade de acompanhar várias alterações em um projeto é onde as solicitações pull entram.

O que é um pedido Pull?

Uma solicitação pull é uma maneira de documentar alterações de ramificação e comunicar que as alterações da ramificação do desenvolvedor estão prontas para serem mescladas na ramificação base (principal). As solicitações pull permitem que as partes interessadas analisem e discutam as alterações propostas para garantir que a qualidade do código na ramificação base seja mantida o mais alta possível.

Para que os dois ramos sejam fundidos, eles devem ser diferentes um do outro:

A ramificação de comparação é a própria ramificação do desenvolvedor, que contém as alterações específicas feitas.
A ramificação de base , também referida como a ramificação principal , é a ramificação na qual as alterações precisam ser fundidas.

O uso mais comum da comparação é comparar ramificações, como quando você está iniciando uma nova solicitação pull. Você sempre é levado para a visualização de comparação de ramificações ao iniciar uma nova solicitação pull.

Criar um pedido Pull

Agora vamos rever como criar um pull request!

No GitHub.com, navegue até a página principal do repositório.
No menu Ramificação, selecione a ramificação que contém suas confirmações.
Acima da lista de arquivos, no banner amarelo, selecione o botão Comparar & pull request para criar uma solicitação pull para a ramificação associada.
No menu suspenso ramificação base, selecione a ramificação na qual você deseja mesclar as alterações. Em seguida, selecione o menu suspenso comparar ramificação para selecionar a ramificação na qual você fez as alterações.
Insira um título e uma descrição para o seu pull request.
Para criar uma solicitação pull pronta para revisão, selecione o botão Create Pull Request . Para criar uma solicitação pull de rascunho, selecione a lista suspensa e selecione Create Draft Pull Request e, em seguida, selecione Draft Pull Request.

Status da solicitação pull

Agora vamos analisar os diferentes status de uma solicitação pull.

Solicitação pull de rascunho - Ao criar uma solicitação pull, você pode optar por criar uma solicitação pull pronta para revisão ou uma solicitação pull de rascunho . Uma solicitação pull com um status de rascunho não pode ser mesclada e os proprietários de código não são solicitados automaticamente a revisar solicitações pull de rascunho.
Solicitação pull aberta - Um status aberto significa que a solicitação pull está ativa e ainda não foi mesclada à ramificação base. Você ainda pode fazer confirmações e discutir e revisar possíveis alterações com os colaboradores.
Solicitação pull fechada - Você pode optar por fechar uma solicitação pull sem mesclá-la na ramificação base/principal. Esta opção pode ser útil se as alterações propostas na sucursal já não forem necessárias, ou se for proposta outra solução noutro ramo.
Solicitação pull mesclada - O status da solicitação pull mesclada significa que as atualizações e confirmações da ramificação de comparação foram combinadas com a ramificação base. Qualquer pessoa com acesso por push ao repositório pode concluir a mesclagem.

Mesclar uma solicitação pull

Sob o nome do repositório, selecione Pull requests.
Na lista Solicitações pull, selecione a solicitação pull que você deseja mesclar.
Role para baixo até a parte inferior da solicitação pull. Dependendo das opções de mesclagem habilitadas para seu repositório, você pode:
- Mescle todas as confirmações na ramificação base selecionando o botão Mesclar solicitação pull. Se a opção Mesclar solicitação pull não for exibida, selecione o menu suspenso de mesclagem, escolha a opção Criar uma confirmação de mesclagem e selecione o botão Criar uma confirmação de mesclagem.
- Squash e mesclar permite que você pegue todos os seus compromissos e combine-os em um. Essa opção pode ajudá-lo a manter o histórico do repositório mais legível e organizado. Selecione a opção Squash e mesclagem e, em seguida, selecione o botão Squash e mesclagem .
- A opção Rebasear e mesclar permite que você faça confirmações sem uma confirmação de mesclagem. Essa opção permite que você ignore uma mesclagem mantendo um histórico de projeto linear. Selecione o menu suspenso de mesclagem, escolha a opção Rebasear e mesclar e, em seguida, selecione o botão Rebasear e mesclar .
Se solicitado, insira uma mensagem de confirmação ou aceite a mensagem padrão.
Se você tiver mais de um endereço de e-mail associado à sua conta no GitHub.com, selecione o menu suspenso de endereço de e-mail e selecione o endereço de e-mail a ser usado como o endereço de e-mail do autor do Git. Apenas os endereços de e-mail verificados aparecem neste menu pendente. Se você ativou a privacidade do endereço de e-mail, um e-mail do GitHub sem resposta é o endereço de e-mail padrão do autor da confirmação.
Selecione Confirmar mesclagem, Confirmar squash e mesclagem ou Confirmar rebase e mesclagem.
Opcionalmente, você pode excluir a ramificação de comparação para manter a lista de ramificações em seu repositório organizada.

Em seguida, você conclui um exercício que pega o que você revisou e o aplica a um exemplo da vida real.