build: add docs extra to build the documentation

Author: espdev

.github/workflows/main.yaml

@@ -42,7 +42,7 @@ jobs:
           key: venv-${{ hashFiles('poetry.lock') }}
 
       - name: Install the project dependencies
-        run: poetry install
+        run: poetry install -E docs
 
       - name: Run static analysis and linters
         run: poetry run poe check

.readthedocs.yml

@@ -24,3 +24,5 @@ python:
   install:
     - method: pip
       path: .
+      extra_requirements:
+        - docs

poetry.lock

@@ -53,23 +53,27 @@ scipy = [
     {version = "*", python = "<3.12"},
     {version = ">=1.11.4", python = ">=3.12"},
 ]
+sphinx = {version = "^7.1.2", optional = true}
+docutils = {version = "^0.21.2", optional = true}
+numpydoc = {version = "^1.6.0", optional = true}
+m2r2 = {version = "^0.3.2", optional = true}
+matplotlib = {version = "^3.7.4", optional = true}
 
 
 [tool.poetry.group.dev.dependencies]
 setuptools = "^78.1.0"
 pytest = "^8.3.5"
 pytest-cov = "^6.1.1"
-m2r2 = "^0.3.2"
-docutils = "^0.20.0"
-sphinx = "^7.1.2"
-numpydoc = "^1.6.0"
-matplotlib = "^3.7.4"
 ruff = "^0.11.5"
 mypy = "^1.7.1"
 pre-commit = "^4.2.0"
 poethepoet = "^0.33.1"
 
 
+[tool.poetry.extras]
+docs = ["sphinx", "docutils", "numpydoc", "m2r2", "matplotlib"]
+
+
 [build-system]
 requires = ["poetry-core", "setuptools"]
 build-backend = "poetry.core.masonry.api"