Build timeout due to autodoc requirements

[eendebakpt]

Details

To get autodoc to work I added setup_py_install: true to the .readthedocs.yml (as described in #3634). A side effect is that my project must now be compiled by readthedocs, before it can be installed. Since my projects compiles code using swig and C++ I created a conda environment file in order to install swig in the build environment. This seems to be working, but now the build takes too long and I get a Build exited due to time out error.

Is it possible to either

• Use autodoc, without building the project?
• Increase the time limit for this project?

More info:

• Read the Docs project URL: https://oapackage.readthedocs.io
• Build URL (if applicable): https://readthedocs.org/projects/oapackage/builds/7559891/
• Read the Docs username (if applicable): eendebakpt

Expected Result

The build should have taken place within the amount of time allowed or autodoc should work without installing the package.

Actual Result

A timeout error was generated.

[stsewd]

Maybe this helps https://docs.readthedocs.io/en/latest/faq.html#i-get-import-errors-on-libraries-that-depend-on-c-modules

[peendebak]

@stsewd I checked the link, but I don't see how this would help. My project does have a C extension, but I don't see hoe the mocks can prevent building the extension.

[peendebak]

@stsewd I figured out how to use the mocks to disable building my C extension. A problem is still that since the C extension is not build, also the swig wrappers are not generated and hence no documentation is generated for this.

[stsewd]

Yeah, you can't use mocks in those cases :/, we need to wait for a maintainer to increase your time limit, but it seems very weird: the command says Command killed due to excessive memory consumption, but the general message says Build exited due to time out

[humitos]

@eendebakpt hi! you may want to subscribe to this issue about adding swig to the image container: readthedocs/readthedocs-docker-images#15

Let's handle the timeout issue for now at #4757

[eendebakpt]

Fixed with #4757