ci: add pre-push package validation

add a pre-push hook to build and validate the standalone executable

- run the packaging script before each push
- verify the packaged executable with the version command
- support windows and unix executable paths
- document pre-commit setup in CONTRIBUTING.md

Author: nos1dot618

.pre-commit-config.yaml

@@ -4,3 +4,12 @@ repos:
     hooks:
       - id: trailing-whitespace
       - id: end-of-file-fixer
+
+  - repo: local
+    hooks:
+      - id: build-and-test-package
+        name: Build and test package
+        entry: python scripts/pre_push_hook.py
+        language: system
+        pass_filenames: false
+        stages: [pre-push]

CONTRIBUTING.md

@@ -8,6 +8,13 @@ Install the required tools listed in the [README](README.md#requirements), then
 
 ```shell
 python java_inventory.py setup
+````
+
+Install `pre-commit` for the development hooks:
+
+```shell
+pip install pre-commit
+pre-commit install
 ```
 
 Use the CLI directly while developing:

scripts/pre_push_hook.py

@@ -0,0 +1,20 @@
+#!/usr/bin/env python3
+
+"""Build the standalone executable and verify its version command."""
+
+# pylint: disable=missing-function-docstring
+
+import os
+import subprocess
+import sys
+
+
+def main():
+    subprocess.run([sys.executable, "package.py"], check=True)
+
+    executable = "dist/java-inventory.exe" if os.name == "nt" else "dist/java-inventory"
+    subprocess.run([executable, "version"], check=True)
+
+
+if __name__ == "__main__":
+    main()