refactor(cli): reword command help and capitalize the first characters

.github/workflows/pythonpackage.yml

@@ -6,7 +6,7 @@ jobs:
   python-check:
     strategy:
       matrix:
-        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
         platform: [ubuntu-22.04, macos-latest, windows-latest]
     runs-on: ${{ matrix.platform }}
     steps:

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,19 @@
 from __future__ import annotations
 
 import sys
-from typing import Callable, ClassVar, Protocol
+from typing import TYPE_CHECKING, Callable, 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 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):
     """