Carregando
0x00Lição 1 de 14

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.

18 min Questionário com 7 perguntas 2 exercícios de código
Ao final desta lição, você saberá
  • 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:

AbaPara que serveAula
Codearquivos, branches, commits, o READMErepositórios, Markdown
Issuesrelatos de bugs, ideias de funcionalidades, tarefasissues e projetos
Pull requestsmudanças propostas, aguardando revisãopull requests, code review
Actionsworkflows automatizados: testes, builds, deploysActions, CI
Projectsquadros e tabelas para planejamentoissues e projetos
Securityalertas sobre dependências vulneráveis e secrets vazadossegurança
Settingscolaboradores, 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 XP

Git 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.

0 de 7 classificadosPontuação 0/0
  • “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.

repo_url.py
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")
Saída
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.

Exercício 1

Que repositório é este?

+25 XP

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/REPO sem o esquema

Os nomes do dono e do repositório usam letras, dígitos, -, _ e ..

  • Muitos formatos
  • Não é GitHub
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
+25 XP

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
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…