5.0.3 • Published 2 years ago

@ronnieacs/cz-conventional-commit v5.0.3

Weekly downloads
-
License
MIT
Repository
github
Last release
2 years ago

cz-conventional-commit

commitizen adapter following the conventional-changelog format, with emojis and additionnal commit types (aliases).

Travis Codecov Greenkeeper badge license

Screenshot

Install as a global utility

npm install --global commitizen @ronnieacs/cz-conventional-commit

Create a .czrc file in your home directory, with the following content:

{
  "path": "@ronnieacs/cz-conventional-commit",
  "cz-conventional-commit": {
    "maxSubjectLength": 72,
    "bodyLineLength": 100
  }
}

Now cd into any git repository and use git cz instead of git commit and you will find the commitizen prompt.

See commitizen documentation for more informations.

Making your repo Commitizen-friendly

npm install --save-dev commitizen @ronnieacs/cz-conventional-commit
./node_modules/.bin/commitizen init @ronnieacs/cz-conventional-commit --save-dev

You can customize cz-conventional-commit in package.json:

...
"config": {
  "commitizen": {
    "path": "@ronnieacs/cz-conventional-commit",
    "cz-conventional-commit": {
      "maxSubjectLength": 72,
      "bodyLineLength": 100,
      "emoji": true
    }
  }
}
...

See commitizen documentation for more informations.

Options

OptionDescriptionDefault
maxSubjectLengthLength at which to truncate the commit head (head includes type, scope, subject and emoji)72
bodyLineLengthLength at which to wrap body lines100
emojiTo add and emoji at the end of the commit messagefalse

Commit types

Commit TypeTitleDescriptionEmoji
featFeaturesA new feature
fixBug FixesA bug Fix🐛
docsDocumentationDocumentation only changes📚
styleStylesChanges that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)💎
refactorCode RefactoringA code change that neither fixes a bug nor adds a feature📦
perfPerformance ImprovementsA code change that improves performance🚀
testTestsAdding missing tests or correcting existing tests🚨
buildBuildsChanges that affect the build system or external dependencies (example scopes: gulp, broccoli, npm)🛠
ciContinuous IntegrationsChanges to our CI configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs)⚙️
choreChoresOther changes that don't modify src or test files♻️
revertRevertsReverts a previous commit🗑

Commit aliases

Aliases are additionnal commit types that will be formatted to follow AngularJS Commit Message Conventions and automatically set some fields.

For example when choosing initial, cz-conventional-commit will automatically set:

  • the standard type to feat
  • the scope to empty
  • the subject to 'Initial commit 🎉'
  • the issues to empty
  • the breaking to empty

The commit message will be feat: Initial commit 🎉.

Commit TypeTypeScope (default)Subject (default)Emoji
initialfeatemptyInitial commit🎉
dependenciesfixpackage-
peerDependenciesfixpackage-⬆️
devDependencieschorepackage-🔼
metadatafixpackage-📦

Related