build_docs.yml

# This is a basic workflow to help you get started with Actions

name: Build docs

# Controls when the action will run. Triggers the workflow on push or pull request
# events but only for the master branch
on:
  push:
    branches: [ master ]
    paths: ['docs/**' ]
  workflow_dispatch:

# A workflow run is made up of one or more jobs that can run sequentially or in parallel
jobs:
  # This workflow contains a single job called "build"
  build_docs:
    # The type of runner that the job will run on
    runs-on: ubuntu-latest

    # Steps represent a sequence of tasks that will be executed as part of the job
    steps:
    # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
    - uses: actions/checkout@v2

    - name: Set up Python
      uses: actions/setup-python@v2
      with:
        python-version: '3.10'
    - name: Install dependencies
      run: |
        python -m pip install --upgrade pip
        pip install setuptools wheel sphinx mock numpy numpydoc cython six sphinx_rtd_theme==0.5.2
    - name: Build extensions
      run: |
        cd PYME
        python setup.py build_ext -i
    - name: Build docs
      run: |
        cd docs
        ./gen_api_docs
        make html
        tar -jcf doc_html.tar.bz2 html
    - name: Upload
      env:
        DOCS_USERNAME: ${{ secrets.DOCS_USERNAME }}
        DOCS_PASSWORD: ${{ secrets.DOCS_PASSWORD }}
      run: |
        cd docs
        curl -u "${DOCS_USERNAME}:${DOCS_PASSWORD}" -T doc_html.tar.bz2 https://python-microscopy.org:2078/
    # - name: Artifact
    #   uses: actions/upload-artifact@v1
    #   with:
    #     name: docs_html.tar.bz2
    #     path: docs/doc_html.tar.bz2