Merge pull request #301 from jpgill86/docs-build-test

Add GitHub Actions test for building the docs

.github/workflows/tests.yml

@@ -3,6 +3,53 @@ name: tests
 on: [push, pull_request]
 
 jobs:
+  sphinx-docs:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.7']
+    steps:
+        - name: Set up Python ${{ matrix.python-version }}
+          run: |
+            echo $CONDA/bin >> $GITHUB_PATH  # prioritize conda over system python
+            conda config --add channels conda-forge
+            conda install -y -q python=${{ matrix.python-version }}
+        #     conda create -y -q -n test-environment python=${{ matrix.python-version }}
+        #     source activate test-environment
+
+        - name: Checkout repository
+          uses: actions/checkout@v2
+
+        - name: Install package from repository
+          run: |
+            pip install -e .
+
+        - name: Install extra depenencies
+          run: |
+            conda install -y -q av
+            pip install -r requirements-docs.txt
+
+        - name: Verify Python version
+          run: |
+            which python
+            python --version
+            python -c "import os, sys; assert sys.version_info[:2] == tuple(map(int, '${{ matrix.python-version }}'.split('.')))[:2]"
+
+        - name: List pip packages
+          run: |
+            pip -V
+            pip list
+
+        - name: List conda packages
+          run: |
+            conda env list
+            conda list
+
+        - name: Build docs
+          run: |
+            cd docs
+            make html
+
   test-linux:
     runs-on: ubuntu-latest
     strategy: