Carregando
0x40Lição 5 de 14

Pull requests e o GitHub flow

Trabalhe em branches, abra pull requests fáceis de revisar e escolha entre merge, squash e rebase.

28 min Questionário com 7 perguntas 2 exercícios de código
Ao final desta lição, você saberá
  • Seguir o GitHub flow: branch, commit, abrir um pull request, revisar, fazer merge
  • Escrever um pull request fácil de revisar e usar drafts e issues vinculadas
  • Comparar merge commits, squash merges e rebase merges

Um pull request (PR) diz: “aqui estão alguns commits na minha branch - por favor, revise-os e puxe-os para a main.” Ele é o coração da colaboração no GitHub. A maioria das equipes segue o GitHub flow:

  1. A main está sempre pronta para deploy.
  2. Crie uma branch para cada mudança: fix/wall-clipping, feature/boss-battles.
  3. Faça commit e push para a branch.
  4. Abra um pull request cedo - como draft se ele não estiver pronto.
  5. As verificações automáticas rodam, e os colegas revisam e discutem.
  6. Faça merge na main e depois apague a branch.
the GitHub flow from the terminal
1git switch -c fix/wall-clipping          # 1. a branch for the change
2# ...edit, test...
3git commit -am "Stop the hero clipping through walls after a dash"
4git push -u origin fix/wall-clipping      # 2. publish the branch
5gh pr create --fill --draft               # 3. open a draft PR (or use the button on GitHub)
6gh pr ready                               # 4. mark it ready for review
7gh pr merge --squash --delete-branch      # 5. after approval and green checks

Experimente

Até 15 XP

A vida de um pull request

Acompanhe o seu primeiro pull request no Dungeon Dash do push até o merge. Preveja o que acontece em cada passo antes de revelá-lo.

Mensagem 1 de 9Previsões 0/0
Você
GitHub
CI (Actions)
Revisora

Um pull request que as pessoas querem revisar

  • Mantenha-o pequeno e focado. Uma mudança por PR. Os revisores pegam muito mais problemas em 100 linhas do que em 1.000.
  • Explique o porquê, não só o quê: o problema, a abordagem, qualquer coisa de que você não tenha certeza e como você testou. Capturas de tela para mudanças visuais.
  • Vincule a issue com uma palavra-chave de fechamento.
  • Revise o seu próprio diff primeiro - você vai pegar prints de depuração esquecidos.
  • Abra um draft cedo para receber feedback sobre a direção antes de polir a coisa errada.

Um arquivo .github/pull_request_template.md preenche a descrição de todo novo PR com um checklist.

Três formas de fazer merge

Suponha que a main tenha os commits A, B, e a sua branch acrescente X, Y, Z:

Métodomain resultanteBom para
Merge commitA, B, X, Y, Z, mais um merge commit M que os unemanter o histórico completo e onde as branches se juntaram
Squash and mergeA, B e depois um novo commit S com as mudanças de X+Y+Zum histórico limpo e linear, com um commit por PR
Rebase and mergeA, B, X′, Y′, Z′ - cópias dos seus commits reaplicadas por cimaum histórico linear que mantém cada commit

O squash merge é popular porque os commits bagunçados de “fix typo” desaparecem. O porém: os commits da sua branch não estão mais na main (S é um commit novo), então apague a branch depois do merge em vez de continuar construindo em cima dela. As configurações do repositório controlam quais métodos são permitidos.

Principais conclusões

  • GitHub flow: branch, commit, push, abrir um PR, passar pelas verificações e pela revisão, fazer merge, apagar a branch.

  • PRs pequenos e focados, que explicam o porquê e vinculam a sua issue, são revisados mais rápido e melhor.

  • PRs em draft convidam feedback cedo; fazer push na branch atualiza o PR.

  • Merge commits mantêm tudo, squash dá um commit por PR, rebase mantém os commits, mas lineariza.

Quiz da aula

7 perguntas · aprovação com 5 acertos · até 50 XP

Ao passar, você conclui a aula e mantém sua sequência. As perguntas erradas voltarão em sessões de revisão.

Pratique: automatize tarefas do GitHub com Python

O trabalho real no GitHub envolve muita automação pequena: conferir CODEOWNERS, expandir matrizes de build, atualizar versões, ler a API. Escreva esses utilitários em Python e execute-os com entradas de exemplo, localmente no navegador e sem precisar de conta no GitHub.

Exercício 1

Simule o botão de merge

+25 XP

A entrada tem duas linhas: main: seguida dos commits da main, e branch: seguida dos commits da branch do PR (cada palavra é um commit). Imprima o histórico resultante da main para cada método de merge:

merge commit: A B X Y M
squash: A B S
rebase: A B X' Y'

(M é o novo merge commit, S o novo commit de squash, e os commits com rebase ganham um ' porque são cópias novas.) Se a branch tiver só um commit, squash e rebase produzem esse único commit como uma cópia nova: S.

  • Três commits
  • Um commit
main.py
Carregando editor…

O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.

Exercício 2

Rotule PRs por tamanho

+25 XP

Muitos projetos rodam um bot que rotula pull requests por tamanho. A entrada é um diff unificado. Conte as linhas adicionadas (que começam com +, mas não o cabeçalho de arquivo +++), as linhas removidas (que começam com -, mas não ---) e os arquivos alterados (linhas diff --git). Imprima files: 2, +7 -3 e uma label de tamanho a partir do total de linhas alteradas:

TotalLabel
menos de 10size/XS
menos de 50size/S
menos de 250size/M
menos de 1000size/L
caso contráriosize/XL
  • Uma pequena correção
  • Nenhuma mudança
main.py
Carregando editor…

O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.

Dúvidas sobre esta lição

Travou em algum ponto? Pergunte. Descobriu algo? Compartilhe. Explicar também é uma ótima forma de aprender.

Carregando publicações…