Create a non-package uv project for defining python packages for docs

.github/dependabot.yml

@@ -19,3 +19,10 @@ updates:
     groups:
       github-actions:
         patterns: ["*"]
+  - package-ecosystem: "uv"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    groups:
+      python:
+        patterns: ["*"]

.pre-commit-config.yaml

@@ -44,7 +44,7 @@ repos:
     hooks:
       - id: pretty-format-toml
         args: [--autofix, --indent, "4", --no-sort]
-        exclude: ^Cargo\.lock$
+        exclude: ^(Cargo|uv)\.lock$
       - id: pretty-format-rust
         args: [--autofix]
   - repo: https://github.com/doublify/pre-commit-rust
@@ -74,3 +74,7 @@ repos:
     rev: 2.1.0
     hooks:
       - id: validate-cff
+  - repo: https://github.com/astral-sh/uv-pre-commit
+    rev: 0.11.15
+    hooks:
+      - id: uv-lock

docs/file_formats/generate_docs.py

@@ -1,11 +1,4 @@
 #!/usr/bin/env python3
-# /// script
-# dependencies = [
-#     "jinja2",
-#     "pyyaml",
-#     "table2md",
-# ]
-# ///
 #
 # A script to generate markdown documentation from table schemas. If invoked without any arguments,
 # it will generate all file format documentation. Alternatively, you can specify one or more type
@@ -90,7 +83,7 @@ def main(options: Iterable[str]) -> None:
         except KeyError:
             print(f'Unknown option "{option}"')
         else:
-            (filename, txt) = fun(env)
+            filename, txt = fun(env)
             path = FILE_FORMAT_DOCS_DIR / filename
             print(f"Writing {path}")
             path.write_text(txt, encoding="utf-8")

docs/generate_example_docs.py

@@ -1,9 +1,4 @@
 #!/usr/bin/env python3
-# /// script
-# dependencies = [
-#     "jinja2",
-# ]
-# ///
 #
 # A script to generate documentation for the different examples from README.txt files.
 

docs/generate_versions_docs.py

@@ -1,9 +1,4 @@
 #!/usr/bin/env python3
-# /// script
-# dependencies = [
-#     "jinja2",
-# ]
-# ///
 #
 # A script to generate the versions.md file, listing links to old versions of documentation.
 

pyproject.toml

@@ -0,0 +1,10 @@
+[project]
+name = "muse2-docs"
+version = "2.1.0"
+description = "Define dependencies for building MUSE2 docs"
+requires-python = ">=3.12"
+dependencies = [
+    "jinja2>=3.1.6",
+    "pyyaml>=6.0.3",
+    "table2md>=1.1.0"
+]