feat(cli): add --version / -V flag

.changeset/0001-version-flag.md

@@ -0,0 +1,5 @@
+---
+"pan-scm-cli": patch
+---
+
+Add `--version` (and `-V`) flag to the top-level `scm` command so users can quickly check the installed CLI version.

src/scm_cli/main.py

@@ -300,13 +300,29 @@ def get_region_override() -> str | None:
     return _region_override
 
 
+def _version_callback(value: bool) -> None:
+    if value:
+        from scm_cli import __version__
+
+        typer.echo(__version__)
+        raise typer.Exit()
+
+
 @app.callback()
 def callback(
     region: str | None = typer.Option(
         None,
         "--region",
         help="Override SCM API region for this invocation",
     ),
+    version: bool | None = typer.Option(
+        None,
+        "--version",
+        "-V",
+        help="Show the CLI version and exit",
+        callback=_version_callback,
+        is_eager=True,
+    ),
 ):
     """Manage Palo Alto Networks Strata Cloud Manager (SCM) configurations.
 

tests/test_main.py

@@ -49,3 +49,21 @@ def test_load_command_help(runner):
     assert "network" in result.stdout
     assert "object" in result.stdout
     assert "security" in result.stdout
+
+
+def test_version_flag(runner):
+    """`scm --version` prints the installed version and exits 0."""
+    from scm_cli import __version__
+
+    result = runner.invoke(app, ["--version"])
+    assert result.exit_code == 0
+    assert __version__ in result.stdout
+
+
+def test_version_short_flag(runner):
+    """`scm -V` is an alias for --version."""
+    from scm_cli import __version__
+
+    result = runner.invoke(app, ["-V"])
+    assert result.exit_code == 0
+    assert __version__ in result.stdout