Skip to main content

A CLI tool that infers a next version number for Git repos.

Project description


pypi version pypi python versions pipeline status Documentation Status sonarcloud quality gate sonarcloud coverage sonarcloud bugs sonarcloud reliability

A CLI tool that infers a next version number for Git repos. It does its magic by looking at the commit messages of commits made since the last tag that had a semver in it. For this to work properly, your commits should following the Conventional Commits spec.

Getting started

Requires Git 2.0+.

To use the tool:

  • pip install --upgrade chronos-cli
  • Change into a Git repo.
  • chronos infer

To bootstrap a development environment (after you've cloned the repo and changed into it):

  • pip install --upgrade pipenv
  • pipenv sync --dev


Docs are hosted at


This project follows PEP8.


  • pytest will run unit tests in this repo.
  • flake8 will lint the code.

This repo also has a CI/CD pipeline built with Ansible and GitLab CI.

The pipeline's Ansible playbook can be run on your *nix workstation too:

ansible-playbook ansible/pipeline.yml --tags build


Commits should follow the Conventional Commits spec.




  • Thanks to Eric Poitras for asking me to write an earlier version of what would become this tool. This was really his idea.

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

chronos-cli-0.2.12.tar.gz (6.5 kB view hashes)

Uploaded source

Built Distribution

chronos_cli-0.2.12-py3-none-any.whl (7.8 kB view hashes)

Uploaded py3

Supported by

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