chore: move docs deps to pyproject.toml

docs/.readthedocs.yaml → .readthedocs.yaml

@@ -9,7 +9,7 @@ version: 2
 build:
   os: ubuntu-22.04
   tools:
-    python: "3.11"
+    python: "3.12"
 
 # Build documentation in the docs/ directory with Sphinx
 sphinx:
@@ -20,7 +20,7 @@ sphinx:
 # Optionally declare the Python requirements required to build your docs
 python:
   install:
-    - requirements: docs/requirements.txt
     - method: pip
       path: .
-
+      extra_requirements:
+        - docs

docs/.sphinx/requirements.txt

@@ -0,0 +1,3 @@
+# This file is used by the automatic-doc-checks CI workflow
+# This is sourced the "craft-cli/docs" dir, so this installs "craft-cli[docs]"
+..[docs]

pyproject.toml

@@ -62,6 +62,12 @@ types = [
     "types-colorama",
     "types-setuptools",
 ]
+docs = [
+    "sphinx-toolbox==3.5.0",
+    "sphinx-lint==0.9.1",
+    "pytest>=7.0.0", # This is just because this is imported by the code
+    "canonical-sphinx@git+https://github.com/canonical/canonical-sphinx@CRAFT-2671-update-assets",
+]
 
 [build-system]
 requires = [

tox.ini

@@ -105,12 +105,12 @@ commands =
     codespell: codespell --toml {tox_root}/pyproject.toml --write-changes {posargs}
 
 [docs]  # Sphinx documentation configuration
-deps =
-    -r{tox_root}/docs/requirements.txt
+extras = docs
 package = editable
 no_package = true
 env_dir = {work_dir}/docs
 runner = ignore_env_name_mismatch
+source_dir = {tox_root}/{project_name}
 
 [testenv:build-docs]
 description = Build sphinx documentation