Read the Docs build information Build id: 255506 Project: tiledb-inc-tiledb Version: latest Commit: fa46641ec633ad35053115668b3e09665b3374e6 Date: 2019-11-01T18:24:12.895967Z State: finished Success: True [rtd-command-info] start-time: 2019-11-01T18:24:14.259718Z, end-time: 2019-11-01T18:24:14.283605Z, duration: 0, exit-code: 0 git remote set-url origin https://github.com/TileDB-Inc/TileDB.git [rtd-command-info] start-time: 2019-11-01T18:24:14.363907Z, end-time: 2019-11-01T18:24:15.758527Z, duration: 1, exit-code: 0 git fetch origin --force --tags --prune --prune-tags --depth 50 From https://github.com/TileDB-Inc/TileDB - [deleted] (none) -> origin/ihn/fix_md_gcc48 25c2c561..fa46641e dev -> origin/dev [rtd-command-info] start-time: 2019-11-01T18:24:16.075429Z, end-time: 2019-11-01T18:24:16.232595Z, duration: 0, exit-code: 0 git checkout --force origin/dev Previous HEAD position was 25c2c561 Fix metadata bug on GCC 4.8 w/ consecutive same-length keys (#1412) HEAD is now at fa46641e Doc fixes (#1414) [rtd-command-info] start-time: 2019-11-01T18:24:16.328879Z, end-time: 2019-11-01T18:24:16.355947Z, duration: 0, exit-code: 0 git clean -d -f -f [rtd-command-info] start-time: 2019-11-01T18:24:20.177847Z, end-time: 2019-11-01T18:26:55.270774Z, duration: 155, exit-code: 0 conda env create --quiet --name latest --file doc/source/conda-env.yml Solving environment: ...working... done Preparing transaction: ...working... done Verifying transaction: ...working... done Executing transaction: ...working... done Collecting sphinxcontrib-contentui Downloading https://files.pythonhosted.org/packages/d6/38/eee534e66909e2f3d53f5eee0a790bea90b73dcb6e88d5d2c1cfcd90f4e1/sphinxcontrib_contentui-0.2.4-py3-none-any.whl Requirement already satisfied: Sphinx>=2.0 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from sphinxcontrib-contentui->-r /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/doc/source/condaenv.bXnOul.requirements.txt (line 1)) (2.2.1) Requirement already satisfied: setuptools in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from Sphinx>=2.0->sphinxcontrib-contentui->-r /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/doc/source/condaenv.bXnOul.requirements.txt (line 1)) (41.6.0.post20191029) Requirement already satisfied: sphinxcontrib-qthelp in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from Sphinx>=2.0->sphinxcontrib-contentui->-r /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/doc/source/condaenv.bXnOul.requirements.txt (line 1)) (1.0.2) Requirement already satisfied: packaging in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from Sphinx>=2.0->sphinxcontrib-contentui->-r /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/doc/source/condaenv.bXnOul.requirements.txt (line 1)) (19.2) Requirement already satisfied: babel!=2.0,>=1.3 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from Sphinx>=2.0->sphinxcontrib-contentui->-r /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/doc/source/condaenv.bXnOul.requirements.txt (line 1)) (2.7.0) Requirement already satisfied: sphinxcontrib-applehelp in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from Sphinx>=2.0->sphinxcontrib-contentui->-r /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/doc/source/condaenv.bXnOul.requirements.txt (line 1)) (1.0.1) Requirement already satisfied: sphinxcontrib-devhelp in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from Sphinx>=2.0->sphinxcontrib-contentui->-r /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/doc/source/condaenv.bXnOul.requirements.txt (line 1)) (1.0.1) Requirement already satisfied: sphinxcontrib-jsmath in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from Sphinx>=2.0->sphinxcontrib-contentui->-r /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/doc/source/condaenv.bXnOul.requirements.txt (line 1)) (1.0.1) Requirement already satisfied: sphinxcontrib-serializinghtml in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from Sphinx>=2.0->sphinxcontrib-contentui->-r /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/doc/source/condaenv.bXnOul.requirements.txt (line 1)) (1.1.3) Requirement already satisfied: Pygments>=2.0 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from Sphinx>=2.0->sphinxcontrib-contentui->-r /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/doc/source/condaenv.bXnOul.requirements.txt (line 1)) (2.4.2) Requirement already satisfied: docutils>=0.12 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from Sphinx>=2.0->sphinxcontrib-contentui->-r /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/doc/source/condaenv.bXnOul.requirements.txt (line 1)) (0.15.2) Requirement already satisfied: Jinja2>=2.3 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from Sphinx>=2.0->sphinxcontrib-contentui->-r /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/doc/source/condaenv.bXnOul.requirements.txt (line 1)) (2.10.3) Requirement already satisfied: alabaster<0.8,>=0.7 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from Sphinx>=2.0->sphinxcontrib-contentui->-r /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/doc/source/condaenv.bXnOul.requirements.txt (line 1)) (0.7.12) Requirement already satisfied: imagesize in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from Sphinx>=2.0->sphinxcontrib-contentui->-r /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/doc/source/condaenv.bXnOul.requirements.txt (line 1)) (1.1.0) Requirement already satisfied: requests>=2.5.0 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from Sphinx>=2.0->sphinxcontrib-contentui->-r /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/doc/source/condaenv.bXnOul.requirements.txt (line 1)) (2.22.0) Requirement already satisfied: snowballstemmer>=1.1 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from Sphinx>=2.0->sphinxcontrib-contentui->-r /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/doc/source/condaenv.bXnOul.requirements.txt (line 1)) (2.0.0) Requirement already satisfied: sphinxcontrib-htmlhelp in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from Sphinx>=2.0->sphinxcontrib-contentui->-r /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/doc/source/condaenv.bXnOul.requirements.txt (line 1)) (1.0.2) Requirement already satisfied: pyparsing>=2.0.2 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from packaging->Sphinx>=2.0->sphinxcontrib-contentui->-r /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/doc/source/condaenv.bXnOul.requirements.txt (line 1)) (2.4.2) Requirement already satisfied: six in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from packaging->Sphinx>=2.0->sphinxcontrib-contentui->-r /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/doc/source/condaenv.bXnOul.requirements.txt (line 1)) (1.12.0) Requirement already satisfied: pytz>=2015.7 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from babel!=2.0,>=1.3->Sphinx>=2.0->sphinxcontrib-contentui->-r /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/doc/source/condaenv.bXnOul.requirements.txt (line 1)) (2019.3) Requirement already satisfied: MarkupSafe>=0.23 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from Jinja2>=2.3->Sphinx>=2.0->sphinxcontrib-contentui->-r /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/doc/source/condaenv.bXnOul.requirements.txt (line 1)) (1.1.1) Requirement already satisfied: certifi>=2017.4.17 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from requests>=2.5.0->Sphinx>=2.0->sphinxcontrib-contentui->-r /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/doc/source/condaenv.bXnOul.requirements.txt (line 1)) (2019.9.11) Requirement already satisfied: idna<2.9,>=2.5 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from requests>=2.5.0->Sphinx>=2.0->sphinxcontrib-contentui->-r /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/doc/source/condaenv.bXnOul.requirements.txt (line 1)) (2.8) Requirement already satisfied: urllib3!=1.25.0,!=1.25.1,<1.26,>=1.21.1 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from requests>=2.5.0->Sphinx>=2.0->sphinxcontrib-contentui->-r /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/doc/source/condaenv.bXnOul.requirements.txt (line 1)) (1.25.6) Requirement already satisfied: chardet<3.1.0,>=3.0.2 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from requests>=2.5.0->Sphinx>=2.0->sphinxcontrib-contentui->-r /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/doc/source/condaenv.bXnOul.requirements.txt (line 1)) (3.0.4) Installing collected packages: sphinxcontrib-contentui Successfully installed sphinxcontrib-contentui-0.2.4 [rtd-command-info] start-time: 2019-11-01T18:26:55.376674Z, end-time: 2019-11-01T18:27:19.861868Z, duration: 24, exit-code: 0 conda install --yes --quiet --name latest mock pillow sphinx sphinx_rtd_theme Solving environment: ...working... done ## Package Plan ## environment location: /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest added / updated specs: - mock - pillow - sphinx - sphinx_rtd_theme The following packages will be downloaded: package | build ---------------------------|----------------- libtiff-4.0.9 | he85c1e1_2 567 KB freetype-2.9.1 | h8a8886c_1 822 KB sphinx_rtd_theme-0.4.3 | py_0 5.1 MB jpeg-9b | h024ee3a_2 248 KB mock-3.0.5 | py36_0 47 KB certifi-2019.9.11 | py36_0 154 KB pillow-5.4.1 | py36h34e0f95_0 627 KB olefile-0.46 | py36_0 48 KB openssl-1.1.1d | h7b6447c_3 3.7 MB libpng-1.6.37 | hbc83047_0 364 KB sphinx-2.2.1 | py_0 1.4 MB ca-certificates-2019.10.16 | 0 131 KB ------------------------------------------------------------ Total: 13.2 MB The following NEW packages will be INSTALLED: freetype: 2.9.1-h8a8886c_1 jpeg: 9b-h024ee3a_2 libpng: 1.6.37-hbc83047_0 libtiff: 4.0.9-he85c1e1_2 mock: 3.0.5-py36_0 olefile: 0.46-py36_0 pillow: 5.4.1-py36h34e0f95_0 sphinx_rtd_theme: 0.4.3-py_0 The following packages will be UPDATED: ca-certificates: 2019.9.11-hecc5488_0 conda-forge --> 2019.10.16-0 certifi: 2019.9.11-py36_0 conda-forge --> 2019.9.11-py36_0 openssl: 1.1.1c-h516909a_0 conda-forge --> 1.1.1d-h7b6447c_3 sphinx: 2.2.1-py_0 conda-forge --> 2.2.1-py_0 Preparing transaction: ...working... done Verifying transaction: ...working... done Executing transaction: ...working... done [rtd-command-info] start-time: 2019-11-01T18:27:19.958795Z, end-time: 2019-11-01T18:27:21.536555Z, duration: 1, exit-code: 0 /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/bin/python -m pip install -U --cache-dir /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/.cache/pip recommonmark readthedocs-sphinx-ext Collecting recommonmark Using cached https://files.pythonhosted.org/packages/94/de/334aaf73df8c0e77fb07f883d1e274344526196c137ef3479cb5e5aef086/recommonmark-0.6.0-py2.py3-none-any.whl Collecting readthedocs-sphinx-ext Using cached https://files.pythonhosted.org/packages/51/43/a5a98d9aec325b2824bdf504fa446ae876d0909d03e28667018f9eb01bcd/readthedocs_sphinx_ext-1.0.0-py2.py3-none-any.whl Requirement already satisfied, skipping upgrade: docutils>=0.11 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from recommonmark) (0.15.2) Collecting commonmark>=0.8.1 Using cached https://files.pythonhosted.org/packages/b1/92/dfd892312d822f36c55366118b95d914e5f16de11044a27cf10a7d71bbbf/commonmark-0.9.1-py2.py3-none-any.whl Requirement already satisfied, skipping upgrade: sphinx>=1.3.1 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from recommonmark) (2.2.1) Requirement already satisfied, skipping upgrade: requests in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from readthedocs-sphinx-ext) (2.22.0) Requirement already satisfied, skipping upgrade: Jinja2>=2.9 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from readthedocs-sphinx-ext) (2.10.3) Requirement already satisfied, skipping upgrade: packaging in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from sphinx>=1.3.1->recommonmark) (19.2) Requirement already satisfied, skipping upgrade: sphinxcontrib-qthelp in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from sphinx>=1.3.1->recommonmark) (1.0.2) Requirement already satisfied, skipping upgrade: imagesize in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from sphinx>=1.3.1->recommonmark) (1.1.0) Requirement already satisfied, skipping upgrade: sphinxcontrib-applehelp in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from sphinx>=1.3.1->recommonmark) (1.0.1) Requirement already satisfied, skipping upgrade: Pygments>=2.0 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from sphinx>=1.3.1->recommonmark) (2.4.2) Requirement already satisfied, skipping upgrade: setuptools in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from sphinx>=1.3.1->recommonmark) (41.6.0.post20191029) Requirement already satisfied, skipping upgrade: babel!=2.0,>=1.3 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from sphinx>=1.3.1->recommonmark) (2.7.0) Requirement already satisfied, skipping upgrade: sphinxcontrib-serializinghtml in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from sphinx>=1.3.1->recommonmark) (1.1.3) Requirement already satisfied, skipping upgrade: snowballstemmer>=1.1 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from sphinx>=1.3.1->recommonmark) (2.0.0) Requirement already satisfied, skipping upgrade: alabaster<0.8,>=0.7 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from sphinx>=1.3.1->recommonmark) (0.7.12) Requirement already satisfied, skipping upgrade: sphinxcontrib-htmlhelp in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from sphinx>=1.3.1->recommonmark) (1.0.2) Requirement already satisfied, skipping upgrade: sphinxcontrib-devhelp in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from sphinx>=1.3.1->recommonmark) (1.0.1) Requirement already satisfied, skipping upgrade: sphinxcontrib-jsmath in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from sphinx>=1.3.1->recommonmark) (1.0.1) Requirement already satisfied, skipping upgrade: chardet<3.1.0,>=3.0.2 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from requests->readthedocs-sphinx-ext) (3.0.4) Requirement already satisfied, skipping upgrade: urllib3!=1.25.0,!=1.25.1,<1.26,>=1.21.1 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from requests->readthedocs-sphinx-ext) (1.25.6) Requirement already satisfied, skipping upgrade: certifi>=2017.4.17 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from requests->readthedocs-sphinx-ext) (2019.9.11) Requirement already satisfied, skipping upgrade: idna<2.9,>=2.5 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from requests->readthedocs-sphinx-ext) (2.8) Requirement already satisfied, skipping upgrade: MarkupSafe>=0.23 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from Jinja2>=2.9->readthedocs-sphinx-ext) (1.1.1) Requirement already satisfied, skipping upgrade: six in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from packaging->sphinx>=1.3.1->recommonmark) (1.12.0) Requirement already satisfied, skipping upgrade: pyparsing>=2.0.2 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from packaging->sphinx>=1.3.1->recommonmark) (2.4.2) Requirement already satisfied, skipping upgrade: pytz>=2015.7 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages (from babel!=2.0,>=1.3->sphinx>=1.3.1->recommonmark) (2019.3) Installing collected packages: commonmark, recommonmark, readthedocs-sphinx-ext Successfully installed commonmark-0.9.1 readthedocs-sphinx-ext-1.0.0 recommonmark-0.6.0 [rtd-command-info] start-time: 2019-11-01T18:27:29.963822Z, end-time: 2019-11-01T18:27:30.311904Z, duration: 0, exit-code: 0 cat doc/source/conf.py #!/usr/bin/env python3 # -*- coding: utf-8 -*- # # TileDB documentation build configuration file, created by # sphinx-quickstart on Mon Feb 5 10:08:37 2018. # # -- Imports configuration ------------------------------------------------- import os import subprocess import sys from os.path import abspath, join, dirname sys.path.insert(0, abspath(join(dirname(__file__)))) # -- ReadTheDocs configuration --------------------------------------------- # Special handling on ReadTheDocs builds. # Some of this code is from https://github.com/robotpy/robotpy-docs/blob/master/conf.py readthedocs = os.environ.get('READTHEDOCS', None) == 'True' rtd_version = os.environ.get('READTHEDOCS_VERSION', 'latest') rtd_version = rtd_version if rtd_version in ['stable', 'latest'] else 'stable' # On RTD, build the Doxygen XML files. if readthedocs: # Build docs subprocess.check_call(''' mkdir ../../build; cd ../../build; ../bootstrap; make doc; ''', shell=True) # -- General configuration ------------------------------------------------ # If your documentation needs a minimal Sphinx version, state it here. # # needs_sphinx = '1.0' # Add any Sphinx extension module names here, as strings. They can be # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom # ones. extensions = [ 'sphinx.ext.autodoc', 'sphinx.ext.intersphinx', 'sphinxcontrib.contentui', 'breathe' ] if readthedocs: # Mapping for linking between RTD subprojects. intersphinx_mapping = { 'tiledb': ('https://tiledb-inc-tiledb.readthedocs-hosted.com/en/%s/' % rtd_version, None), 'tiledb-py': ('https://tiledb-inc-tiledb.readthedocs-hosted.com/projects/python-api/en/%s/' % rtd_version, None) } # Add any paths that contain templates here, relative to this directory. templates_path = ['_templates'] # The suffix(es) of source filenames. source_suffix = '.rst' # The master toctree document. master_doc = 'index' # General information about the project. project = 'TileDB' copyright = '2018 TileDB, Inc' author = 'TileDB, Inc.' # The short X.Y version. version = '1.6' # The full version, including alpha/beta/rc tags. release = '1.6.0' # Breathe extension configuration. tiledb_dir = '../../' doxygen_xml_dir = tiledb_dir + 'build/xml/' breathe_projects = {'TileDB-C': doxygen_xml_dir, 'TileDB-C++': doxygen_xml_dir} breathe_default_project = 'TileDB-C' breathe_projects_source = { 'TileDB-C': (tiledb_dir + 'tiledb/sm/c_api/', ['tiledb.h']), 'TileDB-C++': (tiledb_dir + 'tiledb/sm/cpp_api/', ['tiledb']) } breathe_domain_by_file_pattern = { '*/c_api/tiledb.h': 'c', '*/cpp_api/tiledb': 'cpp' } # Allow parsing TILEDB_DEPRECATED in C++ function signatures. cpp_id_attributes = ['TILEDB_DEPRECATED'] # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. # # This is also used if you do content translation via gettext catalogs. # Usually you set "language" from the command line for these cases. language = None # List of patterns, relative to source directory, that match files and # directories to ignore when looking for source files. # This patterns also effect to html_static_path and html_extra_path exclude_patterns = [] # The name of the Pygments (syntax highlighting) style to use. pygments_style = 'friendly' # If true, `todo` and `todoList` produce output, else they produce nothing. todo_include_todos = False # -- Options for HTML output ---------------------------------------------- html_static_path = ['_static'] html_logo = '_static/tileDB_uppercase_600_112.png' html_favicon = '_static/favicon.ico' if readthedocs: html_theme = 'default' else: import sphinx_rtd_theme html_theme = 'sphinx_rtd_theme' html_theme_path = [sphinx_rtd_theme.get_html_theme_path()] # -- Options for HTMLHelp output ------------------------------------------ # Output file base name for HTML help builder. htmlhelp_basename = 'TileDBdoc' # -- Options for LaTeX output --------------------------------------------- latex_elements = { # The paper size ('letterpaper' or 'a4paper'). # # 'papersize': 'letterpaper', # The font size ('10pt', '11pt' or '12pt'). # # 'pointsize': '10pt', # Additional stuff for the LaTeX preamble. # # 'preamble': '', # Latex figure (float) alignment # # 'figure_align': 'htbp', } # Grouping the document tree into LaTeX files. List of tuples # (source start file, target name, title, # author, documentclass [howto, manual, or own class]). latex_documents = [ (master_doc, 'TileDB.tex', 'TileDB Documentation', 'TileDB, Inc.', 'manual'), ] # -- Options for manual page output --------------------------------------- # One entry per manual page. List of tuples # (source start file, name, description, authors, manual section). man_pages = [ (master_doc, 'tiledb', 'TileDB Documentation', [author], 1) ] # -- Options for Texinfo output ------------------------------------------- # Grouping the document tree into Texinfo files. List of tuples # (source start file, target name, title, author, # dir menu entry, description, category) texinfo_documents = [ (master_doc, 'TileDB', 'TileDB Documentation', author, 'TileDB', 'One line description of project.', 'Miscellaneous'), ] # -- Custom Document processing ---------------------------------------------- # Generate the sidebar automatically so that it is identical across all subprojects. # This (and gensidebar.py) from https://github.com/robotpy/robotpy-docs import gensidebar gensidebar.generate_sidebar({'on_rtd': readthedocs, 'rtd_version': rtd_version}, 'tiledb') # Replace C/C++ source examples path def replaceText(app, docname, source): result = source[0] for key in app.config.text_replacements: result = result.replace(key, app.config.text_replacements[key]) source[0] = result text_replacements = { "{source_examples_path}" : "../../examples", "{tiledb_src_root_url}" : "https://github.com/TileDB-Inc/TileDB/blob/dev", "{tiledb_py_src_root_url}" : "https://github.com/TileDB-Inc/TileDB-Py/blob/dev", "{tiledb_R_src_root_url}" : "https://github.com/TileDB-Inc/TileDB-R/blob/master", "{tiledb_go_src_root_url}" : "https://github.com/TileDB-Inc/TileDB-Go/blob/master" } # -- Custom setup ----------------------------------------------------------- def add_custom_js(app): app.add_javascript('custom.js') def setup(app): app.add_config_value('text_replacements', {}, True) app.connect('source-read', replaceText) app.add_stylesheet('custom.css') # Use this event so that our custom JS gets included *after* the ContentUI # extension adds its JS, otherwise we can't override its behavior. app.connect('builder-inited', add_custom_js) ########################################################################### # 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/"), ("stable", "/en/stable/"), ("1.6.3", "/en/1.6.3/"), ("1.6.2", "/en/1.6.2/"), ("1.6.0", "/en/1.6.0/"), ("1.5.1", "/en/1.5.1/"), ("1.5.0", "/en/1.5.0/"), ("1.4.2", "/en/1.4.2/"), ("1.4.1", "/en/1.4.1/"), ("1.4.0", "/en/1.4.0/"), ("1.3.2", "/en/1.3.2/"), ("1.3.1", "/en/1.3.1/"), ("1.3.0", "/en/1.3.0/"), ("sp-52", "/en/sp-52/"), ], 'downloads': [ ], 'subprojects': [ ("tiledb-inc-tiledb-py", "https://docs.tiledb.io/projects/tiledb-py/en/stable/"), ], 'slug': 'tiledb-inc-tiledb', 'name': u'TileDB', 'rtd_language': u'en', 'programming_language': u'words', 'canonical_url': 'https://docs.tiledb.io/en/stable/', 'analytics_code': '', 'single_version': False, 'conf_py_path': '/doc/source/', 'api_host': 'https://readthedocs.com', 'github_user': 'TileDB-Inc', 'github_repo': 'TileDB', 'github_version': 'dev', 'display_github': True, 'bitbucket_user': 'None', 'bitbucket_repo': 'None', 'bitbucket_version': 'dev', 'display_bitbucket': False, 'gitlab_user': 'None', 'gitlab_repo': 'None', 'gitlab_version': 'dev', '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': 'fa46641e', } 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: 2019-11-01T18:27:30.423219Z, end-time: 2019-11-01T18:28:03.974614Z, duration: 33, exit-code: 0 python /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/bin/sphinx-build -T -E -b readthedocs -d _build/doctrees-readthedocs -D language=en . _build/html Running Sphinx v2.2.1 mkdir: cannot create directory ‘../../build’: File exists -- The C compiler identification is GNU 7.3.0 -- The CXX compiler identification is GNU 7.3.0 -- Check for working C compiler: /usr/bin/gcc -- Check for working C compiler: /usr/bin/gcc -- works -- Detecting C compiler ABI info -- Detecting C compiler ABI info - done -- Detecting C compile features -- Detecting C compile features - done -- Check for working CXX compiler: /usr/bin/g++ -- Check for working CXX compiler: /usr/bin/g++ -- works -- Detecting CXX compiler ABI info -- Detecting CXX compiler ABI info - done -- Detecting CXX compile features -- Detecting CXX compile features - done -- Starting TileDB superbuild. -- Could NOT find Spdlog (missing: SPDLOG_INCLUDE_DIR) -- Adding Spdlog as an external project -- Found Zlib: /usr/lib/x86_64-linux-gnu/libz.so -- Found OpenSSL: /usr/lib/x86_64-linux-gnu/libssl.so -- OpenSSL crypto: /usr/lib/x86_64-linux-gnu/libcrypto.so -- root: /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/build/externals/install;/usr/local/opt/openssl -- Could NOT find TBB (missing: TBB_LIBRARIES TBB_INCLUDE_DIR) -- Adding TBB as an external project -- searching for catch in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/build/externals/src -- Could NOT find Catch (missing: CATCH_INCLUDE_DIR) -- Adding Catch as an external project -- Not found clang-tidy -- Not found clang-format -- Install prefix is /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/dist -- Configuring done -- Generating done -- Build files have been written to: /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/build bootstrap success. Run "make" to build, "make check" to test, or "make -C tiledb install" to install. [ 50%] Generating API documentation with Doxygen [100%] Built target doc loading translations [en]... done making output directory... done loading intersphinx inventory from https://tiledb-inc-tiledb.readthedocs-hosted.com/en/latest/objects.inv... loading intersphinx inventory from https://tiledb-inc-tiledb.readthedocs-hosted.com/projects/python-api/en/latest/objects.inv... /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages/sphinx/util/docutils.py:286: RemovedInSphinx30Warning: function based directive support is now deprecated. Use class based directive instead. RemovedInSphinx30Warning) WARNING: failed to reach any of the inventories with the following issues: intersphinx inventory 'https://tiledb-inc-tiledb.readthedocs-hosted.com/projects/python-api/en/latest/objects.inv' not fetchable due to : 404 Client Error: Not Found for url: https://tiledb-inc-tiledb.readthedocs-hosted.com/projects/python-api/en/latest/objects.inv building [mo]: targets for 0 po files that are out of date building [readthedocs]: targets for 40 source files that are out of date updating environment: [new config] 40 added, 0 changed, 0 removed reading sources... [ 2%] c++-api reading sources... [ 5%] c-api reading sources... [ 7%] index reading sources... [ 10%] installation reading sources... [ 12%] introduction reading sources... [ 15%] performance/introduction reading sources... [ 17%] performance/performance-factors reading sources... [ 20%] performance/using-tiledb-statistics reading sources... [ 22%] quickstart reading sources... [ 25%] real-world-examples/dense-image-data reading sources... [ 27%] real-world-examples/sparse-geospatial-data reading sources... [ 30%] tutorials/advanced-consolidation reading sources... [ 32%] tutorials/array-metadata reading sources... [ 35%] tutorials/async reading sources... [ 37%] tutorials/compression reading sources... [ 40%] tutorials/concurrency-consistency reading sources... [ 42%] tutorials/config reading sources... [ 45%] tutorials/datetimes reading sources... [ 47%] tutorials/dense-arrays reading sources... [ 50%] tutorials/encryption reading sources... [ 52%] tutorials/errors reading sources... [ 55%] tutorials/filters reading sources... [ 57%] tutorials/format-description reading sources... [ 60%] tutorials/fragments-consolidation reading sources... [ 62%] tutorials/kv reading sources... [ 65%] tutorials/multi-attribute-arrays reading sources... [ 67%] tutorials/neg-real reading sources... [ 70%] tutorials/object reading sources... [ 72%] tutorials/parallelism reading sources... [ 75%] tutorials/reading reading sources... [ 77%] tutorials/sparse-arrays reading sources... [ 80%] tutorials/tiling-dense reading sources... [ 82%] tutorials/tiling-sparse reading sources... [ 85%] tutorials/variable-length-attributes reading sources... [ 87%] tutorials/vfs reading sources... [ 90%] tutorials/working-with-hdfs reading sources... [ 92%] tutorials/working-with-s3 reading sources... [ 95%] tutorials/writing-dense reading sources... [ 97%] tutorials/writing-sparse reading sources... [100%] usage /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/checkouts/latest/doc/source/c++-api.rst:123: WARNING: Duplicate declaration, std::vector > tiledb::group_by_cell(const std::vector< T > & buff, uint64_t num_buff) looking for now-outdated files... none found pickling environment... done checking consistency... done preparing documents... done writing output... [ 2%] c++-api writing output... [ 5%] c-api writing output... [ 7%] index writing output... [ 10%] installation writing output... [ 12%] introduction writing output... [ 15%] performance/introduction writing output... [ 17%] performance/performance-factors writing output... [ 20%] performance/using-tiledb-statistics writing output... [ 22%] quickstart writing output... [ 25%] real-world-examples/dense-image-data writing output... [ 27%] real-world-examples/sparse-geospatial-data writing output... [ 30%] tutorials/advanced-consolidation writing output... [ 32%] tutorials/array-metadata writing output... [ 35%] tutorials/async writing output... [ 37%] tutorials/compression writing output... [ 40%] tutorials/concurrency-consistency writing output... [ 42%] tutorials/config writing output... [ 45%] tutorials/datetimes writing output... [ 47%] tutorials/dense-arrays writing output... [ 50%] tutorials/encryption writing output... [ 52%] tutorials/errors writing output... [ 55%] tutorials/filters writing output... [ 57%] tutorials/format-description writing output... [ 60%] tutorials/fragments-consolidation writing output... [ 62%] tutorials/kv writing output... [ 65%] tutorials/multi-attribute-arrays writing output... [ 67%] tutorials/neg-real writing output... [ 70%] tutorials/object writing output... [ 72%] tutorials/parallelism writing output... [ 75%] tutorials/reading writing output... [ 77%] tutorials/sparse-arrays writing output... [ 80%] tutorials/tiling-dense writing output... [ 82%] tutorials/tiling-sparse writing output... [ 85%] tutorials/variable-length-attributes writing output... [ 87%] tutorials/vfs writing output... [ 90%] tutorials/working-with-hdfs writing output... [ 92%] tutorials/working-with-s3 writing output... [ 95%] tutorials/writing-dense writing output... [ 97%] tutorials/writing-sparse writing output... [100%] usage generating indices... genindexdone writing additional pages... searchdone copying images... [ 1%] figures/intro_arrays.png copying images... [ 3%] figures/intro_architecture.png copying images... [ 5%] performance/../figures/cpp.png copying images... [ 6%] performance/../figures/python.png copying images... [ 8%] figures/quickstart_dense.png copying images... [ 10%] figures/cpp.png copying images... [ 12%] figures/python.png copying images... [ 13%] figures/r.png copying images... [ 15%] figures/golang.png copying images... [ 17%] figures/quickstart_sparse.png copying images... [ 18%] real-world-examples/../figures/cpp.png copying images... [ 20%] real-world-examples/../figures/macaw-process.png copying images... [ 22%] real-world-examples/../figures/macaw-sliced.png copying images... [ 24%] real-world-examples/../figures/us-zip-codes-all.png copying images... [ 25%] real-world-examples/../figures/us-zip-codes-sliced.png copying images... [ 27%] tutorials/../figures/consolidation_clean_up.png copying images... [ 29%] tutorials/../figures/consolidatable.png copying images... [ 31%] tutorials/../figures/consolidation_ampl.png copying images... [ 32%] tutorials/../figures/cpp.png copying images... [ 34%] tutorials/../figures/async.png copying images... [ 36%] tutorials/../figures/eventual_consistency.png copying images... [ 37%] tutorials/../figures/consistency_array_open.png copying images... [ 39%] tutorials/../figures/python.png copying images... [ 41%] tutorials/../figures/quickstart_dense.png copying images... [ 43%] tutorials/../figures/fragments.png copying images... [ 44%] tutorials/../figures/fragments_delete.png copying images... [ 46%] tutorials/../figures/fragments_consolidated.png copying images... [ 48%] tutorials/../figures/map.png copying images... [ 50%] tutorials/../figures/multi_attribute.png copying images... [ 51%] tutorials/../figures/neg_domain.png copying images... [ 53%] tutorials/../figures/real_domain.png copying images... [ 55%] tutorials/../figures/reading_dense_layouts.png copying images... [ 56%] tutorials/../figures/reading_sparse_layouts.png copying images... [ 58%] tutorials/../figures/non_empty_domain.png copying images... [ 60%] tutorials/../figures/reading_incomplete.png copying images... [ 62%] tutorials/../figures/multi_range_subarrays.png copying images... [ 63%] tutorials/../figures/quickstart_sparse.png copying images... [ 65%] tutorials/../figures/tiling_dense_motivation_no_tiling.png copying images... [ 67%] tutorials/../figures/tiling_dense_motivation_with_tiling.png copying images... [ 68%] tutorials/../figures/tiling_dense_tile_cell_order.png copying images... [ 70%] tutorials/../figures/tiling_dense_physical_cell_layout.png copying images... [ 72%] tutorials/../figures/tiling_dense_space_filling_curve.png copying images... [ 74%] tutorials/../figures/tiling_dense_space_data_tiles.png copying images... [ 75%] tutorials/../figures/tiling_dense_domain_expansion.png copying images... [ 77%] tutorials/../figures/tiling_sparse_space_tiling_problem.png copying images... [ 79%] tutorials/../figures/tiling_sparse_physical_cell_layout.png copying images... [ 81%] tutorials/../figures/tiling_sparse_data_tiles.png copying images... [ 82%] tutorials/../figures/tiling_sparse_mbr.png copying images... [ 84%] tutorials/../figures/tiling_sparse_mbr_shape.png copying images... [ 86%] tutorials/../figures/variable_length.png copying images... [ 87%] tutorials/../figures/writing_dense_layout.png copying images... [ 89%] tutorials/../figures/writing_dense_padding.png copying images... [ 91%] tutorials/../figures/writing_dense_padding_physical.png copying images... [ 93%] tutorials/../figures/writing_dense_multiple.png copying images... [ 94%] tutorials/../figures/writing_dense_sparse.png copying images... [ 96%] tutorials/../figures/writing_dense_global.png copying images... [ 98%] tutorials/../figures/writing_dense_global_expansion.png copying images... [100%] tutorials/../figures/writing_sparse_multiple.png copying static files... ... done copying readthedocs static files... done copying searchtools... done copying extra files... done dumping search index in English (code: en)... done dumping object inventory... done build succeeded, 2 warnings. The HTML pages are in _build/html. Copying contentui stylesheet/javascript... done /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb/conda/latest/lib/python3.6/site-packages/sphinx_rtd_theme/search.html:20: RemovedInSphinx30Warning: To modify script_files in the theme is deprecated. Please insert a