Awesome
<p align="center"> <img width="250" src="./docs/logo/COCOGITTO_LP_LOGO_TEXT_72dpi.png" alt="Cocogitto – The conventional commits tool box" /> </p> <p align="center"> <a href="https://github.com/cocogitto/cocogitto/actions" ><img src="https://github.com/cocogitto/cocogitto/workflows/CI/badge.svg" alt="GitHub Actions workflow status" /></a> <a href="https://codecov.io/gh/cocogitto/cocogitto" ><img src="https://codecov.io/gh/cocogitto/cocogitto/branch/main/graph/badge.svg" alt="Code coverage status" /></a> <br /> <a href="https://conventionalcommits.org" ><img src="https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg" alt="Conventional commits" /></a> <a href="https://github.com/cocogitto/cocogitto/blob/main/LICENSE" ><img src="https://img.shields.io/github/license/cocogitto/cocogitto" alt="Repository license" /></a> <a href="https://discord.gg/WeZRdhtuf6"> <img alt="Discord logo" src="https://img.shields.io/discord/951009223121195021?color=blue&logo=discord"> </a> </p> <p align="center"> <a href="https://docs.cocogitto.io">Website</a> · <a href="#installation">Installation</a> · <a href="https://docs.cocogitto.io/config">Configuration</a> </p> <h1></h1>The Conventional Commits toolbox
- Verified commits: create conventional compliant commits with ease.
- Automatic Version bump and changelog: automatically bump versions and generate changelogs with your own custom steps and workflows.
- Release profiles: your branching model requires different steps for releases, pre-release, hotfixes ? We got you covered !
- Depends only on libgit2: cocogitto has one standalone binary, the only system dependency is libgit2.
- Conventional git log: search your commit history matching Conventional Commits items such as scope and commit type.
- GitHub integration: enforce the conventional commits specification with our GitHub action and bot.
- Monorepo support: Automatic versioning for mono-repositories is supported out of the box.
Foreword
What is it ?
Cocogitto is a CLI and GitOps toolbox for the Conventional Commits and Semver specifications.
Why ?
There are plenty of tools listed on the conventional commits website to help you generate changelog, git hooks, commit template etc. Some of them are specifically designed for the Conventional Commits specification, and some of them are general purpose.
Cocogitto was designed to help you respect the conventional and semver standard and is not intended to be used in any other context.
It strives to be a set of simple, modern and fast command line interfaces.
Goals
- Make using the conventional commits spec easy and fun.
- Enable people to focus on their work instead of correcting small mistakes and typos.
- Enforce correctness regarding Semver and Conventional Commits.
- Automate things when possible (ex: bumping versions).
Non goals
- Cocogitto is not a
git
replacement. It uses some of libgit2 but only to provide features related to the Conventional Commits specification. Anything else shall be done withgit
. - Supporting other commit conventions or git workflows.
Quick start
This readme is a quick tour of what you can do with Cocogitto, for an in-depth guide please refer to the documentation.
Installation
Archlinux
pacman -S cocogitto
Cargo
cargo install --locked cocogitto
NixOs
nix-env -iA cocogitto
Void Linux
xbps-install cocogitto
MacOS
brew install cocogitto
Conventional commits
To create conventional commits you can use the cog commit
command.
It has subcommands for the default fix
and feat
Conventional Commits types
plus the angular commit
conventional commit types.
Example:
# With cog
cog commit feat "add awesome feature"
# With git
git commit -m "feat: add awesome feature"
See User guide -> Conventional commits.
Configuration
Use cog.toml
file to configure your usage of Cocogitto.
For the full list of options, see User guide -> Configuration reference.
Auto-bumps
Creating a version with cog bump
will perform the following actions :
- Determine a version number according to your commit history.
- Perform configuration defined pre-bump commands.
- Append the version's changelog to your repository changelog file.
- Create a version commit and tag it.
- Perform post-bump commands
Example:
# File: cog.toml
pre_bump_hooks = [
"echo {{version}}",
]
post_bump_hooks = [
"git push",
"git push origin {{version}}",
]
[changelog]
path = "CHANGELOG.md"
template = "remote"
remote = "github.com"
repository = "cocogitto_bot_playground"
owner = "cocogitto"
authors = [
{ username = "oknozor", signature = "Paul Delafosse"}
]
Changelogs
cog changelog
uses tera templates to generate markdown changelogs. It has several built-in
templates, and you can define your own.
Example:
cog changelog
Output :
## 1.2.0 - 2021-11-26
#### Bug Fixes
- **(parser)** handle lowercase identifier - (7521015) - *oknozor*
- handle unknown flag - (e2388dc) - oknozor
#### Features
- **(parser)** simple parser implementation - (0b25eb6) - *oknozor*
- add a new cli flag - (ff84173) - oknozor
#### Miscellaneous Chores
- **(version)** 1.2.0 - (15d1333) - *oknozor*
#### Refactoring
- **(parser)** use a parser interface instead of concrete impl - (ea24c36) - *oknozor*
#### Tests
- add integration test - (bae629c) - *oknozor*
Docker
There is a docker image for cog
available ghcr.io/cocogitto/latest.
Usage:
docker pull ghcr.io/cocogitto/cog:latest
docker run -t -v "$(pwd)":/app/ check
Note that you need to mount a volume pointing to your target directory for cog
to be able to operate on your git log.
See Docker -> Using cocogitto with docker.
GitHub integration
GitHub action:
You can run cog check and perform automatic releases via GitHub action using cocogitto-action.
Example:
- name: Semver release
uses: cocogitto/cocogitto-action@main
with:
release: true
git-user: 'Cog Bot'
git-user-email: 'mycoolproject@org.org'
See Github integration -> GitHub action
GitHub bot:
cocogitto-bot is a standalone, zero-config bot checking your pull requests against the Conventional Commits specification.
See Github integration -> GitHub-bot
Similar projects
Contributing
Found a bug, have a suggestion for a new feature? Please read the contribution guideline and submit an issue.
Licence
All the code in this repository is released under the MIT License, for more information take a look at the LICENSE file.