Read the Docs build information Build id: 2680094 Project: tiledb-inc-tiledb-py Version: 2116 Commit: cabc3e8c75260a0580fd0b0a53f65208eebf241d Date: 2024-12-12T11:24:00.686756Z State: finished Success: True [rtd-command-info] start-time: 2024-12-12T11:24:46.029367Z, end-time: 2024-12-12T11:24:46.585981Z, duration: 0, exit-code: 0 git clone --depth 1 https://github.com/TileDB-Inc/TileDB-Py.git . Cloning into '.'... [rtd-command-info] start-time: 2024-12-12T11:24:46.678404Z, end-time: 2024-12-12T11:24:47.671784Z, duration: 0, exit-code: 0 git fetch origin --force --prune --prune-tags --depth 50 pull/2116/head:external-2116 From https://github.com/TileDB-Inc/TileDB-Py * [new ref] refs/pull/2116/head -> external-2116 * [new tag] 0.32.0 -> 0.32.0 * [new tag] 0.32.1 -> 0.32.1 * [new tag] 0.32.2 -> 0.32.2 * [new tag] 0.32.4 -> 0.32.4 * [new tag] 0.32.5 -> 0.32.5 [rtd-command-info] start-time: 2024-12-12T11:24:47.810867Z, end-time: 2024-12-12T11:24:47.897076Z, duration: 0, exit-code: 0 git checkout --force cabc3e8c75260a0580fd0b0a53f65208eebf241d Note: switching to 'cabc3e8c75260a0580fd0b0a53f65208eebf241d'. You are in 'detached HEAD' state. You can look around, make experimental changes and commit them, and you can discard any commits you make in this state without impacting any branches by switching back to a branch. If you want to create a new branch to retain commits you create, you may do so (now or later) by using -c with the switch command. Example: git switch -c Or undo this operation with: git switch - Turn off this advice by setting config variable advice.detachedHead to false HEAD is now at cabc3e8 Need 2.27 to avoid test-skipping [rtd-command-info] start-time: 2024-12-12T11:24:47.976522Z, end-time: 2024-12-12T11:24:48.037232Z, duration: 0, exit-code: 0 cat .readthedocs.yml # Don't build any extra formats formats: [] # Use RTD config version 2 # https://docs.readthedocs.io/en/stable/config-file/v2.html version: 2 # Set build OS to avoid build failures with old compiler build: os: "ubuntu-22.04" tools: python: "3.12" sphinx: configuration: doc/source/conf.py python: install: - method: pip path: . extra_requirements: - doc [rtd-command-info] start-time: 2024-12-12T11:24:54.145220Z, end-time: 2024-12-12T11:24:54.216708Z, duration: 0, exit-code: 0 asdf global python 3.12.7 [rtd-command-info] start-time: 2024-12-12T11:24:54.652731Z, end-time: 2024-12-12T11:24:55.857592Z, duration: 1, exit-code: 0 python -mvirtualenv $READTHEDOCS_VIRTUALENV_PATH created virtual environment CPython3.12.7.final.0-64 in 809ms creator CPython3Posix(dest=/home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116, clear=False, no_vcs_ignore=False, global=False) seeder FromAppData(download=False, pip=bundle, setuptools=bundle, wheel=bundle, via=copy, app_data_dir=/home/docs/.local/share/virtualenv) added seed packages: pip==23.1, setuptools==67.6.1, wheel==0.40.0 activators BashActivator,CShellActivator,FishActivator,NushellActivator,PowerShellActivator,PythonActivator [rtd-command-info] start-time: 2024-12-12T11:24:55.936134Z, end-time: 2024-12-12T11:25:10.974108Z, duration: 15, exit-code: 0 python -m pip install --upgrade --no-cache-dir pip setuptools Requirement already satisfied: pip in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages (23.1) Collecting pip Downloading pip-24.3.1-py3-none-any.whl (1.8 MB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1.8/1.8 MB 9.6 MB/s eta 0:00:00 Requirement already satisfied: setuptools in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages (67.6.1) Collecting setuptools Downloading setuptools-75.6.0-py3-none-any.whl (1.2 MB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1.2/1.2 MB 19.1 MB/s eta 0:00:00 Installing collected packages: setuptools, pip Attempting uninstall: setuptools Found existing installation: setuptools 67.6.1 Uninstalling setuptools-67.6.1: Successfully uninstalled setuptools-67.6.1 Attempting uninstall: pip Found existing installation: pip 23.1 Uninstalling pip-23.1: Successfully uninstalled pip-23.1 Successfully installed pip-24.3.1 setuptools-75.6.0 [rtd-command-info] start-time: 2024-12-12T11:25:11.049031Z, end-time: 2024-12-12T11:25:18.038596Z, duration: 6, exit-code: 0 python -m pip install --upgrade --no-cache-dir sphinx Collecting sphinx Downloading sphinx-8.1.3-py3-none-any.whl.metadata (6.4 kB) Collecting sphinxcontrib-applehelp>=1.0.7 (from sphinx) Downloading sphinxcontrib_applehelp-2.0.0-py3-none-any.whl.metadata (2.3 kB) Collecting sphinxcontrib-devhelp>=1.0.6 (from sphinx) Downloading sphinxcontrib_devhelp-2.0.0-py3-none-any.whl.metadata (2.3 kB) Collecting sphinxcontrib-htmlhelp>=2.0.6 (from sphinx) Downloading sphinxcontrib_htmlhelp-2.1.0-py3-none-any.whl.metadata (2.3 kB) Collecting sphinxcontrib-jsmath>=1.0.1 (from sphinx) Downloading sphinxcontrib_jsmath-1.0.1-py2.py3-none-any.whl.metadata (1.4 kB) Collecting sphinxcontrib-qthelp>=1.0.6 (from sphinx) Downloading sphinxcontrib_qthelp-2.0.0-py3-none-any.whl.metadata (2.3 kB) Collecting sphinxcontrib-serializinghtml>=1.1.9 (from sphinx) Downloading sphinxcontrib_serializinghtml-2.0.0-py3-none-any.whl.metadata (2.4 kB) Collecting Jinja2>=3.1 (from sphinx) Downloading jinja2-3.1.4-py3-none-any.whl.metadata (2.6 kB) Collecting Pygments>=2.17 (from sphinx) Downloading pygments-2.18.0-py3-none-any.whl.metadata (2.5 kB) Collecting docutils<0.22,>=0.20 (from sphinx) Downloading docutils-0.21.2-py3-none-any.whl.metadata (2.8 kB) Collecting snowballstemmer>=2.2 (from sphinx) Downloading snowballstemmer-2.2.0-py2.py3-none-any.whl.metadata (6.5 kB) Collecting babel>=2.13 (from sphinx) Downloading babel-2.16.0-py3-none-any.whl.metadata (1.5 kB) Collecting alabaster>=0.7.14 (from sphinx) Downloading alabaster-1.0.0-py3-none-any.whl.metadata (2.8 kB) Collecting imagesize>=1.3 (from sphinx) Downloading imagesize-1.4.1-py2.py3-none-any.whl.metadata (1.5 kB) Collecting requests>=2.30.0 (from sphinx) Downloading requests-2.32.3-py3-none-any.whl.metadata (4.6 kB) Collecting packaging>=23.0 (from sphinx) Downloading packaging-24.2-py3-none-any.whl.metadata (3.2 kB) Collecting MarkupSafe>=2.0 (from Jinja2>=3.1->sphinx) Downloading MarkupSafe-3.0.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (4.0 kB) Collecting charset-normalizer<4,>=2 (from requests>=2.30.0->sphinx) Downloading charset_normalizer-3.4.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (34 kB) Collecting idna<4,>=2.5 (from requests>=2.30.0->sphinx) Downloading idna-3.10-py3-none-any.whl.metadata (10 kB) Collecting urllib3<3,>=1.21.1 (from requests>=2.30.0->sphinx) Downloading urllib3-2.2.3-py3-none-any.whl.metadata (6.5 kB) Collecting certifi>=2017.4.17 (from requests>=2.30.0->sphinx) Downloading certifi-2024.8.30-py3-none-any.whl.metadata (2.2 kB) Downloading sphinx-8.1.3-py3-none-any.whl (3.5 MB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 3.5/3.5 MB 115.4 MB/s eta 0:00:00 Downloading alabaster-1.0.0-py3-none-any.whl (13 kB) Downloading babel-2.16.0-py3-none-any.whl (9.6 MB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 9.6/9.6 MB 213.4 MB/s eta 0:00:00 Downloading docutils-0.21.2-py3-none-any.whl (587 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 587.4/587.4 kB 430.2 MB/s eta 0:00:00 Downloading imagesize-1.4.1-py2.py3-none-any.whl (8.8 kB) Downloading jinja2-3.1.4-py3-none-any.whl (133 kB) Downloading packaging-24.2-py3-none-any.whl (65 kB) Downloading pygments-2.18.0-py3-none-any.whl (1.2 MB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1.2/1.2 MB 474.4 MB/s eta 0:00:00 Downloading requests-2.32.3-py3-none-any.whl (64 kB) Downloading snowballstemmer-2.2.0-py2.py3-none-any.whl (93 kB) Downloading sphinxcontrib_applehelp-2.0.0-py3-none-any.whl (119 kB) Downloading sphinxcontrib_devhelp-2.0.0-py3-none-any.whl (82 kB) Downloading sphinxcontrib_htmlhelp-2.1.0-py3-none-any.whl (98 kB) Downloading sphinxcontrib_jsmath-1.0.1-py2.py3-none-any.whl (5.1 kB) Downloading sphinxcontrib_qthelp-2.0.0-py3-none-any.whl (88 kB) Downloading sphinxcontrib_serializinghtml-2.0.0-py3-none-any.whl (92 kB) Downloading certifi-2024.8.30-py3-none-any.whl (167 kB) Downloading charset_normalizer-3.4.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (143 kB) Downloading idna-3.10-py3-none-any.whl (70 kB) Downloading MarkupSafe-3.0.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (23 kB) Downloading urllib3-2.2.3-py3-none-any.whl (126 kB) Installing collected packages: snowballstemmer, urllib3, sphinxcontrib-serializinghtml, sphinxcontrib-qthelp, sphinxcontrib-jsmath, sphinxcontrib-htmlhelp, sphinxcontrib-devhelp, sphinxcontrib-applehelp, Pygments, packaging, MarkupSafe, imagesize, idna, docutils, charset-normalizer, certifi, babel, alabaster, requests, Jinja2, sphinx Successfully installed Jinja2-3.1.4 MarkupSafe-3.0.2 Pygments-2.18.0 alabaster-1.0.0 babel-2.16.0 certifi-2024.8.30 charset-normalizer-3.4.0 docutils-0.21.2 idna-3.10 imagesize-1.4.1 packaging-24.2 requests-2.32.3 snowballstemmer-2.2.0 sphinx-8.1.3 sphinxcontrib-applehelp-2.0.0 sphinxcontrib-devhelp-2.0.0 sphinxcontrib-htmlhelp-2.1.0 sphinxcontrib-jsmath-1.0.1 sphinxcontrib-qthelp-2.0.0 sphinxcontrib-serializinghtml-2.0.0 urllib3-2.2.3 [rtd-command-info] start-time: 2024-12-12T11:25:18.129090Z, end-time: 2024-12-12T11:28:50.394222Z, duration: 212, exit-code: 0 python -m pip install --upgrade --upgrade-strategy only-if-needed --no-cache-dir .[doc] Processing /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/checkouts/2116 Installing build dependencies: started Installing build dependencies: finished with status 'done' Getting requirements to build wheel: started Getting requirements to build wheel: finished with status 'done' Installing backend dependencies: started Installing backend dependencies: finished with status 'done' Preparing metadata (pyproject.toml): started Preparing metadata (pyproject.toml): finished with status 'done' Collecting numpy>=1.25 (from tiledb==0.32.6.dev12+gcabc3e8) Downloading numpy-2.2.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (62 kB) Requirement already satisfied: packaging in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages (from tiledb==0.32.6.dev12+gcabc3e8) (24.2) Collecting jinja2==3.0.0 (from tiledb==0.32.6.dev12+gcabc3e8) Downloading Jinja2-3.0.0-py3-none-any.whl.metadata (3.5 kB) Collecting sphinx-rtd-theme==2.0.0 (from tiledb==0.32.6.dev12+gcabc3e8) Downloading sphinx_rtd_theme-2.0.0-py2.py3-none-any.whl.metadata (4.4 kB) Requirement already satisfied: Sphinx in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages (from tiledb==0.32.6.dev12+gcabc3e8) (8.1.3) Collecting breathe (from tiledb==0.32.6.dev12+gcabc3e8) Downloading breathe-4.35.0-py3-none-any.whl.metadata (1.0 kB) Requirement already satisfied: MarkupSafe>=2.0.0rc2 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages (from jinja2==3.0.0->tiledb==0.32.6.dev12+gcabc3e8) (3.0.2) Collecting Sphinx (from tiledb==0.32.6.dev12+gcabc3e8) Downloading sphinx-7.4.7-py3-none-any.whl.metadata (6.1 kB) Collecting docutils<0.21 (from sphinx-rtd-theme==2.0.0->tiledb==0.32.6.dev12+gcabc3e8) Downloading docutils-0.20.1-py3-none-any.whl.metadata (2.8 kB) Collecting sphinxcontrib-jquery<5,>=4 (from sphinx-rtd-theme==2.0.0->tiledb==0.32.6.dev12+gcabc3e8) Downloading sphinxcontrib_jquery-4.1-py2.py3-none-any.whl.metadata (2.6 kB) Requirement already satisfied: sphinxcontrib-applehelp in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages (from Sphinx->tiledb==0.32.6.dev12+gcabc3e8) (2.0.0) Requirement already satisfied: sphinxcontrib-devhelp in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages (from Sphinx->tiledb==0.32.6.dev12+gcabc3e8) (2.0.0) Requirement already satisfied: sphinxcontrib-jsmath in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages (from Sphinx->tiledb==0.32.6.dev12+gcabc3e8) (1.0.1) Requirement already satisfied: sphinxcontrib-htmlhelp>=2.0.0 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages (from Sphinx->tiledb==0.32.6.dev12+gcabc3e8) (2.1.0) Requirement already satisfied: sphinxcontrib-serializinghtml>=1.1.9 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages (from Sphinx->tiledb==0.32.6.dev12+gcabc3e8) (2.0.0) Requirement already satisfied: sphinxcontrib-qthelp in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages (from Sphinx->tiledb==0.32.6.dev12+gcabc3e8) (2.0.0) INFO: pip is looking at multiple versions of sphinx to determine which version is compatible with other requirements. This could take a while. Collecting Sphinx (from tiledb==0.32.6.dev12+gcabc3e8) Downloading sphinx-7.4.6-py3-none-any.whl.metadata (6.1 kB) Downloading sphinx-7.4.5-py3-none-any.whl.metadata (6.1 kB) Downloading sphinx-7.4.4-py3-none-any.whl.metadata (6.1 kB) Downloading sphinx-7.4.3-py3-none-any.whl.metadata (6.1 kB) Downloading sphinx-7.4.2-py3-none-any.whl.metadata (6.1 kB) Downloading sphinx-7.4.1-py3-none-any.whl.metadata (6.1 kB) Downloading sphinx-7.4.0-py3-none-any.whl.metadata (6.1 kB) INFO: pip is still looking at multiple versions of sphinx to determine which version is compatible with other requirements. This could take a while. Downloading sphinx-7.3.7-py3-none-any.whl.metadata (6.0 kB) Requirement already satisfied: Pygments>=2.14 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages (from Sphinx->tiledb==0.32.6.dev12+gcabc3e8) (2.18.0) Requirement already satisfied: snowballstemmer>=2.0 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages (from Sphinx->tiledb==0.32.6.dev12+gcabc3e8) (2.2.0) Requirement already satisfied: babel>=2.9 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages (from Sphinx->tiledb==0.32.6.dev12+gcabc3e8) (2.16.0) Collecting alabaster~=0.7.14 (from Sphinx->tiledb==0.32.6.dev12+gcabc3e8) Downloading alabaster-0.7.16-py3-none-any.whl.metadata (2.9 kB) Requirement already satisfied: imagesize>=1.3 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages (from Sphinx->tiledb==0.32.6.dev12+gcabc3e8) (1.4.1) Requirement already satisfied: requests>=2.25.0 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages (from Sphinx->tiledb==0.32.6.dev12+gcabc3e8) (2.32.3) Requirement already satisfied: charset-normalizer<4,>=2 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages (from requests>=2.25.0->Sphinx->tiledb==0.32.6.dev12+gcabc3e8) (3.4.0) Requirement already satisfied: idna<4,>=2.5 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages (from requests>=2.25.0->Sphinx->tiledb==0.32.6.dev12+gcabc3e8) (3.10) Requirement already satisfied: urllib3<3,>=1.21.1 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages (from requests>=2.25.0->Sphinx->tiledb==0.32.6.dev12+gcabc3e8) (2.2.3) Requirement already satisfied: certifi>=2017.4.17 in /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages (from requests>=2.25.0->Sphinx->tiledb==0.32.6.dev12+gcabc3e8) (2024.8.30) Downloading Jinja2-3.0.0-py3-none-any.whl (133 kB) Downloading sphinx_rtd_theme-2.0.0-py2.py3-none-any.whl (2.8 MB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 2.8/2.8 MB 128.2 MB/s eta 0:00:00 Downloading numpy-2.2.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (16.1 MB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 16.1/16.1 MB 201.3 MB/s eta 0:00:00 Downloading sphinx-7.3.7-py3-none-any.whl (3.3 MB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 3.3/3.3 MB 221.1 MB/s eta 0:00:00 Downloading breathe-4.35.0-py3-none-any.whl (92 kB) Downloading alabaster-0.7.16-py3-none-any.whl (13 kB) Downloading docutils-0.20.1-py3-none-any.whl (572 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 572.7/572.7 kB 456.7 MB/s eta 0:00:00 Downloading sphinxcontrib_jquery-4.1-py2.py3-none-any.whl (121 kB) Building wheels for collected packages: tiledb Building wheel for tiledb (pyproject.toml): started Building wheel for tiledb (pyproject.toml): still running... Building wheel for tiledb (pyproject.toml): still running... Building wheel for tiledb (pyproject.toml): finished with status 'done' Created wheel for tiledb: filename=tiledb-0.32.6.dev12+gcabc3e8-cp312-cp312-linux_x86_64.whl size=17139667 sha256=dd30b985a6e050cc63fc6ffe62ed5fd9ea4a0752d64c100cef3e5f5309bf9351 Stored in directory: /tmp/pip-ephem-wheel-cache-jepp78yl/wheels/5d/dc/1c/7af72a58c5e408841d01bc685ebbb5f626781956c984f01e77 Successfully built tiledb Installing collected packages: numpy, jinja2, docutils, alabaster, tiledb, Sphinx, sphinxcontrib-jquery, breathe, sphinx-rtd-theme Attempting uninstall: jinja2 Found existing installation: Jinja2 3.1.4 Uninstalling Jinja2-3.1.4: Successfully uninstalled Jinja2-3.1.4 Attempting uninstall: docutils Found existing installation: docutils 0.21.2 Uninstalling docutils-0.21.2: Successfully uninstalled docutils-0.21.2 Attempting uninstall: alabaster Found existing installation: alabaster 1.0.0 Uninstalling alabaster-1.0.0: Successfully uninstalled alabaster-1.0.0 Attempting uninstall: Sphinx Found existing installation: Sphinx 8.1.3 Uninstalling Sphinx-8.1.3: Successfully uninstalled Sphinx-8.1.3 Successfully installed Sphinx-7.3.7 alabaster-0.7.16 breathe-4.35.0 docutils-0.20.1 jinja2-3.0.0 numpy-2.2.0 sphinx-rtd-theme-2.0.0 sphinxcontrib-jquery-4.1 tiledb-0.32.6.dev12+gcabc3e8 [rtd-command-info] start-time: 2024-12-12T11:28:50.586872Z, end-time: 2024-12-12T11:28:50.656666Z, duration: 0, exit-code: 0 cat doc/source/conf.py #!/usr/bin/env python3 # -*- coding: utf-8 -*- # # -- Imports configuration ------------------------------------------------- import os import sys from os.path import abspath, dirname, join import sphinx_rtd_theme from importlib.metadata import version as get_version 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" # -- Project information ----------------------------------------------------- project = "TileDB-Py" copyright = "2024, TileDB, Inc." author = "TileDB, Inc." # The full version, including alpha/beta/rc tags release: str = get_version("tiledb") # The short X.Y version version: str = ".".join(release.split(".")[:2]) # -- 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.doctest", "sphinx.ext.intersphinx"] # Mapping for linking between RTD subprojects. if readthedocs: 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, ), "python": ("https://docs.python.org/", None), } # Add any paths that contain templates here, relative to this directory. templates_path = ["_templates"] # The suffix(es) of source filenames. # You can specify multiple suffix as a list of string: # # source_suffix = ['.rst', '.md'] source_suffix = ".rst" # The master toctree document. master_doc = "index" # 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 = "en" # List of patterns, relative to source directory, that match files and # directories to ignore when looking for source files. # This pattern also affects html_static_path and html_extra_path . exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"] # The name of the Pygments (syntax highlighting) style to use. pygments_style = "friendly" # -- Options for HTML output ------------------------------------------------- html_static_path = ["_static"] html_title = "TileDB Python API Reference — TileDB-Py %s documentation" % version html_logo = "_static/tiledb-logo_color_no_margin_@4x.png" html_favicon = "_static/favicon.ico" 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 = "TileDB-Pydoc" # -- 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-Py.tex", "TileDB-Py 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-py", "TileDB-Py 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-Py", "TileDB-Py Documentation", author, "TileDB-Py", "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-py" ) # -- Custom setup ----------------------------------------------------------- def setup(app): app.add_css_file("custom.css") [rtd-command-info] start-time: 2024-12-12T11:28:50.727389Z, end-time: 2024-12-12T11:28:55.440285Z, duration: 4, exit-code: 0 python -m sphinx -T -b html -d _build/doctrees -D language=en . $READTHEDOCS_OUTPUT/html Running Sphinx v7.3.7 making output directory... done loading intersphinx inventory from https://tiledb-inc-tiledb.readthedocs-hosted.com/en/stable/objects.inv... loading intersphinx inventory from https://tiledb-inc-tiledb.readthedocs-hosted.com/projects/python-api/en/stable/objects.inv... loading intersphinx inventory from https://docs.python.org/objects.inv... intersphinx inventory has moved: https://docs.python.org/objects.inv -> https://docs.python.org/3/objects.inv 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/stable/objects.inv' not fetchable due to : 404 Client Error: Not Found for url: https://tiledb-inc-tiledb.readthedocs-hosted.com/projects/python-api/en/stable/objects.inv building [mo]: targets for 0 po files that are out of date writing output... building [html]: targets for 2 source files that are out of date updating environment: [new config] 2 added, 0 changed, 0 removed reading sources... [ 50%] index reading sources... [100%] python-api /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages/tiledb/__init__.py:docstring of tiledb.dense_array.DenseArrayImpl.query:22: ERROR: Unexpected indentation. /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages/tiledb/__init__.py:docstring of tiledb.dense_array.DenseArrayImpl.query:23: WARNING: Block quote ends without a blank line; unexpected unindent. /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages/tiledb/group.py:docstring of tiledb.group.Group.GroupMetadata:1: WARNING: duplicate object description of tiledb.Group.GroupMetadata, other instance in python-api, use :no-index: for one of them /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages/tiledb/group.py:docstring of tiledb.group.Group.GroupMetadata:1: WARNING: duplicate object description of tiledb.group.Group.GroupMetadata, other instance in python-api, use :no-index: for one of them WARNING: autodoc: failed to import method 'Group.GroupMetadata.__keys__' from module 'tiledb'; the following exception was raised: No module named 'tiledb.Group' WARNING: autodoc: failed to import method 'Group.GroupMetadata.__values__' from module 'tiledb'; the following exception was raised: No module named 'tiledb.Group' WARNING: autodoc: failed to import method 'Group.GroupMetadata.__items__' from module 'tiledb'; the following exception was raised: No module named 'tiledb.Group' /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages/tiledb/group.py:docstring of tiledb.group.Group.GroupMetadata.clear:1: WARNING: duplicate object description of tiledb.Group.GroupMetadata.clear, other instance in python-api, use :no-index: for one of them /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages/tiledb/group.py:docstring of tiledb.group.Group.GroupMetadata.dump:1: WARNING: duplicate object description of tiledb.Group.GroupMetadata.dump, other instance in python-api, use :no-index: for one of them /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages/tiledb/group.py:docstring of tiledb.group.Group.GroupMetadata.pop:1: WARNING: duplicate object description of tiledb.Group.GroupMetadata.pop, other instance in python-api, use :no-index: for one of them /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages/tiledb/group.py:docstring of tiledb.group.Group.GroupMetadata.popitem:1: WARNING: duplicate object description of tiledb.Group.GroupMetadata.popitem, other instance in python-api, use :no-index: for one of them /home/docs/checkouts/readthedocs.org/user_builds/tiledb-inc-tiledb-py/envs/2116/lib/python3.12/site-packages/tiledb/group.py:docstring of tiledb.group.Group.GroupMetadata.setdefault:1: WARNING: duplicate object description of tiledb.Group.GroupMetadata.setdefault, other instance in python-api, use :no-index: for one of them looking for now-outdated files... none found pickling environment... done checking consistency... done preparing documents... done copying assets... copying static files... done copying extra files... done done writing output... [ 50%] index writing output... [100%] python-api generating indices... genindex done writing additional pages... search done dumping search index in English (code: en)... done dumping object inventory... done build succeeded, 13 warnings. The HTML pages are in ../../_readthedocs/html.