docs: borrow poetry version from docs/pyproject.toml

In order make docs build reproducible we need to lock poetry version.
It will also help with pip cache invalidation on the pipeline, hash will
be calculated from `docs/pyproject.toml`.
Does two things:
1. Lock poetry version in `docs/pyproject.toml`
2. Pull version from `docs/pyproject.toml` in `Makefile`

Author: dkropachev

.github/workflows/docs-pages.yml

@@ -24,19 +24,19 @@ jobs:
           fetch-depth: 0
 
       - uses: actions/cache@v4
-        # actions/setup-python poetry cache feature requires poetry to be installed beforehand
-        # which makes use of it extremely awkward.
         with:
           path: |
-            /home/runner/.cache/pip
             /home/runner/.cache/pypoetry
-          # python and poetry version are in docs/pyproject.toml
-          key: docs-cache-${{ runner.os }}-${{ hashFiles('docs/pyproject.toml', 'docs/Makefile') }}
+          key: docs-cache-${{ runner.os }}-${{ hashFiles('docs/poetry.lock') }}
 
-      - name: Set up Python
-        uses: actions/setup-python@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
         with:
-          python-version-file: docs/pyproject.toml
+          version-file: 'docs/pyproject.toml'
+          enable-cache: true
+          cache-dependency-glob: |
+            docs/pyproject.toml
+            docs/uv.lock
 
       - name: Set up env
         run: make -C docs setupenv

.github/workflows/docs-pr.yml

@@ -26,19 +26,18 @@ jobs:
           fetch-depth: 0
 
       - uses: actions/cache@v4
-        # actions/setup-python poetry cache feature requires poetry to be installed beforehand
-        # which makes use of it extremely awkward.
         with:
           path: |
-            /home/runner/.cache/pip
             /home/runner/.cache/pypoetry
-          # python and poetry version are in docs/pyproject.toml
-          key: docs-cache-${{ runner.os }}-${{ hashFiles('docs/pyproject.toml', 'docs/Makefile') }}
+          key: docs-cache-${{ runner.os }}-${{ hashFiles('docs/poetry.lock') }}
 
-      - name: Set up Python
-        uses: actions/setup-python@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
         with:
-          python-version-file: docs/pyproject.toml
+          enable-cache: true
+          cache-dependency-glob: |
+            docs/pyproject.toml
+            docs/uv.lock
 
       - name: Set up env
         run: make -C docs setupenv

docs/Makefile

@@ -1,5 +1,6 @@
 # Global variables
 # You can set these variables from the command line.
+SHELL         = bash
 POETRY        = poetry
 SPHINXOPTS    = -j auto
 SPHINXBUILD   = $(POETRY) run sphinx-build
@@ -19,8 +20,7 @@ all: dirhtml
 # Setup commands
 .PHONY: setupenv
 setupenv:
-	pip install -q poetry
-	sudo apt-get install gcc python3-dev libev4 libev-dev
+	uv pip install -r <(uv pip compile pyproject.toml)
 
 .PHONY: setup
 setup: