chancegarcia/git-toolkit

根据您的提交历史和标签创建变更日志

1.1.1 2021-03-01 03:41 UTC

README

Build Status Latest Stable Version Total Downloads Latest Unstable Version License

develop 分支

Build Status

此工具包目前只包含一个工具。该工具将根据 git 仓库标签和 git 提交历史为项目创建一个 changelog.md 文件。

安装

    composer require --dev chancegarcia/git-toolkit

通用用法

除非在配置文件中指定,否则将使用当前工作目录中找到的仓库。

配置(可选)

可以通过位于

config/chancegarcia_git_toolkit.php

的配置文件设置某些命令参数和选项的默认值。

以下值是可以配置的

  • project_root:仓库所在的目录
  • project_name:主标题值
  • filename:输出的 markdown 文件名。
  • output_directory:markdown 文件应写入的路径

ChangeLog 命令用法

    ./vendor/bin/toolkit toolkit:changelog toolkit:changelog

变更日志文件将生成一个具有主标题(可选,通过标题参数设置)为 Projecty McProjectFacemarkdown 文档。标签名称是副标题,并且在标签之间的提交将打印在副标题之后

虽然您可以通过运行基本命令来生成变更日志,但可能希望传递一个主标题参数。除非您真的想将顶部标题设置为 Projecty McProjectFace(完全不是在批评)。

    ./vendor/bin/toolkit toolkit:changelog toolkit:changelog "I am not a cat."

准备新的或初始发布标签/编号

如果没有标签存在。副标题将是提交 ID。

为了“创建”一个新的标签,使用 --new-tag=<NEWTAG> 设置新标题并将自上一个标签(如果有)以来的所有最新提交写入到变更日志中。

    ./vendor/chancegarcia/git-toolkit/bin/toolkit toolkit:changelog "We Love Kittens" --new-tag="1.0.0"