enforce conventional commits

.github/workflows/test.yml

@@ -2,7 +2,7 @@ name: test
 
 on:
   push:
-    branches: [ "main", "develop" ]
+    branches: [ "main" ]
   pull_request:
     branches: [ "main", "develop" ]
 

.pre-commit-config.yaml

@@ -0,0 +1,18 @@
+repos:
+- repo: https://github.com/pre-commit/pre-commit-hooks
+  rev: v4.5.0
+  hooks:
+    - id: check-added-large-files
+      args: ['--maxkb=5000']
+    - id: end-of-file-fixer
+    - id: trailing-whitespace
+    - id: check-executables-have-shebangs
+
+- repo: local
+  hooks:
+  - id: commitizen
+    name: commitizen
+    entry: cz check
+    args: [--allow-abort, --commit-msg-file]
+    language: python
+    stages: [commit-msg]

CHANGELOG.md

@@ -0,0 +1,6 @@
+## v0.2.0 (2025-07-31)
+
+### Feat
+
+- add pre-commit and commitizen into template repo
+- add commitizen support

README.md

@@ -16,7 +16,7 @@ A modern cookiecutter template for Python projects using `uv` as the package man
 ### Creating a new project
 
 If you want to keep your project in sync with this template, you can use
-*cruft*. 
+*cruft*.
 
 ```bash
 cruft create gh:haztecaso/python-template
@@ -41,6 +41,7 @@ cookiecutter gh:haztecaso/python-template
   - flake8 for code quality checks
   - pyright for static type checking
 - 🪝 **Git Hooks**: Automated quality checks with pre-commit
+- 📝 **Conventional Commits**: Standardized commit messages with commitizen
 - 🤖 **CI Pipeline**: GitHub Actions workflow for automated testing
 - 🧰 **CLI Support**: Optional command-line interface scaffolding with click or argparse
 - 📚 **Documentation**: Optional MkDocs setup with automatic API documentation generation and GitHub Pages deployment
@@ -57,4 +58,3 @@ cookiecutter gh:haztecaso/python-template
 - 🐳 **Containerization**: Dockerfile and docker-compose setup
 - 🔄 **Enhanced CI**: GitHub Action test matrix for multi-environment testing
 - 🐍 **PyPy**: Registry setup and GitHub Action for multi-interpreter testing
-

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "cookiecutter-haztecaso-python"
-version = "0.1.0"
+version = "0.2.0"
 description = "My personal cookiecutter template for Python"
 readme = "README.md"
 requires-python = ">=3.13"
@@ -13,7 +13,9 @@ build-backend = "hatchling.build"
 [dependency-groups]
 dev = [
     "black>=25.1.0",
+    "commitizen>=3.13.0",
     "isort>=6.0.1",
+    "pre-commit>=3.6.0",
     "pytest-cookies",
 ]
 
@@ -37,3 +39,16 @@ include = [
 testpaths = [ "tests" ]
 norecursedirs = [ "{{cookiecutter.project_slug}}" ]
 
+[tool.commitizen]
+version_provider = "uv"
+tag_format = "v${version}"
+version_scheme = "semver"
+update_changelog_on_bump = true
+
+[tool.black]
+line-length = 88
+target-version = ['py310', 'py311', 'py312', 'py313']
+include = '\.pyi?$'
+
+[tool.isort]
+profile = "black"