build_docs.yaml

name: Build Docs
on:
  pull_request:
    types: [opened, synchronize]
  push:
    branches:
      - main
env:
  PYARROW_IGNORE_TIMEZONE: 1
  ALTERYX_OPEN_SRC_UPDATE_CHECKER: False
jobs:
  build_docs:
    name: ${{ matrix.python_version }} Build Docs
    runs-on: ubuntu-latest
    strategy:
      matrix:
        python_version: ["3.9", "3.10", "3.11", "3.12"]
    steps:
      - name: Checkout repository
        uses: actions/checkout@v3
        with:
          ref: ${{ github.event.pull_request.head.ref }}
          repository: ${{ github.event.pull_request.head.repo.full_name }}
      - name: Set up python ${{ matrix.python_version }}
        uses: actions/setup-python@v4
        with:
          python-version: ${{ matrix.python_version }}
          cache: 'pip'
          cache-dependency-path: 'pyproject.toml'
      - uses: actions/cache@v3
        id: cache
        with:
          path: ${{ env.pythonLocation }}
          key: ${{ matrix.python_version }}-lint-${{ env.pythonLocation }}-${{ hashFiles('**/pyproject.toml') }}-v01
      - name: Install apt requirements
        run: |
          sudo apt update
          sudo apt install -y pandoc
          python -m pip install --upgrade pip
      - name: Install woodwork with doc dependencies (not using cache)
        if: steps.cache.outputs.cache-hit != 'true'
        run: |
          python -m pip install ".[docs]"
      - name: Install woodwork with no doc dependencies (using cache)
        if: steps.cache.outputs.cache-hit == 'true'
        run: |
          python -m pip install -e . --no-deps
      - name: Build docs
        run: |
          make -C docs/ html
          ls docs/build/html