feat: add executable version

Author: itsAnanth

.github/workflows/release.yaml

@@ -35,6 +35,8 @@ jobs:
         run: uv sync --locked --all-extras --dev
 
       - name: Run PowerShell build script
+        env:
+          PVM_VERSION: ${{ github.ref_name }}
         shell: pwsh
         run: |
           Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

.gitignore

@@ -215,4 +215,5 @@ __marimo__/
 # Streamlit
 .streamlit/secrets.toml
 
-dump/
+dump/
+_version.py

main.py

@@ -13,6 +13,11 @@
 # Use DEBUG in development, INFO in production builds
 log_level = logging.DEBUG if os.getenv('PVM_DEV') == '1' else logging.INFO
 
+try:
+    from src._version import VERSION
+except ImportError:
+    VERSION = "dev"
+
 logging.basicConfig(
     level=log_level,
     format='[%(asctime)s] [%(levelname)s] [%(name)s] - %(message)s',
@@ -33,6 +38,13 @@ def cli():
         description="A lightweight Python version manager for Windows. Install, manage, and switch between multiple Python versions with ease. Downloads official embeddable Python distributions, maintains isolated installations, and uses shims for seamless version switching without modifying system settings or registry."
     )
 
+    parser.add_argument(
+        '--version',
+        action='version',
+        version=f'pvm {VERSION}',
+        help='Shows the version of pvm installed'
+    )
+
     subparsers = parser.add_subparsers(
         title="commands",
         dest="command",

powershell/build.ps1

@@ -3,4 +3,14 @@ Write-Host "Building python-version-manager executable..."
 # Set production mode (INFO level logging), 1 for development (DEBUG level logging)
 $env:PVM_DEV = "0"
 
+# Version from CI (fallback for local builds)
+# during CI, version is exposed by github as github.ref_name instead
+
+if (-not $env:PVM_VERSION) {
+    $env:PVM_VERSION = "dev"
+}
+
+"VERSION = `"$env:PVM_VERSION`"" | Set-Content src/_version.py
+
+Write-Host "Building version $($env:PVM_VERSION)"
 uv run -m PyInstaller --onefile --clean --exclude-module tests --name pvm main.py