Prepend emoji to matching semantic commit messages.
- This package adds github compatible emojis to commit messages in plain text.
- This package is intended to be used directly in the
commit-msggit hook. - Following git hook documentation, it will rewrite temp commit messages that follow certain semantic commit type keywords.
- It can rewrite other messages, like automated version commits, merges, and reverts.
- This is similar to other implementations, but instead of choosing between emoji or explicit semantic commit, you get both!
- This also follows some of the emoji suggestions from gitmoji.
- Allows for overriding conventional emojis with your own if you provide it in the message. (Useful for chore if you want more granularity)
Example:
$ git commit -m "feat: Add new function" -m "Some expanded description about the feature"
$ git log --format=%B -n 1 HEAD
:sparkles:feat: Add new function
Some expanded description about the feature
$- Add native emojis to commit mesages.
- This will not enforce that commits are of a semantic commit pattern.
- It will also not prepend emojis to messages that do not follow a semantic commit pattern.
- For simplicity, the total list of gitmoji has been reduced to some
The list of current message types and their used emoji
| Type | Emoji |
|---|---|
| feat | ✨ :sparkles: |
| fix | 🐛 :bug: |
| docs | 📝 :pencil: |
| refactor | ♻️ :recycle: |
| style | 🎨 :art: |
| test | 🔬 :microscope: |
| perf | ⚡ :zap: |
| hotfix | 🚑 :ambulance: |
| locale | 🌐 :globe_with_meridians: |
| ci | 👷 :construction_worker: |
| chore | 🔧 :wrench: |
| types | 🏷️ :label: |
This can either be a global module if this is just a personal preference, or a project one, so that you may enforce consistency on all contributors. It is recommended that you use a utility, like Husky, to manage consistently setting up git hooks on project setup.
yarn global add semantic-commit-emoji
# or
npm g i semantic-commit-emojiyarn add --dev semantic-commit-emoji
# or
npm install --save-dev semantic-commit-emojiFor a standalone git hook, you can symlink the script into the appropriate hook
mkdir -p .git/hooks
ln -s ./node_modules/.bin/semantic-commit-emojiIf you want this hook to run with other commit-message or prepare-commit-message hooks, it can be called from the hook file like this (assuming sh syntax):
#!/bin/sh
# ... Other git hooks
# If globally installed module
commit-message-emoji "$@"
# Or if localy installed module
npx commit-message-emoji "$@"An example for husky can be found in this repo's .huskyrs.js file.
By design, this package will let you override an emoji with your own if you provide it in your message. This offers the greatest flexibility for your own preferences over the conventions of this script.
It is recommended that you use this in the commit-msg hook, as the prepare-commit-msg hook prepares templates for an editor.
This means that if a user runs git commit their message that was entered via an external editor will not get processed, and therefore will miss the benefits of this package.
Since this is a user script, this will not be able to rewrite messages generated by git server actions, like merging a PR on github or bitbucket. If need be, you could write a CI step to detect merged and reverts from your source control server, rewrite the message and force push it back up. However, it is the opinion of the maintainer that you shoud probably just do a manual merge of PRs according to the copy+paste script that github provides.