Skip to main content

ghlog

Generate release notes based on GitHub Commits.

ghlog categorises the commits based on Conventional Commits. All the commits that don’t follow the CC patern are not considered.

try it now:

deno run -A https://deno.land/x/ghlog/ghlog.ts nestdotland/nest

Install

You can install ghlog using the following command.

deno install -A https://deno.land/x/ghlog/ghlog.ts

Usage

ghlog <user/repo> [ ...arguments ] [ ...options ]

Arguments

argument default description
[base_ref] last tag or initial commit git ref to newest commit.
[head_ref] the latest commit git ref to oldest commit.

Options

option default description
-h, --help show help
-o, --output CHANGELOG.md location to release notes output
-v, --version UNRELEASED tag to use in release notes
-n, --name name to use in release notes
-a, --append append to existing changelog
--auth GitHub access token to avoid rate limits

You can also use the GITHUB_TOKEN environment variable to use the GitHub access token.

Templates

ghlog provides a sane default template out of the box, but if you want more custom template, you can use the defaultChangelog() function in mod.ts as a reference and create your own templates.

License

This software is released under The MIT License