Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
Try to debug the autodoxy pb on framagit builders
authorMartin Quinson <martin.quinson@ens-rennes.fr>
Sun, 10 Nov 2019 20:48:28 +0000 (21:48 +0100)
committerMartin Quinson <martin.quinson@ens-rennes.fr>
Sun, 10 Nov 2019 20:48:31 +0000 (21:48 +0100)
- increase sphinx verbosity on gitlab
- build pages asap (not after regular builds)
- simplify the imports that are not found (top of file, not within a function)

.gitlab-ci.yml
docs/source/_ext/autodoxy/__init__.py

index 4a27f3c..edb2cb0 100644 (file)
@@ -1,18 +1,18 @@
 image: simgrid/build-deps
 
-stages:
- - build
- - test
+#stages:
+# - build
+# - test
 
 pages:
-  stage: test
+#  stage: test
   script:
   - cmake -Denable_model-checking=OFF -Denable_documentation=ON -Denable_compile_optimizations=OFF -Denable_smpi=OFF -Dpython=ON .
   - make -j4
   - pip3 install --requirement docs/requirements.txt
   - cd docs
-  - LC_ALL=C.UTF-8 ./Build.sh
-  - mv build/html ../public || (cat /tmp/sphinx-err-* ; false)
+  - LC_ALL=C.UTF-8 SPHINXOPTS=-vvv ./Build.sh || (cat /tmp/sphinx-err-* ; false)
+  - mv build/html ../public
   # - The CSS contains a reference to a font or something, not something we gonna fix on our side
   # - The javasphinx output does not exist in the git, so the "edit on FramaGit" link is broken.
   #   I'd like to report this as a bug, but javasphinx seems abandonned upstream.
@@ -27,7 +27,7 @@ pages:
   - master
 
 ctest:
-  stage: build
+#  stage: build
   except:
   - stable
   script:
@@ -36,7 +36,7 @@ ctest:
 
 pip:
   image: debian:testing
-  stage: build
+#  stage: build
   except:
   - stable
   script:
@@ -45,7 +45,7 @@ pip:
   - cd dist && tar xfz simgrid*.tar.gz && cd simgrid-*/ && python3 setup.py build
 
 release:
-  stage: build
+#  stage: build
   only:
   - stable
   script:
index 29b12f9..c113b02 100644 (file)
@@ -2,6 +2,10 @@ import os.path
 from lxml import etree as ET
 from sphinx.errors import ExtensionError
 
+import sphinx.ext.autosummary
+from autodoxy import DoxygenClassDocumenter, DoxygenMethodDocumenter, DoxygenTypeDocumenter
+from autodoxy.autosummary import DoxygenAutosummary, DoxygenAutoEnum
+from autodoxy.autosummary.generate import process_generate_options
 
 def set_doxygen_xml(app):
     """Load all doxygen XML files from the app config variable
@@ -34,10 +38,6 @@ def get_doxygen_root():
     return setup.DOXYGEN_ROOT
 
 def setup(app):
-    import sphinx.ext.autosummary
-    from autodoxy import DoxygenClassDocumenter, DoxygenMethodDocumenter, DoxygenTypeDocumenter
-    from autodoxy.autosummary import DoxygenAutosummary, DoxygenAutoEnum
-    from autodoxy.autosummary.generate import process_generate_options
 
     app.connect("builder-inited", set_doxygen_xml)
     app.connect("builder-inited", process_generate_options)