.readthedocs.yaml

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

version: 2

build:
  os: ubuntu-22.04
  tools:
    # On Python 3.12, pip fails with AttributeError: module 'pkgutil' has no attribute
    # 'ImpImporter', probably because readthedocs provides an old version of pip.
    python: "3.11"
  jobs:
    post_checkout:
      # RTD defaults to a depth of 50 but Toga versioning may require
      # much more git history to accurately determine the SCM version
      - git fetch --unshallow
    pre_build:
      - tox -e docs-lint

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

# Build docs as PDF (other options are epub and htmlzip)
formats:
   - pdf

# Install extras for build - dev is needed to run tox
python:
  install:
  - method: pip
    path: core
    extra_requirements:
      - dev
      - docs