chancegarcia/git-toolkit

create a change log based on your commit history and tags

1.1.1 2021-03-01 03:41 UTC

README

Build Status Latest Stable Version Total Downloads Latest Unstable Version License

develop branch:

Build Status

This toolkit only contains one tool currently. That tool will create a changelog.md for a project using the git repository tags and the git commit history.

Installation

    composer require --dev chancegarcia/git-toolkit

General Usage

Unless specified in a config file, the repository found in the current working directory will be used.

Configuration (optional)

Default values for some command arguments and options can be set via a config file in

config/chancegarcia_git_toolkit.php

A .dist file provides an example of configuration options.

The following values are configurable:

  • project_root: the directory where the repository resides
  • project_name: The main header value
  • filename: name of the markdown file to write out.
  • output_directory: path to where the markdown file should be written

ChangeLog Command Usage

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

The changelog file will produce a markdown document with a main header (optionally set by the header argument) of Projecty McProjectFace. Tag names are the subheaders and the commits between the tags are printed after the subheader

While you can run the base command, without a header argument, to produce a changelog, you might want to pass the a main header argument with it. Unless you really want to have the top header be Projecty McProjectFace (totally not judging) .

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

Prepare a new or initial release tag/number

If no tags are present. The subheader will be the commit id.

In order to "create" a new tag, use the --new-tag=<NEWTAG> to set the new header and write all recent commits since the previous tag (if there is one) into the changelog.

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