Update deps, RTD config, tox. (#23)

Author: kattni

.readthedocs.yaml

@@ -7,13 +7,14 @@ version: 2
 
 # Set the version of Python and other tools you might need
 build:
-  os: ubuntu-22.04
+  os: ubuntu-24.04
   tools:
-    # Docs are always built on Python 3.12. See also the tox config.
-    python: "3.12"
+    # Docs are always built on Python 3.13. See also the tox config.
+    python: "3.13"
   jobs:
     pre_install:
-      - python -m pip install -r requirements.dev.txt
+      - python -m pip install --upgrade pip
+      - python -m pip install --group 'dev'
     pre_build:
       - python -m tox -e docs-lint
     build:

pyproject.toml

@@ -23,6 +23,9 @@ maintainers = [
 ]
 
 dependencies = [
+    # We use ruff for *our* code formatting, but mkdocstrings (optionally) uses
+    # black to format method prototypes.
+    "black==25.1.0",
     "markdown-checker==0.2.5",
     "mistletoe==1.4.0",
     "mkdocs-autorefs==1.4.2",
@@ -38,7 +41,7 @@ dependencies = [
     "translate-toolkit @ git+https://github.com/translate/translate@aa35159f03f53aa536381643dfafbc2a19a24784",
 ]
 
-[project.optional-dependencies]
+[dependency-groups]
 # Extras used by developers *of* beeware-docs-tools are pinned to specific versions to
 # ensure environment consistency.
 dev = [

requirements.dev.txt

@@ -8,11 +8,11 @@ config_dir = {tox_root}{/}docs{/}config
 templates_dir = {tox_root}{/}docs{/}locales{/}templates
 
 [testenv:docs{,-lint,-translate,-all,-live,-en,-fr,-de}]
-# Docs are always built on Python 3.12. See also the RTD config.
-base_python = py312
+# Docs are always built on Python 3.13. See also the RTD config.
+base_python = py313
 skip_install = true
 deps =
-    -r {tox_root}/requirements.docs.txt
+    -e .
 commands:
     !lint-!all-!translate-!live-!en-!fr-!de : build_md_translations {posargs} --source-code=src en
     translate : md2po --input docs{/}en --output {[docs]templates_dir} --pot --duplicates=merge