Repolode
Enviar
Songmu

Songmu/tagpr

Uma GitHub Action que mantém atualizada uma pull request de release com atualizações de versão e changelog e, após o merge, cria a tag e publica um GitHub Release.

Ver no GitHubSite
Estrelas
336
Forks
46
Issues abertas
19
Último commit
há 19 horas

O que é?

tagpr automatiza a preparação de releases para projetos hospedados no GitHub. A ferramenta mantém continuamente uma pull request de release na branch de release, propondo a próxima versão e atualizando o arquivo de versão e o CHANGELOG.md. A pull request acompanha os novos commits na branch de release, mantendo-se atualizada até que a pessoa responsável pela manutenção decida fazer o merge.

Quando a pull request de release é integrada, tagpr cria uma tag para o novo head da branch de release e pode criar um GitHub Release, publicado ou como rascunho. A tag pode então acionar as etapas de build, empacotamento ou implantação do próprio projeto. As atualizações de versão são definidas pelos labels da pull request, com SemVer como padrão. Também há suporte a CalVer, releases somente com tag, prefixos de tag para monorepos e branches de manutenção com versão major fixa.

A ferramenta é executada como um workflow do GitHub Actions e é configurada por meio de um arquivo .tagpr no formato Git config ou de variáveis de ambiente TAGPR_*.

Recursos principais

  • 01Mantém uma pull request de release que atualiza automaticamente a versão e o changelog.
  • 02Atualiza a PR de release conforme novos commits chegam à branch de release.
  • 03Cria uma tag para o commit integrado da release e pode criar um GitHub Release.
  • 04Define atualizações de SemVer com base nos labels da PR, com opções para CalVer e releases somente com tag.
  • 05Oferece suporte a prefixos de tag para monorepos e branches de manutenção com versão major fixa.

Casos de uso

  • Automatizar atualizações de versão e changelogs em projetos Go ou outros projetos hospedados no GitHub.
  • Acionar workflows de build e publicação a partir de uma tag criada no momento da release.
  • Gerenciar releases de pacotes com versões independentes em um monorepo.

Início rápido

  1. 1

    Adicione o arquivo de workflow do tagpr a um repositório que faça releases a partir de main

  2. 2

    Nas configurações do repositório, habilite a opção para permitir que o GitHub Actions crie e aprove pull requests

  3. 3

    Faça o commit do workflow e envie-o para main

Antes de usar

  • Ele é executado apenas dentro do GitHub Actions e precisa de permissões de gravação para contents e pull requests.
  • Tags criadas com GITHUB_TOKEN não acionam outros workflows baseados em tags, a menos que você use um token do GitHub App.

Em coleções

Frameworks de teste e ferramentas de automação de testes

Tópicos

#github-actions#release-automation#changelog#semver#ci-cd#go

Perguntas frequentes

O que é tagpr?
Uma GitHub Action que mantém atualizada uma pull request de release com atualizações de versão e changelog e, após o merge, cria a tag e publica um GitHub Release. tagpr automatiza a preparação de releases para projetos hospedados no GitHub. A ferramenta mantém continuamente uma pull request de release na branch de release, propondo a próxima versão e atualizando o arquivo de versão e o CHANGELOG.md. A pull request acompanha os novos commits na branch de release, mantendo-se atualizada até que a pessoa responsável pela manutenção decida fazer o merge.
tagpr é gratuito? Qual é a licença?
tagpr é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
tagpr ainda é mantido?
Manutenção ativa. O último commit de tagpr foi em 6 de nov. de 2026.
Para que posso usar tagpr?
Automatizar atualizações de versão e changelogs em projetos Go ou outros projetos hospedados no GitHub. Acionar workflows de build e publicação a partir de uma tag criada no momento da release. Gerenciar releases de pacotes com versões independentes em um monorepo.
Como instalar tagpr?
Adicione o arquivo de workflow do tagpr a um repositório que faça releases a partir de main Nas configurações do repositório, habilite a opção para permitir que o GitHub Actions crie e aprove pull requests Faça o commit do workflow e envie-o para main
Onde consigo tagpr?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Songmu/tagpr

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados