Open ylep opened 4 months ago
The logs of that hanging Sphinx process are there: https://brainvisa.info/builds/view/branch%205.1/job/cea-5.1-5.3/4426/ (I killed the process manually after about 4 hours)
/casa/host/src/capsul/5.1/capsul/study_config/config_modules/somaworkflow_config.py:docstring of capsul.study_config.config_modules.somaworkflow_config.SomaWorkflowConfig.set_computing_resource_password:1: WARNING: duplicate object description of capsul.study_config.config_modules.somaworkflow_config.SomaWorkflowConfig.set_computing_resource_password, other instance in api/study_config, use :noindex: for one of them
/casa/host/src/capsul/5.1/doc/source/api/utils.rst:5: WARNING: No classes found for inheritance diagram
Notebook error:
DeadKernelError in tutorial/capsul_tutorial.ipynb:
Kernel died
make[3]: *** [build_files/capsul/CMakeFiles/capsul-sphinx.dir/build.make:71: build_files/capsul/CMakeFiles/capsul-sphinx] Error 2
make[2]: *** [CMakeFiles/Makefile2:11416: build_files/capsul/CMakeFiles/capsul-sphinx.dir/all] Error 2
make[1]: *** [CMakeFiles/Makefile2:6523: CMakeFiles/doc.dir/rule] Error 2
make: *** [Makefile:303: doc] Error 2
Also, the capsul tests timed out: https://brainvisa.info/builds/view/branch%205.1/job/cea-5.1-5.3/4430/
test_full_wf (capsul.pipeline.test.test_pipeline_workflow.TestPipelineWorkflow) ... ok
test_iter_workflow (capsul.pipeline.test.test_pipeline_workflow.TestPipelineWorkflow) ...
================================================================================
TIMED OUT (exit code 124)
Finished: FAILURE
Yes I have noticed that docs fail or hang. The behaviour has changed after an update of the casa-distro images, and is linked with version changes in sphinx, nbsphinx, sphinx-gallery and possibly more related packages. However I could not find a version which reliably works now. With some versions notebooks docs fail or hang, and in some others it is sphinx-gallery which causes trouble (as far as I remember). The problem is perhaps on our side however: notebooks or examples run python programs which possibly don't exit cleanly as they import C++ bindings compiled modules. It' quite difficult to track. And it' even a bit worse than that: once a sphinx-gallery doc is built, it is not rebuilt later, so buildings docs may pass, or look being OK, but if we build them from scratch again, it fails.
Anyway disabling Capsul docs will not be enough: some fail in aims or anatomist docs.
The timeout in capsul test is also non-reproducible and happens sometimes. I guess it is somewhere in soma-workflow client/server communications.
When using
bv maker doc
, the process sometimes hangs indefinitely, seemingly while running some Ipython code:Maybe the easy/lazy fix is just to disable documentation for Capsul v2, since we are abandoning this API anyway?
Environment:
casa-dev-5.3-25