@auto-it/conventional-commits

Conventional commit plugin for auto

Usage no npm install needed!

<script type="module">
  import autoItConventionalCommits from 'https://cdn.skypack.dev/@auto-it/conventional-commits';
</script>

README

Conventional Commits Plugin

Parse conventional commit messages and use them to calculate the version. This plugin will omit the PR HEAD if it isn't labeled and has a commit with a conventional-commit commit message.

The default behavior extends the conventional commits spec:

  • Type fix: => patch
  • Type feat: => minor
  • Type BREAKING: => major
  • A ! in the type indicated a breaking change
  • BREAKING CHANGE in the footer indicates a breaking change
  • All other types are considered skip-release

Installation

This plugin is not included with the auto CLI installed via NPM. To install:

npm i --save-dev @auto-it/conventional-commits
# or
yarn add -D @auto-it/conventional-commits

Usage

{
  "plugins": [
    "npm",
    "conventional-commits"
    // other plugins
  ]
}

Options

preset

You can use any conventional-changelog preset with this plugin. Using a preset will completely override this plugin's default behavior with whatever the preset defines.

{
  "plugins": [
    "npm",
    ["conventional-commits", { "preset": "angular" }]
    // other plugins
  ]
}

defaultReleaseType

The default release type to apply when the conventional commit isn't "fix", "feat" or "breaking" (ex: "chore:"). Defaults to skip.

{
  "plugins": [
    "npm",
    ["conventional-commits", { "defaultReleaseType": "patch" }]
    // other plugins
  ]
}