Simplify version management and update for release

As a general principle, it makes sense to update the internal version number as soon as we've completed a release so that dashboard-dev is clearly distinguished from dashboard. So having released v0.2.1, I'm updating the version to v0.2.2.

When I created the version.py build script, I'd envisioned reading the version directly from the pyproject.toml file, but for "simplicity" (of implementation) I ended up creating a separate VERSION file with the base version string. While easy to write, this is harder to manage over time.

Python 3.11 includes a built-in tomllib package, but as we're still depending on 3.9 I experimented with several alternatives -- toml can't parse our pyproject.toml and was difficult to debug; but tomlkit is recommended by Python documentation (for pre-3.11 and for writing toml files), and that works.

So we now have [project] version = "v0.2.2" as our only source of version truth in the repo, and the version.py script is now able to read that and generate our live version information from that.

Author: dbutenhof

backend/VERSION

@@ -2,8 +2,8 @@
 name = "openshift_perfscale_api"
 requires-python = ">=3.9,<3.10"
 dynamic = ["dependencies"]
-version = "0.1.1"
-description = "Python transformer of OpenShift performance and scale test results"
+version = "0.2.2"
+description = "Aggregator for Performance & Scale CPT data"
 authors = [{name = "mleader", email = "mleader@redhat.com"}]
 
 [tool.poetry]
@@ -35,6 +35,7 @@ trio = "^0.28.0"
 uvicorn = "^0.34.0"
 uvloop = "^0.21.0"
 vyper-config = "1.0.0"
+tomlkit = "^0.13.3"
 
 [tool.poetry.group.dev.dependencies]
 black = "^24.4.2"

backend/poetry.lock

@@ -12,6 +12,8 @@
 import sys
 from typing import Optional
 
+import tomlkit
+
 
 def do(cmd: list[str]) -> list[str]:
     result = subprocess.run(cmd, text=True, capture_output=True)
@@ -32,7 +34,9 @@ def getone(cmd: list[str], if_none: Optional[str] = None) -> str:
 def main():
     top = Path(getone(["git", "rev-parse", "--show-toplevel"]))
     backend = top / "backend"
-    version = (backend / "VERSION").read_text().strip()
+    with (backend / "pyproject.toml").open() as tml:
+        config = tomlkit.load(tml)
+    version = config["project"]["version"]
     sha = getone(["git", "rev-parse", "--short", "HEAD"])
     branch = getone(["git", "branch", "--show-current"], if_none="CI")
     display = f"v{version}-{sha}"
@@ -53,8 +57,4 @@ def main():
 
 
 if __name__ == "__main__":
-    try:
-        sys.exit(main())
-    except Exception as exc:
-        print(f"Failed with {str(exc)!r}", file=sys.stderr)
-        sys.exit(1)
+    sys.exit(main())