chore(release): generate release notes latex file from toml

doc/ReleaseNotes/develop.tex.jinja

@@ -0,0 +1,10 @@
+\item \currentmodflowversion
+
+{% for section, notes in sections|groupby("type") %}
+\underline{{{ section }}}
+\begin{itemize}
+{% for note in section %}
+\item {{ note.text }}
+{% endfor %}
+\end{itemize}
+{% endfor %}

doc/ReleaseNotes/mk_deprecations.py

@@ -68,4 +68,4 @@
         ftex.close()
         print(f"Created LaTex file {fnametex} from markdown deprecations file {fpath}")
     else:
-        warn(f"Deprecations not found: {fpath}")
+        warn(f"Deprecations file not found: {fpath}")

doc/ReleaseNotes/mk_releasenotes.py

@@ -0,0 +1,36 @@
+# This script converts the release notes TOML file
+# to a latex file to include in the release notes.
+import argparse
+from pathlib import Path
+import sys
+from warnings import warn
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser()
+    parser.add_argument("path")
+    args = parser.parse_args()
+
+    fname = "develop"
+    fpath = Path(args.path).expanduser().absolute()
+    fnametex = Path(f"{fname}.tex").absolute()
+    fnametex.unlink(missing_ok=True)
+
+    if not fpath.is_file():
+        warn(f"Release notes TOML file not found: {fpath}")
+        sys.exit(0)
+
+    from jinja2 import Environment, FileSystemLoader
+    import tomlkit
+
+    loader = FileSystemLoader(fnametex.parent)
+    env = Environment(
+        loader=loader,
+        trim_blocks=True,
+        lstrip_blocks=True,
+        line_statement_prefix="_",
+        keep_trailing_newline=True,
+    )
+    template = env.get_template(f"{fnametex.name}.jinja")
+    with open(fnametex, "w") as f:
+        f.write(template.render(tomlkit.load(f"{fname}.toml")))

environment.yml

@@ -13,6 +13,7 @@ dependencies:
   - fprettify
   - fortran-language-server
   - gitpython
+  - Jinja2>=3
   - jupytext
   - matplotlib
   - meson=1.3.0
@@ -39,4 +40,5 @@ dependencies:
   - scipy
   - shapely
   - syrupy
+  - tomlkit
 

pixi.toml

@@ -12,6 +12,7 @@ flaky = "*"
 fortran-language-server = "*"
 fprettify = "*"
 gitpython = "*"
+Jinja2 = ">=3"
 jupytext = "*"
 matplotlib = "*"
 meson = "1.3.0"
@@ -36,6 +37,7 @@ ruff = "*"
 scipy = "*"
 shapely = "*"
 syrupy = "*"
+tomlkit = "*"
 xmipy = "*"
 
 [feature.rtd.dependencies]