cookiecutter-hypermodern-python icon indicating copy to clipboard operation
cookiecutter-hypermodern-python copied to clipboard

Release `2022.6.3` contains default sphinx dependencies in pyproject.toml that cannot be resolved in `poetry update`.

Open s-t-a-n opened this issue 1 year ago • 0 comments

Hey guys, I am running into an issue with the latest release. I can't update the dependencies without disabling some sphinx-dependencies. The culprit seems to be the sphinxcontrib.applehelp dependency. Maybe I am seeing ghosts but I thought to let you know anyway as I haven't been able to crack this one so far and it seems to break on the default release provided.

Anyway thanks for making this template. If I can help any way to resolve this issue then be frank about it :)

To reproduce

cookiecutter gh:cjolowicz/cookiecutter-hypermodern-python --checkout=2022.6.3
# enter all default
cd hypermodern-python
poetry install -vvv # ok
poetry update -vvv # hangs on `fact: sphinxcontrib.applehelp (1.0.3) requires Python >=3.8`

Expected

Packages are updated

Actual results

Poetry hangs on resolving dependency sphinxcontrib.applehelp (1.0.3) with error fact: sphinxcontrib.applehelp (1.0.3) requires Python >=3.8

I let it run for some 10 minutes. It's a deadlock.

with this output:

   $ poetry update -vvv 
   ...
   1: selecting sphinxcontrib.applehelp (1.0.3)
   1: selecting sphinxcontrib.applehelp (1.0.3)
   1: selecting sphinxcontrib.applehelp (1.0.3)
   1: selecting sphinxcontrib.applehelp (1.0.3)
   1: selecting sphinxcontrib.applehelp (1.0.3)
   1: selecting sphinxcontrib.applehelp (1.0.3)
   1: selecting sphinxcontrib.applehelp (1.0.3)

Workaround

Disable the following Sphinx dependencies in pyproject.toml:

  32   │ #furo = ">=2021.11.12"
  41   │ #sphinx = ">=4.3.2"
  42   │ #sphinx-autobuild = ">=2021.3.14"
  43   │ #sphinx-click = ">=3.0.2"
  46   │ #myst-parser = {version = ">=0.16.1"}

I have also tried bumping Sphinx to no avail (even when bumping minimal Python requirement to >3.8). Same issue.

Potential culprits

  • pyproject Sphinx circular dependency (possibly with a specific versioning conflict?)
  • a Poetry bug

Details

Poetry: 1.1.15 #latest from Pypi Pip: 22.3.1 #latest from Pypi Python: 3.10.6 OS: Ubuntu 22.04 LTS

s-t-a-n avatar Jan 13 '23 21:01 s-t-a-n