简介
changelogx 是一款 NPM 包,用于自动生成项目的 CHANGELOG。它可以帮助开发者在每次版本更新时更轻松地记录和维护一个清晰、规范的变更日志。
安装
使用 npm 安装 changelogx:
npm install -g changelogx
使用
以下是 changelogx 的常用命令:
初始化 changelog
changelogx init
该命令会在项目根目录下生成一个 CHANGELOG.md
文件,并将初始版本信息写入文件中。
添加新版本
changelogx add [version] [date]
version
:新增版本号,例如v1.0.0
。date
:新增版本日期,格式为YYYY-MM-DD
。
执行该命令后,changelogx 会自动检索 git 提交记录,并将最新提交与上一次版本发布之间的所有 commit 记录添加到 CHANGELOG.md
文件中。
查看 CHANGELOG
changelogx show
该命令会在终端中显示当前项目的 CHANGELOG。
自动生成并发布新版本
changelogx release [version] [date]
version
:新发布版本号,例如v1.0.0
。date
:新发布版本日期,格式为YYYY-MM-DD
。
执行该命令后,changelogx 会自动向 git 提交一个新版本的 tag,并将新版本的 CHANGELOG 更新到 CHANGELOG.md
文件中,最后推送代码至远程仓库。
示例
以下是一个简单的示例:
$ changelogx init $ git add . $ git commit -m "init CHANGELOG" $ changelogx add v1.0.0 2022-03-01 $ git add CHANGELOG.md $ git commit -m "update CHANGELOG for v1.0.0" $ changelogx release v1.0.0 2022-03-01
执行完这些命令后,你会在 GitHub 的 Release 页面中看到一个新的版本发布。同时,你也可以在项目根目录下查看到自动生成的 CHANGELOG.md 文件。
总结
使用 changelogx 能够帮助我们更好地维护和管理项目的变更日志。通过自动化的日志生成和记录,我们可以更加高效地协作开发,提高代码质量和可维护性。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/41036