@bassist/changelog
Simple CHANGELOG generator by @chengpeiquan , based on conventional-changelog-cli.
If you are tired of remembering long command names and command line configurations every time, you can use this package to simplify the operation.
Usage
This is a CLI tool, you can install it locally and run it through commands such as pnpm exec.
Install it:
pnpm add -D @bassist/changelog conventional-changelog-cliIn your package.json :
{
"scripts": {
"gen:changelog": "pnpm exec changelog"
}
}Run on command line:
pnpm gen:changelogYou can see a CHANGELOG.md file in the project root directory, which will generate the software's change records based on your Git Logs.
Implementation Principle
In this package, the program will run the conventional-changelog CLI command to generate CHANGELOG, so conventional-changelog-cli, as the peerDependency of the package, also needs to be installed together.
Options
For most projects, the default settings are sufficient. If adjustments are sometimes needed, some options are provided to pass on.
On the command line, options can be passed to the program, e.g. --preset angular by option, or -p angular by short flag.
| Option | Short Flag | Default Value | Description |
|---|---|---|---|
| lerna-package | l | Generate a changelog for a specific lerna package (:pkg-name@1.0.0) | |
| preset | p | angular |
Name of the preset you want to use. Must be one of the following: angular, atom, codemirror, conventionalcommits, ember, eslint, express, jquery or jshint
|
| infile | i | CHANGELOG.md |
Read the CHANGELOG from this file, and outputting to the same file |
| release-count | r | 1 |
How many releases to be generated from the latest, If 0 , the whole changelog will be regenerated and the outfile will be overwritten directory |
| commit-path | ./src |
Generate a changelog scoped to a specific directory |
Btw: The paths are all based on process.cwd() , which is usually run from the root directory of the package (the directory where package.json is located).
If there are any running problems, please provide a reproducible example in the issue, or use conventional-changelog-cli directly (need to configure it yourself)
Release Notes
Please refer to CHANGELOG for details.
License
MIT License © 2023-PRESENT chengpeiquan