Releases e versionamento semântico
Versione com semver e conventional commits, crie releases a partir de tags, escreva notas de release e publique pacotes.
- 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:
| Incremento | Quando | Exemplo |
|---|---|---|
| MAJOR | mudanças incompatíveis - os usuários precisam se adaptar | 1.9.3 → 2.0.0: saves antigos não carregam mais |
| MINOR | funcionalidades novas, compatíveis com versões anteriores | 1.4.2 → 1.5.0: batalhas contra chefes adicionadas |
| PATCH | só correções de bugs | 1.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 majorOutros 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.
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"]))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.
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.
Escolha a próxima versão
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
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.
Ordene versões do jeito do semver
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
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…