.readthedocs.yaml

# Copyright 2021 Agnostiq Inc.
#
# This file is part of Covalent.
#
# Licensed under the Apache License 2.0 (the "License"). A copy of the
# License may be obtained with this software package or at
#
#     https://www.apache.org/licenses/LICENSE-2.0
#
# Use of this file is prohibited except in compliance with the License.
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

# .readthedocs.yml
# Read the Docs configuration file
# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details

# Required
version: 2

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

# Optionally set the version of Python and requirements required to build your docs
python:
  install:
    - requirements: requirements.txt
    - requirements: doc/autodoc_executor_plugins_requirements.txt
    - requirements: doc/requirements.txt
    - method: pip
      path: .
    - method: pip
      path: .
    - method: pip
      path: .

build:
  os: "ubuntu-22.04"
  tools:
    python: "3.8"
  jobs:
    # This for dependency pinning because readthedocs.yml automatically updates all libraries despite being pinned.
    # See: https://github.com/readthedocs/readthedocs.org/issues/9752#issuecomment-1324778813
    post_install:
      # Botocore from AWS executors requrires urllib3<1.27,>=1.25.4
      - pip install urllib3==1.26.6
      # For covalent slurm plugin
      - pip install aiofiles==0.8.0
      - pip list | grep rich