Builds timeout during cat conf.py

[matt-chan]

Details

Not sure if this is something I'm doing that's causing it to timeout, or if it's something that is RTD-side. All my builds are timing out and there's no meaningful output.

• Read the Docs project URL: https://readthedocs.org/projects/iodata/
• Build URL (if applicable): https://readthedocs.org/projects/iodata/builds/7952133/
• Read the Docs username (if applicable): theochem

Expected Result

Builds should complete, or give error messages which caused timeout.

Actual Result

The last printed message is cat conf.py.

[stsewd]

This is because conda is very heavy, please try https://docs.readthedocs.io/en/latest/guides/build-using-too-many-resources.html If that doesn't work you can request more build time

[stsewd]

And it's probably falling when creating the docs, see #4288

[humitos]

@matt-chan do you really need to install all those dependencies to build just the docs? That's one of the most important questions. Are you using numpy and cython for building the docs? Maybe a simple requirements.txt file is enough, or even not needed at all for this docs.

[matt-chan]

Yes, I think so. We have cython modules in both projects. Sphinx can't get the docstrings from them without building first unfortunately (or at least I haven't figured out a way to do it) since it imports the module and inspects the __doc__ parameter. Autoapi doesn't support c++ yet, nor cython afaik. The gbasis project in particular also has a binary dependency that needs to be provided by conda.

On Wed, Oct 17, 2018 at 4:03 AM Manuel Kaufmann ***@***.***> wrote: @matt-chan <https://github.com/matt-chan> do you *really* need to install all those dependencies to build just the docs? That's one of the most important questions. Are you using numpy and cython for building the docs? Maybe a simple requirements.txt file is enough, or even not needed at all for this docs. — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#4773 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AA_-Nd0OwPmmZ7Eo_NUpsiX7ljVBHh9Uks5uluRlgaJpZM4XiYvf> .

-- Matt

…

Sent from my phone

[matt-chan]

I got it working. Sorry about that. There was a bug in my conf.py which ended up eating up all the build time. I couldn't see the error though because of #4288. I'll re-open next time if I really time-out.

[stsewd]

@matt-chan glad that your docs are building again, can you please tell me what the problem was? Maybe other users are facing the same problem and I can help there.

[matt-chan]

The issue was a shell script I was calling from conf.py. I accidentally put a make html into it. It worked fine locally, but I forgot that RTD calls "make html" itself. It probably was going into an infinite loop.