git-cliff – 高可定制的 Git 项目变更日志生成器:从代码提交中自动生成变更日志

git-cliff 是一个可以从 Git 历史记录中自动生成变更日志的小工具,并且能通过模板定义格式内容,最终导出 CHANGELOG.md 文件。@Appinn

git-cliff 如何使用

git-cliff 能够整合在 git 之中,使用的时候只需要:

git cliff –output CHANGELOG.md

它会根据 git 提交记录,匹配如 fix|修复、doc|文档、style|样式、perf|性能 等描述语,然后自动生成 .md 文档。

默认文档匹配是这样的,按需修改即可。

{ message = “^feat”, group = “<!– 0 –> Features” },
{ message = “^fix”, group = “<!– 1 –> Bug Fixes” },
{ message = “^doc”, group = “<!– 3 –> Documentation” },
{ message = “^perf”, group = “<!– 4 –> Performance” },
{ message = “^refactor”, group = “<!– 2 –> Refactor” },
{ message = “^style”, group = “<!– 5 –> Styling” },
{ message = “^test”, group = “<!– 6 –> Testing” },
{ message = “^chore\(release\): prepare for”, skip = true },
{ message = “^chore\(deps.*\)”, skip = true },
{ message = “^chore\(pr\)”, skip = true },
{ message = “^chore\(pull\)”, skip = true },
{ message = “^chore|^ci”, group = “<!– 7 –> Miscellaneous Tasks” },
{ body = “.*security”, group = “<!– 8 –> Security” },
{ message = “^revert”, group = “<!– 9 –> Revert” },

可以为特定的部分 git 历史记录生成变成日志,比如:

git cliff –current
git cliff –unreleased –tag 1.0.0

也可以指定范围:

git cliff 4c7b043..a440c6e
git cliff 4c7b043..HEAD
git cliff HEAD~2..
git cliff v2.2.1..
git cliff v0.1.0..HEAD

更具体的用法参见例子

获取

官网

有需求的同学可以试试。

具体的案例,可以 git-cliff 自己的 CHANGELOG.md 文件。

原文:https://www.appinn.com/git-cliff/

相关阅读

像写代码一样写作哦,我的 Git(Oh My Git!):一个学习 Git 的开源游戏GitNote – 基于 Git 的跨平台云笔记工具Gource – 可视化 Git、SVN 的提交历史,生成酷炫的动画效果 [Windows]Source – 手机上的「git 全功能客户端」和代码编辑器 [iPhone / iPad]
©2023 青小蛙 for 小众软件 | 加入我们 | 投稿 | 订阅指南
3659b075e72a5b7b1b87ea74aa7932ff
点击这里留言、和原作者一起评论

[ 点击前往获取链接 ]

0 0 投票数
文章评分
订阅评论
提醒
guest
0 评论
内联反馈
查看所有评论
滚动至顶部