Skip to main content
Deno 2 is finally here 🎉️
Learn more

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 description
[base_ref] git ref to newest commit. (default: last tag or initial commit)
[head_ref] git ref to oldest commit. (default: the latest commit)

Options

option description
-h, --help show help
-o, --output location to release notes output (default: CHANGELOG.md)
-v, --version version to use in release notes (default: “UNRELEASED”)
--auth use this to avoid API rate limits and access private repos

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 mod.ts as a reference and create your own templates.

License

This software is released under The MIT License