MfGames Conventional Commit

Up a Level

News

2025-08-12 Making It Useful

2025-12-05 Updating Dependencies

Blog Archives

Introduction

A small utility that calculates the sematic version from conventional commits in a Git repository.

This utility does only two things: calculate the semantic version[1] from Git commits that conform to the conventional commit[2] specification and provide a lightweight way of running scripts when it changes. It is path-aware which means only commits inside certain directories are included in the calculation. The current version number is built from the highest sematic version tag found in the commit's parents.

1: https://semver.org/

2: https://www.conventionalcommits.org/en/v1.0.0/

For example, the version of “Package1” will be 1.2.4 and “Package2” will be 1.3.0 from the following commits:

In the above example, the second commit is ignored while calculating the “Package1” commits which will have a new version of “1.3.0” because of the “feat” commit. While calculating “Package2”, the version will be “1.2.4” because of the “fix” in the second commit because the first is ignored.

If a version cannot be found, this will use `0.0.1`.

Documentation

The documentation for the entire project can be found in the ./docs/ folder[3] of this project

3: ./docs/

Metadata

Project:

Home

Documentation

Repository

Issues

- Project ID: 019530c5-8880-77e3-9e41-83db8b5a49ba</li>

Categories:

MfGames Conventional Commit

Footer

Below are various useful links within this site and to related sites (not all have been converted over to Gemini).

Categories

D. Moonfire

Fedran

The Moonfires

HTML

Atom Feed