Home

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

<p align="center"> <a href="https://docs.cocogitto.io/"><strong>Explore Cocogitto's docs&nbsp;&nbsp;▶</strong></a> </p>

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

Non goals

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

Packaging status

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 :

  1. Determine a version number according to your commit history.
  2. Perform configuration defined pre-bump commands.
  3. Append the version's changelog to your repository changelog file.
  4. Create a version commit and tag it.
  5. 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"}
]

cog bump example

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*

See User guide -> Changelogs.

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.

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.