Carregando
0x60Lição 7 de 14

Forks e open source

Contribua com projetos nos quais você não pode fazer push, mantenha o seu fork sincronizado e entenda as licenças e a etiqueta do open source.

26 min Questionário com 7 perguntas 2 exercícios de código
Ao final desta lição, você saberá
  • Contribuir por meio de um fork: clonar, criar branch, fazer push e abrir um pull request para o upstream
  • Manter um fork sincronizado com o repositório upstream
  • Escolher uma licença open source e seguir as normas da comunidade

Você não pode fazer push num repositório no qual não tem acesso de escrita - o que vale para a maior parte do mundo open source. Em vez disso, você faz um fork: o GitHub cria uma cópia na sua conta na qual você pode fazer push, e o seu pull request vai do seu fork de volta para o original, chamado de upstream.

contributing through a fork
1# Fork on GitHub first (or: gh repo fork dungeon-dash/dungeon-dash --clone)
2git clone git@github.com:you/dungeon-dash.git
3cd dungeon-dash
4git remote add upstream https://github.com/dungeon-dash/dungeon-dash.git
5
6git switch -c fix/typo-in-controls
7# ...fix, commit...
8git push -u origin fix/typo-in-controls     # to YOUR fork
9gh pr create --repo dungeon-dash/dungeon-dash   # PR from your fork to upstream
10
11# Later: bring your fork's main up to date with upstream
12git switch main
13git fetch upstream
14git merge --ff-only upstream/main            # or the "Sync fork" button on GitHub
15git push origin main

Agora são dois remotes: origin (o seu fork, para onde você faz push) e upstream (o original, de onde você faz fetch). Antes de começar um trabalho novo, sincronize a main com o upstream e crie a branch a partir dela, para que o seu PR não carregue histórico desatualizado. O GitHub mostra na página do repositório quantos commits o seu fork está “à frente” (ahead) e “atrás” (behind) do upstream.

Licenças open source

Uma licença é o que transforma “público” em “open source”: ela dá a todos permissão para usar, mudar e compartilhar o código, sob certas condições. As mais comuns:

LicençaNuma frase
MITfaça quase qualquer coisa, só mantenha o aviso de copyright - curta e permissiva
Apache 2.0permissiva como a MIT, mais uma concessão explícita de patentes
GPL 3.0“copyleft”: se você distribuir versões modificadas, elas também precisam ser GPL, com o código-fonte
AGPL 3.0uma GPL que também vale quando o software é oferecido pela rede
Sem licençatodos os direitos reservados - ninguém pode reutilizá-lo legalmente

O GitHub lê o arquivo LICENSE e mostra a licença na página do repositório; o choosealicense.com ajuda você a escolher.

Experimente

Até 15 XP

Permissiva ou copyleft?

Classifique cada situação pelo tipo de licença que ela descreve.

0 de 6 classificadosPontuação 0/0
  • “Uma empresa pode usar o código num produto de código fechado, mantendo o aviso”

  • “Se você distribuir uma versão modificada, precisa compartilhar o código-fonte dela sob a mesma licença”

  • “Um repositório público sem arquivo LICENSE”

  • “Inclui uma concessão explícita dos direitos de patente dos contribuidores”

  • “Rodar uma versão modificada como serviço web exige oferecer o código-fonte dela aos usuários”

  • ““Você pode olhar, mas não copiar nem modificar””

Sendo um bom cidadão do open source

  • Leia o CONTRIBUTING.md primeiro: ele explica como o projeto quer receber contribuições (testes, estilo de commit, sign-offs).
  • Procure as labels “good first issue” e comente antes de começar um trabalho grande - alguém pode já estar nele, ou os mantenedores podem querer outra abordagem.
  • Siga o código de conduta (CODE_OF_CONDUCT.md). Os mantenedores muitas vezes são voluntários; paciência e gentileza vão longe.
  • PRs pequenos são mesclados. Uma correção focada tem muito mais chance de ser aceita do que uma reescrita gigante.
  • Os projetos dos quais você depende podem ser apoiados pelo GitHub Sponsors.

Principais conclusões

  • Faça fork para ter uma cópia na qual você pode fazer push; abra PRs do seu fork de volta para o upstream.

  • Adicione o original como upstream e sincronize a main com ele antes de começar um trabalho novo.

  • As licenças tornam o código open source: MIT e Apache são permissivas, a GPL é copyleft.

  • Leia o CONTRIBUTING.md, comece pelas good first issues e mantenha os PRs pequenos e gentis.

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

À frente e atrás

+25 XP

O GitHub diz que o seu fork está “3 commits ahead, 2 behind”. A entrada tem duas linhas, upstream: e fork:, cada uma listando os commits de uma branch do mais antigo para o mais novo. Elas compartilham um começo comum (a merge base). Imprima merge base: b, depois ahead 1: x (os commits do fork depois da base) e behind 2: c d (os do upstream), e uma recomendação: up to date, sync with upstream (só atrás), ready for a pull request (só à frente) ou diverged: sync before opening a pull request (os dois). Imprima - para listas vazias.

  • Divergiu
  • Atrás
  • Atualizado
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

Bot conselheiro de licenças

+25 XP

Escreva um pequeno conselheiro de licenças. Cada linha de entrada responde a três perguntas de sim/não (yes/no) sobre um projeto: copyleft patents network - o autor quer que as versões modificadas continuem open source? Quer uma concessão explícita de patentes? O projeto vai rodar principalmente como serviço web? Recomende:

  • copyleft e network → AGPL-3.0
  • copyleft → GPL-3.0
  • patents → Apache-2.0
  • caso contrário → MIT

Imprima project 1: MIT e depois uma linha final contando cada licença recomendada, da mais comum para a menos comum, empates em ordem alfabética: MIT x2, GPL-3.0 x1.

  • Quatro projetos
  • Fãs de copyleft
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…