readthedocs.org: Builds broken with `poetry` 1.8

Following the install dependencies with poetry guide, I get the following error with poetry 1.8:

no theme named 'furo' found (missing theme.conf?)

However, the theme is clearly installed!

- Installing furo (2024.1.29)

Specifically installing poetry 1.7 with fixes the issue:

- pip install 'poetry~=1.7.0'

I don’t see anything in the poetry 1.8 release notes to as a cause for the breakage. If you can pin down what the problem is, I’ll gladly follow-up with an issue on the poetry issue tracker. 🙇

Details

Read the Docs project URL: https://readthedocs.org/projects/logot/
Build URL (if applicable): https://readthedocs.org/projects/logot/builds/23555282/
Read the Docs username (if applicable): https://readthedocs.org/profiles/etianen/

Expected Result

The build to pass with poetry 1.8 👍

Actual Result

The build fails with poetry 1.8 👎

About this issue

Original URL
State: closed
Created 4 months ago
Reactions: 1
Comments: 16 (10 by maintainers)

Commits related to this issue

Fix docs build for Poetry >=1.8 (#881) https://github.com/readthedocs/readthedocs.org/issues/11150 https://github.com/python-poetry/poetry/issues/9025 — committed to ml6team/fondant by RobbeSneyders 4 months ago
Attempt to fix broken docs build due to Poetry changes This commit introduces the changes from readthedocs/readthedocs.org#11150. — committed to davidalber/geneagrapher-core by davidalber 4 months ago
Fix .readthedocs.yml Following https://github.com/readthedocs/readthedocs.org/issues/11150 — committed to botify-labs/django-readonly-field by ewjoachim 3 months ago

Most upvoted comments

For the record, I got a completed build in RTF with:

version: 2

build:
  os: "ubuntu-22.04"
  tools:
    python: "3.11"
  jobs:
    post_create_environment:
      # Install poetry and the export plugin for pip
      - python -m pip install poetry poetry-plugin-export
    post_install:
      - poetry export -f requirements.txt --without-hashes --only docs -o only-docs.txt
      - pip install --requirement only-docs.txt

I prefer you workaround @ewjoachim since is simpler.

Thanks!

jfagoagas on Feb 26, 2024

For the record, I got a running build in RTD with:

version: 2

build:
  os: "ubuntu-22.04"
  tools:
    python: "3.10"
  jobs:
    post_create_environment:
      - python -m pip install poetry
    post_install:
      - VIRTUAL_ENV=$READTHEDOCS_VIRTUALENV_PATH python -m poetry install --with docs

I’ll open a PR for this to become “the way”. When we can improve this, we will.

ewjoachim on Feb 25, 2024