Use hatch-mkdocs and hatch-pip-compile for docs deps

.github/workflows/deploy-docs.yml

@@ -13,11 +13,11 @@ jobs:
       - name: Install Python
         uses: actions/setup-python@v4
         with:
-          python-version: '3.x'
+          python-version: '3.11'
       - name: Install dependencies
-        run: pip install --no-deps -r docs/requirements.txt
+        run: pip install --no-deps -r requirements/requirements-docs.txt
       - name: Build site
-        run: mkdocs build
+        run: mkdocs build --strict
       - name: Upload to GitHub Pages
         uses: actions/upload-pages-artifact@v2
         with:

pyproject.toml

@@ -54,6 +54,12 @@ path = "mkdocstrings_handlers/crystal/__init__.py"
 [tool.hatch.build.targets.sdist]
 include = ["/mkdocstrings_handlers", "/tests"]
 
+[tool.hatch.env]
+requires = [
+    "hatch-mkdocs",
+    "hatch-pip-compile",
+]
+
 [tool.hatch.build.targets.wheel]
 packages = ["mkdocstrings_handlers"]
 
@@ -98,17 +104,10 @@ format = [
     "ruff format -q mkdocstrings_handlers tests",
 ]
 
+[tool.hatch.env.collectors.mkdocs.docs]
 [tool.hatch.envs.docs]
-detached = true
-dependencies = [
-    "mkdocs >=1.5",
-    "mkdocs-material >=7.1.4",
-    "mkdocs-section-index >=0.3.0",
-    "mkdocstrings >=0.15.0",
-    "mkdocstrings-python >=0.7.1",
-    "pymdown-extensions >=8.2",
-    "markdown-callouts >=0.2",
-]
+type = "pip-compile"
+pip-compile-hashes = false
 
 [tool.ruff]
 line-length = 100

docs/requirements.txt → requirements/requirements-docs.txt

@@ -1,9 +1,15 @@
 #
-# This file is autogenerated by pip-compile with Python 3.11
-# by the following command:
+# This file is autogenerated by hatch-pip-compile with Python 3.11
 #
-#    pip-compile --output-file=docs/requirements.txt -
+# - markdown-callouts
+# - mkdocs
+# - mkdocs-material
+# - mkdocs-section-index
+# - mkdocstrings
+# - mkdocstrings-python
+# - pymdown-extensions
 #
+
 babel==2.13.1
     # via mkdocs-material
 certifi==2023.7.22