image: python:3.7-alpine

variables:
  PIP_CACHE_DIR: "$CI_PROJECT_DIR/pip-cache"

cache:
  paths:
    - "$CI_PROJECT_DIR/pip-cache"
  key: "$CI_PROJECT_ID"

.install_sphinx:
  before_script:
  - pip install -U sphinx
  - pip install -U sphinx-theme-pd
  - pip install -U reno[sphinx]


test-docs:
  stage: test
  extends:
  - .install_sphinx
  script:
  - sphinx-build -b html docs userdocs
  artifacts:
    paths:
    - userdocs
  only:
  - branches

deploy:
  stage: deploy
  extends:
  - .install_sphinx
  script:
  - sphinx-build -b html docs public
  artifacts:
    paths:
    - public
  only:
  - tags