feat(bump): add --version-files-only and deprecate --files-only

commitizen/cli.py

@@ -208,6 +208,11 @@ def __call__(
                     {
                         "name": "--files-only",
                         "action": "store_true",
+                        "help": "Bump version in the files from the config (This is deprecated and will be removed in v5).",
+                    },
+                    {
+                        "name": "--version-files-only",
+                        "action": "store_true",
                         "help": "bump version in the files from the config",
                     },
                     {

commitizen/commands/bump.py

@@ -47,6 +47,7 @@ class BumpArgs(Settings, total=False):
     dry_run: bool
     file_name: str
     files_only: bool | None
+    version_files_only: bool | None
     get_next: bool
     git_output_to_stderr: bool
     increment_mode: str
@@ -356,9 +357,17 @@ def __call__(self) -> None:
                 else None,
             )
 
-        if self.arguments["files_only"]:
+        if self.arguments.get("files_only"):
+            warnings.warn(
+                "--files-only is deprecated and will be removed in v5. Use --version-files-only instead.",
+                DeprecationWarning,
+            )
             raise ExpectedExit()
 
+        if self.arguments.get("version_files_only"):
+            raise ExpectedExit()
+
+
         # FIXME: check if any changes have been staged
         git.add(*files)
         c = git.commit(message, args=self._get_commit_args())