chore(tooling): add commitizen and changelog support

.pre-commit-config.yaml

@@ -34,3 +34,11 @@ repos:
         language: system
         pass_filenames: false
         stages: [pre-commit]
+
+  #---
+  - repo: https://github.com/commitizen-tools/commitizen
+    rev: v4.18.0  # Replace with latest tag
+    hooks:
+      - id: commitizen
+      - id: commitizen-branch
+        stages: [pre-push]

CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on Conventional Commits and the changelog can be updated with Commitizen.

CONTRIBUTING.md

@@ -211,6 +211,21 @@ Performance-related PRs should explain:
 - what benchmark changed
 - why the change is safe
 
+## Commit messages
+
+This project follows the Conventional Commits specification.
+
+Examples:
+
+- `feat: add a new feature`
+- `fix(parser): handle invalid input`
+- `docs: update documentation`
+- `chore: update tooling`
+
+Install the commit message hook with:
+
+```bash
+uv run pre-commit install --hook-type commit-msg
 ---
 
 Happy hacking 🚀

pyproject.toml

@@ -52,6 +52,7 @@ dev = [
   "pre-commit>=4.5.1",
   "httpx>=0.28.1",
   "pydantic>=2,<3",
+  "commitizen>=4.18.0",
 ]
 
 [tool.black]
@@ -74,3 +75,8 @@ manifest-path = "rust-base32/Cargo.toml"
 module-name = "typeid._base32"
 features = ["pyo3/extension-module"]
 include = ["LICENSE", "README.md", "typeid/**", "rust-base32/**"]
+
+[tool.commitizen]
+name = "cz_conventional_commits"
+version_provider = "uv"
+update_changelog_on_bump = true