Merge pull request #121 from dgarcia360/docs-update-1.9

docs: update theme 1.9

Author: dkropachev

.github/dependabot.yml

@@ -1,6 +1,6 @@
 version: 2
 updates:
-  - package-ecosystem: "pip"
+  - package-ecosystem: "uv"
     directory: "/docs"
     schedule:
       interval: "daily"

.github/workflows/docs-pages.yaml

@@ -15,6 +15,8 @@ on:
 jobs:
   release:
     runs-on: ubuntu-latest
+    permissions:
+      contents: write
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -25,7 +27,9 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
-          python-version: '3.10'
+          python-version: '3.12'
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
       - name: Set up env
         run: make -C docs setupenv
       - name: Build docs

.github/workflows/docs-pr.yaml

@@ -10,6 +10,9 @@ on:
       - "docs/**"
       - "topics/**"
 
+permissions:
+  contents: read
+
 jobs:
   build:
     runs-on: ubuntu-latest
@@ -22,7 +25,9 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
-          python-version: '3.10'
+          python-version: '3.12'
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
       - name: Set up env
         run: make -C docs setupenv
       - name: Build docs

docs/Makefile

@@ -1,7 +1,7 @@
 # You can set these variables from the command line.
-POETRY        = poetry
+UV            = uv
 SPHINXOPTS    = -j auto
-SPHINXBUILD   = $(POETRY) run sphinx-build
+SPHINXBUILD   = $(UV) run sphinx-build
 PAPER         =
 BUILDDIR      = _build
 SOURCEDIR     = _source
@@ -20,20 +20,20 @@ all: dirhtml
 # Setup commands
 .PHONY: setupenv
 setupenv:
-	pip install -q poetry
+	pip install -q uv
 	sudo apt-get install doxygen
 
 .PHONY: setup
 setup:
-	$(POETRY) install
+	$(UV) sync
 	cd .. && doxygen Doxyfile.in
 	@if [ ! -d "$(SOURCEDIR)" ]; then mkdir -p "$(SOURCEDIR)"; fi
 	cp -RL source/* $(SOURCEDIR)
 	cd $(SOURCEDIR) && find . -name README.md -execdir mv '{}' index.md ';'
 
 .PHONY: update
 update:
-	$(POETRY) update
+	$(UV) sync --upgrade
 
 # Clean commands
 .PHONY: pristine
@@ -61,7 +61,7 @@ singlehtml: setup
 
 .PHONY: multiversion
 multiversion: setup
-	$(POETRY) run ./_utils/multiversion.sh
+	$(UV) run ./_utils/multiversion.sh
 	@echo
 	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
 
@@ -85,18 +85,18 @@ dummy: setup
 
 .PHONY: redirects
 redirects: setup
-	$(POETRY) run redirects-cli fromfile --yaml-file _utils/redirects.yaml --output-dir $(BUILDDIR)/dirhtml
+	$(UV) run redirects-cli fromfile --yaml-file _utils/redirects.yaml --output-dir $(BUILDDIR)/dirhtml
 	@echo
 	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
 
 # Preview commands
 .PHONY: preview
 preview: setup
-	$(POETRY) run sphinx-autobuild -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml --port 5500 --re-ignore 'api/*'
+	$(UV) run sphinx-autobuild -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml --port 5500 --re-ignore 'api/*'
 
 .PHONY: multiversionpreview
 multiversionpreview: multiversion
-	$(POETRY) run python -m http.server 5500 --directory $(BUILDDIR)/dirhtml
+	$(UV) run python -m http.server 5500 --directory $(BUILDDIR)/dirhtml
 
 # Test commands
 .PHONY: test

docs/poetry.lock

@@ -1,24 +1,20 @@
-[tool.poetry]
+[project]
 name = "cpp-driver"
 description = "Scylla C/C++ Driver"
 version = "0.1"
-authors = ["ScyllaDB Documentation Contributors"]
-package-mode = false
+requires-python = ">=3.11"
+dependencies = [
+    "breathe>=4.35.0",
+    "pygments>=2.18.0",
+    "sphinx-scylladb-theme>=1.9.1",
+    "myst-parser>=5.0.0",
+    "sphinx-autobuild>=2025.4.8",
+    "sphinx>=9.0",
+    "sphinx-multiversion-scylla>=0.3.7",
+    "sphinx-sitemap>=2.9.0",
+    "redirects_cli>=0.1.3",
+    "sphinx-scylladb-markdown>=0.1.2",
+]
 
-[tool.poetry.dependencies]
-breathe="4.35.0"
-python = "^3.10"
-pygments = "^2.18.0"
-redirects_cli ="^0.1.3"
-sphinx-scylladb-theme = "^1.8.5"
-sphinx-sitemap = "^2.6.0"
-sphinx-autobuild = "^2024.4.19"
-Sphinx = "^7.3.7"
-sphinx-multiversion-scylla = "^0.3.1"
-sphinx-scylladb-markdown = "^0.1.2"
-[tool.poetry.dev-dependencies]
-pytest = "5.2"
-
-[build-system]
-requires = ["poetry>=1.8.0"]
-build-backend = "poetry.masonry.api" 
+[tool.uv]
+package = false

docs/pyproject.toml

@@ -59,7 +59,7 @@
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
 # This patterns also effect to html_static_path and html_extra_path
-exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
+exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store', '.venv']
 
 # The name of the Pygments (syntax highlighting) style to use.
 pygments_style = 'sphinx'