add output format flag support to --version subcommand

Author: BartoszBlizniak

CHANGELOG.md

@@ -7,10 +7,15 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ## [Unreleased]
 
+## [1.11.2] - 2026-01-22
+
+## Added
+
 - Migrate from CircleCI to GitHub Actions for testing and release workflows.
 - Remove CircleCI workflows.
 - Migrate from using `shiv` for zipapp generation to `pex` in order to support specific platform/arch and improve testing framework.
 - Add zizmor for GitHub Actions code scans, part of workflow and pre-commit
+- Support output format for `--version` in order to allow JSON parsing
 
 ## [1.10.3] - 2026-01-08
 

cloudsmith_cli/cli/commands/main.py

@@ -5,22 +5,31 @@
 from ...core.api.version import get_version as get_api_version
 from ...core.utils import get_github_website, get_help_website
 from ...core.version import get_version as get_cli_version
-from .. import command, decorators
+from .. import command, decorators, utils
 
 CONTEXT_SETTINGS = dict(help_option_names=["-h", "--help"])
 
 
-def print_version():
+def print_version(opts):
     """Print the environment versions."""
-    click.echo("Versions:")
-    click.secho(
-        "CLI Package Version: %(version)s"
-        % {"version": click.style(get_cli_version(), bold=True)}
-    )
-    click.secho(
-        "API Package Version: %(version)s"
-        % {"version": click.style(get_api_version(), bold=True)}
-    )
+    cli_version = get_cli_version()
+    api_version = get_api_version()
+
+    data = {
+        "cli_version": cli_version,
+        "api_version": api_version,
+    }
+
+    if not utils.maybe_print_as_json(opts, data):
+        click.echo("Versions:")
+        click.secho(
+            "CLI Package Version: %(version)s"
+            % {"version": click.style(cli_version, bold=True)}
+        )
+        click.secho(
+            "API Package Version: %(version)s"
+            % {"version": click.style(api_version, bold=True)}
+        )
 
 
 @click.group(
@@ -52,12 +61,13 @@ def print_version():
     is_eager=True,
 )
 @decorators.common_cli_config_options
+@decorators.common_cli_output_options
 @click.pass_context
 def main(ctx, opts, version):
     """Handle entrypoint to CLI."""
     # pylint: disable=unused-argument
 
     if version:
-        print_version()
+        print_version(opts)
     elif ctx.invoked_subcommand is None:
         click.echo(ctx.get_help())

cloudsmith_cli/cli/tests/commands/test_main.py

@@ -1,3 +1,5 @@
+import json
+
 import pytest
 
 from ....core.api.version import get_version as get_api_version
@@ -17,6 +19,32 @@ def test_main_version(self, runner, option):
             "API Package Version: " + get_api_version() + "\n"
         )
 
+    @pytest.mark.parametrize("option", ["-V", "--version"])
+    @pytest.mark.parametrize(
+        "format_option,format_value",
+        [("-F", "json"), ("--output-format", "json")],
+    )
+    def test_main_version_json(self, runner, option, format_option, format_value):
+        """Test the JSON output of `cloudsmith --version --output-format json`."""
+        result = runner.invoke(main, [option, format_option, format_value])
+        assert result.exit_code == 0
+        output = json.loads(result.output)
+        assert "data" in output
+        assert output["data"]["cli_version"] == get_version()
+        assert output["data"]["api_version"] == get_api_version()
+
+    @pytest.mark.parametrize("option", ["-V", "--version"])
+    def test_main_version_pretty_json(self, runner, option):
+        """Test the pretty JSON output of `cloudsmith --version --output-format pretty_json`."""
+        result = runner.invoke(main, [option, "--output-format", "pretty_json"])
+        assert result.exit_code == 0
+        output = json.loads(result.output)
+        assert "data" in output
+        assert output["data"]["cli_version"] == get_version()
+        assert output["data"]["api_version"] == get_api_version()
+        # Verify it's formatted with indentation
+        assert "    " in result.output
+
     @pytest.mark.parametrize("option", ["-h", "--help"])
     def test_main_help(self, runner, option):
         """Test the output of `cloudsmith --help`."""