yac

yaclt

Yet Another Change Log Tool

Showing:

Popularity

Downloads/wk

161

GitHub Stars

15

Maintenance

Last Commit

3d ago

Contributors

8

Package

Dependencies

7

License

MPL-2.0

Type Definitions

Tree-Shakeable

No?

Categories

Readme

GitHub issues Build NPM Publish npm version Discord Server Husky yargs Neovim plugin

yaclt logo

Yet Another Change Log Tool

Friends don't let friends use git commit messages as change log entries; they should be more thoughtfully written.

yaclt is a highly configurable, file-based change log generator and validator. Include a change log entry file generated by yaclt in each Pull Request, then use yaclt again to gather each individual entry into CHANGELOG.md as part of your release process.

yaclt new command demo

Features

  • Customize the format of individual entries and CHANGELOG.md using Handlebars
  • Add your own extra user-defined validations using pre- and post-command hooks
  • Validate that all change log entries match a specified format (e.g. for use in CI pipelines)
  • Automatically parse issue numbers from branch names
  • Automatically checkout a new branch for generating release notes (branch name customizable with Handlebars)
  • Neovim plugin (yaclt.nvim)
  • And more

The full set of options for each command can be found in COMMANDS.md or by running the command with the --help argument.

Configuration

All command line flags and arguments can be specified in a configuration file. Most likely you will want most of your options to be specified in a configuration file. Supported file names are yacltrc.yml, yacltrc.yaml, yacltrc.json, and yacltrc.js (.js config must use CommonJS format, e.g. module.exports =). Options passed on the command line will override options from the configuration file if present.

If the working directory is inside a git repository, the tree will be traversed to the git root, using the first valid configuration file that is found. If no configuration file is found in the repo, it will also check, in order of precedence, $YACLT_CONFIG_HOME/, $XDG_CONFIG_HOME/yaclt/, $HOME/.config/yaclt/ for global configuration files.

If you are using a Javascript configuration file (e.g. yacltrc.js), any of the options can be a parameterless function which returns a value of the same type expected by the option. This can be useful, for example, if you'd like to write some custom logic to parse the next release number based on git tags, or generate your messages automatically from git commit messages.

For options which are Handlebars templates (e.g. --format, --releaseBranchPattern, or --changelogTemplate), you may specify a filepath instead of a literal template string. The CLI will check if the argument is a filepath to a file that exists, and if so, read the template from that file.

Documentation on customizing formats with Handlebars can be found in handlebars-templates.md.

Configuration Recipes

Some common configuration recipes can be found in the wiki.

Contributing

See CONTRIBUTING.md

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100