Add submodules to sys.path to fix autodoc's "No module named 'health_azure'"

CHANGELOG.md

@@ -97,6 +97,7 @@ gets uploaded to AzureML, by skipping all test folders.
 
 ### Fixed
 
+- ([#702](https://github.com/microsoft/InnerEye-DeepLearning/pull/702)) Fix autodoc's "No module named 'health_azure'".
 - ([#699](https://github.com/microsoft/InnerEye-DeepLearning/pull/699)) Fix Sphinx warnings.
 - ([#682](https://github.com/microsoft/InnerEye-DeepLearning/pull/682)) Ensure the shape of input patches is compatible with model constraints.
 - ([#681](https://github.com/microsoft/InnerEye-DeepLearning/pull/681)) Pad model outputs if they are smaller than the inputs.

sphinx-docs/source/conf.py

@@ -17,21 +17,24 @@
 #
 import sys
 from pathlib import Path
+
 repo_dir = Path(__file__).absolute().parents[2]
 sys.path.insert(0, str(repo_dir))
+from InnerEye.Common import fixed_paths
+fixed_paths.add_submodules_to_path()
 
 
 # -- Imports -----------------------------------------------------------------
 from recommonmark.parser import CommonMarkParser
 
 # -- Project information -----------------------------------------------------
 
-project = 'InnerEye-DeepLearning'
-copyright = 'Microsoft Corporation'
-author = 'Microsoft'
+project = "InnerEye-DeepLearning"
+copyright = "Microsoft Corporation"
+author = "Microsoft"
 
 # The full version, including alpha/beta/rc tags
-release = '1.0.0'
+release = "1.0.0"
 
 
 # -- General configuration ---------------------------------------------------
@@ -40,14 +43,14 @@
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
-    'sphinx.ext.autodoc',
-    'sphinx_rtd_theme',
-    'recommonmark',
-    'sphinx.ext.viewcode'
+    "sphinx.ext.autodoc",
+    "sphinx_rtd_theme",
+    "recommonmark",
+    "sphinx.ext.viewcode",
 ]
 
 # Add any paths that contain templates here, relative to this directory.
-templates_path = ['_templates']
+templates_path = ["_templates"]
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
@@ -60,18 +63,18 @@
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_theme = 'sphinx_rtd_theme'
+html_theme = "sphinx_rtd_theme"
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
 # html_static_path = ['_static']
 
 source_parsers = {
-    '.md': CommonMarkParser,
+    ".md": CommonMarkParser,
 }
 
 source_suffix = {
-    '.rst': 'restructuredtext',
-    '.md': 'markdown',
+    ".rst": "restructuredtext",
+    ".md": "markdown",
 }