Add --version flag to display client version

- Add --version argument to display 'codeplain version X.X.X'
- Update filename validation to allow --version without filename
- Add unit test for --version flag
- Version flag takes precedence (checked first in main())

Author: pedjaradenkovic

cli_output/status.py

@@ -133,7 +133,11 @@ def print_status(api_key: str, api_url: str, client_version: str) -> None:
         console.print(f"Version: {client_version}")
     else:
         from plain2code_console import Plain2CodeConsole
-        console.print(f"Version: {client_version} (outdated — minimum required: {min_version})", style=Plain2CodeConsole.ERROR_STYLE)
+
+        console.print(
+            f"Version: {client_version} (outdated — minimum required: {min_version})",
+            style=Plain2CodeConsole.ERROR_STYLE,
+        )
         console.print("To update, run: uv tool upgrade codeplain\n", style=Plain2CodeConsole.ERROR_STYLE)
     console.print(f"Name: {user['first_name']} {user['last_name']}")
     console.print(f"User email: {user['email']}")

plain2code.py

@@ -47,7 +47,6 @@
     get_log_file_path,
 )
 from plain2code_state import RunState
-from plain2code_utils import format_duration_hms
 from system_config import system_config
 from tui.plain2code_tui import Plain2CodeTUI
 from tui.plain_module_render_choice_tui import PlainModuleRenderChoiceTUI
@@ -254,6 +253,11 @@ def main():  # noqa: C901
 
     args = parse_arguments()
 
+    # Handle --version flag before any other initialization
+    if args.version:
+        console.print(f"codeplain version {system_config.client_version}")
+        return
+
     # Handle --status flag before any other initialization
     if args.status:
         if not args.api_key:

plain2code_arguments.py

@@ -357,6 +357,13 @@ def create_parser():
         "Does not render any code.",
     )
 
+    parser.add_argument(
+        "--version",
+        action="store_true",
+        default=False,
+        help="Display the client version and exit.",
+    )
+
     return parser
 
 
@@ -366,7 +373,7 @@ def parse_arguments():
     args = parser.parse_args()
 
     # Validate filename is provided when needed
-    if not args.status and not args.filename:
+    if not args.status and not args.version and not args.filename:
         parser.error("the following arguments are required: filename")
 
     # Only process config if filename is provided (not needed for --status)

tests/test_cli_output.py

@@ -1,6 +1,7 @@
 """Unit tests for cli_output module."""
 
 from datetime import datetime, timezone
+from io import StringIO
 from unittest.mock import Mock, patch
 
 import pytest
@@ -386,3 +387,25 @@ def test_multiple_purchased_credit_buckets(self, mock_console, mock_api_class):
         calls = [str(call) for call in mock_console.print.call_args_list]
         purchased_calls = [c for c in calls if "Purchased" in c]
         assert len(purchased_calls) == 2
+
+
+class TestVersionFlag:
+    """Tests for --version flag."""
+
+    def test_version_flag_without_filename(self, capsys):
+        """Test that --version works without providing a filename."""
+        import sys
+
+        import plain2code
+
+        # Save original argv
+        original_argv = sys.argv
+        try:
+            sys.argv = ["plain2code.py", "--version"]
+            # This should not raise an error about missing filename
+            plain2code.main()
+
+            captured = capsys.readouterr()
+            assert "codeplain version" in captured.out
+        finally:
+            sys.argv = original_argv