#changelog #git #cli

app git-chlog

Release changelog generator for Git-enabled projects

1 unstable release

0.1.0 Jul 8, 2021

#1839 in Development tools

MIT license

12KB
180 lines

Git Changelog

Simple tool for release changelog reports with multiple template support.

Features

  • Supports multiple output templates
  • Handlebars templating language support
  • Excludes bots noise from the output (Dependabot, etc.)

Usage

You can get usage details by running the command with the --help argument:

./git-chlog --help
USAGE:
    git-chlog [FLAGS] [OPTIONS] <range>

ARGS:
    <range>    Commit range, i.e. master..develop

FLAGS:
    -h, --help       Prints help information
    -v, --verbose    Verbose output
    -V, --version    Prints version information

OPTIONS:
    -c, --config <path>          Sets a custom config file [default: default.conf]
    -d, --dir <path>             Working directory [default: .]
    -n, --max-count <number>     Limit the number of commits to output
    -o, --output <output>        Output file, will use console output if not defined
        --skip <number>          Skip number commits before starting to show the commit output
    -t, --template <template>    Path to the custom output template

Usage Examples

# generate release log with markdown format using changes between develop and master branches
./git-chlog -d ~/github/my-app master..develop > v1.md

# generate release log with HTML format using changes between develop and master branches
./git-chlog -d ~/github/my-app master..develop -t ./assets/templates/html.hbs > v1.html

Templates

The tool supports Handlebars templating language.

Output templates:

  • Markdown (default) (assets/templates/md.hbs)
  • HTML (assets/templates/html.hbs)

Simple Markdown template example looks like the following:

# Changelog

{{#each commits as |commit|}}
 - [{{commit.hash}}]({{../repo_url}}/commit/{{commit.hash}}) {{commit.subject}}
{{/each}}

Building

# debug build
cargo build

# release build
cargo build --release

License

MIT License, see LICENCE for more details.

Dependencies

~5.5MB
~109K SLoC