Skip to main content

Tidy git commit messages, linting, and logging

Project description

git-tidy is a set of git extensions for:

  1. Keeping your git logs tidy with ease. git tidy-commit guides users through a structured commit with a configurable schema. git tidy-squash squashes messy commits into one tidy commit.

  2. Linting a commit log. git tidy-lint verifies that commits match the schema. If a user uses git tidy-commit, commits will always validate.

  3. Rendering a commit log. git tidy-log can render commits from any range and can render structured commits from a configurable Jinja template. Want to automatically generate release notes? git tidy-log can be configured to group and render commits based on the schema.


View the git-tidy docs here for a complete tutorial on using git-tidy.


git-tidy can be installed a number of ways. The preferred way on OSX is with homebrew

brew tap jyveapp/homebrew-tap
brew install git-tidy

If not on OSX, one can install git-tidy system-wide with pipx:

pipx install git-tidy

git-tidy can also be installed with pip. Be sure to install it system-wide so that git-tidy’s execution is not tied to a virtual environment:

pip3 install git-tidy

Contributing Guide

For information on setting up git-tidy for development and contributing changes, view CONTRIBUTING.rst.

Primary Authors

  • @wesleykendall (Wes Kendall)

  • @tomage (Tómas Árni Jónasson)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

git-tidy-1.2.0.tar.gz (15.5 kB view hashes)

Uploaded source

Built Distribution

git_tidy-1.2.0-py3-none-any.whl (15.8 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page