summaryrefslogtreecommitdiff
path: root/.github/workflows/doc.yml
diff options
context:
space:
mode:
Diffstat (limited to '.github/workflows/doc.yml')
-rw-r--r--.github/workflows/doc.yml47
1 files changed, 47 insertions, 0 deletions
diff --git a/.github/workflows/doc.yml b/.github/workflows/doc.yml
new file mode 100644
index 00000000..fe61335a
--- /dev/null
+++ b/.github/workflows/doc.yml
@@ -0,0 +1,47 @@
+# For documentation on GitHub Actions Workflows, see:
+# https://docs.github.com/en/actions/reference/workflow-syntax-for-github-actions
+name: Doc
+
+on:
+ push:
+ branches:
+ - master
+ - 2.0
+ pull_request:
+ branches:
+ - master
+ - 2.0
+
+env:
+ PYTHON_LATEST: 3.9
+
+jobs:
+ ci:
+ strategy:
+ matrix:
+ os: [ubuntu-latest]
+ python-version: [3.9]
+ fail-fast: false
+ runs-on: ${{ matrix.os }}
+ steps:
+ - uses: actions/checkout@v2 # https://github.com/actions/checkout
+ with:
+ # Only a single commit is fetched by default, for the ref/SHA that triggered the workflow.
+ # Set fetch-depth: 0 to fetch all history for all branches and tags.
+ fetch-depth: 0 # Needed for setuptools_scm to work correctly
+ - name: Set up Python
+ uses: actions/setup-python@v2 # https://github.com/actions/setup-python
+ with:
+ python-version: ${{ matrix.python-version }}
+ - name: Cache dependencies
+ id: cache-deps
+ uses: actions/cache@v2 # https://github.com/actions/cache
+ with:
+ path: ~/.cache/pip
+ key: ${{ runner.os }}-pip-${{ matrix.python-version }}-${{ hashFiles('setup.py') }}
+ - name: Install python prerequisites
+ # Only install dependencies when there is a cache miss
+ if: steps.cache-deps.outputs.cache-hit != 'true'
+ run: pip install -U --user pip setuptools setuptools-scm flake8 nox
+ - name: Sphinx documentation build
+ run: python -m nox --non-interactive --session docs # Run nox just for documentation build