From 80e1d98daaeb1307f09a3a1be126d453364c0b7d Mon Sep 17 00:00:00 2001 From: Jacopo Teneggi Date: Mon, 21 Mar 2022 19:24:30 -0400 Subject: [PATCH 1/2] Add submodules to sys.path to fix autodoc's "No module named 'health_azure'" warning --- sphinx-docs/source/conf.py | 29 ++++++++++++++++------------- 1 file changed, 16 insertions(+), 13 deletions(-) diff --git a/sphinx-docs/source/conf.py b/sphinx-docs/source/conf.py index 3ec28a55e..a5963b418 100644 --- a/sphinx-docs/source/conf.py +++ b/sphinx-docs/source/conf.py @@ -17,8 +17,11 @@ # 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 ----------------------------------------------------------------- @@ -26,12 +29,12 @@ # -- 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,7 +63,7 @@ # 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, @@ -68,10 +71,10 @@ # html_static_path = ['_static'] source_parsers = { - '.md': CommonMarkParser, + ".md": CommonMarkParser, } source_suffix = { - '.rst': 'restructuredtext', - '.md': 'markdown', + ".rst": "restructuredtext", + ".md": "markdown", } From 81332ec29d3d68a5c84a2ee753e924dd2d39bd91 Mon Sep 17 00:00:00 2001 From: Jacopo Teneggi Date: Mon, 21 Mar 2022 19:32:18 -0400 Subject: [PATCH 2/2] Update CHANGELOG --- CHANGELOG.md | 1 + 1 file changed, 1 insertion(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 73d94d267..14aaef9fc 100644 --- a/CHANGELOG.md +++ b/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.