Cocogitto – The conventional commits tool box

The conventional commits toolbox

Verified commits️: create conventional compliant commits with ease.
Automatic Version bump and changelog: automatically bump version and generate changelogs with your own custom steps and workflows.
Release profiles: your branching model requires different steps for releases, prerelease, hotfix ? We got you covered !
Depends only on libgit2: cocogitto has two 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.

Foreword

What is it ?

Cocogitto is a CLI and GitOps toolbox for the conventional commit and semver specifications.

Why ?

There are plenty of tools listed on the conventional commits web site 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 use in any other context.

It strives to be a set of simples, moderns 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 typo.
Correctness regarding semver and conventional commit.
Automate things when possible (ex: bumping versions).

Non goals

Coccogitto 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 with git.
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

shell yay -S cocogitto-bin

Cargo

shell cargo install cocogitto

Conventional commits

To create conventional commits you can use the coco binary. It has subcommands for the default fix andfeat conventional commits type plus the angular commit conventional commits types.

Example:

```shell

With coco

coco feat "add awesome feature"

With git

git commit -m "feat: add awesome feature" ```

See Coco guide -> Conventional commits.

Auto-bumps

Creating a version with cog bump will perform the following actions :

calculate a version number according to your commit history.
perform configuration defined pre-bump commands.
append the version changelog to your repository changelog file.
create a version commit and tag it.
perform post-bump commands

Example:

```shell

File: cog.toml

prebumphooks = [ "echo {{version}}", ]

postbumphooks = [ "git push", "git push origin {{version}}", ]

[changelog] path = "CHANGELOG.md" template = "remote" remote = "github.com" repository = "cocogittobotplayground" owner = "cocogitto" authors = [ { username = "oknozor", signature = "Paul Delafosse"} ] ```

cog bump example

Changelogs

cog changelog use tera templates to generate markdown changelogs. It has several built-in templates, and you can define your own.

Example:

shell cog changelog

Output :

```markdown

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 ```

See Cog guide -> Changelogs.

GitHub integration

Github action:

You can run cog check and perform auto releases via GitHub action using cocogitto-action.

Example: yaml - name: Semver release uses: oknozor/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 request against the conventional commits specification.

cog bot example

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.