Fix issue with Python sphinx installation (#272)

* Low-effort attempts to fix Windows builds.

* It's early.

* Test w/out sphinx.

* Move sphinx installation to different file & target.

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

.github/workflows/pull_request.yml

@@ -8,11 +8,11 @@ jobs:
   main:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v1
+      - uses: actions/checkout@v4
       - name: Set up Python 3.7
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v4
         with:
-          python-version: "3.7"
+          python-version: "3.8"
       - name: Install packages
         run: |
           make install
@@ -35,9 +35,9 @@ jobs:
         os: [ubuntu-latest, macos-latest, windows-latest]
         python: ["3.7", "3.8", "3.9", "3.10", "3.11"]
     steps:
-      - uses: actions/checkout@v1
+      - uses: actions/checkout@v4
       - name: Setup Python
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v4
         with:
           python-version: ${{ matrix.python }}
       - name: Install Tox and any other packages

.github/workflows/release-docs.yml

@@ -15,7 +15,7 @@ jobs:
           python-version: 3.9
       - name: Install dependencies
         run: |
-          make install
+          make install-docs
       - name: Build docs
         run: |
           cd docs

Makefile

@@ -26,6 +26,9 @@ install:
 	pip install . && \
 	./scripts/get-spec.sh
 
+install-docs: install
+	pip install -U -r requirements-docs.txt
+
 #-----------------------------------------------------------------------
 # Testing & Linting
 #-----------------------------------------------------------------------

requirements-docs.txt

@@ -0,0 +1,6 @@
+# - Docs
+enum-tools[sphinx]
+m2r2
+sphinx==7.2.5
+sphinx-rtd-theme
+autodocsumm==0.2.11

requirements.txt

@@ -32,11 +32,5 @@ build
 setuptools_scm
 twine
 
-# - Docs
-enum-tools[sphinx]
-m2r2
-sphinx
-sphinx-rtd-theme
-
 # - Typing
 types-requests