Currently the docs builds are failing due to two issues:
Dependencies:
WARNING: autodoc: failed to import module 'construct' from module 'mira.dkg'; the following exception was raised:
No module named 'pyobo'
This would require (a) hiding the pyobo import inside some funnction, or (b) putting pyobo in as a requirement for the docs build to have it be installed (c) mocking pyobo.
Jinja issues:
Traceback (most recent call last):
File "/home/docs/checkouts/readthedocs.org/user_builds/miramodel/envs/latest/lib/python3.8/site-packages/sphinx/builders/html/__init__.py", line 1093, in handle_page
output = self.templates.render(templatename, ctx)
File "/home/docs/checkouts/readthedocs.org/user_builds/miramodel/envs/latest/lib/python3.8/site-packages/readthedocs_ext/readthedocs.py", line 181, in rtd_render
content = old_render(template, render_context)
File "/home/docs/checkouts/readthedocs.org/user_builds/miramodel/envs/latest/lib/python3.8/site-packages/sphinx/jinja2glue.py", line 196, in render
return self.environment.get_template(template).render(context)
File "/home/docs/checkouts/readthedocs.org/user_builds/miramodel/envs/latest/lib/python3.8/site-packages/jinja2/environment.py", line 1301, in render
self.environment.handle_exception()
File "/home/docs/checkouts/readthedocs.org/user_builds/miramodel/envs/latest/lib/python3.8/site-packages/jinja2/environment.py", line 936, in handle_exception
raise rewrite_traceback_stack(source=source)
File "/home/docs/checkouts/readthedocs.org/user_builds/miramodel/envs/latest/lib/python3.8/site-packages/sphinx/themes/basic/page.html", line 10, in top-level template code
{%- extends "layout.html" %}
File "/home/docs/checkouts/readthedocs.org/user_builds/miramodel/envs/latest/lib/python3.8/site-packages/sphinx_rtd_theme/layout.html", line 23, in top-level template code
<link rel="stylesheet" href="{{ pathto('_static/' + style, 1) }}" type="text/css" />
jinja2.exceptions.UndefinedError: 'style' is undefined
This implies some sort of incompatibility between Sphinx's RTD theme package and Jinja.
Currently the docs builds are failing due to two issues:
Dependencies:
This would require (a) hiding the pyobo import inside some funnction, or (b) putting pyobo in as a requirement for the docs build to have it be installed (c) mocking pyobo.
Jinja issues:
This implies some sort of incompatibility between Sphinx's RTD theme package and Jinja.