Feature/uv

.github/pull_request_template.md

@@ -14,7 +14,7 @@ Please fill in the following content to let us know better about this change.
 ### Code Changes
 
 - [ ] Add test cases to all the changes you introduce
-- [ ] Run `poetry all` locally to ensure this change passes linter check and tests
+- [ ] Run `uv run poe all` locally to ensure this change passes linter check and tests
 - [ ] Manually test the changes:
   - [ ] Verify the feature/bug fix works as expected in real-world scenarios
   - [ ] Test edge cases and error conditions
@@ -24,10 +24,10 @@ Please fill in the following content to let us know better about this change.
 
 ### Documentation Changes
 
-- [ ] Run `poetry doc` locally to ensure the documentation pages renders correctly
+- [ ] Run `uv run poe doc` locally to ensure the documentation pages renders correctly
 - [ ] Check and fix any broken links (internal or external) in the documentation
 
-> When running `poetry doc`, any broken internal documentation links will be reported in the console output like this:
+> When running `uv run poe doc`, any broken internal documentation links will be reported in the console output like this:
 >
 > ```text
 > INFO    -  Doc file 'config.md' contains a link 'commands/bump.md#-post_bump_hooks', but the doc 'commands/bump.md' does not contain an anchor '#-post_bump_hooks'.

.github/workflows/docspublish.yml

@@ -15,17 +15,16 @@ jobs:
           token: ${{ secrets.PERSONAL_ACCESS_TOKEN }}
           fetch-depth: 0
       - name: Set up Python
-        uses: actions/setup-python@v6
+        uses: astral-sh/setup-uv@v6
         with:
           python-version: "3.x"
       - name: Install dependencies
         run: |
-          python -m pip install -U pip poetry poethepoet
-          poetry --version
-          poetry install --only main,script
+          uv --version
+          uv sync --locked --group script
       - name: Update CLI screenshots
         run: |
-          poetry doc:screenshots
+          uv run poe doc:screenshots
       - name: Commit and push updated CLI screenshots
         run: |
           git config --global user.name "github-actions[bot]"
@@ -51,14 +50,13 @@ jobs:
         run: |
           git pull origin master
       - name: Set up Python
-        uses: actions/setup-python@v6
+        uses: astral-sh/setup-uv@v6
         with:
           python-version: "3.x"
       - name: Install dependencies
         run: |
-          python -m pip install -U pip poetry poethepoet
-          poetry --version
-          poetry install --no-root --only documentation
+          uv --version
+          uv sync --locked --only-group documentation
       - name: Generate Sponsors 💖
         uses: JamesIves/github-sponsors-readme-action@v1
         with:
@@ -69,7 +67,7 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
-          poetry doc:build
+          uv run poe doc:build
       - name: Deploy 🚀
         uses: JamesIves/github-pages-deploy-action@v4
         with:

.github/workflows/homebrewpublish.yml

@@ -14,12 +14,11 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v6
       - name: Set up Python
-        uses: actions/setup-python@v6
+        uses: astral-sh/setup-uv@v6
         with:
           python-version: "3.x"
       - name: Install dependencies
-        run: |
-          python -m pip install -U commitizen
+        run: uv pip install -U commitizen
       - name: Set Project version env variable
         run: |
           echo "project_version=$(cz version --project)" >> $GITHUB_ENV

.github/workflows/links.yml

@@ -0,0 +1,41 @@
+name: Links
+
+on:
+  repository_dispatch:
+  workflow_dispatch:
+  pull_request:
+  schedule:
+    - cron: "00 18 * * *"
+
+jobs:
+  check-links:
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write # required for peter-evans/create-issue-from-file
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Link Checker
+        id: lychee
+        uses: lycheeverse/lychee-action@v2
+        with:
+          args: --config lychee.toml .
+          fail: false
+
+      - name: Broken Links Report
+        if: steps.lychee.outputs.exit_code != 0 && github.event_name == 'schedule'
+        uses: actions/github-script@v8
+        with:
+          script: |
+            const fs = require('fs');
+
+            // Read the markdown file
+            // Ensure the path is correct relative to the workspace root
+            const reportBody = fs.readFileSync('./lychee/out.md', 'utf8');
+
+            await github.rest.issues.create({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              title: 'Broken Links Report',
+              body: reportBody
+            });

.github/workflows/pythonpackage.yml

@@ -6,27 +6,26 @@ jobs:
   python-check:
     strategy:
       matrix:
-        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
         platform: [ubuntu-22.04, macos-latest, windows-latest]
     runs-on: ${{ matrix.platform }}
     steps:
       - uses: actions/checkout@v6
         with:
           fetch-depth: 0
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v6
+        uses: astral-sh/setup-uv@v6
         with:
           python-version: ${{ matrix.python-version }}
       - name: Install dependencies
         run: |
-          python -m pip install -U pip poetry poethepoet
-          poetry --version
-          poetry install --only main,linters,test
+          uv --version
+          uv sync --locked --dev --group test --group linters
       - name: Run tests and linters
         run: |
           git config --global user.email "action@github.com"
           git config --global user.name "GitHub Action"
-          poetry ci
+          uv run poe ci
         shell: bash
       - name: Upload coverage to Codecov
         if: runner.os == 'Linux'

.github/workflows/pythonpublish.yml

@@ -14,15 +14,10 @@ jobs:
           token: "${{ secrets.PERSONAL_ACCESS_TOKEN }}"
           fetch-depth: 0
       - name: Set up Python
-        uses: actions/setup-python@v6
+        uses: astral-sh/setup-uv@v6
         with:
           python-version: "3.x"
-      - name: Install dependencies
-        run: |
-          python -m pip install -U pip poetry
-          poetry --version
+      - name: Build
+        run: uv build
       - name: Publish
-        env:
-          POETRY_HTTP_BASIC_PYPI_USERNAME: ${{ secrets.PYPI_USERNAME }}
-          POETRY_HTTP_BASIC_PYPI_PASSWORD: ${{ secrets.PYPI_PASSWORD }}
-        run: poetry publish --build
+        run: uv publish

.pre-commit-config.yaml

@@ -29,6 +29,14 @@ repos:
         args: [ '--unsafe' ] # for mkdocs.yml
       - id: detect-private-key
 
+  - repo: https://github.com/astral-sh/uv-pre-commit
+    rev: 0.9.18
+    hooks:
+      - id: uv-lock
+      - id: uv-sync
+        args: [ --locked, --all-groups ]
+        stages: [ pre-commit, post-checkout, post-merge, post-rewrite ]
+
   - repo: https://github.com/asottile/blacken-docs
     rev: 1.19.1
     hooks:
@@ -48,7 +56,7 @@ repos:
           - tomli
 
   - repo: https://github.com/commitizen-tools/commitizen
-    rev: v4.10.0 # automatically updated by Commitizen
+    rev: v4.11.0 # automatically updated by Commitizen
     hooks:
       - id: commitizen
       - id: commitizen-branch
@@ -63,15 +71,15 @@ repos:
   - repo: local
     hooks:
       - id: format
-        name: Format Python code via Poetry
+        name: Format Python code
         language: system
         pass_filenames: false
-        entry: poetry format
+        entry: uv run poe format
         types: [ python ]
 
       - id: linter and test
-        name: Linters via Poetry
+        name: Linters
         language: system
         pass_filenames: false
-        entry: poetry lint
+        entry: uv run poe lint
         types: [ python ]

CHANGELOG.md

@@ -1,3 +1,32 @@
+## v4.11.0 (2025-12-29)
+
+### Feat
+
+- Drop support for Python 3.9 as EOL reached and add Python 3.14 support
+- add custom validation
+
+## v4.10.1 (2025-12-11)
+
+### Fix
+
+- **version**: fix the behavior of cz version --major
+- **cli**: debug and no_raise can be used together in sys.excepthook
+- **git**: replace lstrip with strip for compatibility issue
+- **bump**: remove NotAllowed related to --get-next option, other related refactoring
+
+### Refactor
+
+- **version**: rename class member to align with other classes
+- **cargo_provider**: cleanup and get rid of potential type errors
+- **bump**: extract option validation and new version resolution to new functions
+- **changelog**: raise NotAllow when file_name not passed instead of using assert
+- **bump**: rename parameter and variables
+
+### Perf
+
+- **ruff**: enable ruff rules TC001~TC006
+- add TYPE_CHECKING to CzQuestion imports
+
 ## v4.10.0 (2025-11-10)
 
 ### Feat

commitizen/__version__.py

@@ -1 +1 @@
-__version__ = "4.10.0"
+__version__ = "4.11.0"

commitizen/bump.py

@@ -3,16 +3,19 @@
 import os
 import re
 from collections import OrderedDict
-from collections.abc import Generator, Iterable
 from glob import iglob
 from logging import getLogger
 from string import Template
-from typing import cast
+from typing import TYPE_CHECKING, cast
 
 from commitizen.defaults import BUMP_MESSAGE, MAJOR, MINOR, PATCH
 from commitizen.exceptions import CurrentVersionNotFoundError
 from commitizen.git import GitCommit, smart_open
-from commitizen.version_schemes import Increment, Version
+
+if TYPE_CHECKING:
+    from collections.abc import Generator, Iterable
+
+    from commitizen.version_schemes import Increment, Version
 
 VERSION_TYPES = [None, PATCH, MINOR, MAJOR]
 
@@ -56,13 +59,13 @@ def find_increment(
                 if increment == MAJOR:
                     break
 
-    return cast(Increment, increment)
+    return cast("Increment", increment)
 
 
 def update_version_in_files(
     current_version: str,
     new_version: str,
-    files: Iterable[str],
+    version_files: Iterable[str],
     *,
     check_consistency: bool,
     encoding: str,
@@ -77,7 +80,7 @@ def update_version_in_files(
     """
     updated_files = []
 
-    for path, pattern in _resolve_files_and_regexes(files, current_version):
+    for path, pattern in _resolve_files_and_regexes(version_files, current_version):
         current_version_found = False
         bumped_lines = []
 

commitizen/changelog.py

@@ -29,7 +29,6 @@
 
 import re
 from collections import OrderedDict, defaultdict
-from collections.abc import Generator, Iterable, Mapping, MutableMapping, Sequence
 from dataclasses import dataclass
 from datetime import date
 from itertools import chain
@@ -44,13 +43,14 @@
     Template,
 )
 
-from commitizen.cz.base import ChangelogReleaseHook
 from commitizen.exceptions import InvalidConfigurationError, NoCommitsFoundError
-from commitizen.git import GitCommit, GitTag
 from commitizen.tags import TagRules
 
 if TYPE_CHECKING:
-    from commitizen.cz.base import MessageBuilderHook
+    from collections.abc import Generator, Iterable, Mapping, MutableMapping, Sequence
+
+    from commitizen.cz.base import ChangelogReleaseHook, MessageBuilderHook
+    from commitizen.git import GitCommit, GitTag
 
 
 @dataclass

commitizen/changelog_formats/__init__.py

@@ -1,17 +1,16 @@
 from __future__ import annotations
 
-import sys
-from typing import Callable, ClassVar, Protocol
+from importlib import metadata
+from typing import TYPE_CHECKING, ClassVar, Protocol
 
-if sys.version_info >= (3, 10):
-    from importlib import metadata
-else:
-    import importlib_metadata as metadata
-
-from commitizen.changelog import Metadata
-from commitizen.config.base_config import BaseConfig
 from commitizen.exceptions import ChangelogFormatUnknown
 
+if TYPE_CHECKING:
+    from collections.abc import Callable
+
+    from commitizen.changelog import Metadata
+    from commitizen.config.base_config import BaseConfig
+
 CHANGELOG_FORMAT_ENTRYPOINT = "commitizen.changelog_format"
 TEMPLATE_EXTENSION = "j2"
 

commitizen/changelog_formats/base.py

@@ -2,15 +2,17 @@
 
 import os
 from abc import ABCMeta
-from typing import IO, Any, ClassVar
+from typing import IO, TYPE_CHECKING, Any, ClassVar
 
 from commitizen.changelog import Metadata
-from commitizen.config.base_config import BaseConfig
 from commitizen.tags import TagRules, VersionTag
 from commitizen.version_schemes import get_version_scheme
 
 from . import ChangelogFormat
 
+if TYPE_CHECKING:
+    from commitizen.config.base_config import BaseConfig
+
 
 class BaseFormat(ChangelogFormat, metaclass=ABCMeta):
     """