Documentation API description #1857
Workflow file for this run
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| name: Docs | |
| on: [pull_request, workflow_dispatch] | |
| permissions: | |
| contents: write | |
| jobs: | |
| docs: | |
| runs-on: ubuntu-latest | |
| steps: | |
| - uses: actions/checkout@v3 | |
| - uses: actions/setup-python@v3 | |
| - name: Set up Conda Environment | |
| uses: conda-incubator/setup-miniconda@v2 | |
| with: | |
| activate-environment: "pcmdi_metrics_dev" | |
| miniforge-variant: Mambaforge | |
| miniforge-version: latest | |
| environment-file: conda-env/ci.yml | |
| use-mamba: true | |
| mamba-version: "*" | |
| channel-priority: strict | |
| auto-update-conda: true | |
| # Used for refreshing the cache every 24 hours to avoid inconsistencies of package | |
| # versions between the CI pipeline and local installations. | |
| - name: Get Date | |
| id: get-date | |
| run: echo "today=$(/bin/date -u '+%Y%m%d')" >> $GITHUB_OUTPUT | |
| shell: bash | |
| - name: Cache Conda | |
| uses: actions/cache@v3 | |
| with: | |
| path: ${{ env.CONDA }}/envs | |
| key: | |
| conda-${{ runner.os }}--${{ runner.arch }}--${{ | |
| steps.get-date.outputs.today }}-${{ | |
| hashFiles('conda-env/dev.yml') }}-${{ env.CACHE_NUMBER}} | |
| env: | |
| # Increase this value to reset cache if conda/dev.yml has not changed in the workflow | |
| CACHE_NUMBER: 0 | |
| - name: Update environment | |
| run: | |
| mamba env update -n pcmdi_metrics_dev -f conda-env/dev.yml | |
| if: steps.cache.outputs.cache-hit != 'true' | |
| - name: Install pcmdi_metrics | |
| # Source: https://github.com/conda/conda-build/issues/4251#issuecomment-1053460542 | |
| run: | | |
| python -m pip install --no-build-isolation --no-deps -e . | |
| - name: Sphinx build | |
| run: | | |
| sphinx-build docs _build | |
| - name: Deploy | |
| uses: peaceiris/actions-gh-pages@v3 | |
| if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }} | |
| with: | |
| publish_branch: gh-pages | |
| github_token: ${{ secrets.GITHUB_TOKEN }} | |
| publish_dir: _build/ | |
| force_orphan: true |