121 lines
4.3 KiB
YAML
121 lines
4.3 KiB
YAML
name: "Docs check"
|
|
# https://github.com/marketplace/actions/sphinx-build
|
|
|
|
on: # Trigger the workflow on push or pull request, but only for the master branch
|
|
push:
|
|
branches: [master, "release/*"]
|
|
pull_request:
|
|
branches: [master, "release/*"]
|
|
|
|
jobs:
|
|
sphinx-check:
|
|
runs-on: ubuntu-20.04
|
|
steps:
|
|
- uses: actions/checkout@v2
|
|
with:
|
|
submodules: true
|
|
# lfs: true
|
|
- uses: ammaraskar/sphinx-action@master
|
|
with:
|
|
# git is required to clone the docs theme
|
|
# before custom requirement are resolved https://github.com/ammaraskar/sphinx-action/issues/16
|
|
pre-build-command: "apt-get update -y && apt-get install -y git pandoc && pip install -r requirements/docs.txt"
|
|
docs-folder: "docs/"
|
|
repo-token: "${{ secrets.GITHUB_TOKEN }}"
|
|
|
|
test-docs:
|
|
runs-on: ubuntu-20.04
|
|
steps:
|
|
- uses: actions/checkout@v2
|
|
with:
|
|
submodules: true
|
|
# lfs: true
|
|
- uses: actions/setup-python@v2
|
|
with:
|
|
python-version: 3.7
|
|
|
|
- name: Weekly reset caching
|
|
run: echo "::set-output name=period::$(python -c 'import time ; days = time.time() / 60 / 60 / 24 ; print(int(days / 7))' 2>&1)"
|
|
id: times
|
|
|
|
# Note: This uses an internal pip API and may not always work
|
|
# https://github.com/actions/cache/blob/master/examples.md#multiple-oss-in-a-workflow
|
|
- name: Cache pip
|
|
uses: actions/cache@v2
|
|
with:
|
|
path: ~/.cache/pip
|
|
key: ${{ runner.os }}-pip-td${{ steps.times.outputs.period }}-${{ hashFiles('requirements.txt') }}
|
|
restore-keys: |
|
|
${{ runner.os }}-pip-td${{ steps.times.outputs.period }}-
|
|
|
|
- name: Install dependencies
|
|
run: |
|
|
sudo apt-get update
|
|
sudo apt-get install -y cmake pandoc
|
|
pip --version
|
|
# remove Horovod from requirements
|
|
python .github/prune-packages.py requirements/extra.txt "horovod"
|
|
# python -m pip install --upgrade --user pip
|
|
pip install --requirement requirements.txt --upgrade-strategy only-if-needed --find-links https://download.pytorch.org/whl/cpu/torch_stable.html --quiet
|
|
pip install --requirement requirements/extra.txt
|
|
pip install --requirement requirements/loggers.txt
|
|
pip install --requirement requirements/docs.txt
|
|
pip list
|
|
shell: bash
|
|
|
|
- name: Test Documentation
|
|
env:
|
|
SPHINX_MOCK_REQUIREMENTS: 0
|
|
working-directory: ./docs
|
|
run: |
|
|
# First run the same pipeline as Read-The-Docs
|
|
make doctest
|
|
make coverage
|
|
|
|
make-docs:
|
|
runs-on: ubuntu-20.04
|
|
steps:
|
|
- uses: actions/checkout@v2
|
|
with:
|
|
submodules: true
|
|
# lfs: true
|
|
- uses: actions/setup-python@v2
|
|
with:
|
|
python-version: 3.7
|
|
|
|
# Note: This uses an internal pip API and may not always work
|
|
# https://github.com/actions/cache/blob/master/examples.md#multiple-oss-in-a-workflow
|
|
- name: Cache pip
|
|
uses: actions/cache@v2
|
|
with:
|
|
path: ~/.cache/pip
|
|
key: ${{ runner.os }}-pip-${{ hashFiles('requirements.txt') }}
|
|
restore-keys: |
|
|
${{ runner.os }}-pip-
|
|
|
|
- name: Install dependencies
|
|
run: |
|
|
sudo apt-get update
|
|
sudo apt-get install -y cmake pandoc
|
|
pip --version
|
|
# pip install --requirement requirements.txt --upgrade-strategy only-if-needed --find-links https://download.pytorch.org/whl/cpu/torch_stable.html --quiet
|
|
pip install --requirement requirements/docs.txt
|
|
# install Texlive, see https://linuxconfig.org/how-to-install-latex-on-ubuntu-20-04-focal-fossa-linux
|
|
sudo apt-get update && sudo apt-get install -y texlive-latex-extra dvipng texlive-pictures
|
|
pip list
|
|
shell: bash
|
|
|
|
- name: Make Documentation
|
|
working-directory: ./docs
|
|
run: |
|
|
# First run the same pipeline as Read-The-Docs
|
|
make html --debug --jobs $(nproc) SPHINXOPTS="-W --keep-going"
|
|
|
|
- name: Upload built docs
|
|
uses: actions/upload-artifact@v2
|
|
with:
|
|
name: docs-results-${{ github.sha }}
|
|
path: docs/build/html/
|
|
# Use always() to always run this step to publish test results when there are test failures
|
|
if: success()
|