Como gerar e manter o histórico do código com o git log.

프로젝트 문서, mantendo um padrão e um bom histórico das mensagens de commit, pode ser gerada com o comandogit log . Arquivo de mudançasCHANGELOG, ou as notas de releaseRELEASE NOTES, podem facilitar bastante a manutenção e rastreabilidade no código.

O subcomando log do git mostra todos os commits em um repositório e é uma ferramenta útil para inspectionar o histórico de um projeto. Sua saída pode gerar documentação do projeto, como notas de versão e registros de mudanças. 커밋을 정의하고 의미 있는 작업을 수행하고 프로젝트를 문서화할 수 있는 키트를 만들지 않습니다.

Um bom histórico de commits pode ser alcançado utilizando boas práticas como as descritas no modelo Conventional Commits que propõe um conjunto de regras para criar um histórico de commits explícito, facilitando a criação ou utilização de ferramentas automatizadas com esse propósito.

Gerando notas alterações ou releases

É possível gerar informando as tags que serão fitradas

git log --oneline v0.1.0...v0.1.1

As saídas dos comandos podem ser redirecionadas para um arquivo, como no example:

git log --oneline v0.1.0...v0.1.1 >> CHANGELOG # OR RELEASE_NOTES

O arquivo definido na saída do comando, pode ser versionado ou utilizado em alguma ferramenta que apresente aos usuários o que foi alterado no último release do sistema.

A flag de formatação--online는 que queremos uma versão condensada de cada commit, um commit por linha를 정의합니다.

13abc49 docs(about): improves about page infos
9f4c7c3 ci(fix): adjustments on deploy stages
caf2d83 build(migration): migrates site to firebase
070da73 refactor(content): It centralizes the way to load content
4ef6b8d test(dynamics): Fix tests
cfd6bd5 fix(project): Fix SEO and improve fetch
2ee58e5 ci(workflow): Update ci
0d29391 ci(actions): Fix environment var names
7648d85 build(nuxt): Update project dependencies
...

사용자 지정 o 출력 로그

Para definir quais serão os valores informados no log, adequando às necessidades do projeto, é possível utilizar a flag--format .

git log --format=">> %h %s"

Nesse example, removendo o hash na saída. Mais opções de filtros, podem ser encontradas na documentação no topicoPRETTY FORMATS

>> ci(scp): removes scp deploy task
>> docs(about): improves about page infos
>> ci(fix): adjustments on deploy stages
>> build(migration): migrates site to firebase
>> refactor(content): It centralizes the way to load content
>> test(dynamics): Fix tests
>> fix(project): Fix SEO and improve fetch
>> ci(workflow): Update ci
>> ci(actions): Fix environment var names
>> build(nuxt): Update project dependencies
...

숏로그

O comando shortlog é specialmente útil ao gerar notas de versão para projetos com muitos colaboradores. É possível gerar uma saída com os commits agrupados por autor e classificados por nome.

Juntamente com o --format , flag -n 정보는 작가의 커밋 수량을 시각화할 수 있습니다.

오 특공대:

git shortlog -n --format="%s" 3.2.7...3.2.8

Produz a saída:

Mariusz Felisiak (7):
      [3.2.x] Post-release version bump.
      [3.2.x] Added stub release notes for Django 3.2.8.
      [3.2.x] Fixed #33082 -- Fixed CommandTests.test_subparser_invalid_option on Python 3.9.7+.
      [3.2.x] Corrected outputs and made cosmetic edits in GeoDjango tutorial.
      [3.2.x] Used :rfc: role in docs/topics/conditional-view-processing.txt.
      [3.2.x] Fixed broken links and redirects in docs.
      [3.2.x] Corrected field and model check messages in docs.

Carlton Gibson (3):
      [3.2.x] Fixed #33083 -- Fixed selecting all items in the admin changelist when actions are both top and bottom.
      [3.2.x] Added release date for 3.2.7.
      [3.2.x] Bumped version for 3.2.8 release.

Adam Johnson (1):
      [3.2.x] Refs #31055 -- Doc'd 'databases' argument of check functions.

Claude Paroz (1):
      [3.2.x] Removed obsolete GEOS 3.5 requirement note.

David Sanders (1):
      [3.2.x] Clarified type of Window()'s partition_by and order_by arguments.

David Smith (1):
      [3.2.x] Doc'd Jinja2 form renderer.

Jacob Walls (1):
      [3.2.x] Fixed typo in docs/topics/i18n/formatting.txt.

Ken Whitesell (1):
      [3.2.x] Fixed #33077 -- Fixed links to related models for admin's readonly fields in custom admin site.

Sarah Abderemane (1):
      [3.2.x] Refs #27694 -- Doc'd lookups that can be chained with HStoreField key transforms.

Steven Maude (1):
      [3.2.x] Fixed typo in docs/intro/reusable-apps.txt.

참조

https://www.git-scm.com/docs/git-log

https://www.conventionalcommits.org/pt-br/v1.0.0-beta.4/

https://github.com/django/django/