quick-commit 0.2.0

Add your description here

quick-commit

quick-commit is a CLI-based git commit automation tool that helps you follow the Conventional Commits specification.

The main features include:

• automatic generation of commit messages based on the Conventional Commits specification with gitmoji support.
• filter functions to find your desired commit types, scopes, and gitmojis.
• sorting methods to give you your most commonly/recently used gitmojis and scopes right away.
• commit message validation to ensure your commit messages are formatted correctly.
• a simple and easy-to-use interface.
• a customisable configuration file to suit your needs.

quick-commit is designed to help you write better commit messages and make your git history more readable and understandable with the least amount of effort.

Installation

To install quick-commit, you can use the following command:

pipx install quick-commit

This installs the quick-commit python application (requires Python 3.10 or later) and makes it available as a command-line tool.

Usage

To use quick-commit, you can run the following command:

quick-commit

This will open the quick-commit CLI interface where you can customise your commit message. Starting quick-commit with the -a flag additionally stages all modified files for the commit.

If you wish to include a footer in your commit message, use the flag --footer (or enable it by default in the configuration file).

To mark breaking changes in your commit message, use the flag --breaking.

Configuration

quick-commit uses a configuration file to store your preferences. A configuration file can be stored locally for your project at .quick-commit-config.yaml or globally in your user-config directory (/home/username/.config/quick-commit/config.yaml for Linux, or C:\Users\username\AppData\Roaming\quick-commit\config.yaml for Windows).

An example configuration file that shows off all supported settings is as follows:

types:
  exclude:
    - chore
    - revert
  add:
    - name: my-commit-type
      description: My custom commit type
    - name: my-other-commit-type
      description: My other custom commit type
  priority:
    - feat
    - my-commit-type
    - my-other-commit-type

scopes:
  exclude:
    - deps
    - '#\d+'
  add:
    - my-new-scope
  prohibit-no-scope: true

message:
  custom-pattern: '^\w+\.'

gitmojis:
  exclude:
    - art
    - fire
  add:
    - icon: 🎨
      name: my-gitmoji
      description: My custom gitmoji.
    - icon: 🔥
      name: my-gitmoji-2
      description: My custom gitmoji number 2.
  priority:
    - sparkles
    - my-gitmoji
    - my-gitmoji-2

always-enable-footer: true