Add version option (#12)

* Add version command

* Adding documnetation and linting

Author: pcortada-te

README.md

@@ -57,5 +57,6 @@ The ["I am starting from scratch" quick-start guide](<2.2. I am starting from sc
         9. [`stacks surgery rename`](<docs/3.3.9. stacks surgery rename.md>)
         10. [`stacks surgery move`](<docs/3.3.10. stacks surgery move.md>)
         11. [`stacks surgery edit`](<docs/3.3.11. stacks surgery edit.md>)
+        12. [`stacks version`](<docs/3.3.12. stacks version.md>)
     4. [Directory structure](<docs/3.4. Directory structure.md>)
     5. [Special variables](<docs/3.5. Special variables.md>)

docs/3.3.12. stacks version.md

@@ -0,0 +1,20 @@
+# `stacks surgery edit`
+
+## Usage
+```
+Usage: stacks version
+
+  Print the Stacks and Python version numbers 
+```
+
+## Description
+
+  Print the Stacks and Python version numbers and exit
+
+## Example
+
+```shell
+$ stacks version
+Stacks 2.0.8
+Python 3.12.8
+```

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "stacks"
-version = "2.0.7"
+version = "2.0.8"
 description = "Stacks, the Terraform code pre-processor"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -9,9 +9,10 @@ dependencies = [
     "cryptography>=43.0.3",
     "deepmerge>=2.0",
     "gitpython>=3.1.43",
+    "importlib>=1.0.4",
     "jinja2>=3.1.4",
     "packaging>=24.2",
-    "python-hcl2<6.0.0",  # https://github.com/amplify-education/python-hcl2/issues/183
+    "python-hcl2<6.0.0", # https://github.com/amplify-education/python-hcl2/issues/183
     "pyyaml>=6.0.2",
 ]
 

src/stacks/main.py

@@ -1,4 +1,6 @@
+import importlib.metadata
 import pathlib
+import platform
 
 import click
 
@@ -16,6 +18,12 @@ def cli():
     pass
 
 
+@cli.command()
+def version():
+    print(f"Stacks {importlib.metadata.version('stacks')}")
+    print(f"Python {platform.python_version()}")
+
+
 @cli.command(hidden=True)  # hidden because it should not be used independently unless for advanced debugging purposes
 def preinit():
     cmd.preinit(ctx=cmd.Context())