release-it plugin for lerna-changelog
npm install @release-it-plugins/lerna-changelogThis package is a release-it plugin
(using release-it's plugin
API) that
integrates lerna-changelog into therelease-it pipeline.
Installation using your projects normal package manager, for example:
``npm
npm install --save-dev @release-it-plugins/lerna-changelog
Once installed, configure
release-it to use the plugin.Either via
package.json:`json
{
"release-it": {
"plugins": {
"@release-it-plugins/lerna-changelog": {}
}
}
}
`Or via
.release-it.json:`json
{
"plugins": {
"@release-it-plugins/lerna-changelog": {}
}
}
`Configuration
@release-it-plugins/lerna-changelog supports one configuration option, infile. When
specified, this option represents the file name to prepend changelog
information to during a release.For example, given the following configuration (in
package.json):`json
{
"release-it": {
"plugins": {
"@release-it-plugins/lerna-changelog": {
"infile": "CHANGELOG.md",
"launchEditor": true
}
}
}
}
`The two options that
@release-it-plugins/lerna-changelog is aware of are:$3
infile represents the file to prepend the generated changelog into.$3
When specified,
@release-it-plugins/lerna-changelog will generate the changelog
then launch the configured editor with a temporary file. This allows the person
doing the release to customize the changelog before continuing.There are a few valid values for
launchEditor:*
false - Disables the feature.
* true - If present the process.env.EDITOR value will be used as the
command to invoke, if process.env.EDITOR is not found process.env.PATH
will be searched for a command named editor (which is commonly used on
Debian / Ubuntu systems to point to the currently configured editor). The
temporary file for editing is added as an argument (i.e.
$EDITOR /some/tmp/file).
* any string - This string will be used as if it were a command. In order to
interpolate the temporary file path in the string, you can use ${file} in
your configuration.Each release will run
lerna-changelog and prepend the results into CHANGELOG.md`.This project is licensed under the MIT License.