19 unstable releases (3 breaking)
0.4.17 | Jan 31, 2023 |
---|---|
0.4.16 | Jan 30, 2023 |
0.4.15 | Sep 23, 2022 |
0.3.10 | Sep 22, 2022 |
0.1.7 | Sep 22, 2022 |
#2220 in Command line utilities
57 downloads per month
11KB
180 lines
rcz
A tool to write a commit message based on Conventional Commits
inspired by git-cz
Installation
cargo install rcz
Example
# bash
function gitz() {
local output
if output=$(rcz); then
git commit -m "${output}"
else
echo "Err: failed to generate a commit message"
fi
}
or
.gitconfig
[alias]
cz = "!gitz() { if local output= ...}; gitz"
gif
Configuration
The configuration file will be automatically generated on:
- Linux:
~/.config/rcz
- Windows:
{FOLDERID_RoamingAppData}\rcz
- Mac OS:
~/Library/Preferences/rs.rcz
Default configuration
format = '''
{type}: {subject}'''
[[types]]
description = 'A bug fix'
value = 'fix'
emoji = '๐'
[[types]]
description = 'A new feature'
value = 'feat'
emoji = 'โจ'
[[types]]
description = 'Changes that introduces a breaking API change'
value = 'BREAKING CHANGE'
emoji = '๐ฅ'
[[types]]
description = 'build system or external dependencies'
value = 'chore'
emoji = '๐ ๏ธ'
[[types]]
description = 'CI related changes'
value = 'ci'
emoji = '๐ซ'
[[types]]
description = 'Documentation only changes'
value = 'docs'
emoji = 'โ๏ธ'
[[types]]
description = 'Changes that do not affect the meaning of the code'
value = 'style'
emoji = '๐'
[[types]]
description = 'A code change that neither fixes a bug nor adds a feature'
value = 'refactor'
emoji = '๐งน'
[[types]]
description = ' A code change that improves performance'
value = 'perf'
emoji = '๐'
[[types]]
description = 'Adding or correcting tests'
value = 'test'
emoji = '๐งช'
Format
All section etc {scope}
that you can add on the format are bellow.
{type}
{emoji}
{description}
โ ๏ธ The string that enclosed in double brackets ({{echo 'foo'}}
, {{date}}
etc) is interpreted as shell script.
Other strings ({body}
, {footer}
, {header}
etc) is interpreted as a custom input.
The string is used as a prompt message.
Sometimes you don't have a scope and have to delete the brackets. If a space is entered for scope, brackets are removed altogether. #6
A example for your customize is bellow.
format = '''
{type}{scope}: {emoji}{subject}
{body}
{footer}'''
Dependencies
~2โ10MB
~92K SLoC