Merge pull request #271 from python-openapi/fix/readthedocs-build-fix

Readthedocs build fix

Author: p1c2u

.github/workflows/docs-build.yml

@@ -23,6 +23,8 @@ jobs:
 
       - name: Set up poetry
         uses: Gr1N/setup-poetry@v9
+        with:
+          poetry-version: "2.1.1"
 
       - name: Configure poetry
         run: poetry config virtualenvs.in-project true

.readthedocs.yaml

@@ -6,12 +6,13 @@ sphinx:
 formats: all
 
 build:
-  os: ubuntu-20.04
+  os: ubuntu-24.04
   tools:
     python: "3.10"
   jobs:
     post_create_environment:
-      - pip install poetry
+      - pip install "poetry==2.1.1"
       - poetry config virtualenvs.create false
     post_install:
-      - poetry install --with docs
+      - poetry install --with docs --no-interaction --no-ansi
+      - python -m pip install --no-cache-dir "sphinx-immaterial>=0.11,<0.14"

docs/conf.py

@@ -1,10 +1,29 @@
-import openapi_schema_validator
+import re
+import sys
+from pathlib import Path
+
+ROOT_DIR = Path(__file__).resolve().parents[1]
+sys.path.insert(0, str(ROOT_DIR))
+
+
+def _read_project_version() -> str:
+    pyproject_path = ROOT_DIR / "pyproject.toml"
+    pyproject_content = pyproject_path.read_text(encoding="utf-8")
+    match = re.search(
+        r"\[tool\.poetry\][\s\S]*?^version\s*=\s*\"([^\"]+)\"",
+        pyproject_content,
+        re.MULTILINE,
+    )
+    if match is None:
+        return "unknown"
+    return match.group(1)
+
 
 project = "openapi-schema-validator"
 copyright = "2023, Artur Maciag"
 author = "Artur Maciag"
 
-release = openapi_schema_validator.__version__
+release = _read_project_version()
 
 extensions = [
     "sphinx.ext.autodoc",