config.yml

# See: https://circleci.com/docs/2.0/language-python/

version: 2
jobs:

  build-docs:
    working_directory: ~/repo
    docker:
      - image: cimg/python:3.8

    steps:
      - checkout

      - run:
          name: Install deps for building atari-py
          command: sudo apt-get update && sudo apt-get install -y cmake ffmpeg

      - run:
          name: Install Python dependencies
          command: |
            python3 -m venv venv
            source venv/bin/activate
            pip install --upgrade pip wheel setuptools
            pip install -r site/requirements.txt -r requirements.txt

      - restore_cache:
          keys:
            - cache-data

      - run:
          name: Build site
          no_output_timeout: 30m
          command: |
            # NOTE: blas multithreading behaves badly on circleci
            export OMP_NUM_THREADS=1
            source venv/bin/activate
            # n = nitpicky (broken links), W = warnings as errors,
            # T = full tracebacks, keep-going = run to completion even with errors
            make -C site/ SPHINXOPTS="-nWT --keep-going" html

      - save_cache:
          key: cache-data
          paths:
            - _data

      - store_artifacts:
          path: site/_build/html

      - persist_to_workspace:
          root: site/_build
          paths: html

  deploy-docs:
    working_directory: ~/repo
    docker:
      - image: circleci/python:3.8.5-buster
    steps:
      - checkout

      - attach_workspace:
          at: site/_build

      - run:
          name: install deploy deps
          command : |
            python3 -m pip install --user ghp-import

      - run:
          name: configure git
          command: |
            git config --global user.name "ci-doc-deploy-bot"
            git config --global user.email "ci-doc-deploy-bot@nomail"
            git config --global push.default simple

      - add_ssh_keys:
          fingerprints:
            db:84:df:44:ad:77:d0:aa:2d:81:c9:73:30:9d:21:37

      - run:
          name: deploy to gh-pages
          command: |
            ghp-import -n -f -p -m "[skip ci] docs build of $CIRCLE_SHA1" site/_build/html


workflows:
  version: 2
  build:
    jobs:
      - build-docs
      - deploy-docs:
          requires:
            - build-docs
          filters:
            branches:
              only: main