Becksteinlab / GromacsWrapper

GromacsWrapper wraps system calls to GROMACS tools into thin Python classes (GROMACS 4.6.5 - 2024 supported).

Home Page:https://gromacswrapper.readthedocs.org

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

RTD build fails / no 0.6.2 docs online

orbeckst opened this issue · comments

I hate debugging RTD failures...

No idea why https://readthedocs.org/projects/gromacswrapper/builds/5188013/ fails but locally it builds just fine.

Anyone ( @dotsdl , @jandom , @ianmkenney ) can shed some light on this?

Note:

python setup.py build_sphinx upload_docs

builds but then

running upload_docs
Upload_docs command is deprecated. Use RTD instead.
Submitting documentation to https://pypi.python.org/pypi/
Upload failed (503): first byte timeout

Note that it says Upload_docs command is deprecated. Use RTD instead. so maybe that's what is supposed to work.

For completeness: I also tried manually uploading docs to PyPi as a zip file but ran into an error like pypi/legacy#266 (and specifically pypi/legacy#454)

Error 503 first byte timeout

first byte timeout
Guru Mediation:

Details: cache-sea1047-SEA 1490291444 1413371420

Varnish cache server

Apparentlt, pythonhosted is in read-only mode MDAnalysis/mdanalysis#664 (comment) – so we need to sort out RTD or use gh-pages.

In f315770 I've added the sphinx conda package to the environment we install. This ensures we get the latest version, since RTD often runs at least a release behind if not more. Looks like builds are working again.

Thanks again. I backported (cherry-picked) your fix onto master and now the 0.6.2 docs are also properly available again.