.readthedocs.yml

version: 2

sphinx:
  configuration: docs/conf.py

build:
  os: ubuntu-20.04
  tools:
    python: "3.8"
  jobs:
    post_install:
      # https://github.com/pdm-project/pdm/discussions/1365#discussioncomment-3581356
      - env
      - ls -al $READTHEDOCS_VIRTUALENV_PATH
      - python --version
      - python -c "import sys; print(sys.executable)"
      - ls -l $(python -c "import sys; print(sys.executable)")
      # Install PDM in its own isolated environment, so docs deps don't trample its deps
      - curl -sSL https://raw.githubusercontent.com/pdm-project/pdm/main/install-pdm.py | python -
      # TODO export `pdm` on the $PATH?
      - VIRTUAL_ENV=$READTHEDOCS_VIRTUALENV_PATH $HOME/.local/bin/pdm info
      - VIRTUAL_ENV=$READTHEDOCS_VIRTUALENV_PATH $HOME/.local/bin/pdm sync -v -G viz -dG docs