git_emoji_enhancer 0.1.0

SDKdartflutter
Platformandroidioswindowslinuxmacos

A tool to enhance Git commit messages with emojis.

Git Emoji Enhancer

A Dart package to automatically add emojis to Git commit messages based on keywords, making your commit history more expressive and easier to understand.

Features

  • Emoji Enhancement: Adds relevant emojis to commit messages based on keywords.
  • File Support: Reads commit messages from a file and enhances them with emojis.
  • Git Hook Generation: Creates a Git hook to enhance commit messages automatically during the commit process.

Keywords and Emojis

Enhance your commit messages with the following keywords and their corresponding emojis:

KeywordDescriptionEmoji
featNew feature
fixBug fix🐛
docsDocumentation changes📝
styleCode style changes🎨
refactorRefactoring code♻️
testAdding or fixing tests
choreMaintenance and chores🔧
perfPerformance improvements
buildBuild related changes🏗️
ciContinuous Integration👷

Usage

Command-Line Tool

The git_emoji_enhancer command-line tool provides options to enhance commit messages:

  • -m or --message - Add emojis to a specific commit message.
  • -p or --path - Read a commit message from a file and add emojis.
  • -g or --generate-hook - Generate a prepare-commit-msg hook to automatically enhance commit messages.

Examples

Add emojis to a commit message:

dart run git_emoji_enhancer -m "fix: correct typo"

Output:

🐛 fix: correct typo

Read commit message from a file and add emojis:

dart run git_emoji_enhancer -p /path/to/commit_message.txt

If commit_message.txt contains:

feat: add new feature
fix: correct bug

Output:

✨ feat: add new feature
🐛 fix: correct bug

Generate the Git hook:

dart run git_emoji_enhancer -g

Creates a prepare-commit-msg hook in the .git/hooks/ directory to automatically add emojis to your commit messages.

Git Commit Example:

After generating the Git hook, commit as usual:

git commit -m "feat: first commit"

Automatically Enhanced Output:

✨ feat: first commit