Ir para o conteúdo
Totalmente local

Gerador de changelog

Transforme um git log colado num changelog agrupado e legível.

Entrada
Saída

Gerador de changelog

Cole a saída de "git log" ou "git log --oneline" e esta ferramenta transforma-a num changelog que pode utilizar diretamente numa versão, num ficheiro CHANGELOG.md ou numa descrição de pedido de merge. Lê tanto o formato predefinido de git log com múltiplas linhas (com cabeçalhos de Author: e commit) como o formato compacto de uma linha, permitindo copiar qualquer um diretamente do seu terminal.

Os commits são agrupados por tipo ou por âmbito. Detete tipos automaticamente a partir de prefixos Conventional Commits (feat, fix, docs, chore e outros), ou forneça o seu próprio mapeamento de prefixo para etiqueta quando a sua equipa usa uma convenção diferente. Os merge commits e tarefas podem ser filtrados com uma caixa de seleção, de modo a que o changelog mostre apenas o que mudou para os utilizadores. Escolha a saída Markdown que segue o formato Keep a Changelog, ou uma lista agrupada simples sem qualquer marcação.

Ligue a ligação de bilhetes para converter referências como #123 ou PROJ-42 em ligações, utilizando um modelo de URL com um espaço reservado {id}. Os nomes dos autores são recolhidos automaticamente quando o seu formato de registo os inclui, e as alterações críticas — marcadas com um "!" no final do tipo ou um rodapé "BREAKING CHANGE:" — são extraídas para a sua própria secção no topo quando o destaque está ativado. Adicione uma versão e uma data para gerar um título de lançamento adequado.

Tudo funciona localmente no seu navegador: o seu histórico de commits nunca é enviado para lugar nenhum, o que é importante para repositórios privados. O resultado atualiza-se à medida que escreve ou altera uma opção, e pode copiá-lo, transferi-lo como um ficheiro .txt ou enviá-lo diretamente para outra ferramenta.

FAQ

Que formatos de git log são suportados?
Tanto a saída predefinida de "git log" (blocos de commit/Author/Date com uma mensagem indentada) como "git log --oneline". Cole qualquer um diretamente do seu terminal.
Como são detetados os tipos de commit?
Por predefinição, procura prefixos Conventional Commits como "feat:" ou "fix(scope):". Mude para prefixos personalizados e liste os seus pares prefixo=Etiqueta se o seu projeto usa uma convenção diferente.
Como funciona a ligação de bilhetes?
Introduza um modelo de URL contendo {id}, como https://github.com/org/repo/issues/{id}. Referências como #123 ou PROJ-42 encontradas no sujeito de um commit são convertidas em ligações utilizando esse modelo.
O que conta como uma alteração crítica?
Um tipo seguido de "!" (como "feat!:") ou uma linha "BREAKING CHANGE:" no corpo do commit, ao colar o formato completo de git log. Com destaque ativado, estas são agrupadas na sua própria secção no topo.
O meu histórico de commits é carregado algures?
Não. O changelog é gerado inteiramente no seu navegador — o seu git log nunca sai do seu dispositivo.