semantic-release plugin to create or update a changelog file

Package: @semantic-release/changelog

Created by: semantic-release

Last modified: Wed, 12 Jul 2023 19:37:51 GMT

Version: 6.0.3

License: MIT

Downloads: 2,885,306

Repository: https://github.com/semantic-release/changelog

Install

npm install @semantic-release/changelog

yarn add @semantic-release/changelog

@semantic-release/changelog

semantic-release plugin to create or update a changelog file.

Step	Description
`verifyConditions`	Verify the `changelogFile` and `changelogTitle` options configuration.
`prepare`	Create or update a changelog file in the local project directory with the changelog content created in the generate notes step.

Install

 $ npm install @semantic-release/changelog -D

Usage

The plugin can be configured in the semantic-release configuration file:

 {
  "plugins": [
    "@semantic-release/commit-analyzer",
    "@semantic-release/release-notes-generator",
    [
      "@semantic-release/changelog",
      {
        "changelogFile": "docs/CHANGELOG.md"
      }
    ],
    [
      "@semantic-release/git",
      {
        "assets": ["docs/CHANGELOG.md"]
      }
    ]
  ]
}

With this example, for each release, a docs/CHANGELOG.md will be created or updated.

Configuration

Options

Options	Description	Default
`changelogFile`	File path of the changelog.	`CHANGELOG.md`
`changelogTitle`	Title of the changelog file (first line of the file).	-

Examples

When used with the @semantic-release/git or @semantic-release/npm plugins the @semantic-release/changelog plugin must be called first in order to update the changelog file so the @semantic-release/git and @semantic-release/npm plugins can include it in the release.

 {
  "plugins": [
    "@semantic-release/commit-analyzer",
    "@semantic-release/release-notes-generator",
    "@semantic-release/changelog",
    "@semantic-release/npm",
    "@semantic-release/git"
  ]
}