Changelog Generator

A simple and efficient tool to generate a CHANGELOG.md file for your Git repository. This tool lists all the commits between two specified commits, formatted by date and including commit messages and bodies.

Features

• Generates a CHANGELOG.md file with commit details.
• Supports specifying a range of commits.
• Option to reverse the order of commits.
• Customizable repository URL, file name, changelog path, and title format.
• Supports multiple range operators ("...", "..", "space") for specifying commit ranges.

Installation

Install the package globally via npm:

npm install -g @bhaireshm/gencl

Usage

Using the generateChangelog Function

You can use the generateChangelog function in your Node.js scripts to generate a changelog programmatically.

Function Signature

generateChangelog(fromHash = '', toHash = 'HEAD'): void

Example

import ChangelogGenerator from "@bhaireshm/gencl";

const config = {
  repoUrl: "https://github.com/username/repo",
  fileName: "MY_CHANGELOG.md",
  changelogPath: "/path/to/save",
  reverse: true,
  title: "My Changelog",
  remoteName: "origin",
  rangeOperator: "...",
};

const changelogGenerator = new ChangelogGenerator(config);
changelogGenerator.generateChangelog({ fromHash: "abc1234", toHash: "def5678" });

Using the CLI

You can also use the CLI to generate a changelog. The available options are:

Option	Alias	Description	Default
--from	-f	The starting commit hash.	empty string
--to	-t	The ending commit hash.	HEAD
--reverse	-r	Reverse the order of commits.	false
--repoUrl	-u	The repository URL.	remote.{remoteName}.url
--fileName	-n	The name of the changelog file.	CHANGELOG.md
--changelogPath	-p	The path to save the changelog file.	current working directory
--title	-l	The title of the changelog.	Timeline: {day}-{month}-{year}
--remoteName	-m	The name of the remote.	origin
--rangeOperator	-o	The range operator to use.	space

CLI Examples

Simple Example

Generate a changelog from the last commit to the current commit:

gencl -f HEAD~1 -t HEAD

Custom Repository URL and File Name

Generate a changelog with a custom repository URL and file name:

gencl -f abc1234 -t def5678 -u https://github.com/username/repo -n MY_CHANGELOG.md

Reverse Order and Custom Title

Generate a changelog with the commits in reverse order and a custom title:

gencl -f abc1234 -t def5678 -r -l "My Changelog"

Custom Range Operator

Generate a changelog using a custom range operator:

gencl -f abc1234 -t def5678 -o "..."