feat: add release email generation tooling (#743)

* feat: add release email generation tooling

* fix: handle binding no votes in result email

* fix: make adaptive crag example python 3.10 compatible

Author: hussain-s

.github/workflows/release-validation.yml

@@ -100,7 +100,7 @@ jobs:
         run: sudo apt-get install -y --no-install-recommends graphviz
 
       - name: Install Python build deps
-        run: pip install flit twine
+        run: pip install flit twine jinja2
 
       - name: Cache Apache RAT
         id: cache-rat

.gitignore

@@ -129,6 +129,7 @@ ipython_config.py
 #   in version control.
 #   https://pdm.fming.dev/#use-with-ide
 .pdm.toml
+uv.lock
 
 # PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
 __pypackages__/

examples/adaptive-crag/application.py

@@ -282,7 +282,7 @@ def router(state: State, query: str, attempts: int = ATTEMPTS) -> tuple[dict[str
     table_names = db.table_names()
     chat_history = state["chat_history"]
     # using this as a `response_model` to ensure the route is valid
-    routes = Literal[*table_names, "web_search", "assistant"]  # type: ignore
+    routes = Literal.__getitem__((*table_names, "web_search", "assistant"))  # type: ignore
     try:
         route = ask_gemini.create(
             messages=[

pyproject.toml

@@ -81,6 +81,10 @@ redis = [
   "redis"
 ]
 
+release = [
+  "jinja2",
+]
+
 tests = [
   "pytest",
   "pytest-asyncio",

scripts/README.md

@@ -101,6 +101,11 @@ python scripts/apache_release.py verify 0.41.0 0
 
 # Skip upload step in 'all' command
 python scripts/apache_release.py all 0.41.0 0 your_apache_id --no-upload
+
+# Generate release emails from templates
+python scripts/apache_release.py vote-email --version 0.41.0 --rc 0
+python scripts/apache_release.py result-email --version 0.41.0 --rc 0 --binding-yes 3 --non-binding-yes 2 --binding-no 0 --non-binding-no 1
+python scripts/apache_release.py announce-email --version 0.41.0
 ```
 
 Output: `dist/` directory with tar.gz (archive + sdist), whl, plus .asc and .sha512 files. The wheel is validated with `twine check` to ensure metadata correctness before signing. Install from the whl file to test it out after running the `wheel` subcommand.