O que é o GitHub?
Diferencie o Git do GitHub, oriente-se na página de um repositório e veja como as pessoas colaboram ali.
- Explicar a diferença entre Git e GitHub
- Navegar por um repositório: código, issues, pull requests, actions e configurações
- Descrever contas, organizações, visibilidade, estrelas, watch e forks
Boas-vindas ao Dungeon Dash, um jogo retrô open source feito com poucos recursos: heróis em pixel art, masmorras geradas proceduralmente e uma pequena e animada equipe de mantenedores voluntários. Você acabou de ser convidado para ajudar. Ao longo desta trilha, você vai sair do seu primeiro pull request até publicar releases com testes automatizados, verificações de segurança e um bot de releases que você mesmo escreve.
Primeiro, uma distinção importante:
- O Git é a ferramenta de controle de versão no seu computador. Ele registra o histórico num repositório e funciona offline. (A trilha de Git trata dele.)
- O GitHub é um site e um serviço que hospeda repositórios Git e constrói colaboração em torno deles: issues, pull requests, code review, automação com Actions, quadros de projeto, varredura de segurança, releases e mais.
O GitHub não é o único host - GitLab, Bitbucket, Codeberg e outros fazem trabalhos parecidos -, mas, com mais de 100 milhões de desenvolvedores, é onde vive a maior parte do open source.
Um passeio pela página de um repositório
Todo repositório vive em github.com/OWNER/REPO - o Dungeon Dash é github.com/dungeon-dash/dungeon-dash. As abas no topo são o mapa desta trilha inteira:
| Aba | Para que serve | Aula |
|---|---|---|
| Code | arquivos, branches, commits, o README | repositórios, Markdown |
| Issues | relatos de bugs, ideias de funcionalidades, tarefas | issues e projetos |
| Pull requests | mudanças propostas, aguardando revisão | pull requests, code review |
| Actions | workflows automatizados: testes, builds, deploys | Actions, CI |
| Projects | quadros e tabelas para planejamento | issues e projetos |
| Security | alertas sobre dependências vulneráveis e secrets vazados | segurança |
| Settings | colaboradores, proteção de branches, secrets (só mantenedores) | em todo lugar |
Os donos são contas pessoais (@mira) ou organizações (@dungeon-dash), que agrupam pessoas em equipes com permissões diferentes. Os repositórios são públicos (qualquer pessoa pode ler) ou privados (só as pessoas que você convidar).
Experimente
Até 15 XPGit ou GitHub?
Qual dos dois fornece cada funcionalidade? Lembre: o Git é a ferramenta na sua máquina; o GitHub é o serviço construído em torno da hospedagem.
“Commits e branches”
“Pull requests com comentários de revisão”
“Issues e labels”
“git log e git diff”
“Rodar testes automaticamente a cada push”
“Fazer merge de duas branches”
“Estrelas e forks”
Alguns botões sociais que você vai ver em todo repositório:
- Star - salva um projeto nos favoritos e mostra apreço. As estrelas são o jeito como as pessoas medem, por alto, a popularidade.
- Watch - recebe notificações sobre a atividade (toda ela, só releases ou nada).
- Fork - a sua própria cópia do repositório na sua conta, para você poder mudá-la e propor essas mudanças de volta. (A unidade 2 trata de forks.)
Automatizando o GitHub
Tudo o que você pode clicar no GitHub também pode virar script: pela ferramenta de linha de comando gh, pelas APIs REST e GraphQL e pelo Actions. É por isso que os exercícios desta trilha são pequenos programas em Python - o tipo de utilitário que os mantenedores realmente escrevem. Aqui está o primeiro: extrair o dono e o nome das muitas formas que a URL de um repositório pode ter.
1import re
2
3PATTERN = re.compile(r"(?:https://|git@)?github\.com[/:]([\w.-]+)/([\w.-]+?)(?:\.git)?(?:/.*)?$")
4
5for url in ["https://github.com/dungeon-dash/dungeon-dash",
6 "git@github.com:mira/pixel-heroes.git",
7 "github.com/dungeon-dash/dungeon-dash/issues/42",
8 "https://gitlab.com/someone/thing"]:
9 match = PATTERN.match(url)
10 print(f"{match.group(1)}/{match.group(2)}" if match else "not a GitHub repo")dungeon-dash/dungeon-dash mira/pixel-heroes dungeon-dash/dungeon-dash not a GitHub repo
Principais conclusões
O Git registra o histórico localmente; o GitHub hospeda repositórios Git e adiciona colaboração em torno deles.
As abas da página de um repositório - Code, Issues, Pull requests, Actions, Projects, Security - mapeiam a plataforma.
Os repositórios pertencem a contas pessoais ou a organizações, e são públicos ou privados.
Star para salvar nos favoritos, watch para receber notificações, fork para ter a sua própria cópia para mudar.
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.
Que repositório é este?
Cada linha de entrada é um link que alguém colou no chat do Dungeon Dash. Imprima owner/repo para links de repositórios do GitHub em qualquer um destes formatos, ou not a GitHub repo caso contrário:
https://github.com/OWNER/REPO(opcionalmente terminando em.git, numa/ou em qualquer caminho a mais, como/issues/42)git@github.com:OWNER/REPO.git(a forma SSH)github.com/OWNER/REPOsem o esquema
Os nomes do dono e do repositório usam letras, dígitos, -, _ e ..
- Muitos formatos
- Não é GitHub
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.
Repositórios em alta
Cada linha de entrada é um objeto JSON que descreve um repositório, como a API do GitHub devolve: {"full_name": ..., "stargazers_count": ..., "forks_count": ..., "language": ...}. Imprima os 3 primeiros por estrelas como 1. owner/repo (520 stars, 40 forks) e depois o número de repositórios por linguagem, da mais comum para a menos comum (empates em ordem alfabética), como Python: 2. Uma linguagem null conta como unknown.
- Cinco repositórios
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…