docs: fix doc build failures

For some reason, poetry does not install dependencies
to the correct site-package. As a temporary fix,
we can `pip freeze` the packages that poetry installs
and reinstall them to the correct site-packages by
directly using pip.

Signed-off-by: Liam Brady <[email protected]>

Author: liambrady

readthedocs.yml

@@ -8,9 +8,15 @@ build:
       # Install poetry
       - pip install poetry~=1.2
       # Tell poetry to not use a virtual environment
-      - poetry config virtualenvs.create false
+      #- poetry config virtualenvs.create false
     post_install:
       # Install dependencies
       - poetry install --with doc
+      # Why did poetry find and install to the wrong site-packages?
+      #- python -c "import site; print(site.getsitepackages())"
+      #- poetry run python -c "import site; print(site.getsitepackages())"
+      # Install dependencies to the correct site-packages
+      - poetry run pip freeze > reqs.txt
+      - pip install --upgrade -r reqs.txt
 sphinx:
   configuration: doc/source/conf.py