Carregando
0xA0Lição 11 de 14

Releases e versionamento semântico

Versione com semver e conventional commits, crie releases a partir de tags, escreva notas de release e publique pacotes.

26 min Questionário com 7 perguntas 2 exercícios de código
Ao final desta lição, você saberá
  • Escolher a próxima versão com versionamento semântico
  • Escrever mensagens de conventional commits que as ferramentas conseguem ler
  • Criar releases com tags, notas e arquivos anexados, e publicar pacotes

Os jogadores do Dungeon Dash querem saber: a versão nova é segura para instalar? Os meus saves vão continuar funcionando? O versionamento semântico (semver) responde isso no próprio número da versão, MAJOR.MINOR.PATCH:

IncrementoQuandoExemplo
MAJORmudanças incompatíveis - os usuários precisam se adaptar1.9.3 → 2.0.0: saves antigos não carregam mais
MINORfuncionalidades novas, compatíveis com versões anteriores1.4.2 → 1.5.0: batalhas contra chefes adicionadas
PATCHsó correções de bugs1.4.2 → 1.4.3: atravessar paredes corrigido

Incrementar um zera os que estão à direita dele. Pré-releases como 2.0.0-beta.1 vêm antes de 2.0.0, e versões abaixo de 1.0.0 sinalizam “tudo pode mudar”.

Conventional commits

Se as mensagens de commit disserem que tipo de mudança elas são, as ferramentas podem escolher a próxima versão e escrever as notas de release automaticamente. Os conventional commits usam um prefixo de tipo:

1feat: add boss battles                    → minor
2fix(physics): stop wall clipping          → patch (scope in parentheses)
3docs: explain the controls                → no release by itself
4feat!: new save file format               → major (the ! means breaking)
5refactor: split the renderer
6
7BREAKING CHANGE: saves from 1.x won’t load   ← a footer also means major

Outros tipos comuns: chore, test, perf, ci, build, style. Muitas equipes impõem o formato na CI, e, com squash merge, o título do PR vira a mensagem do commit - então é o título do PR que precisa seguir a convenção.

next_version.py
1import re
2
3def next_version(current, commits):
4    major, minor, patch = map(int, current.lstrip("v").split("."))
5    kinds = []
6    for message in commits:
7        match = re.match(r"(\w+)(?:\([\w-]+\))?(!)?:", message)
8        if match and (match.group(2) or "BREAKING CHANGE:" in message):
9            kinds.append("major")
10        elif match and match.group(1) == "feat":
11            kinds.append("minor")
12        elif match and match.group(1) in ("fix", "perf"):
13            kinds.append("patch")
14    if "major" in kinds:
15        return f"v{major + 1}.0.0"
16    if "minor" in kinds:
17        return f"v{major}.{minor + 1}.0"
18    if "patch" in kinds:
19        return f"v{major}.{minor}.{patch + 1}"
20    return f"v{major}.{minor}.{patch} (no release needed)"
21
22print(next_version("v1.4.2", ["fix(physics): stop wall clipping", "docs: controls"]))
23print(next_version("v1.4.2", ["feat: boss battles", "fix: typo in menu"]))
24print(next_version("v1.4.2", ["feat!: new save format"]))
25print(next_version("v1.4.2", ["chore: update dependencies"]))
Saída
v1.4.3
v1.5.0
v2.0.0
v1.4.2 (no release needed)

Tags e releases

Uma tag do Git marca um commit com um nome como v1.5.0. Uma release do GitHub é construída sobre uma tag: um título, notas de release e arquivos anexados (“assets”), como os instaladores do jogo. O GitHub pode gerar as notas a partir dos PRs mesclados desde a última release, agrupados por label.

cutting a release
1git tag -a v1.5.0 -m "Boss battles"
2git push origin v1.5.0
3gh release create v1.5.0 dist/*.zip --title "v1.5.0: Boss battles" --generate-notes
4gh release create v2.0.0-beta.1 --prerelease --notes "Try the new save format!"

Muitos projetos deixam um workflow fazer isso: num push de tag (on: push: tags: ["v*"]), gerar o jogo, criar a release e enviar os assets. E o GitHub Packages hospeda pacotes - imagens de contêiner em ghcr.io, npm, Maven e mais - junto do código, com as mesmas permissões.

Principais conclusões

  • Semver MAJOR.MINOR.PATCH: mudanças incompatíveis, funcionalidades, correções; incrementar um zera os demais.

  • Conventional commits (feat, fix, feat!, BREAKING CHANGE) deixam as ferramentas escolherem versões e escreverem notas.

  • Tags marcam commits; releases acrescentam notas e assets para download, muitas vezes criados por um workflow.

  • Pré-releases como 2.0.0-beta.1 vêm antes de 2.0.0 na ordenação.

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

Escolha a próxima versão

+25 XP

A primeira linha de entrada é a versão atual (como v1.4.2); as demais são mensagens de conventional commits desde então. Imprima a próxima versão e o porquê: v1.5.0 (minor: 1 feature, 2 fixes). Um tipo seguido de !, ou uma mensagem que contém BREAKING CHANGE:, é incompatível (major); feat é minor; fix e perf são patch; qualquer outra coisa não dispara uma release. Conte features (feat), fixes (fix e perf) e breaking changes, listando só as contagens diferentes de zero, nessa ordem. Se não houver nada para lançar, imprima v1.4.2 (no release).

  • Uma release de funcionalidade
  • Incompatível
  • Nada para lançar
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

Ordene versões do jeito do semver

+25 XP

Cada linha de entrada é uma tag de versão (um v opcional, depois MAJOR.MINOR.PATCH e, opcionalmente, -PRERELEASE). Imprima-as da mais antiga para a mais nova e depois latest stable: v... (a mais nova sem parte de pré-release). Precedência do semver:

  • compare MAJOR, MINOR e PATCH como números (então 1.10.0 vem depois de 1.9.0);
  • uma pré-release vem antes da mesma versão sem pré-release;
  • as pré-releases são comparadas parte por parte, separadas por pontos: partes numéricas como números, partes de texto em ordem alfabética, números antes de texto e menos partes primeiro quando todo o resto é igual (alpha < alpha.1 < beta < beta.2 < beta.11 < rc.1).
  • Tags misturadas
  • Só betas à frente
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…