mirror of
https://github.com/webinstall/webi-installers.git
synced 2026-02-14 17:49:53 +00:00
109 lines
2.2 KiB
Markdown
109 lines
2.2 KiB
Markdown
---
|
|
title: koji
|
|
homepage: https://github.com/its-danny/koji
|
|
tagline: |
|
|
🦊 An interactive CLI for creating conventional commits.
|
|
---
|
|
|
|
To update or switch versions, run `webi koji@stable` (or `@v2`, `@beta`, etc).
|
|
|
|
**Note**: You should install [git](/git) before installing koji.
|
|
|
|
## Cheat Sheet
|
|
|
|
> `koji` is an interactive CLI for creating [conventional commits][cc].
|
|
|
|
|
|
|
|
[cc]: https://conventionalcommits.org/en/v1.0.0/
|
|
|
|
You can use koji in one of two ways:
|
|
|
|
1. `koji` instead of `git commit`
|
|
2. `koji --hook` in `./.git/hooks/prepare-commit-msg` \
|
|
(to be run by `git commit`)
|
|
|
|
Here's the shortlist of options we've found most useful:
|
|
|
|
```txt
|
|
-e, --emoji - use emoji for commit type (ex: `✨ feat:`)
|
|
-a, --autocomplete - guess 'scope' based on commit history (slow on large projects)
|
|
--hook - expect to be run from 'git commit', rather than wrap it
|
|
```
|
|
|
|
### Files
|
|
|
|
These are the files that are created and/or modified with this installer:
|
|
|
|
```sh
|
|
~/.config/envman/PATH.env
|
|
~/.local/bin/koji
|
|
~/.local/opt/koji-VERSION/bin/koji
|
|
```
|
|
|
|
### How to use koji (standalone)
|
|
|
|
In this case, `koji` acts as a wrapper around `git commit`:
|
|
|
|
```sh
|
|
git add example.env
|
|
|
|
# same as `git commit`, but interactive
|
|
koji
|
|
```
|
|
|
|
### How to use koji as a commit hook
|
|
|
|
Just add `koji --hook` to your project's `.git/hooks/prepare-commit-msg`:
|
|
|
|
```sh
|
|
echo >> ./.git/hooks/prepare-commit-msg << "EOF"
|
|
#!/bin/bash
|
|
koji --hook
|
|
EOF
|
|
|
|
chmod a+x ./.git/hooks/prepare-commit-msg
|
|
```
|
|
|
|
```sh
|
|
# will run koji by way of prepare-commit-msg
|
|
git commit
|
|
```
|
|
|
|
### How to use Emoji
|
|
|
|
You can use `-e` (or `--emoji`) to prepend your commit message with the relevant
|
|
emoji for the commit type:
|
|
|
|
```sh
|
|
koji -e
|
|
```
|
|
|
|
As a git hook:
|
|
|
|
`.git/hooks/prepare-commit-msg`:
|
|
|
|
```sh
|
|
#!/bin/bash
|
|
koji --emoji --hook
|
|
```
|
|
|
|
You can also use _shortcodes_ (`:pinched_fingers:`) in the scope, summary, or
|
|
body.
|
|
|
|
### How to configure Koji (custom emoji)
|
|
|
|
You can add custom commit types via a `koji.toml` in the project directory.
|
|
|
|
For example:
|
|
|
|
```toml
|
|
[[commit_types]]
|
|
name = "feat"
|
|
emoji = "✨"
|
|
description = "A new feature"
|
|
```
|
|
|
|
The default emoji can be seen in
|
|
[koji-default.toml](https://github.com/its-danny/koji/blob/main/meta/config/koji-default.toml).
|