Read the Docs build information Build id: 295553 Project: espressif-esp-rainmaker Version: latest Commit: 97c41310d8b1581ffa79543161659f2620cca306 Date: 2020-03-02T13:55:41.512414Z State: finished Success: False [rtd-command-info] start-time: 2020-03-02T13:55:44.533794Z, end-time: 2020-03-02T13:55:44.843731Z, duration: 0, exit-code: 0 git remote set-url origin git@github.com:espressif/esp-rainmaker.git [rtd-command-info] start-time: 2020-03-02T13:55:45.169971Z, end-time: 2020-03-02T13:55:45.993302Z, duration: 0, exit-code: 0 git fetch origin --force --tags --prune --prune-tags --depth 50 Warning: Permanently added 'github.com,192.30.255.113' (RSA) to the list of known hosts. [rtd-command-info] start-time: 2020-03-02T13:55:46.380934Z, end-time: 2020-03-02T13:55:46.693291Z, duration: 0, exit-code: 0 git checkout --force origin/test/read-the-docs HEAD is now at 97c4131 docs: ESP RainMaker Coming Soon [rtd-command-info] start-time: 2020-03-02T13:55:46.860219Z, end-time: 2020-03-02T13:55:47.167262Z, duration: 0, exit-code: 0 git clean -d -f -f Removing docs/sphinx/__pycache__/ Removing docs/sphinx/en/_build/ Removing docs/sphinx/en/doxygen-warning-log.txt Removing docs/sphinx/en/man/ Removing docs/sphinx/en/xml/ Removing docs/sphinx/en/xml_in/ [rtd-command-info] start-time: 2020-03-02T13:55:48.925470Z, end-time: 2020-03-02T13:55:53.404098Z, duration: 4, exit-code: 0 python2.7 -mvirtualenv --no-site-packages New python executable in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-rainmaker/envs/latest/bin/python2.7 Also creating executable in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-rainmaker/envs/latest/bin/python Installing setuptools, pip, wheel... done. [rtd-command-info] start-time: 2020-03-02T13:55:53.558385Z, end-time: 2020-03-02T13:55:54.682542Z, duration: 1, exit-code: 0 python -m pip install --upgrade --cache-dir /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-rainmaker/.cache/pip pip DEPRECATION: Python 2.7 reached the end of its life on January 1st, 2020. Please upgrade your Python as Python 2.7 is no longer maintained. A future version of pip will drop support for Python 2.7. More details about Python 2 support in pip, can be found at https://pip.pypa.io/en/latest/development/release-process/#python-2-support Requirement already up-to-date: pip in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-rainmaker/envs/latest/lib/python2.7/site-packages (20.0.2) [rtd-command-info] start-time: 2020-03-02T13:55:54.844831Z, end-time: 2020-03-02T13:56:06.480264Z, duration: 11, exit-code: 0 python -m pip install --upgrade --cache-dir /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-rainmaker/.cache/pip Pygments==2.3.1 setuptools==41.0.1 docutils==0.14 mock==1.0.1 pillow==5.4.1 alabaster>=0.7,<0.8,!=0.7.5 commonmark==0.8.1 recommonmark==0.5.0 sphinx<2 sphinx-rtd-theme<0.5 readthedocs-sphinx-ext<1.1 DEPRECATION: Python 2.7 reached the end of its life on January 1st, 2020. Please upgrade your Python as Python 2.7 is no longer maintained. A future version of pip will drop support for Python 2.7. More details about Python 2 support in pip, can be found at https://pip.pypa.io/en/latest/development/release-process/#python-2-support Collecting Pygments==2.3.1 Using cached Pygments-2.3.1-py2.py3-none-any.whl (849 kB) Collecting setuptools==41.0.1 Using cached setuptools-41.0.1-py2.py3-none-any.whl (575 kB) Collecting docutils==0.14 Using cached docutils-0.14-py2-none-any.whl (543 kB) Processing /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-rainmaker/.cache/pip/wheels/ad/62/e0/a06cc957652749e64c7904e899eca3ecb2ec47c60d52653660/mock-1.0.1-py2-none-any.whl Collecting pillow==5.4.1 Using cached Pillow-5.4.1-cp27-cp27mu-manylinux1_x86_64.whl (2.0 MB) Collecting alabaster!=0.7.5,<0.8,>=0.7 Using cached alabaster-0.7.12-py2.py3-none-any.whl (14 kB) Collecting commonmark==0.8.1 Using cached commonmark-0.8.1-py2.py3-none-any.whl (47 kB) Collecting recommonmark==0.5.0 Using cached recommonmark-0.5.0-py2.py3-none-any.whl (9.8 kB) Collecting sphinx<2 Using cached Sphinx-1.8.5-py2.py3-none-any.whl (3.1 MB) Collecting sphinx-rtd-theme<0.5 Using cached sphinx_rtd_theme-0.4.3-py2.py3-none-any.whl (6.4 MB) Collecting readthedocs-sphinx-ext<1.1 Using cached readthedocs_sphinx_ext-1.0.1-py2.py3-none-any.whl (14 kB) Processing /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-rainmaker/.cache/pip/wheels/5f/11/0c/aad680baf5ef4fbcbab992c9f03e1130357e0c173a4fdabfff/future-0.18.2-py2-none-any.whl Collecting babel!=2.0,>=1.3 Using cached Babel-2.8.0-py2.py3-none-any.whl (8.6 MB) Collecting imagesize Using cached imagesize-1.2.0-py2.py3-none-any.whl (4.8 kB) Collecting typing; python_version < "3.5" Using cached typing-3.7.4.1-py2-none-any.whl (26 kB) Collecting Jinja2>=2.3 Using cached Jinja2-2.11.1-py2.py3-none-any.whl (126 kB) Collecting requests>=2.0.0 Using cached requests-2.23.0-py2.py3-none-any.whl (58 kB) Collecting packaging Using cached packaging-20.1-py2.py3-none-any.whl (36 kB) Collecting snowballstemmer>=1.1 Using cached snowballstemmer-2.0.0-py2.py3-none-any.whl (97 kB) Collecting six>=1.5 Using cached six-1.14.0-py2.py3-none-any.whl (10 kB) Collecting sphinxcontrib-websupport Using cached sphinxcontrib_websupport-1.1.2-py2.py3-none-any.whl (39 kB) Collecting pytz>=2015.7 Using cached pytz-2019.3-py2.py3-none-any.whl (509 kB) Collecting MarkupSafe>=0.23 Using cached MarkupSafe-1.1.1-cp27-cp27mu-manylinux1_x86_64.whl (24 kB) Collecting certifi>=2017.4.17 Using cached certifi-2019.11.28-py2.py3-none-any.whl (156 kB) Collecting urllib3!=1.25.0,!=1.25.1,<1.26,>=1.21.1 Using cached urllib3-1.25.8-py2.py3-none-any.whl (125 kB) Collecting idna<3,>=2.5 Using cached idna-2.9-py2.py3-none-any.whl (58 kB) Collecting chardet<4,>=3.0.2 Using cached chardet-3.0.4-py2.py3-none-any.whl (133 kB) Collecting pyparsing>=2.0.2 Using cached pyparsing-2.4.6-py2.py3-none-any.whl (67 kB) Installing collected packages: Pygments, setuptools, docutils, mock, pillow, alabaster, future, commonmark, pytz, babel, imagesize, typing, MarkupSafe, Jinja2, certifi, urllib3, idna, chardet, requests, six, pyparsing, packaging, snowballstemmer, sphinxcontrib-websupport, sphinx, recommonmark, sphinx-rtd-theme, readthedocs-sphinx-ext Attempting uninstall: setuptools Found existing installation: setuptools 44.0.0 Uninstalling setuptools-44.0.0: Successfully uninstalled setuptools-44.0.0 Successfully installed Jinja2-2.11.1 MarkupSafe-1.1.1 Pygments-2.3.1 alabaster-0.7.12 babel-2.8.0 certifi-2019.11.28 chardet-3.0.4 commonmark-0.8.1 docutils-0.14 future-0.18.2 idna-2.9 imagesize-1.2.0 mock-1.0.1 packaging-20.1 pillow-5.4.1 pyparsing-2.4.6 pytz-2019.3 readthedocs-sphinx-ext-1.0.1 recommonmark-0.5.0 requests-2.23.0 setuptools-41.0.1 six-1.14.0 snowballstemmer-2.0.0 sphinx-1.8.5 sphinx-rtd-theme-0.4.3 sphinxcontrib-websupport-1.1.2 typing-3.7.4.1 urllib3-1.25.8 [rtd-command-info] start-time: 2020-03-02T13:56:07.907748Z, end-time: 2020-03-02T13:56:08.223450Z, duration: 0, exit-code: 0 cat docs/sphinx/en/conf.py # -*- coding: utf-8 -*- # # English Language RTD & Sphinx config file # # Uses ../conf_common.py for most non-language-specific settings. # Importing conf_common adds all the non-language-specific # parts to this conf module import sys import os from subprocess import call sys.path.insert(0, os.path.abspath('..')) sys.path.append(os.path.abspath('../../../cli/')) # Setting a dummy IDF_PATH just to prevent an "import" error from esp_rainmaker_prov os.environ['IDF_PATH'] = os.getcwd() from conf_common import * # noqa: F401, F403 - need to make available everything from common from local_util import download_file_if_missing # noqa: E402 - need to import from common folder autodoc_mock_imports = ["pathlib","oauth2client", "serial", "user_mapping", "rmaker_tools.esp_rainmaker_prov.security","rmaker_tools.esp_rainmaker_prov.prov", "rmaker_tools.esp_rainmaker_prov.prov_util"] # General information about the project. project = u'ESP RainMaker Programming Guide' copyright = u'2020, Espressif Systems (Shanghai) CO., LTD' # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. language = 'en' # Download font file that is stored on a separate server to save on esp-idf repository size. print("Downloading font file") download_file_if_missing('https://dl.espressif.com/dl/esp-idf/docs/_static/DejaVuSans.ttf', '../_static') # Set up font for blockdiag, nwdiag, rackdiag and packetdiag blockdiag_fontpath = '../_static/DejaVuSans.ttf' seqdiag_fontpath = '../_static/DejaVuSans.ttf' actdiag_fontpath = '../_static/DejaVuSans.ttf' nwdiag_fontpath = '../_static/DejaVuSans.ttf' rackdiag_fontpath = '../_static/DejaVuSans.ttf' packetdiag_fontpath = '../_static/DejaVuSans.ttf' ########################################################################### # auto-created readthedocs.org specific configuration # ########################################################################### # # The following code was added during an automated build on readthedocs.org # It is auto created and injected for every build. The result is based on the # conf.py.tmpl file found in the readthedocs.org codebase: # https://github.com/rtfd/readthedocs.org/blob/master/readthedocs/doc_builder/templates/doc_builder/conf.py.tmpl # import importlib import sys import os.path from six import string_types from sphinx import version_info # Get suffix for proper linking to GitHub # This is deprecated in Sphinx 1.3+, # as each page can have its own suffix if globals().get('source_suffix', False): if isinstance(source_suffix, string_types): SUFFIX = source_suffix elif isinstance(source_suffix, (list, tuple)): # Sphinx >= 1.3 supports list/tuple to define multiple suffixes SUFFIX = source_suffix[0] elif isinstance(source_suffix, dict): # Sphinx >= 1.8 supports a mapping dictionary for multiple suffixes SUFFIX = list(source_suffix.keys())[0] # make a ``list()`` for py2/py3 compatibility else: # default to .rst SUFFIX = '.rst' else: SUFFIX = '.rst' # Add RTD Static Path. Add to the end because it overwrites previous files. if not 'html_static_path' in globals(): html_static_path = [] if os.path.exists('_static'): html_static_path.append('_static') # Add RTD Theme only if they aren't overriding it already using_rtd_theme = ( ( 'html_theme' in globals() and html_theme in ['default'] and # Allow people to bail with a hack of having an html_style 'html_style' not in globals() ) or 'html_theme' not in globals() ) if using_rtd_theme: theme = importlib.import_module('sphinx_rtd_theme') html_theme = 'sphinx_rtd_theme' html_style = None html_theme_options = {} if 'html_theme_path' in globals(): html_theme_path.append(theme.get_html_theme_path()) else: html_theme_path = [theme.get_html_theme_path()] if globals().get('websupport2_base_url', False): websupport2_base_url = 'https://readthedocs.com/websupport' websupport2_static_url = 'https://media.readthedocs.com/' #Add project information to the template context. context = { 'using_theme': using_rtd_theme, 'html_theme': html_theme, 'current_version': "latest", 'version_slug': "latest", 'MEDIA_URL': "https://media.readthedocs.com/media/", 'STATIC_URL': "https://media.readthedocs.com/", 'PRODUCTION_DOMAIN': "readthedocs.com", 'versions': [ ("latest", "/en/latest/"), ], 'downloads': [ ("pdf", "//docs.espressif.com/_/downloads/esp-rainmaker/en/latest/pdf/"), ("html", "//docs.espressif.com/_/downloads/esp-rainmaker/en/latest/htmlzip/"), ("epub", "//docs.espressif.com/_/downloads/esp-rainmaker/en/latest/epub/"), ], 'subprojects': [ ], 'slug': 'espressif-esp-rainmaker', 'name': u'esp-rainmaker', 'rtd_language': u'en', 'programming_language': u'c', 'canonical_url': 'https://docs.espressif.com/projects/esp-rainmaker/en/latest/', 'analytics_code': 'None', 'single_version': False, 'conf_py_path': '/docs/sphinx/en/', 'api_host': 'https://readthedocs.com', 'proxied_api_host': '/_', 'github_user': 'espressif', 'github_repo': 'esp-rainmaker', 'github_version': 'test/read-the-docs', 'display_github': True, 'bitbucket_user': 'None', 'bitbucket_repo': 'None', 'bitbucket_version': 'test/read-the-docs', 'display_bitbucket': False, 'gitlab_user': 'None', 'gitlab_repo': 'None', 'gitlab_version': 'test/read-the-docs', 'display_gitlab': False, 'READTHEDOCS': True, 'using_theme': (html_theme == "default"), 'new_theme': (html_theme == "sphinx_rtd_theme"), 'source_suffix': SUFFIX, 'ad_free': False, 'user_analytics_code': '', 'global_analytics_code': 'UA-17997319-2', 'commit': '97c41310', } if 'html_context' in globals(): html_context.update(context) else: html_context = context # Add custom RTD extension if 'extensions' in globals(): # Insert at the beginning because it can interfere # with other extensions. # See https://github.com/rtfd/readthedocs.org/pull/4054 extensions.insert(0, "readthedocs_ext.readthedocs") else: extensions = ["readthedocs_ext.readthedocs"] # Add External version warning banner to the external version documentation if 'branch' == 'external': extensions.insert(1, "readthedocs_ext.external_version_warning") project_language = 'en' # User's Sphinx configurations language_user = globals().get('language', None) latex_engine_user = globals().get('latex_engine', None) latex_elements_user = globals().get('latex_elements', None) # Remove this once xindy gets installed in Docker image and XINDYOPS # env variable is supported # https://github.com/rtfd/readthedocs-docker-images/pull/98 latex_use_xindy = False chinese = any([ language_user in ('zh_CN', 'zh_TW'), project_language in ('zh_CN', 'zh_TW'), ]) japanese = any([ language_user == 'ja', project_language == 'ja', ]) if chinese: latex_engine = latex_engine_user or 'xelatex' latex_elements_rtd = { 'preamble': '\\usepackage[UTF8]{ctex}\n', } latex_elements = latex_elements_user or latex_elements_rtd elif japanese: latex_engine = latex_engine_user or 'platex' [rtd-command-info] start-time: 2020-03-02T13:56:08.388137Z, end-time: 2020-03-02T13:56:09.425158Z, duration: 1, exit-code: 2 python sphinx-build -T -b readthedocs -d _build/doctrees-readthedocs -D language=en . _build/html Running Sphinx v1.8.5 Getting Doxyfile's INPUT Generating 'api_name.inc' files with Doxygen directives fatal: No names found, cannot describe anything. Calling Doxygen to generate latest XML files Version: Release: Downloading font file The file '../_static/DejaVuSans.ttf' already exists loading translations [en]... done Traceback (most recent call last): File "/home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-rainmaker/envs/latest/lib/python2.7/site-packages/sphinx/cmd/build.py", line 303, in build_main args.tags, args.verbosity, args.jobs, args.keep_going) File "/home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-rainmaker/envs/latest/lib/python2.7/site-packages/sphinx/application.py", line 228, in __init__ self.setup_extension(extension) File "/home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-rainmaker/envs/latest/lib/python2.7/site-packages/sphinx/application.py", line 449, in setup_extension self.registry.load_extension(self, extname) File "/home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-rainmaker/envs/latest/lib/python2.7/site-packages/sphinx/registry.py", line 475, in load_extension raise ExtensionError(__('Could not import extension %s') % extname, err) ExtensionError: Could not import extension breathe (exception: No module named breathe) Extension error: Could not import extension breathe (exception: No module named breathe)