build_docs.yaml

#
# Copyright 2022 Graviti. Licensed under MIT License.
#

---
name: Build Docs

on: [push, pull_request]

jobs:
  build:
    runs-on: ${{ matrix.os }}
    strategy:
      matrix:
        python-version: [3.8.0]
        os: [ubuntu-20.04]

    steps:
      - uses: actions/checkout@v2

      - name: Set up ruby
        uses: ruby/setup-ruby@v1
        with:
          ruby-version: 2.6
          bundler-cache: true

      - name: Cache python ${{ matrix.python-version }}
        uses: actions/cache@v2
        with:
          path: /opt/hostedtoolcache/Python/${{ matrix.python-version }}
          key: >-
            docs-${{ matrix.os }}-${{ matrix.python-version }}-
            ${{ hashFiles('requirements_docs.txt') }}-
            ${{ hashFiles('requirements.txt') }}

      - name: Set up python ${{ matrix.python-version }}
        uses: actions/setup-python@v2
        with:
          python-version: ${{ matrix.python-version }}

      - name: Install dependencies
        run: |
          pip install -r requirements_docs.txt
          pip install -r requirements.txt

      - name: Build docs
        id: build_docs
        run: python -m sphinx -T -E -d build/doctrees -D language=en docs/source build/html -W