git shortlog

Inspeção e comparação

Resume o histórico por autor

O comando 'git shortlog' agrupa os commits por autor: cada autor com o número de commits e os assuntos. É usado para notas de versão e listas de contribuidores. Com -s só aparecem as contagens, -n ordena pelo número de commits e -e acrescenta os e-mails. Num terminal resume o branch atual; em scripts, informe a revisão (git shortlog HEAD).

Sinopse

git shortlog [<options>] [<revision-range>] [[--] <path>...]
[ ] opcional| ou<arg> valor a substituir... repetível--flag opção

Opções

Clique em uma opção para expandir

Iniciante (3)

Mostra só o número de commits por autor.

RecomendadoUma linha por autor com o número de commits

Exemplo

git shortlog -s

Ordena os autores pelo número de commits em vez do nome.

RecomendadoOrdenar autores pelo número de commits

Exemplo

git shortlog -sn

Mostra o e-mail de cada autor.

Quando necessárioDiferenciar autores com o mesmo nome

Exemplo

git shortlog -sne

Escolhendo a opção certa

shortlog versus log

Agrupamento

ComandoAgrupado por
git log --onelineData (mais recente primeiro)
git shortlogAutor

Exemplos

Por autor

git shortlog

Cada autor com os assuntos dos seus commits.

Ranking

git shortlog -sn

Contagem de commits, os mais ativos primeiro.

Desde uma versão

git shortlog v1.0..HEAD

Quem fez o quê desde a v1.0 — notas de versão.

Exemplos de fluxos de trabalho

1
git shortlog v1.0..v1.1

Alterações agrupadas por autor

2
git shortlog -sn v1.0..v1.1

Agradecer aos contribuidores

Solução de problemas

Sem saída

Causa: Não está num terminal, então o shortlog lê a entrada padrão

Informe uma revisão: git shortlog HEAD

Dicas e armadilhas

Boas práticas

  • ✓Mantenha um .mailmap para cada pessoa contar uma vez só.

Erros comuns

  • ✗Receber saída vazia num script: sem revisão, o shortlog lê da entrada padrão ali — passe HEAD.
  • ✗Contar a mesma pessoa duas vezes porque usou dois e-mails — adicione um arquivo .mailmap.

Perguntas frequentes

A:

Sim, a menos que você adicione --no-merges.