feat(version): add the ability to just print major or minor version

Author: woile

commitizen/cli.py

@@ -543,6 +543,18 @@ def __call__(
                         "action": "store_true",
                         "exclusive_group": "group1",
                     },
+                    {
+                        "name": ["--major"],
+                        "help": "get just the major version",
+                        "action": "store_true",
+                        "exclusive_group": "group2",
+                    },
+                    {
+                        "name": ["--minor"],
+                        "help": "get just the minor version",
+                        "action": "store_true",
+                        "exclusive_group": "group2",
+                    },
                 ],
             },
         ],

commitizen/commands/version.py

@@ -5,14 +5,17 @@
 from commitizen import out
 from commitizen.__version__ import __version__
 from commitizen.config import BaseConfig
-from commitizen.exceptions import NoVersionSpecifiedError
+from commitizen.exceptions import NoVersionSpecifiedError, VersionSchemeUnknown
 from commitizen.providers import get_provider
+from commitizen.version_schemes import get_version_scheme
 
 
 class VersionArgs(TypedDict, total=False):
     report: bool
     project: bool
     verbose: bool
+    major: bool
+    minor: bool
 
 
 class Version:
@@ -41,6 +44,17 @@ def __call__(self) -> None:
                 out.error("No project information in this project.")
                 return
 
+            try:
+                version_scheme = get_version_scheme(self.config.settings)
+            except VersionSchemeUnknown:
+                out.error("Unknown version scheme.")
+            _version = version_scheme(version)
+
+            if self.parameter.get("major"):
+                version = f"{_version.major}"
+            elif self.parameter.get("minor"):
+                version = f"{_version.minor}"
+
             out.write(f"Project Version: {version}" if verbose else version)
             return
 

commitizen/version_schemes.py

@@ -410,7 +410,9 @@ def _get_prerelease(self) -> str:
 def get_version_scheme(settings: Settings, name: str | None = None) -> VersionScheme:
     """
     Get the version scheme as defined in the configuration
-    or from an overridden `name`
+    or from an overridden `name`.
+
+
 
     :raises VersionSchemeUnknown: if the version scheme is not found.
     """

docs/images/cli_help/cz_version___help.svg

@@ -119,3 +119,40 @@ def test_version_command_shows_description_when_use_help_option(
 
     out, _ = capsys.readouterr()
     file_regression.check(out, extension=".txt")
+
+
+@pytest.mark.parametrize(
+    "version, expected_version", (("1.0.0", "1\n"), ("2.1.3", "2\n"), ("0.0.1", "0\n"))
+)
+def test_version_just_major(config, capsys, version: str, expected_version: str):
+    config.settings["version"] = version
+    commands.Version(
+        config,
+        {
+            "report": False,
+            "project": True,
+            "verbose": False,
+            "major": True,
+        },
+    )()
+    captured = capsys.readouterr()
+    assert expected_version == captured.out
+
+
+@pytest.mark.parametrize(
+    "version, expected_version",
+    (("1.0.0", "0\n"), ("2.1.3", "1\n"), ("0.0.1", "0\n"), ("0.1.0", "1\n")),
+)
+def test_version_just_minor(config, capsys, version: str, expected_version: str):
+    config.settings["version"] = version
+    commands.Version(
+        config,
+        {
+            "report": False,
+            "project": True,
+            "verbose": False,
+            "minor": True,
+        },
+    )()
+    captured = capsys.readouterr()
+    assert expected_version == captured.out