You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
DOC: Unpin max version of Sphinx when Sphinx 4.0.2 is out (and Jinja2) #11725
changed the title [-]DOC: Unpin max version of Sphinx when Sphinx 4.0.2 is out[/-][+]DOC: Unpin max version of Sphinx when Sphinx 4.0.2 is out (and Jinja2)[/+]on Mar 24, 2022
sphinx-doc/sphinx@7318d1d introduced code to sphinx 3.5 that ended up being incompatible with Python 3.10. The fix was provided by sphinx-doc/sphinx@8b2031c, but is available only for sphinx >= 4.2. Installing astropy[docs] currently results in sphinx 3.5.4 being installed. If the maximum version of sphinx can't be unpinned soon then it should lowered even further to < 3.5.
@saimn was going to revisit this when he can but if you are in a rush, you can try use astropy/sphinx-automodapi#150 in this repo and debug the remaining errors.
For the time being I have installed sphinx 3.4.3. This does not address the underlying problems, but at least it enables building astropy docs with Python 3.10.
Activity
astrojuanlu commentedon May 11, 2021
Looks like Sphinx 4.0.2 will be released with this fix!
pllim commentedon May 17, 2021
I have been following sphinx-doc/sphinx#9214 . I think it is happening by the end of the week.
[-]DOC: Unpin max version of Sphinx[/-][+]DOC: Unpin max version of Sphinx when Sphinx 4.0.2 is out[/+][-]DOC: Unpin max version of Sphinx when Sphinx 4.0.2 is out[/-][+]DOC: Unpin max version of Sphinx when Sphinx 4.0.2 is out (and Jinja2)[/+]WilliamJamieson commentedon Mar 24, 2022
Jinja2 pin is related to sphinx-doc/sphinx#10291
eerovaher commentedon Aug 29, 2022
sphinx-doc/sphinx@7318d1d introduced code to
sphinx3.5 that ended up being incompatible with Python 3.10. The fix was provided by sphinx-doc/sphinx@8b2031c, but is available only forsphinx>= 4.2. Installingastropy[docs]currently results insphinx3.5.4 being installed. If the maximum version ofsphinxcan't be unpinned soon then it should lowered even further to < 3.5.pllim commentedon Aug 30, 2022
@saimn was going to revisit this when he can but if you are in a rush, you can try use astropy/sphinx-automodapi#150 in this repo and debug the remaining errors.
eerovaher commentedon Aug 30, 2022
For the time being I have installed
sphinx3.4.3. This does not address the underlying problems, but at least it enables buildingastropydocs with Python 3.10.pllim commentedon Aug 30, 2022
@eerovaher , do you want to open a PR to lower the pin and also try to build RTD in Python 3.10 with it? Thanks!
astropy/.readthedocs.yml
Line 8 in d15a689
🐛 fix(pyproject.toml): pin dependencies
🐛 fix(pyproject.toml): re-pin `Sphinx` and `Jinja2`
🐛 fix(pyproject): re-pin `Sphinx` and `Jinja2`
Create Documenation in GitHub Pages (#9)
📚 docs: create GitHub Pages
📚 docs: create GitHub Pages
🐛 fix(pyproject.toml): unpin `Sphinx` and `Jinja2` dependencies
🐛 fix(pyproject.toml): unpin `Sphinx` and `Jinja2` dependencies