Read the Docs build information
Build id: 4139148
Project: anyscale-ray
Version: master
Commit: c63e5bd962993e7b161c45aa67546b55ae3c26d2
Date: 2026-06-23T22:33:52.883079Z
State: cancelled
Success: False


[rtd-command-info] start-time: 2026-06-23T22:33:53.673472Z, end-time: 2026-06-23T22:34:05.814232Z, duration: 12, exit-code: 0
git clone --depth 1 https://github.com/ray-project/ray.git .
Cloning into '.'...
Updating files:  40% (4111/10028)
Updating files:  41% (4112/10028)
Updating files:  42% (4212/10028)
Updating files:  43% (4313/10028)
Updating files:  44% (4413/10028)
Updating files:  45% (4513/10028)
Updating files:  46% (4613/10028)
Updating files:  47% (4714/10028)
Updating files:  48% (4814/10028)
Updating files:  49% (4914/10028)
Updating files:  50% (5014/10028)
Updating files:  51% (5115/10028)
Updating files:  52% (5215/10028)
Updating files:  53% (5315/10028)
Updating files:  54% (5416/10028)
Updating files:  55% (5516/10028)
Updating files:  56% (5616/10028)
Updating files:  57% (5716/10028)
Updating files:  58% (5817/10028)
Updating files:  59% (5917/10028)
Updating files:  60% (6017/10028)
Updating files:  61% (6118/10028)
Updating files:  62% (6218/10028)
Updating files:  63% (6318/10028)
Updating files:  64% (6418/10028)
Updating files:  65% (6519/10028)
Updating files:  66% (6619/10028)
Updating files:  67% (6719/10028)
Updating files:  68% (6820/10028)
Updating files:  69% (6920/10028)
Updating files:  70% (7020/10028)
Updating files:  71% (7120/10028)
Updating files:  72% (7221/10028)
Updating files:  73% (7321/10028)
Updating files:  74% (7421/10028)
Updating files:  75% (7521/10028)
Updating files:  76% (7622/10028)
Updating files:  77% (7722/10028)
Updating files:  78% (7822/10028)
Updating files:  79% (7923/10028)
Updating files:  80% (8023/10028)
Updating files:  81% (8123/10028)
Updating files:  82% (8223/10028)
Updating files:  83% (8324/10028)
Updating files:  84% (8424/10028)
Updating files:  85% (8524/10028)
Updating files:  86% (8625/10028)
Updating files:  87% (8725/10028)
Updating files:  88% (8825/10028)
Updating files:  89% (8925/10028)
Updating files:  90% (9026/10028)
Updating files:  91% (9126/10028)
Updating files:  92% (9226/10028)
Updating files:  93% (9327/10028)
Updating files:  94% (9427/10028)
Updating files:  95% (9527/10028)
Updating files:  96% (9627/10028)
Updating files:  97% (9728/10028)
Updating files:  98% (9828/10028)
Updating files:  99% (9928/10028)
Updating files: 100% (10028/10028)
Updating files: 100% (10028/10028), done.

[rtd-command-info] start-time: 2026-06-23T22:34:05.892798Z, end-time: 2026-06-23T22:34:06.827781Z, duration: 0, exit-code: 0
git fetch origin --force --prune --prune-tags --depth 50 refs/heads/master:refs/remotes/origin/master


[rtd-command-info] start-time: 2026-06-23T22:34:07.485666Z, end-time: 2026-06-23T22:34:08.484474Z, duration: 0, exit-code: 0
git checkout --force origin/master
Note: switching to 'origin/master'.

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 <new-branch-name>

Or undo this operation with:

  git switch -

Turn off this advice by setting config variable advice.detachedHead to false

HEAD is now at c63e5bd [Data] Fix flaky test_streaming_split_stats (#64290)

[rtd-command-info] start-time: 2026-06-23T22:34:08.564497Z, end-time: 2026-06-23T22:34:08.606129Z, duration: 0, exit-code: 0
cat .readthedocs.yaml
# .readthedocs.yaml
# Read the Docs configuration file
# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details

# Required
version: 2

# Set the version of Python and other tools you might need
build:
  os: ubuntu-24.04
  tools:
    python: "3.11"
  jobs:
    # On PR builds, skip the Sphinx build when the PR doesn't touch any
    # files that affect documentation output. Reduces queue pressure on
    # the shared RTD build slots when several PRs are open at once.
    # Tag/branch builds (master, stable, etc.) always run.
    # See https://docs.readthedocs.com/platform/stable/guides/build/skip-build.html
    #
    # Some constructs are avoided deliberately because RTD's job runner
    # silently drops scripts that contain them: use echo (not printf
    # with a backslash-escape format string), avoid backslash escapes
    # in general, and keep shell comments out of this block so that
    # backticks/$() inside comments don't confuse the preprocessor.
    post_checkout:
      - |
        if [ "${READTHEDOCS_VERSION_TYPE:-}" != "external" ]; then
          echo "Not a PR build (version type: '${READTHEDOCS_VERSION_TYPE:-unset}'); building docs."
          exit 0
        fi
        git fetch --depth=500 origin master 2>/dev/null || true
        if ! git merge-base origin/master HEAD >/dev/null 2>&1; then
          echo "Could not determine merge-base with origin/master; building docs to be safe."
          exit 0
        fi
        if git diff --quiet origin/master...HEAD -- doc/ python/ray/ rllib/ .readthedocs.yaml; then
          echo "No doc-affecting files changed in this PR; skipping Sphinx build."
          echo "Files changed in PR:"
          git diff --name-only origin/master...HEAD
          exit 183
        fi
        echo "Doc-affecting files changed; building docs. Changed doc-relevant paths:"
        git diff --name-only origin/master...HEAD -- doc/ python/ray/ rllib/ .readthedocs.yaml

# Build documentation in the docs/ directory with Sphinx
sphinx:
  configuration: doc/source/conf.py
  fail_on_warning: true

# We recommend specifying your dependencies to enable reproducible builds:
# https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
python:
  install:
    - requirements: doc/requirements-doc.lock.txt

[rtd-command-info] start-time: 2026-06-23T22:34:08.690604Z, end-time: 2026-06-23T22:34:08.730955Z, duration: 0, exit-code: 0
if [ "${READTHEDOCS_VERSION_TYPE:-}" != "external" ]; then
  echo "Not a PR build (version type: '${READTHEDOCS_VERSION_TYPE:-unset}'); building docs."
  exit 0
fi
git fetch --depth=500 origin master 2>/dev/null || true
if ! git merge-base origin/master HEAD >/dev/null 2>&1; then
  echo "Could not determine merge-base with origin/master; building docs to be safe."
  exit 0
fi
if git diff --quiet origin/master...HEAD -- doc/ python/ray/ rllib/ .readthedocs.yaml; then
  echo "No doc-affecting files changed in this PR; skipping Sphinx build."
  echo "Files changed in PR:"
  git diff --name-only origin/master...HEAD
  exit 183
fi
echo "Doc-affecting files changed; building docs. Changed doc-relevant paths:"
git diff --name-only origin/master...HEAD -- doc/ python/ray/ rllib/ .readthedocs.yaml
Not a PR build (version type: branch); building docs.

[rtd-command-info] start-time: 2026-06-23T22:34:13.848014Z, end-time: 2026-06-23T22:34:13.909914Z, duration: 0, exit-code: 0
asdf global python 3.11.14


[rtd-command-info] start-time: 2026-06-23T22:34:14.317587Z, end-time: 2026-06-23T22:34:14.786292Z, duration: 0, exit-code: 0
python -mvirtualenv $READTHEDOCS_VIRTUALENV_PATH
created virtual environment CPython3.11.14.final.0-64 in 247ms
  creator CPython3Posix(dest=/home/docs/checkouts/readthedocs.org/user_builds/anyscale-ray/envs/master, 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: 2026-06-23T22:34:14.871202Z, end-time: 2026-06-23T22:34:17.709472Z, duration: 2, 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/anyscale-ray/envs/master/lib/python3.11/site-packages (23.1)
Collecting pip
  Downloading pip-26.1.2-py3-none-any.whl (1.8 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1.8/1.8 MB 35.2 MB/s eta 0:00:00
Requirement already satisfied: setuptools in /home/docs/checkouts/readthedocs.org/user_builds/anyscale-ray/envs/master/lib/python3.11/site-packages (67.6.1)
Collecting setuptools
  Downloading setuptools-82.0.1-py3-none-any.whl (1.0 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1.0/1.0 MB 446.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-26.1.2 setuptools-82.0.1

[rtd-command-info] start-time: 2026-06-23T22:34:17.790551Z, end-time: 2026-06-23T22:34:21.814460Z, duration: 4, exit-code: 0
python -m pip install --upgrade --no-cache-dir sphinx
Collecting sphinx
  Downloading sphinx-9.0.4-py3-none-any.whl.metadata (5.8 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.6-py3-none-any.whl.metadata (2.9 kB)
Collecting Pygments>=2.17 (from sphinx)
  Downloading pygments-2.20.0-py3-none-any.whl.metadata (2.5 kB)
Collecting docutils<0.23,>=0.20 (from sphinx)
  Downloading docutils-0.22.4-py3-none-any.whl.metadata (15 kB)
Collecting snowballstemmer>=2.2 (from sphinx)
  Downloading snowballstemmer-3.1.1-py3-none-any.whl.metadata (7.9 kB)
Collecting babel>=2.13 (from sphinx)
  Downloading babel-2.18.0-py3-none-any.whl.metadata (2.2 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-2.0.0-py2.py3-none-any.whl.metadata (1.5 kB)
Collecting requests>=2.30.0 (from sphinx)
  Downloading requests-2.34.2-py3-none-any.whl.metadata (4.8 kB)
Collecting roman-numerals>=1.0.0 (from sphinx)
  Downloading roman_numerals-4.1.0-py3-none-any.whl.metadata (3.3 kB)
Collecting packaging>=23.0 (from sphinx)
  Downloading packaging-26.2-py3-none-any.whl.metadata (3.5 kB)
Collecting MarkupSafe>=2.0 (from Jinja2>=3.1->sphinx)
  Downloading markupsafe-3.0.3-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.metadata (2.7 kB)
Collecting charset_normalizer<4,>=2 (from requests>=2.30.0->sphinx)
  Downloading charset_normalizer-3.4.7-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.metadata (40 kB)
Collecting idna<4,>=2.5 (from requests>=2.30.0->sphinx)
  Downloading idna-3.18-py3-none-any.whl.metadata (6.1 kB)
Collecting urllib3<3,>=1.26 (from requests>=2.30.0->sphinx)
  Downloading urllib3-2.7.0-py3-none-any.whl.metadata (6.9 kB)
Collecting certifi>=2023.5.7 (from requests>=2.30.0->sphinx)
  Downloading certifi-2026.6.17-py3-none-any.whl.metadata (2.5 kB)
Downloading sphinx-9.0.4-py3-none-any.whl (3.9 MB)
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 3.9/3.9 MB 103.1 MB/s  0:00:00
Downloading docutils-0.22.4-py3-none-any.whl (633 kB)
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 633.2/633.2 kB 198.4 MB/s  0:00:00
Downloading alabaster-1.0.0-py3-none-any.whl (13 kB)
Downloading babel-2.18.0-py3-none-any.whl (10.2 MB)
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 10.2/10.2 MB 391.2 MB/s  0:00:00
Downloading imagesize-2.0.0-py2.py3-none-any.whl (9.4 kB)
Downloading jinja2-3.1.6-py3-none-any.whl (134 kB)
Downloading markupsafe-3.0.3-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (22 kB)
Downloading packaging-26.2-py3-none-any.whl (100 kB)
Downloading pygments-2.20.0-py3-none-any.whl (1.2 MB)
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1.2/1.2 MB 774.5 MB/s  0:00:00
Downloading requests-2.34.2-py3-none-any.whl (73 kB)
Downloading charset_normalizer-3.4.7-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (214 kB)
Downloading idna-3.18-py3-none-any.whl (65 kB)
Downloading urllib3-2.7.0-py3-none-any.whl (131 kB)
Downloading certifi-2026.6.17-py3-none-any.whl (133 kB)
Downloading roman_numerals-4.1.0-py3-none-any.whl (7.7 kB)
Downloading snowballstemmer-3.1.1-py3-none-any.whl (104 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)
Installing collected packages: urllib3, sphinxcontrib-serializinghtml, sphinxcontrib-qthelp, sphinxcontrib-jsmath, sphinxcontrib-htmlhelp, sphinxcontrib-devhelp, sphinxcontrib-applehelp, snowballstemmer, roman-numerals, Pygments, packaging, MarkupSafe, imagesize, idna, docutils, charset_normalizer, certifi, babel, alabaster, requests, Jinja2, sphinx

Successfully installed Jinja2-3.1.6 MarkupSafe-3.0.3 Pygments-2.20.0 alabaster-1.0.0 babel-2.18.0 certifi-2026.6.17 charset_normalizer-3.4.7 docutils-0.22.4 idna-3.18 imagesize-2.0.0 packaging-26.2 requests-2.34.2 roman-numerals-4.1.0 snowballstemmer-3.1.1 sphinx-9.0.4 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.7.0

[rtd-command-info] start-time: 2026-06-23T22:34:21.908074Z, end-time: 2026-06-23T22:35:03.569790Z, duration: 41, exit-code: 0
python -m pip install --exists-action=w --no-cache-dir -r doc/requirements-doc.lock.txt
Collecting absl-py==2.4.0 (from -r doc/requirements-doc.lock.txt (line 3))
  Downloading absl_py-2.4.0-py3-none-any.whl (135 kB)
Collecting accessible-pygments==0.0.5 (from -r doc/requirements-doc.lock.txt (line 10))
  Downloading accessible_pygments-0.0.5-py3-none-any.whl (1.4 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1.4/1.4 MB 16.4 MB/s  0:00:00
Requirement already satisfied: alabaster==1.0.0 in /home/docs/checkouts/readthedocs.org/user_builds/anyscale-ray/envs/master/lib/python3.11/site-packages (from -r doc/requirements-doc.lock.txt (line 14)) (1.0.0)
Collecting annotated-types==0.7.0 (from -r doc/requirements-doc.lock.txt (line 18))
  Downloading annotated_types-0.7.0-py3-none-any.whl (13 kB)
Collecting anyio==4.13.0 (from -r doc/requirements-doc.lock.txt (line 22))
  Downloading anyio-4.13.0-py3-none-any.whl (114 kB)
Collecting appnope==0.1.4 (from -r doc/requirements-doc.lock.txt (line 28))
  Downloading appnope-0.1.4-py2.py3-none-any.whl (4.3 kB)
Collecting asttokens==3.0.1 (from -r doc/requirements-doc.lock.txt (line 32))
  Downloading asttokens-3.0.1-py3-none-any.whl (27 kB)
Collecting astunparse==1.6.3 (from -r doc/requirements-doc.lock.txt (line 36))
  Downloading astunparse-1.6.3-py2.py3-none-any.whl (12 kB)
Collecting attrs==26.1.0 (from -r doc/requirements-doc.lock.txt (line 40))
  Downloading attrs-26.1.0-py3-none-any.whl (67 kB)
Collecting autodoc-pydantic==2.2.0 (from -r doc/requirements-doc.lock.txt (line 47))
  Downloading autodoc_pydantic-2.2.0-py3-none-any.whl (34 kB)
Requirement already satisfied: babel==2.18.0 in /home/docs/checkouts/readthedocs.org/user_builds/anyscale-ray/envs/master/lib/python3.11/site-packages (from -r doc/requirements-doc.lock.txt (line 50)) (2.18.0)
Collecting beautifulsoup4==4.15.0 (from -r doc/requirements-doc.lock.txt (line 56))
  Downloading beautifulsoup4-4.15.0-py3-none-any.whl (109 kB)
Collecting boto3==1.34.69 (from -r doc/requirements-doc.lock.txt (line 60))
  Downloading boto3-1.34.69-py3-none-any.whl (139 kB)
Collecting botocore==1.34.162 (from -r doc/requirements-doc.lock.txt (line 64))
  Downloading botocore-1.34.162-py3-none-any.whl (12.5 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 12.5/12.5 MB 56.0 MB/s  0:00:00
Collecting certifi==2026.5.20 (from -r doc/requirements-doc.lock.txt (line 70))
  Downloading certifi-2026.5.20-py3-none-any.whl (134 kB)
Requirement already satisfied: charset-normalizer==3.4.7 in /home/docs/checkouts/readthedocs.org/user_builds/anyscale-ray/envs/master/lib/python3.11/site-packages (from -r doc/requirements-doc.lock.txt (line 74)) (3.4.7)
Collecting click==8.1.7 (from -r doc/requirements-doc.lock.txt (line 205))
  Downloading click-8.1.7-py3-none-any.whl (97 kB)
Collecting colorama==0.4.6 (from -r doc/requirements-doc.lock.txt (line 213))
  Downloading colorama-0.4.6-py2.py3-none-any.whl (25 kB)
Collecting comm==0.2.3 (from -r doc/requirements-doc.lock.txt (line 217))
  Downloading comm-0.2.3-py3-none-any.whl (7.3 kB)
Collecting debugpy==1.8.21 (from -r doc/requirements-doc.lock.txt (line 221))
  Downloading debugpy-1.8.21-cp311-cp311-manylinux_2_34_x86_64.whl (3.1 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 3.1/3.1 MB 127.5 MB/s  0:00:00
Collecting decorator==5.3.1 (from -r doc/requirements-doc.lock.txt (line 253))
  Downloading decorator-5.3.1-py3-none-any.whl (10 kB)
Collecting docutils==0.21.2 (from -r doc/requirements-doc.lock.txt (line 257))
  Downloading docutils-0.21.2-py3-none-any.whl (587 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 587.4/587.4 kB 184.0 MB/s  0:00:00
Collecting executing==2.2.1 (from -r doc/requirements-doc.lock.txt (line 266))
  Downloading executing-2.2.1-py2.py3-none-any.whl (28 kB)
Collecting fastjsonschema==2.21.2 (from -r doc/requirements-doc.lock.txt (line 270))
  Downloading fastjsonschema-2.21.2-py3-none-any.whl (24 kB)
Collecting flatbuffers==25.12.19 (from -r doc/requirements-doc.lock.txt (line 274))
  Downloading flatbuffers-25.12.19-py2.py3-none-any.whl (26 kB)
Collecting gast==0.7.0 (from -r doc/requirements-doc.lock.txt (line 277))
  Downloading gast-0.7.0-py3-none-any.whl (22 kB)
Collecting gitdb==4.0.12 (from -r doc/requirements-doc.lock.txt (line 281))
  Downloading gitdb-4.0.12-py3-none-any.whl (62 kB)
Collecting gitpython==3.1.50 (from -r doc/requirements-doc.lock.txt (line 285))
  Downloading gitpython-3.1.50-py3-none-any.whl (212 kB)
Collecting google-pasta==0.2.0 (from -r doc/requirements-doc.lock.txt (line 289))
  Downloading google_pasta-0.2.0-py3-none-any.whl (57 kB)
Collecting greenlet==3.5.1 (from -r doc/requirements-doc.lock.txt (line 294))
  Downloading greenlet-3.5.1-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (614 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 614.8/614.8 kB 168.0 MB/s  0:00:00
Collecting grpcio==1.81.0 (from -r doc/requirements-doc.lock.txt (line 375))
  Downloading grpcio-1.81.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl (6.8 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 6.8/6.8 MB 159.7 MB/s  0:00:00
Collecting h11==0.16.0 (from -r doc/requirements-doc.lock.txt (line 430))
  Downloading h11-0.16.0-py3-none-any.whl (37 kB)
Collecting h5py==3.16.0 (from -r doc/requirements-doc.lock.txt (line 434))
  Downloading h5py-3.16.0-cp311-cp311-manylinux_2_28_x86_64.whl (5.0 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 5.0/5.0 MB 154.9 MB/s  0:00:00
Requirement already satisfied: idna==3.18 in /home/docs/checkouts/readthedocs.org/user_builds/anyscale-ray/envs/master/lib/python3.11/site-packages (from -r doc/requirements-doc.lock.txt (line 486)) (3.18)
Requirement already satisfied: imagesize==2.0.0 in /home/docs/checkouts/readthedocs.org/user_builds/anyscale-ray/envs/master/lib/python3.11/site-packages (from -r doc/requirements-doc.lock.txt (line 492)) (2.0.0)
Collecting importlib-metadata==9.0.0 (from -r doc/requirements-doc.lock.txt (line 496))
  Downloading importlib_metadata-9.0.0-py3-none-any.whl (27 kB)
Collecting ipykernel==7.3.0 (from -r doc/requirements-doc.lock.txt (line 502))
  Downloading ipykernel-7.3.0-py3-none-any.whl (120 kB)
Collecting ipython==9.14.1 (from -r doc/requirements-doc.lock.txt (line 506))
  Downloading ipython-9.14.1-py3-none-any.whl (627 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 627.8/627.8 kB 325.9 MB/s  0:00:00
Collecting ipython-pygments-lexers==1.1.1 (from -r doc/requirements-doc.lock.txt (line 512))
  Downloading ipython_pygments_lexers-1.1.1-py3-none-any.whl (8.1 kB)
Collecting jedi==0.20.0 (from -r doc/requirements-doc.lock.txt (line 516))
  Downloading jedi-0.20.0-py2.py3-none-any.whl (4.9 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 4.9/4.9 MB 240.6 MB/s  0:00:00
Requirement already satisfied: jinja2==3.1.6 in /home/docs/checkouts/readthedocs.org/user_builds/anyscale-ray/envs/master/lib/python3.11/site-packages (from -r doc/requirements-doc.lock.txt (line 520)) (3.1.6)
Collecting jmespath==1.1.0 (from -r doc/requirements-doc.lock.txt (line 528))
  Downloading jmespath-1.1.0-py3-none-any.whl (20 kB)
Collecting jsonpointer==3.1.1 (from -r doc/requirements-doc.lock.txt (line 534))
  Downloading jsonpointer-3.1.1-py3-none-any.whl (7.7 kB)
Collecting jsonschema==4.26.0 (from -r doc/requirements-doc.lock.txt (line 538))
  Downloading jsonschema-4.26.0-py3-none-any.whl (90 kB)
Collecting jsonschema-specifications==2025.9.1 (from -r doc/requirements-doc.lock.txt (line 544))
  Downloading jsonschema_specifications-2025.9.1-py3-none-any.whl (18 kB)
Collecting jupyter-cache==1.0.1 (from -r doc/requirements-doc.lock.txt (line 548))
  Downloading jupyter_cache-1.0.1-py3-none-any.whl (33 kB)
Collecting jupyter-client==8.9.1 (from -r doc/requirements-doc.lock.txt (line 552))
  Downloading jupyter_client-8.9.1-py3-none-any.whl (109 kB)
Collecting jupyter-core==5.9.1 (from -r doc/requirements-doc.lock.txt (line 558))
  Downloading jupyter_core-5.9.1-py3-none-any.whl (29 kB)
Collecting jupytext==1.15.2 (from -r doc/requirements-doc.lock.txt (line 566))
  Downloading jupytext-1.15.2-py3-none-any.whl (307 kB)
Collecting keras==3.14.1 (from -r doc/requirements-doc.lock.txt (line 570))
  Downloading keras-3.14.1-py3-none-any.whl (1.6 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1.6/1.6 MB 266.2 MB/s  0:00:00
Collecting libclang==18.1.1 (from -r doc/requirements-doc.lock.txt (line 574))
  Downloading libclang-18.1.1-py2.py3-none-manylinux2010_x86_64.whl (24.5 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 24.5/24.5 MB 251.2 MB/s  0:00:00
Collecting markdown==3.10.2 (from -r doc/requirements-doc.lock.txt (line 586))
  Downloading markdown-3.10.2-py3-none-any.whl (108 kB)
Collecting markdown-it-py==4.2.0 (from -r doc/requirements-doc.lock.txt (line 590))
  Downloading markdown_it_py-4.2.0-py3-none-any.whl (91 kB)
Requirement already satisfied: markupsafe==3.0.3 in /home/docs/checkouts/readthedocs.org/user_builds/anyscale-ray/envs/master/lib/python3.11/site-packages (from -r doc/requirements-doc.lock.txt (line 598)) (3.0.3)
Collecting matplotlib-inline==0.2.2 (from -r doc/requirements-doc.lock.txt (line 691))
  Downloading matplotlib_inline-0.2.2-py3-none-any.whl (9.5 kB)
Collecting mdit-py-plugins==0.6.1 (from -r doc/requirements-doc.lock.txt (line 697))
  Downloading mdit_py_plugins-0.6.1-py3-none-any.whl (66 kB)
Collecting mdurl==0.1.2 (from -r doc/requirements-doc.lock.txt (line 703))
  Downloading mdurl-0.1.2-py3-none-any.whl (10.0 kB)
Collecting ml-dtypes==0.5.4 (from -r doc/requirements-doc.lock.txt (line 707))
  Downloading ml_dtypes-0.5.4-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (5.0 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 5.0/5.0 MB 202.3 MB/s  0:00:00
Collecting myst-nb==1.4.0 (from -r doc/requirements-doc.lock.txt (line 750))
  Downloading myst_nb-1.4.0-py3-none-any.whl (82 kB)
Collecting myst-parser==5.1.0 (from -r doc/requirements-doc.lock.txt (line 754))
  Downloading myst_parser-5.1.0-py3-none-any.whl (85 kB)
Collecting namex==0.1.0 (from -r doc/requirements-doc.lock.txt (line 760))
  Downloading namex-0.1.0-py3-none-any.whl (5.9 kB)
Collecting nbclient==0.11.0 (from -r doc/requirements-doc.lock.txt (line 764))
  Downloading nbclient-0.11.0-py3-none-any.whl (25 kB)
Collecting nbformat==5.10.4 (from -r doc/requirements-doc.lock.txt (line 770))
  Downloading nbformat-5.10.4-py3-none-any.whl (78 kB)
Collecting nest-asyncio2==1.7.2 (from -r doc/requirements-doc.lock.txt (line 778))
  Downloading nest_asyncio2-1.7.2-py3-none-any.whl (7.8 kB)
Collecting numpy==2.4.6 (from -r doc/requirements-doc.lock.txt (line 782))
  Downloading numpy-2.4.6-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (16.9 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 16.9/16.9 MB 425.3 MB/s  0:00:00
Collecting opt-einsum==3.4.0 (from -r doc/requirements-doc.lock.txt (line 861))
  Downloading opt_einsum-3.4.0-py3-none-any.whl (71 kB)
Collecting optree==0.19.1 (from -r doc/requirements-doc.lock.txt (line 865))
  Downloading optree-0.19.1-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (447 kB)
Requirement already satisfied: packaging==26.2 in /home/docs/checkouts/readthedocs.org/user_builds/anyscale-ray/envs/master/lib/python3.11/site-packages (from -r doc/requirements-doc.lock.txt (line 965)) (26.2)
Collecting parso==0.8.7 (from -r doc/requirements-doc.lock.txt (line 976))
  Downloading parso-0.8.7-py2.py3-none-any.whl (107 kB)
Collecting pexpect==4.9.0 (from -r doc/requirements-doc.lock.txt (line 980))
  Downloading pexpect-4.9.0-py2.py3-none-any.whl (63 kB)
Collecting pillow==12.2.0 (from -r doc/requirements-doc.lock.txt (line 984))
  Downloading pillow-12.2.0-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (7.1 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 7.1/7.1 MB 519.8 MB/s  0:00:00
Collecting platformdirs==4.10.0 (from -r doc/requirements-doc.lock.txt (line 1077))
  Downloading platformdirs-4.10.0-py3-none-any.whl (22 kB)
Collecting prompt-toolkit==3.0.52 (from -r doc/requirements-doc.lock.txt (line 1081))
  Downloading prompt_toolkit-3.0.52-py3-none-any.whl (391 kB)
Collecting protobuf==7.35.0 (from -r doc/requirements-doc.lock.txt (line 1085))
  Downloading protobuf-7.35.0-cp310-abi3-manylinux2014_x86_64.whl (327 kB)
Collecting psutil==7.2.2 (from -r doc/requirements-doc.lock.txt (line 1097))
  Downloading psutil-7.2.2-cp36-abi3-manylinux2010_x86_64.manylinux_2_12_x86_64.manylinux_2_28_x86_64.whl (155 kB)
Collecting ptyprocess==0.7.0 (from -r doc/requirements-doc.lock.txt (line 1122))
  Downloading ptyprocess-0.7.0-py2.py3-none-any.whl (13 kB)
Collecting pure-eval==0.2.3 (from -r doc/requirements-doc.lock.txt (line 1126))
  Downloading pure_eval-0.2.3-py3-none-any.whl (11 kB)
Collecting pyarrow==19.0.1 (from -r doc/requirements-doc.lock.txt (line 1130))
  Downloading pyarrow-19.0.1-cp311-cp311-manylinux_2_28_x86_64.whl (42.1 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 42.1/42.1 MB 146.7 MB/s  0:00:00
Collecting pydantic==2.12.4 (from -r doc/requirements-doc.lock.txt (line 1174))
  Downloading pydantic-2.12.4-py3-none-any.whl (463 kB)
Collecting pydantic-core==2.41.5 (from -r doc/requirements-doc.lock.txt (line 1181))
  Downloading pydantic_core-2.41.5-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.1 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 2.1/2.1 MB 160.6 MB/s  0:00:00
Collecting pydantic-settings==2.14.1 (from -r doc/requirements-doc.lock.txt (line 1304))
  Downloading pydantic_settings-2.14.1-py3-none-any.whl (60 kB)
Collecting pydata-sphinx-theme==0.18.0 (from -r doc/requirements-doc.lock.txt (line 1308))
  Downloading pydata_sphinx_theme-0.18.0-py3-none-any.whl (6.2 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 6.2/6.2 MB 242.8 MB/s  0:00:00
Collecting pygments==2.18.0 (from -r doc/requirements-doc.lock.txt (line 1312))
  Downloading pygments-2.18.0-py3-none-any.whl (1.2 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1.2/1.2 MB 994.7 MB/s  0:00:00
Collecting python-dateutil==2.9.0.post0 (from -r doc/requirements-doc.lock.txt (line 1323))
  Downloading python_dateutil-2.9.0.post0-py2.py3-none-any.whl (229 kB)
Collecting python-dotenv==1.2.2 (from -r doc/requirements-doc.lock.txt (line 1329))
  Downloading python_dotenv-1.2.2-py3-none-any.whl (22 kB)
Collecting pyyaml==6.0.3 (from -r doc/requirements-doc.lock.txt (line 1333))
  Downloading pyyaml-6.0.3-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (806 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 806.6/806.6 kB 982.0 MB/s  0:00:00
Collecting pyzmq==27.1.0 (from -r doc/requirements-doc.lock.txt (line 1414))
  Downloading pyzmq-27.1.0-cp311-cp311-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl (857 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 857.0/857.0 kB 950.1 MB/s  0:00:00
Collecting referencing==0.37.0 (from -r doc/requirements-doc.lock.txt (line 1510))
  Downloading referencing-0.37.0-py3-none-any.whl (26 kB)
Collecting requests==2.32.5 (from -r doc/requirements-doc.lock.txt (line 1516))
  Downloading requests-2.32.5-py3-none-any.whl (64 kB)
Collecting rich==15.0.0 (from -r doc/requirements-doc.lock.txt (line 1524))
  Downloading rich-15.0.0-py3-none-any.whl (310 kB)
Requirement already satisfied: roman-numerals==4.1.0 in /home/docs/checkouts/readthedocs.org/user_builds/anyscale-ray/envs/master/lib/python3.11/site-packages (from -r doc/requirements-doc.lock.txt (line 1528)) (4.1.0)
Collecting roman-numerals-py==4.1.0 (from -r doc/requirements-doc.lock.txt (line 1532))
  Downloading roman_numerals_py-4.1.0-py3-none-any.whl (4.5 kB)
Collecting rpds-py==2026.5.1 (from -r doc/requirements-doc.lock.txt (line 1536))
  Downloading rpds_py-2026.5.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (378 kB)
Collecting s3transfer==0.10.4 (from -r doc/requirements-doc.lock.txt (line 1670))
  Downloading s3transfer-0.10.4-py3-none-any.whl (83 kB)
Collecting setuptools==80.9.0 (from -r doc/requirements-doc.lock.txt (line 1674))
  Downloading setuptools-80.9.0-py3-none-any.whl (1.2 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1.2/1.2 MB 675.8 MB/s  0:00:00
Collecting six==1.17.0 (from -r doc/requirements-doc.lock.txt (line 1681))
  Downloading six-1.17.0-py2.py3-none-any.whl (11 kB)
Collecting smmap==5.0.3 (from -r doc/requirements-doc.lock.txt (line 1690))
  Downloading smmap-5.0.3-py3-none-any.whl (24 kB)
Requirement already satisfied: snowballstemmer==3.1.1 in /home/docs/checkouts/readthedocs.org/user_builds/anyscale-ray/envs/master/lib/python3.11/site-packages (from -r doc/requirements-doc.lock.txt (line 1694)) (3.1.1)
Collecting soupsieve==2.8.4 (from -r doc/requirements-doc.lock.txt (line 1698))
  Downloading soupsieve-2.8.4-py3-none-any.whl (37 kB)
Collecting sphinx==8.2.3 (from -r doc/requirements-doc.lock.txt (line 1702))
  Downloading sphinx-8.2.3-py3-none-any.whl (3.6 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 3.6/3.6 MB 191.5 MB/s  0:00:00
Collecting sphinx-autobuild==2024.4.16 (from -r doc/requirements-doc.lock.txt (line 1723))
  Downloading sphinx_autobuild-2024.4.16-py3-none-any.whl (11 kB)
Collecting sphinx-click==5.1.0 (from -r doc/requirements-doc.lock.txt (line 1727))
  Downloading sphinx_click-5.1.0-py3-none-any.whl (9.7 kB)
Collecting sphinx-collections==0.3.1 (from -r doc/requirements-doc.lock.txt (line 1731))
  Downloading sphinx_collections-0.3.1-py3-none-any.whl (16 kB)
Collecting sphinx-copybutton==0.5.2 (from -r doc/requirements-doc.lock.txt (line 1735))
  Downloading sphinx_copybutton-0.5.2-py3-none-any.whl (13 kB)
Collecting sphinx-design==0.7.0 (from -r doc/requirements-doc.lock.txt (line 1739))
  Downloading sphinx_design-0.7.0-py3-none-any.whl (2.2 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 2.2/2.2 MB 161.2 MB/s  0:00:00
Collecting sphinx-docsearch==0.3.0 (from -r doc/requirements-doc.lock.txt (line 1743))
  Downloading sphinx_docsearch-0.3.0-py3-none-any.whl (141 kB)
Collecting sphinx-jsonschema==1.19.2 (from -r doc/requirements-doc.lock.txt (line 1747))
  Downloading sphinx_jsonschema-1.19.2.tar.gz (30 kB)
  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'
  Preparing metadata (pyproject.toml): started
  Preparing metadata (pyproject.toml): finished with status 'done'
Collecting sphinx-last-updated-by-git==0.3.8 (from -r doc/requirements-doc.lock.txt (line 1750))
  Downloading sphinx_last_updated_by_git-0.3.8-py3-none-any.whl (8.6 kB)
Collecting sphinx-llms-txt==0.7.1 (from -r doc/requirements-doc.lock.txt (line 1754))
  Downloading sphinx_llms_txt-0.7.1-py3-none-any.whl (22 kB)
Collecting sphinx-remove-toctrees==0.0.3 (from -r doc/requirements-doc.lock.txt (line 1758))
  Downloading sphinx_remove_toctrees-0.0.3-py3-none-any.whl (4.7 kB)
Collecting sphinx-sitemap==2.9.0 (from -r doc/requirements-doc.lock.txt (line 1762))
  Downloading sphinx_sitemap-2.9.0-py3-none-any.whl (6.2 kB)
Requirement already satisfied: sphinxcontrib-applehelp==2.0.0 in /home/docs/checkouts/readthedocs.org/user_builds/anyscale-ray/envs/master/lib/python3.11/site-packages (from -r doc/requirements-doc.lock.txt (line 1766)) (2.0.0)
Requirement already satisfied: sphinxcontrib-devhelp==2.0.0 in /home/docs/checkouts/readthedocs.org/user_builds/anyscale-ray/envs/master/lib/python3.11/site-packages (from -r doc/requirements-doc.lock.txt (line 1770)) (2.0.0)
Requirement already satisfied: sphinxcontrib-htmlhelp==2.1.0 in /home/docs/checkouts/readthedocs.org/user_builds/anyscale-ray/envs/master/lib/python3.11/site-packages (from -r doc/requirements-doc.lock.txt (line 1774)) (2.1.0)
Requirement already satisfied: sphinxcontrib-jsmath==1.0.1 in /home/docs/checkouts/readthedocs.org/user_builds/anyscale-ray/envs/master/lib/python3.11/site-packages (from -r doc/requirements-doc.lock.txt (line 1778)) (1.0.1)
Requirement already satisfied: sphinxcontrib-qthelp==2.0.0 in /home/docs/checkouts/readthedocs.org/user_builds/anyscale-ray/envs/master/lib/python3.11/site-packages (from -r doc/requirements-doc.lock.txt (line 1782)) (2.0.0)
Collecting sphinxcontrib-redoc==1.6.0 (from -r doc/requirements-doc.lock.txt (line 1786))
  Downloading sphinxcontrib-redoc-1.6.0.tar.gz (350 kB)
  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'
Requirement already satisfied: sphinxcontrib-serializinghtml==2.0.0 in /home/docs/checkouts/readthedocs.org/user_builds/anyscale-ray/envs/master/lib/python3.11/site-packages (from -r doc/requirements-doc.lock.txt (line 1789)) (2.0.0)
Collecting sphinxemoji==0.3.2 (from -r doc/requirements-doc.lock.txt (line 1793))
  Downloading sphinxemoji-0.3.2-py3-none-any.whl (45 kB)
Collecting sphinxext-opengraph==0.13.0 (from -r doc/requirements-doc.lock.txt (line 1797))
  Downloading sphinxext_opengraph-0.13.0-py3-none-any.whl (1.0 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1.0/1.0 MB 984.0 MB/s  0:00:00
Collecting sqlalchemy==2.0.50 (from -r doc/requirements-doc.lock.txt (line 1801))
  Downloading sqlalchemy-2.0.50-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (3.3 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 3.3/3.3 MB 333.9 MB/s  0:00:00
Collecting stack-data==0.6.3 (from -r doc/requirements-doc.lock.txt (line 1861))
  Downloading stack_data-0.6.3-py3-none-any.whl (24 kB)
Collecting starlette==1.2.1 (from -r doc/requirements-doc.lock.txt (line 1865))
  Downloading starlette-1.2.1-py3-none-any.whl (73 kB)
Collecting tabulate==0.10.0 (from -r doc/requirements-doc.lock.txt (line 1869))
  Downloading tabulate-0.10.0-py3-none-any.whl (39 kB)
Collecting tensorboard==2.20.0 (from -r doc/requirements-doc.lock.txt (line 1873))
  Downloading tensorboard-2.20.0-py3-none-any.whl (5.5 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 5.5/5.5 MB 591.7 MB/s  0:00:00
Collecting tensorboard-data-server==0.7.2 (from -r doc/requirements-doc.lock.txt (line 1876))
  Downloading tensorboard_data_server-0.7.2-py3-none-manylinux_2_31_x86_64.whl (6.6 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 6.6/6.6 MB 644.9 MB/s  0:00:00
Collecting tensorflow==2.20.0 (from -r doc/requirements-doc.lock.txt (line 1881))
  Downloading tensorflow-2.20.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (620.6 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 620.6/620.6 MB 203.5 MB/s  0:00:03
Collecting termcolor==3.3.0 (from -r doc/requirements-doc.lock.txt (line 1905))
  Downloading termcolor-3.3.0-py3-none-any.whl (7.7 kB)
Collecting tf-keras==2.20.1 (from -r doc/requirements-doc.lock.txt (line 1909))
  Downloading tf_keras-2.20.1-py3-none-any.whl (1.7 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1.7/1.7 MB 295.2 MB/s  0:00:00
Collecting toml==0.10.2 (from -r doc/requirements-doc.lock.txt (line 1913))
  Downloading toml-0.10.2-py2.py3-none-any.whl (16 kB)
Collecting tornado==6.5.7 (from -r doc/requirements-doc.lock.txt (line 1917))
  Downloading tornado-6.5.7-cp39-abi3-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl (449 kB)
Collecting traitlets==5.15.1 (from -r doc/requirements-doc.lock.txt (line 1931))
  Downloading traitlets-5.15.1-py3-none-any.whl (85 kB)
Collecting typing-extensions==4.15.0 (from -r doc/requirements-doc.lock.txt (line 1942))
  Downloading typing_extensions-4.15.0-py3-none-any.whl (44 kB)
Collecting typing-inspection==0.4.2 (from -r doc/requirements-doc.lock.txt (line 1961))
  Downloading typing_inspection-0.4.2-py3-none-any.whl (14 kB)
Collecting urllib3==1.26.20 (from -r doc/requirements-doc.lock.txt (line 1967))
  Downloading urllib3-1.26.20-py2.py3-none-any.whl (144 kB)
Collecting uvicorn==0.49.0 (from -r doc/requirements-doc.lock.txt (line 1974))
  Downloading uvicorn-0.49.0-py3-none-any.whl (71 kB)
Collecting watchfiles==1.2.0 (from -r doc/requirements-doc.lock.txt (line 1978))
  Downloading watchfiles-1.2.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (456 kB)
Collecting wcwidth==0.8.1 (from -r doc/requirements-doc.lock.txt (line 2087))
  Downloading wcwidth-0.8.1-py3-none-any.whl (323 kB)
Collecting websockets==16.0 (from -r doc/requirements-doc.lock.txt (line 2091))
  Downloading websockets-16.0-cp311-cp311-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl (184 kB)
Collecting werkzeug==3.1.8 (from -r doc/requirements-doc.lock.txt (line 2154))
  Downloading werkzeug-3.1.8-py3-none-any.whl (226 kB)
Collecting wheel==0.47.0 (from -r doc/requirements-doc.lock.txt (line 2158))
  Downloading wheel-0.47.0-py3-none-any.whl (32 kB)
Collecting wrapt==2.2.1 (from -r doc/requirements-doc.lock.txt (line 2162))
  Downloading wrapt-2.2.1-cp311-cp311-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl (159 kB)
Collecting xmltodict==0.13.0 (from -r doc/requirements-doc.lock.txt (line 2254))
  Downloading xmltodict-0.13.0-py2.py3-none-any.whl (10.0 kB)
Collecting zipp==4.1.0 (from -r doc/requirements-doc.lock.txt (line 2258))
  Downloading zipp-4.1.0-py3-none-any.whl (10 kB)
Building wheels for collected packages: sphinx-jsonschema, sphinxcontrib-redoc
  Building wheel for sphinx-jsonschema (pyproject.toml): started
  Building wheel for sphinx-jsonschema (pyproject.toml): finished with status 'done'
  Created wheel for sphinx-jsonschema: filename=sphinx_jsonschema-1.19.2-py3-none-any.whl size=27877 sha256=8fc47f6690c31e1d090bbd213488da8c0ddd55744bf88bcb21faab09783fadb0
  Stored in directory: /tmp/pip-ephem-wheel-cache-4tr2_nww/wheels/ba/c0/f7/4c4fe0e65cd03c0887c1d7bef4c7ed0036c8e102ed6f757a18
  Building wheel for sphinxcontrib-redoc (pyproject.toml): started
  Building wheel for sphinxcontrib-redoc (pyproject.toml): finished with status 'done'
  Created wheel for sphinxcontrib-redoc: filename=sphinxcontrib_redoc-1.6.0-py3-none-any.whl size=299648 sha256=539163c7a889186edc6fe106459e3c56b7bd0227566b0e3dae49b51ca41579a5
  Stored in directory: /tmp/pip-ephem-wheel-cache-4tr2_nww/wheels/a1/90/66/d015c821e6e8b2de75d210826c4983325ebb344834965e8730
Successfully built sphinx-jsonschema sphinxcontrib-redoc
Installing collected packages: pure-eval, ptyprocess, namex, libclang, flatbuffers, fastjsonschema, zipp, xmltodict, wrapt, wheel, werkzeug, websockets, wcwidth, urllib3, typing-extensions, traitlets, tornado, toml, termcolor, tensorboard-data-server, tabulate, soupsieve, smmap, six, setuptools, rpds-py, roman-numerals-py, pyzmq, pyyaml, python-dotenv, pygments, pyarrow, psutil, protobuf, platformdirs, pillow, pexpect, parso, opt-einsum, numpy, nest-asyncio2, mdurl, markdown, jsonpointer, jmespath, h11, greenlet, gast, executing, docutils, decorator, debugpy, comm, colorama, click, certifi, attrs, asttokens, appnope, annotated-types, absl-py, uvicorn, typing-inspection, stack-data, sqlalchemy, requests, referencing, python-dateutil, pydantic-core, prompt-toolkit, optree, ml-dtypes, matplotlib-inline, markdown-it-py, jupyter-core, jedi, ipython-pygments-lexers, importlib-metadata, h5py, grpcio, google-pasta, gitdb, beautifulsoup4, astunparse, anyio, accessible-pygments, watchfiles, tensorboard, starlette, sphinx-jsonschema, sphinx, rich, pydantic, mdit-py-plugins, jupyter-client, jsonschema-specifications, ipython, gitpython, botocore, sphinxext-opengraph, sphinxemoji, sphinx-remove-toctrees, sphinx-llms-txt, sphinx-last-updated-by-git, sphinx-docsearch, sphinx-design, sphinx-copybutton, sphinx-collections, sphinx-click, sphinx-autobuild, s3transfer, pydata-sphinx-theme, pydantic-settings, myst-parser, keras, jsonschema, ipykernel, tensorflow, sphinxcontrib-redoc, sphinx-sitemap, nbformat, boto3, autodoc-pydantic, tf-keras, nbclient, jupytext, jupyter-cache, myst-nb
  Attempting uninstall: wheel
    Found existing installation: wheel 0.40.0
    Uninstalling wheel-0.40.0:
      Successfully uninstalled wheel-0.40.0
  Attempting uninstall: urllib3
    Found existing installation: urllib3 2.7.0
    Uninstalling urllib3-2.7.0:
      Successfully uninstalled urllib3-2.7.0
  Attempting uninstall: setuptools
    Found existing installation: setuptools 82.0.1
    Uninstalling setuptools-82.0.1:
      Successfully uninstalled setuptools-82.0.1
  Attempting uninstall: pygments
    Found existing installation: Pygments 2.20.0
    Uninstalling Pygments-2.20.0:
      Successfully uninstalled Pygments-2.20.0
  Attempting uninstall: docutils
    Found existing installation: docutils 0.22.4
    Uninstalling docutils-0.22.4:
      Successfully uninstalled docutils-0.22.4
  Attempting uninstall: certifi
    Found existing installation: certifi 2026.6.17
    Uninstalling certifi-2026.6.17:
      Successfully uninstalled certifi-2026.6.17
  Attempting uninstall: requests
    Found existing installation: requests 2.34.2
    Uninstalling requests-2.34.2:
      Successfully uninstalled requests-2.34.2
  Attempting uninstall: sphinx
    Found existing installation: Sphinx 9.0.4
    Uninstalling Sphinx-9.0.4:
      Successfully uninstalled Sphinx-9.0.4

Successfully installed absl-py-2.4.0 accessible-pygments-0.0.5 annotated-types-0.7.0 anyio-4.13.0 appnope-0.1.4 asttokens-3.0.1 astunparse-1.6.3 attrs-26.1.0 autodoc-pydantic-2.2.0 beautifulsoup4-4.15.0 boto3-1.34.69 botocore-1.34.162 certifi-2026.5.20 click-8.1.7 colorama-0.4.6 comm-0.2.3 debugpy-1.8.21 decorator-5.3.1 docutils-0.21.2 executing-2.2.1 fastjsonschema-2.21.2 flatbuffers-25.12.19 gast-0.7.0 gitdb-4.0.12 gitpython-3.1.50 google-pasta-0.2.0 greenlet-3.5.1 grpcio-1.81.0 h11-0.16.0 h5py-3.16.0 importlib-metadata-9.0.0 ipykernel-7.3.0 ipython-9.14.1 ipython-pygments-lexers-1.1.1 jedi-0.20.0 jmespath-1.1.0 jsonpointer-3.1.1 jsonschema-4.26.0 jsonschema-specifications-2025.9.1 jupyter-cache-1.0.1 jupyter-client-8.9.1 jupyter-core-5.9.1 jupytext-1.15.2 keras-3.14.1 libclang-18.1.1 markdown-3.10.2 markdown-it-py-4.2.0 matplotlib-inline-0.2.2 mdit-py-plugins-0.6.1 mdurl-0.1.2 ml-dtypes-0.5.4 myst-nb-1.4.0 myst-parser-5.1.0 namex-0.1.0 nbclient-0.11.0 nbformat-5.10.4 nest-asyncio2-1.7.2 numpy-2.4.6 opt-einsum-3.4.0 optree-0.19.1 parso-0.8.7 pexpect-4.9.0 pillow-12.2.0 platformdirs-4.10.0 prompt-toolkit-3.0.52 protobuf-7.35.0 psutil-7.2.2 ptyprocess-0.7.0 pure-eval-0.2.3 pyarrow-19.0.1 pydantic-2.12.4 pydantic-core-2.41.5 pydantic-settings-2.14.1 pydata-sphinx-theme-0.18.0 pygments-2.18.0 python-dateutil-2.9.0.post0 python-dotenv-1.2.2 pyyaml-6.0.3 pyzmq-27.1.0 referencing-0.37.0 requests-2.32.5 rich-15.0.0 roman-numerals-py-4.1.0 rpds-py-2026.5.1 s3transfer-0.10.4 setuptools-80.9.0 six-1.17.0 smmap-5.0.3 soupsieve-2.8.4 sphinx-8.2.3 sphinx-autobuild-2024.4.16 sphinx-click-5.1.0 sphinx-collections-0.3.1 sphinx-copybutton-0.5.2 sphinx-design-0.7.0 sphinx-docsearch-0.3.0 sphinx-jsonschema-1.19.2 sphinx-last-updated-by-git-0.3.8 sphinx-llms-txt-0.7.1 sphinx-remove-toctrees-0.0.3 sphinx-sitemap-2.9.0 sphinxcontrib-redoc-1.6.0 sphinxemoji-0.3.2 sphinxext-opengraph-0.13.0 sqlalchemy-2.0.50 stack-data-0.6.3 starlette-1.2.1 tabulate-0.10.0 tensorboard-2.20.0 tensorboard-data-server-0.7.2 tensorflow-2.20.0 termcolor-3.3.0 tf-keras-2.20.1 toml-0.10.2 tornado-6.5.7 traitlets-5.15.1 typing-extensions-4.15.0 typing-inspection-0.4.2 urllib3-1.26.20 uvicorn-0.49.0 watchfiles-1.2.0 wcwidth-0.8.1 websockets-16.0 werkzeug-3.1.8 wheel-0.47.0 wrapt-2.2.1 xmltodict-0.13.0 zipp-4.1.0

[rtd-command-info] start-time: 2026-06-23T22:35:03.729265Z, end-time: 2026-06-23T22:35:03.773386Z, duration: 0, exit-code: 0
cat doc/source/conf.py
import io
import json
import logging
import os
import pathlib
import random
import re
import sys
import time
import zipfile
from datetime import datetime
from dataclasses import is_dataclass
from importlib import import_module
from typing import Any, Dict
from urllib.error import HTTPError, URLError
from urllib.request import urlopen

import sphinx
from docutils import nodes
from jinja2.filters import FILTERS
from sphinx.ext.autosummary import generate
from sphinx.util.inspect import safe_getattr
from sphinx.util.matching import compile_matchers

DEFAULT_API_GROUP = "Others"

logger = logging.getLogger(__name__)

sys.path.insert(0, os.path.abspath("."))
from custom_directives import (  # noqa
    DownloadAndPreprocessEcosystemDocs,
    update_context,
    LinkcheckSummarizer,
    parse_navbar_config,
    setup_context,
    pregenerate_example_rsts,
    generate_versions_json,
    collect_example_orphans,
)

# If extensions (or modules to document with autodoc) are in another directory,
# add these directories to sys.path here. If the directory is relative to the
# documentation root, use os.path.abspath to make it absolute, like shown here.
assert not os.path.exists(
    "../../python/ray/_raylet.so"
), "_raylet.so should not be imported for the purpose for doc build, please rename the file to _raylet.so.bak and try again."
sys.path.insert(0, os.path.abspath("../../python/"))

# -- General configuration ------------------------------------------------

# This setting controls how single backticks are handled by sphinx. Developers
# are used to using single backticks for code, but RST syntax requires that code
# code to be denoted with _double_ backticks.
# Here we make sphinx treat single backticks as code also, because everyone is
# used to using single backticks as is done with markdown; without this setting,
# lots of documentation ends up getting committed with single backticks anyway,
# so we might as well make it work as developers intend for it to.
default_role = "code"

sys.path.append(os.path.abspath("./_ext"))

extensions = [
    "callouts",  # custom extension from _ext folder
    "queryparamrefs",
    "sphinx.ext.autodoc",
    "sphinx.ext.viewcode",
    "sphinx.ext.napoleon",
    "sphinx_click.ext",
    "sphinx-jsonschema",
    "sphinxemoji.sphinxemoji",
    "sphinx_copybutton",
    "sphinx_sitemap",
    "myst_nb",
    "sphinx.ext.doctest",
    "sphinx.ext.coverage",
    "sphinx.ext.autosummary",
    "sphinxcontrib.autodoc_pydantic",
    "sphinxcontrib.redoc",
    "sphinx_remove_toctrees",
    "sphinx_design",
    "sphinx.ext.intersphinx",
    "sphinx_docsearch",
    "sphinx_collections",
    "sphinx_llms_txt",
    "sphinxext.opengraph",
]

# -- sphinx-llms-txt: agent-friendly summary and full corpus -----------

llms_txt_summary = (
    "Ray is an open-source unified compute framework for scaling AI and "
    "Python workloads, including data processing, model training, model "
    "serving, hyperparameter tuning, and reinforcement learning. The full "
    "documentation lives at https://docs.ray.io/."
)

# Filter low-signal pages from llms-full.txt. Auto-generated API reference
# pages (one per public class/method) are excluded because they would
# dominate the corpus with autodoc boilerplate. Mirrors the directories in
# `remove_from_toctrees` below. Agents needing specific API details can
# fetch per-page markdown twins via Read the Docs' Markdown for Agents
# content negotiation. Tuning of this list is tracked separately.
llms_txt_exclude = [
    "search",
    "genindex",
    "404",
    "_TableOfContents",
    "cluster/running-applications/job-submission/doc/*",
    "ray-observability/reference/doc/*",
    "ray-core/api/doc/*",
    "data/api/doc/*",
    "train/api/doc/*",
    "tune/api/doc/*",
    "serve/api/doc/*",
    "rllib/package_ref/*",
]

# Exclude Jupyter notebooks from llms-full.txt. sphinx-llms-txt reads each
# docname's source verbatim from `_sources/`, so for `.ipynb` pages it
# appends raw notebook JSON (cells, outputs, embedded base64 images) into
# the corpus. `llms_txt_exclude` matches docnames (extension stripped) via
# fnmatch, so a `**/*.ipynb` pattern can't work — we enumerate each
# notebook's docname instead. Notebooks remain fully rendered in the HTML
# build; only the agent corpus drops them.
_conf_dir = pathlib.Path(__file__).parent
llms_txt_exclude += sorted(
    p.relative_to(_conf_dir).with_suffix("").as_posix()
    for p in _conf_dir.rglob("*.ipynb")
)

# -- sphinx-collections: pull external template files at build time -----------

_TEMPLATES_CI_BASE = "https://templates.ci.ray.io"
_TEMPLATE_CHANNEL_API = _TEMPLATES_CI_BASE + "/templates/{name}/latest/channel.json"

# Hard timeouts on the templates.ci.ray.io HTTP calls. The doc build previously
# stalled when the templates host was slow or unresponsive (#63112 revert);
# explicit timeouts let urlopen surface a TimeoutError instead of hanging
# indefinitely so the per-template error handler in `_fetch_and_extract_zip`
# can log a warning and continue with the remaining templates.
_TEMPLATE_CHANNEL_TIMEOUT_S = 30
_TEMPLATE_DOWNLOAD_TIMEOUT_S = 90

# Retry policy for the templates.ci.ray.io HTTP calls. Many doc builds can run
# concurrently against the same endpoint (PR previews + branch builds); under
# that load the host returns transient errors (HTTP 5xx/429, connection resets,
# read timeouts). A single urlopen with no retry would drop the template, and
# since every template is wired into a toctree that broken ref fails the whole
# build under `fail_on_warning`. Retry with exponential backoff plus full random
# jitter so the retry bursts from many concurrent builds don't re-synchronize
# and hammer the endpoint in lockstep.
_TEMPLATE_FETCH_ATTEMPTS = 3
_TEMPLATE_RETRY_BASE_S = 1.0


def _urlopen_read_with_retries(url, timeout):
    """Fetch `url` and return its body bytes, retrying transient failures.

    Retries cover both the connection and the body read (a slow `read()` under
    load can itself time out). Only transient conditions are retried — a 4xx
    other than 429 won't fix itself, so it's raised immediately. After the
    final attempt the last exception propagates to the caller's handler, which
    preserves the existing per-template skip semantics.
    """
    last_exc = None
    for attempt in range(_TEMPLATE_FETCH_ATTEMPTS):
        try:
            with urlopen(url, timeout=timeout) as resp:
                return resp.read()
        except HTTPError as exc:
            last_exc = exc
            # HTTPError is a subclass of URLError, so it must be caught first.
            # Don't retry deterministic client errors (4xx except 429).
            if exc.code != 429 and not (500 <= exc.code < 600):
                raise
        except (URLError, TimeoutError, OSError) as exc:
            # URLError wraps DNS/refused/connection-reset; TimeoutError is the
            # urlopen/read timeout; OSError covers lower-level socket errors.
            last_exc = exc
        if attempt < _TEMPLATE_FETCH_ATTEMPTS - 1:
            base = _TEMPLATE_RETRY_BASE_S * (2 ** attempt)
            delay = base + random.uniform(0, base)  # full jitter on the delay
            logger.info(
                "sphinx-collections: retrying %s in %.1fs "
                "(attempt %d/%d) after: %s",
                url,
                delay,
                attempt + 1,
                _TEMPLATE_FETCH_ATTEMPTS,
                last_exc,
            )
            time.sleep(delay)
    raise last_exc

_TEMPLATE_COLLECTIONS = {
    "asynchronous_inference": {
        "target": "serve/tutorials/asynchronous-inference",
    },
    "audio-dataset-curation-llm-judge": {
        "target": "ray-overview/examples/e2e-audio",
    },
    "deepspeed_finetune": {
        "target": "train/examples/pytorch/deepspeed_finetune",
    },
    "deployment-serve-llm": {
        "target": "serve/tutorials/deployment-serve-llm",
    },
    "distributing-pytorch": {
        "target": "train/examples/pytorch/distributing-pytorch",
    },
    "e2e-rag-deepdive": {
        "target": "ray-overview/examples/e2e-rag",
    },
    "e2e-timeseries-forecasting": {
        "target": "ray-overview/examples/e2e-timeseries",
    },
    "entity-recognition-with-llms": {
        "target": "ray-overview/examples/entity-recognition-with-llms",
    },
    "image-search-and-classification": {
        "target": "ray-overview/examples/e2e-multimodal-ai-workloads",
    },
    "llm_batch_inference_text": {
        "target": "data/examples/llm_batch_inference_text",
    },
    "llm_batch_inference_vision": {
        "target": "data/examples/llm_batch_inference_vision",
    },
    "langchain-agent-ray-serve": {
        "target": "ray-overview/examples/langchain_agent_ray_serve/content",
    },
    "llm_finetuning": {
        "target": "ray-overview/examples/llamafactory-llm-fine-tune",
    },
    "multi_agent_a2a": {
        "target": "ray-overview/examples/multi_agent_a2a",
    },
    "mcp-ray-serve": {
        "target": "ray-overview/examples/mcp-ray-serve",
    },
    "model-composition-recsys": {
        "target": "serve/tutorials/model-composition-recsys",
    },
    "model-multiplexing": {
        "target": "serve/tutorials/model_multiplexing_forecast",
    },
    "object-detection-video-processing": {
        "target": "ray-overview/examples/object-detection",
    },
    "ray_train_workloads": {
        "target": "train/tutorials",
    },
    "pytorch-fsdp": {
        "target": "train/examples/pytorch/pytorch-fsdp",
    },
    "pytorch-profiling": {
        "target": "train/examples/pytorch/pytorch-profiling",
    },
    "tensor_parallel_autotp": {
        "target": "train/examples/pytorch/tensor_parallel_autotp",
    },
    "tensor_parallel_dtensor": {
        "target": "train/examples/pytorch/tensor_parallel_dtensor",
    },
    "tune_pytorch_asha": {
        "target": "tune/examples/tune_pytorch_asha",
    },
    "unstructured_data_ingestion": {
        "target": "data/examples/unstructured_data_ingestion",
    },
    "xgboost-training-and-serving": {
        "target": "ray-overview/examples/e2e-xgboost",
    },
}


def _resolve_template_url(name):
    """Fetch the build zip URL for a template from the channel API."""
    api_url = _TEMPLATE_CHANNEL_API.format(name=name)
    logger.info("sphinx-collections: resolving template URL from %s", api_url)
    data = json.loads(
        _urlopen_read_with_retries(api_url, _TEMPLATE_CHANNEL_TIMEOUT_S)
    )
    url = data["url"]
    # Replace the ascommon:/// protocol with the templates.ci.ray.io base URL.
    url = url.replace("ascommon:///", _TEMPLATES_CI_BASE + "/")
    # Append /build.zip to get the docs build archive.
    url = url.rstrip("/") + "/build.zip"
    logger.info("sphinx-collections: resolved URL %s", url)
    return url


def _fetch_and_extract_zip(config):
    """Download a zip archive and extract it into the collection target directory.

    Failures fetching, downloading, or extracting an individual template are
    logged as warnings and the target directory is cleared, so a single bad
    template doesn't abort the entire doc build. Pages that depended on the
    skipped template will surface as broken refs at build time and can be
    triaged independently.
    """
    import shutil

    name = config["name"]
    target = pathlib.Path(config["target"])
    try:
        url = _resolve_template_url(name)
        if target.is_dir():
            shutil.rmtree(target)
        target.mkdir(parents=True, exist_ok=True)
        logger.info("sphinx-collections: downloading %s -> %s", url, target)
        zip_bytes = io.BytesIO(
            _urlopen_read_with_retries(url, _TEMPLATE_DOWNLOAD_TIMEOUT_S)
        )
        with zipfile.ZipFile(zip_bytes) as zf:
            zf.extractall(target)
        logger.info(
            "sphinx-collections: extracted %d files to %s",
            len(zf.namelist()),
            target,
        )
    except Exception as exc:
        logger.warning(
            "sphinx-collections: skipping template %r — fetch/extract failed: %s",
            name,
            exc,
        )
        # Leave any partial state out of the build tree so downstream sphinx
        # passes don't trip over a half-extracted archive.
        if target.is_dir():
            shutil.rmtree(target, ignore_errors=True)


collections = {
    name: {
        "driver": "function",
        "source": _fetch_and_extract_zip,
        "target": coll["target"],
        "clean": False,
        "final_clean": False,
        "write_result": False,
    }
    for name, coll in _TEMPLATE_COLLECTIONS.items()
}

# Don't wipe the target before build — other docs may co-exist in parent dirs.
collections_clean = True
# Clean up collected files after build so they don't get committed.
collections_final_clean = True

# The collections config contains a function reference (for the "function" driver)
# which Sphinx cannot pickle for caching. This is harmless — suppress the warning
# so it doesn't cause a build failure under -W (warnings-as-errors).
suppress_warnings = [
    "config.cache",
    # sphinxcontrib-redoc (unmaintained, 1.6.0) redundantly copies its bundled
    # redoc.js asset; Sphinx 8's new copy_overwrite check flags the second copy over
    # the existing (identical) file. Benign and not fixable upstream.
    "misc.copy_overwrite",
]
# Disable autodoc_pydantic features that can produce empty raw directives
# (e.g. when schema JSON fails for models with non-serializable fields)
autodoc_pydantic_model_show_json = False

# Configuration for algolia
# Note: This API key grants read access to our indexes and is intended to be public.
# See https://www.algolia.com/doc/guides/security/api-keys/ for more information.
docsearch_app_id = "LBHF0PABBL"
docsearch_api_key = "6c42f30d9669d8e42f6fc92f44028596"
docsearch_index_name = "docs-ray"

remove_from_toctrees = [
    "cluster/running-applications/job-submission/doc/*",
    "ray-observability/reference/doc/*",
    "ray-core/api/doc/*",
    "data/api/doc/*",
    "train/api/doc/*",
    "tune/api/doc/*",
    "serve/api/doc/*",
    "rllib/package_ref/algorithm/*",
    "rllib/package_ref/policy/*",
    "rllib/package_ref/models/*",
    "rllib/package_ref/catalogs/*",
    "rllib/package_ref/rl_modules/*",
    "rllib/package_ref/learner/*",
    "rllib/package_ref/evaluation/*",
    "rllib/package_ref/replay-buffers/*",
    "rllib/package_ref/utils/*",
]

myst_enable_extensions = [
    "dollarmath",
    "amsmath",
    "deflist",
    "html_admonition",
    "html_image",
    "colon_fence",
    "smartquotes",
    "replacements",
]

myst_heading_anchors = 3

# Add these for attachment handling
nb_render_key_pairs = {
    "html": [
        ("img", ["src", "alt"]),
    ]
}

nb_output_folder = "_build/jupyter_execute"

# Make broken internal references into build time errors.
# See https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-nitpicky
# for more information. :py:class: references are ignored due to false positives
# arising from type annotations. See https://github.com/ray-project/ray/pull/46103
# for additional context.
nitpicky = True
nitpick_ignore_regex = [
    ("py:obj", "ray.actor.T"),
    ("py:obj", "ray.data.aggregate.AccumulatorType"),
    ("py:obj", "ray.data.aggregate.SupportsRichComparisonType"),
    ("py:obj", "ray.data.aggregate.AggOutputType"),
    ("py:class", ".*"),
    # Workaround for https://github.com/sphinx-doc/sphinx/issues/10974
    ("py:obj", "ray\\.data\\.datasource\\.datasink\\.WriteReturnType"),
    # UnknownPreprocessorError is an internal exception not exported in public API
    ("py:exc", "UnknownPreprocessorError"),
    ("py:exc", "ray\\.data\\.preprocessors\\.version_support\\.UnknownPreprocessorError"),
    # TypeVar for gRPCInputStream generic type
    ("py:obj", "ray\\.serve\\.grpc_util\\.T"),
    # autodoc_pydantic generates invalid py:obj refs for pydantic v2 validators
    # (e.g. "all fields", "_validate_*" references in validator docstrings)
    ("py:obj", r"ray\.serve\.config\.\w+\.all fields"),
    ("py:obj", r"ray\.serve\.config\.GangSchedulingConfig\._validate_runtime_failure_policy"),
    ("py:obj", r"ray\.serve\.schema\.\w+\.all fields"),
    # autodoc_pydantic also emits invalid field refs for these dashboard job models.
    ("py:obj", r"ray\.dashboard\.modules\.job\.pydantic_models\.(DriverInfo|JobDetails)\.\w+"),
]

# Cache notebook outputs in _build/.jupyter_cache
# To prevent notebook execution, set this to "off". To force re-execution, set this to
# "force". To cache previous runs, set this to "cache".
nb_execution_mode = os.getenv("RUN_NOTEBOOKS", "off")

# Add a render priority for doctest
nb_mime_priority_overrides = [
    ("html", "application/vnd.jupyter.widget-view+json", 10),
    ("html", "application/javascript", 20),
    ("html", "text/html", 30),
    ("html", "image/svg+xml", 40),
    ("html", "image/png", 50),
    ("html", "image/jpeg", 60),
    ("html", "text/markdown", 70),
    ("html", "text/latex", 80),
    ("html", "text/plain", 90),
]

html_extra_path = ["robots.txt"]

html_baseurl = "https://docs.ray.io/en/latest/"

# `html_baseurl` already encodes `/en/latest/`, so override sphinx-sitemap's
# default `{lang}{version}{link}` scheme to just `{link}`. Otherwise the
# extension prepends `en/` again, producing URLs like `en/latesten/<page>`.
sitemap_url_scheme = "{link}"

# sphinxext-opengraph: emit Open Graph metadata per page. Pin `ogp_site_url`
# to `html_baseurl` so the `og:url` tag tracks the same canonical URL as
# Sphinx's `<link rel="canonical">`. If `ogp_site_url` were left unset, the
# extension would fall back to Read the Docs' `READTHEDOCS_CANONICAL_URL`
# env var (set by RtD's Addons framework from the project's "Canonical
# version" admin setting), which can diverge from `html_baseurl`. Per-page
# `:og:description:` and `:og:image:` can still be set in individual files.
ogp_site_url = html_baseurl

# This pattern matches:
# - Python Repl prompts (">>> ") and it's continuation ("... ")
# - Bash prompts ("$ ")
# - IPython prompts ("In []: ", "In [999]: ") and it's continuations
#   ("  ...: ", "     : ")
copybutton_prompt_text = r">>> |\.\.\. |\$ |In \[\d*\]: | {2,5}\.\.\.: | {5,8}: "
copybutton_prompt_is_regexp = True

# Ignore divs with class="no-copybutton"
copybutton_selector = "div:not(.no-copybutton) > div.highlight > pre"

# By default, tabs can be closed by selecting an open tab. We disable this
# functionality with the `sphinx_tabs_disable_tab_closing` option.
sphinx_tabs_disable_tab_closing = True

# Special mocking of packaging.version.Version is required when using sphinx;
# we can't just add this to autodoc_mock_imports, as packaging is imported by
# sphinx even before it can be mocked. Instead, we patch it here.
import packaging.version as packaging_version  # noqa

Version = packaging_version.Version


class MockVersion(Version):
    def __init__(self, version: str):
        if isinstance(version, (str, bytes)):
            super().__init__(version)
        else:
            super().__init__("0")


packaging_version.Version = MockVersion

# Add any paths that contain templates here, relative to this directory.
templates_path = ["_templates"]

# The master toctree document.
master_doc = "index"

# General information about the project.
project = "Ray"
copyright = str(datetime.now().year) + ", The Ray Team"
author = "The Ray Team"

# The version info for the project you're documenting acts as replacement for
# |version| and |release|, and is also used in various other places throughout the
# built documents. Retrieve the version using `find_version` rather than importing
# directly (from ray import __version__) because initializing ray will prevent
# mocking of certain external dependencies.
from setup import find_version  # noqa

release = find_version("ray", "_version.py")

language = "en"

# autogen files are only used to auto-generate public API documentation.
# They are not included in the toctree to avoid warnings such as documents not included
# in any toctree.
autogen_files = [
    "data/api/_autogen.rst",
]

# List of patterns, relative to source directory, that match files and
# directories to ignore when looking for source files.
# Also helps resolve warnings about documents not included in any toctree.
exclude_patterns = [
    "templates/*",
    "cluster/running-applications/doc/ray.*",
    "data/api/ray.data.*.rst",
    # Hide README.md used for display on the console (anyscale templates)
    "serve/tutorials/**/content/**README.md",
    "data/examples/**/content/**README.md",
    "ray-overview/examples/**/content/**README.md",
    "ray-core/examples/**/content/**README.md",
    "train/examples/**/content/**README.md",
    "tune/examples/**/content/**README.md",
    # Other misc files (overviews, console-only examples, etc)
    "serve/tutorials/video-analysis/*.ipynb",
    # Legacy/backward compatibility
    "ray-overview/examples/**/README.md",
    "train/examples/**/README.md",
    "_collections/serve/tutorials/deployment-serve-llm/README.*",
    "_collections/serve/tutorials/deployment-serve-llm/*.ipynb",
    "_collections/serve/tutorials/deployment-serve-llm/**/*.ipynb",
    # Each template ships README.md + README.ipynb at the same docname; keep
    # only the .md and exclude the duplicate .ipynb at the template root and
    # in any sub-template directories. The template root README.md is the
    # actual content page that toctrees / examples.yml refer to.
    *[
        pattern
        for coll in _TEMPLATE_COLLECTIONS.values()
        for pattern in (
            f"_collections/{coll['target']}/README.ipynb",
            f"_collections/{coll['target']}/**/README.ipynb",
        )
    ],
    # ray_train_workloads bundles sub-folder READMEs that aren't part of any
    # toctree (only the notebooks are). Exclude them to avoid orphan warnings.
    # Keep the root README.* — train.rst's toctree and tutorials button both
    # link to /_collections/train/tutorials/README.
    "_collections/train/tutorials/*/README.*",  # one-level sidecars (getting-started, workload-patterns)
    "_collections/train/tutorials/*/**/README.*",  # deeper sidecars, if any
    # Sidecar README.md files in fetched template dirs duplicate the canonical
    # notebook that the gallery / toctree already links to. Exclude to avoid
    # orphan warnings without losing reachable content.
    "_collections/serve/tutorials/asynchronous-inference/README.md",
    "_collections/tune/examples/tune_pytorch_asha/README.md",
    # llamafactory: master excludes the in-tree paths only, but this branch
    # also pulls a copy via sphinx-collections (see _TEMPLATE_COLLECTIONS).
    # Mirror the in-tree patterns under _collections/ so the fetched copy
    # is suppressed too. The template has no landing page on docs.ray.io.
    "_collections/ray-overview/examples/llamafactory-llm-fine-tune/README.*",
    "_collections/ray-overview/examples/llamafactory-llm-fine-tune/**/*.ipynb",
] + autogen_files

# If "DOC_LIB" is found, only build that top-level navigation item.
build_one_lib = os.getenv("DOC_LIB")

all_toc_libs = [
    f.path.strip("./") for f in os.scandir(".") if f.is_dir() and "ray-" in f.path
]
all_toc_libs += [
    "cluster",
    "tune",
    "data",
    "train",
    "rllib",
    "serve",
    "llm",
    "workflows",
]
if build_one_lib and build_one_lib in all_toc_libs:
    all_toc_libs.remove(build_one_lib)
    exclude_patterns += all_toc_libs


# If true, `todo` and `todoList` produce output, else they produce nothing.
todo_include_todos = False

# Do not check anchors for links because it produces many false positives
# and is slow (it needs to download the linked website).
linkcheck_anchors = False

if os.environ.get("LINKCHECK_ALL"):
    # Only check external links, i.e. the ones starting with http:// or https://.
    linkcheck_ignore = [
        r"^((?!http).)*$",  # exclude links not starting with http
        "http://ala2017.it.nuigalway.ie/papers/ALA2017_Gupta.pdf",  # broken
        "https://mvnrepository.com/artifact/*",  # working but somehow not with linkcheck
        # This should be fixed -- is temporal the successor of cadence? Do the examples need to be updated?
        "https://github.com/serverlessworkflow/specification/blob/main/comparisons/comparison-cadence.md",
        "https://www.oracle.com/java/technologies/javase-jdk15-downloads.html",  # forbidden for client
        "https://speakerdeck.com/*",  # forbidden for bots
        r"https://huggingface.co/*",  # seems to be flaky
        r"https://www.meetup.com/*",  # seems to be flaky
        r"https://www.pettingzoo.ml/*",  # seems to be flaky
        r"http://localhost[:/].*",  # Ignore localhost links
        r"^http:/$",  # Ignore incomplete links
        # 403 Client Error: Forbidden for url.
        # They ratelimit bots.
        "https://www.datanami.com/2018/02/01/rays-new-library-targets-high-speed-reinforcement-learning/",
        # 403 Client Error: Forbidden for url.
        # They ratelimit bots.
        "https://www.researchgate.net/publication/222573328_Stochastic_Gradient_Boosting",
        "https://www.datanami.com/2019/11/05/why-every-python-developer-will-love-ray/",
        "https://dev.mysql.com/doc/connector-python/en/",
        # Returning 522s intermittently.
        "https://lczero.org/",
        # Returns 406 but remains accessible
        "https://www.uber.com/blog/elastic-xgboost-ray/",
        # Aggressive anti-bot checks
        "https://archive.vn/*",
        "https://archive.is/*",
        # 429: Rate limited
        "https://medium.com/*",
        "https://towardsdatascience.com/*",
    ]
else:
    # Only check links that point to the ray-project org on github, since those
    # links are under our control and therefore much more likely to be real
    # issues that we need to fix if they are broken.
    linkcheck_ignore = [
        r"^(?!https://(raw\.githubusercontent|github)\.com/ray-project/).*$"
    ]


# -- Options for HTML output ----------------------------------------------
def render_svg_logo(path):
    with open(pathlib.Path(__file__).parent / path, "r") as f:
        content = f.read()

    return content


# The theme to use for HTML and HTML Help pages.  See the documentation for
# a list of builtin themes.
html_theme = "pydata_sphinx_theme"

# Theme options are theme-specific and customize the look and feel of a theme
# further.  For a list of options available for each theme, see the
# documentation.
html_theme_options = {
    "use_edit_page_button": True,
    "announcement": """Try Ray with $100 credit — <a target="_blank" href="https://console.anyscale.com/register/ha?render_flow=ray&utm_source=ray_docs&utm_medium=docs&utm_campaign=banner">Start now</a><button type="button" id="close-banner" aria-label="Close banner">&times;</button>""",
    "logo": {
        "svg": render_svg_logo("_static/img/ray_logo.svg"),
    },
    "navbar_start": ["navbar-ray-logo"],
    "navbar_end": [
        "theme-switcher",
        "version-switcher",
        "navbar-icon-links",
        "navbar-anyscale",
    ],
    "navbar_center": ["navbar-links"],
    "navbar_align": "left",
    "secondary_sidebar_items": [
        "page-toc",
        "edit-on-github",
    ],
    "content_footer_items": [
        "csat",
    ],
    "navigation_depth": 4,
    "pygments_light_style": "stata-dark",
    "pygments_dark_style": "stata-dark",
    "switcher": {
        "json_url": "https://docs.ray.io/en/master/_static/versions.json",
        "version_match": os.getenv("READTHEDOCS_VERSION", "master"),
    },
}

html_context = {
    "github_user": "ray-project",
    "github_repo": "ray",
    "github_version": "master",
    "doc_path": "doc/source/",
}

html_sidebars = {
    "**": [
        (
            "main-sidebar-readthedocs"
            if os.getenv("READTHEDOCS") == "True"
            else "main-sidebar"
        )
    ],
    "ray-overview/examples": [],
}

# The name for this set of Sphinx documents.  If None, it defaults to
# "<project> v<release> documentation".
html_title = f"Ray {release}"

autodoc_typehints_format = "short"

# The name of an image file (within the static path) to use as favicon of the
# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
# pixels large.
html_favicon = "_static/favicon.ico"

# 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,
# so a file named "default.css" will overwrite the builtin "default.css".
html_static_path = ["_static"]


# Output file base name for HTML help builder.
htmlhelp_basename = "Raydoc"

# -- 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',
}

latex_documents = [
    (master_doc, "Ray.tex", "Ray Documentation", author, "manual"),
]

# -- Options for manual page output ---------------------------------------

man_pages = [(master_doc, "ray", "Ray Documentation", [author], 1)]

# -- Options for Texinfo output -------------------------------------------
texinfo_documents = [
    (
        master_doc,
        "Ray",
        "Ray Documentation",
        author,
        "Ray",
        "Ray provides a simple, universal API for building distributed applications.",
        "Miscellaneous",
    ),
]

# Python methods should be presented in source code order
autodoc_member_order = "bysource"

# Better typehint formatting (see custom.css)
autodoc_typehints = "signature"


def filter_out_undoc_class_members(member_name, class_name, module_name):
    module = import_module(module_name)
    cls = getattr(module, class_name)
    if getattr(cls, member_name).__doc__:
        return f"~{class_name}.{member_name}"
    else:
        return ""


def has_public_constructor(class_name, module_name):
    cls = getattr(import_module(module_name), class_name)
    return _is_public_api(cls)


def get_api_groups(method_names, class_name, module_name):
    api_groups = set()
    cls = getattr(import_module(module_name), class_name)
    for method_name in method_names:
        method = getattr(cls, method_name)
        if _is_public_api(method):
            api_groups.add(
                safe_getattr(method, "_annotated_api_group", DEFAULT_API_GROUP)
            )

    return sorted(api_groups)


def select_api_group(method_names, class_name, module_name, api_group):
    cls = getattr(import_module(module_name), class_name)
    return [
        method_name
        for method_name in method_names
        if _is_public_api(getattr(cls, method_name))
        and _is_api_group(getattr(cls, method_name), api_group)
    ]


def _is_public_api(obj):
    api_type = safe_getattr(obj, "_annotated_type", None)
    if not api_type:
        return False
    return api_type.value == "PublicAPI"


def _is_api_group(obj, group):
    return safe_getattr(obj, "_annotated_api_group", DEFAULT_API_GROUP) == group


FILTERS["filter_out_undoc_class_members"] = filter_out_undoc_class_members
FILTERS["get_api_groups"] = get_api_groups
FILTERS["select_api_group"] = select_api_group
FILTERS["has_public_constructor"] = has_public_constructor


def add_custom_assets(
    app: sphinx.application.Sphinx,
    pagename: str,
    templatename: str,
    context: Dict[str, Any],
    doctree: nodes.Node,
):
    """Add custom per-page assets.

    See documentation on Sphinx Core Events for more information:
    https://www.sphinx-doc.org/en/master/extdev/appapi.html#sphinx-core-events
    """
    if pagename == "index":
        app.add_css_file("css/index.css")
        app.add_js_file("js/index.js")
        return "index.html"  # Use the special index.html template for this page

    if pagename == "ray-overview/examples":
        app.add_css_file("css/examples.css")
        app.add_js_file("js/examples.js")
        return "ray-overview/examples.html"

    if pagename in [
        "data/examples",
        "train/examples",
        "serve/examples",
    ]:
        return "examples.html"

    if pagename == "train/train":
        app.add_css_file("css/ray-train.css")
    elif pagename == "ray-overview/ray-libraries":
        app.add_css_file("css/ray-libraries.css")
    elif pagename == "ray-overview/use-cases":
        app.add_css_file("css/use_cases.css")


def _autogen_apis(app: sphinx.application.Sphinx):
    """
    Auto-generate public API documentation.
    """
    try:
        generate.generate_autosummary_docs(
            [os.path.join(app.srcdir, file) for file in autogen_files],
            app=app,
        )
    except Exception as e:
        import warnings
        warnings.warn(f"Skipping autogen due to: {e}")


def process_signature(app, what, name, obj, options, signature, return_annotation):
    # Sphinx is unable to render dataclass with factory/`field`
    # https://github.com/sphinx-doc/sphinx/issues/10893
    if what == "class" and is_dataclass(obj):
        return signature.replace("<factory>", "..."), return_annotation


def setup(app):
    # Only generate versions JSON during RTD build
    if os.getenv("READTHEDOCS") == "True":
        generate_versions_json()

    pregenerate_example_rsts(app)

    # NOTE: 'MOCK' is a custom option we introduced to illustrate mock outputs. Since
    # `doctest` doesn't support this flag by default, `sphinx.ext.doctest` raises
    # warnings when we build the documentation.
    import doctest

    doctest.register_optionflag("MOCK")
    app.connect("html-page-context", update_context)

    app.add_config_value("navbar_content_path", "navbar.yml", "env")
    app.connect("config-inited", parse_navbar_config)
    app.connect("html-page-context", setup_context)
    app.connect("html-page-context", add_custom_assets)

    # https://github.com/ines/termynal
    app.add_js_file("js/termynal.js", defer="defer")
    app.add_css_file("css/termynal.css")

    app.add_js_file("js/custom.js", defer="defer")
    app.add_css_file("css/custom.css", priority=800)

    app.add_js_file("js/csat.js", defer="defer")
    app.add_css_file("css/csat.css")

    app.add_js_file("js/dismissable-banner.js", defer="defer")
    app.add_css_file("css/dismissable-banner.css")

    base_path = pathlib.Path(__file__).parent
    github_docs = DownloadAndPreprocessEcosystemDocs(base_path)
    # Download docs from ecosystem library repos
    app.connect("builder-inited", github_docs.write_new_docs)
    # Restore original file content after build
    app.connect("build-finished", github_docs.write_original_docs)

    # Hook into the logger used by linkcheck to display a summary at the end.
    linkcheck_summarizer = LinkcheckSummarizer()
    app.connect("builder-inited", linkcheck_summarizer.add_handler_to_linkcheck)
    app.connect("build-finished", linkcheck_summarizer.summarize)

    # Hook into the auto generation of public apis
    app.connect("builder-inited", _autogen_apis)

    app.connect("autodoc-process-signature", process_signature)

    class DuplicateObjectFilter(logging.Filter):
        def filter(self, record):
            # Intentionally allow duplicate object description of ray.actor.ActorMethod.bind:
            # once in Ray Core API and once in Compiled Graph API
            if "duplicate object description of ray.actor.ActorMethod.bind" in record.getMessage():
                return False  # Don't log this specific warning
            return True  # Log all other warnings

    logging.getLogger("sphinx").addFilter(DuplicateObjectFilter())

    class CollectionsFootnoteFilter(logging.Filter):
        # Example notebooks fetched into _collections (from templates.ci.ray.io) contain
        # prose that myst-parser 5.x parses as reST footnote refs/targets, which docutils
        # then flags as errors. That content is external (not in this repo), so it can't
        # be fixed here -- the fix belongs upstream. Drop these specific errors for
        # _collections paths so the fail_on_warning build is not blocked by fetched content.
        # TODO: fix the offending footnote-like text upstream and remove this filter.
        def filter(self, record):
            # INFO/DEBUG records (the bulk of build output) can't be the
            # footnote/target warnings below, so skip getMessage() for them.
            if record.levelno < logging.WARNING:
                return True
            msg = record.getMessage()
            if (
                "autonumbered footnote references" in msg
                or "Unknown target name" in msg
            ):
                location = str(getattr(record, "location", "") or "")
                if "_collections" in location:
                    return False
            return True

    logging.getLogger("sphinx").addFilter(CollectionsFootnoteFilter())

    # Register hook to mark orphan documents
    example_orphan_documents = collect_example_orphans(app.confdir, app.srcdir)
    def mark_orphans(app, docname, _source):
        if docname in example_orphan_documents:
            app.env.metadata.setdefault(docname, {})
            app.env.metadata[docname]["orphan"] = True

    app.connect('source-read', mark_orphans)

    # Fix code-block language tags in _collections markdown files.
    # Notebooks converted to markdown tag Jupyter magic shell commands
    # (e.g. ``!serve run ...``) as ``python`` code blocks, which causes
    # Sphinx highlighting warnings.  Re-tag them as ``ipython3`` so the
    # python parts stay highlighted as python and ``!magic`` / ``%magic``
    # lines render as shell.
    _MAGIC_CODE_BLOCK_RE = re.compile(r"```python\n((?:#[^\n]*\n)*)([!%]\S)")

    def fix_collections_code_blocks(app, docname, source):
        if docname.startswith("_collections/"):
            source[0] = _MAGIC_CODE_BLOCK_RE.sub(r"```ipython3\n\1\2", source[0])

    app.connect('source-read', fix_collections_code_blocks)

    app.add_config_value("ipython3_lexer_patterns", [], "env")
    app.add_config_value("ipython3_lexer_exclude_patterns", [], "env")
    app.connect("config-inited", _compile_pattern_matchers)
    app.connect("source-read", apply_ipython3_lexer)


redoc = [
    {
        "name": "Ray Jobs API",
        "page": "cluster/running-applications/job-submission/api",
        "spec": "cluster/running-applications/job-submission/openapi.yml",
        "embed": True,
    },
]

redoc_uri = "https://cdn.redoc.ly/redoc/latest/bundles/redoc.standalone.js"

autosummary_filename_map = {
    "ray.serve.deployment": "ray.serve.deployment_decorator",
    "ray.serve.Deployment": "ray.serve.Deployment",
}

# Mock out external dependencies here.

autodoc_mock_imports = [
    "aiohttp",
    "async_timeout",
    "backoff",
    "cachetools",
    "comet_ml",
    "composer",
    "cupy",
    "dask",
    "datasets",
    "fastapi",
    "filelock",
    "fsspec",
    "google",
    "grpc",
    "gymnasium",
    "horovod",
    "huggingface",
    "httpx",
    "joblib",
    "lightgbm",
    "lightgbm_ray",
    "mlflow",
    "nevergrad",
    "numpy",
    "pandas",
    "pyarrow",
    "pyarrow.compute",
    "pytorch_lightning",
    "scipy",
    "setproctitle",
    "skimage",
    "sklearn",
    "starlette",
    "tensorflow",
    "torch",
    "torchvision",
    "transformers",
    "tree",
    "typer",
    "uvicorn",
    "wandb",
    "watchfiles",
    "openai",
    "xgboost",
    "xgboost_ray",
    "psutil",
    "colorama",
    "grpc",
    "vllm",
    # Internal compiled modules
    "ray._raylet",
    "ray.core.generated",
    "ray.serve.generated",
]

for mock_target in autodoc_mock_imports:
    if mock_target in sys.modules:
        logger.info(
            f"Potentially problematic mock target ({mock_target}) found; "
            "autodoc_mock_imports cannot mock modules that have already "
            "been loaded into sys.modules when the sphinx build starts."
        )


# Other sphinx docs can be linked to if the appropriate URL to the docs
# is specified in the `intersphinx_mapping` - for example, types annotations
# that are defined in dependencies can link to their respective documentation.
intersphinx_mapping = {
    "aiohttp": ("https://docs.aiohttp.org/en/stable/", None),
    "composer": ("https://docs.mosaicml.com/en/latest/", None),
    "dask": ("https://docs.dask.org/en/stable/", None),
    "datasets": ("https://huggingface.co/docs/datasets/main/en/", None),
    "distributed": ("https://distributed.dask.org/en/stable/", None),
    "grpc": ("https://grpc.github.io/grpc/python/", None),
    "gymnasium": ("https://gymnasium.farama.org/", None),
    "horovod": ("https://horovod.readthedocs.io/en/stable/", None),
    "lightgbm": ("https://lightgbm.readthedocs.io/en/latest/", None),
    "mars": ("https://mars-project.readthedocs.io/en/latest/", None),
    "modin": ("https://modin.readthedocs.io/en/stable/", None),
    "nevergrad": ("https://facebookresearch.github.io/nevergrad/", None),
    "numpy": ("https://numpy.org/doc/stable/", None),
    "pandas": (
        "https://pandas.pydata.org/pandas-docs/stable/",
        "https://github.com/ray-project/pandas/releases/download/object-mirror-0.1.0/objects.inv",
    ),
    "pyarrow": ("https://arrow.apache.org/docs", None),
    "pydantic": ("https://docs.pydantic.dev/latest/", None),
    "pymongoarrow": ("https://mongo-arrow.readthedocs.io/en/latest/", None),
    "pyspark": ("https://spark.apache.org/docs/latest/api/python/", None),
    "python": ("https://docs.python.org/3", None),
    "pytorch_lightning": ("https://lightning.ai/docs/pytorch/stable/", None),
    "scipy": (
        "https://docs.scipy.org/doc/scipy/",
        "https://github.com/ray-project/scipy/releases/download/object-mirror-0.1.0/objects.inv",
    ),
    "sklearn": ("https://scikit-learn.org/stable/", None),
    "tensorflow": (
        "https://www.tensorflow.org/api_docs/python",
        "https://raw.githubusercontent.com/GPflow/tensorflow-intersphinx/master/tf2_py_objects.inv",
    ),
    "torch": (
        "https://docs.pytorch.org/docs/stable/",
        "https://docs.pytorch.org/docs/2.7/objects.inv",
    ),
    "torchvision": ("https://pytorch.org/vision/stable/", None),
    "transformers": ("https://huggingface.co/docs/transformers/main/en/", None),
}

intersphinx_timeout = 15

# Ray must not be imported in conf.py because third party modules initialized by
# `import ray` will no be mocked out correctly. Perform a check here to ensure
# ray is not imported by future maintainers.
assert (
    "ray" not in sys.modules
), "If ray is already imported, we will not render documentation correctly!"

os.environ["RAY_DOC_BUILD"] = "1"

ipython3_lexer_patterns = [
    # External templates fetched by sphinx_collections (see #62179) land here at
    # build time; their notebook JSON has no language_info, so Sphinx defaults
    # to the python3 lexer and chokes on !pip / %magic cells.
    "_collections/**/*.ipynb",
    "ray-overview/examples/**/content/**.ipynb",
    "serve/tutorials/**/content/**.ipynb",
    "data/examples/**/content/**.ipynb",
    "tune/examples/**/content/**.ipynb",
]
ipython3_lexer_exclude_patterns = []


def _compile_pattern_matchers(app, config):
    app.ipython3_lexer_patterns = compile_matchers(
        config.ipython3_lexer_patterns or []
    )
    app.ipython3_lexer_exclude_patterns = compile_matchers(
        config.ipython3_lexer_exclude_patterns or []
    )


def apply_ipython3_lexer(app, docname, source):
    """Force the ipython3 pygments lexer on notebooks matching
    ``ipython3_lexer_patterns`` (minus ``ipython3_lexer_exclude_patterns``).

    Sphinx + myst-nb otherwise default to the python3 lexer, which fails on
    ``!shell`` and ``%magic`` cells and is fatal under Readthedocs ``-W``.
    """
    # Sphinx 8 returns a _StrPath from doc2path; coerce to str so the re-based
    # matchers (compile_matchers) and .endswith below accept it.
    doc_source = str(app.env.doc2path(docname, base=False))
    if not doc_source.endswith(".ipynb"):
        return
    if any(m(doc_source) for m in app.ipython3_lexer_exclude_patterns):
        return
    if not any(m(doc_source) for m in app.ipython3_lexer_patterns):
        return

    notebook = json.loads(source[0])
    lang_info = notebook.setdefault("metadata", {}).setdefault("language_info", {})
    if lang_info.get("pygments_lexer") != "ipython3":
        lang_info["pygments_lexer"] = "ipython3"
        source[0] = json.dumps(notebook, ensure_ascii=False)

[rtd-command-info] start-time: None, end-time: None, duration: None, exit-code: None
python -m sphinx -T -W --keep-going -j auto -b html -d _build/doctrees -D language=en . $READTHEDOCS_OUTPUT/html