build documentation from master and preview from docs

Author: cossatot

.github/workflows/docs.yaml

@@ -0,0 +1,47 @@
+name: docs
+
+on:
+  push:
+    branches: [ master ]
+
+jobs:
+  build-and-deploy:
+    name: build and deploy docs
+    runs-on: ubuntu-latest
+    env:
+      MPLBACKEND: 'Agg'
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python 3.11
+      uses: actions/setup-python@v4
+      with:
+        python-version: 3.11
+
+    - name: Install OQ and dependencies
+      run: |
+        sudo apt-get install -y libspatialindex-dev
+        git clone --depth=1 https://github.com/gem/oq-engine.git
+        cd oq-engine
+        python ./install.py devel
+        cd ..
+        source $HOME/openquake/bin/activate
+        pip install h3
+        pip install -r requirements.txt
+        pip install -e .
+        pip install sphinx furo recommonmark
+
+    - name: Build HTML docs
+      run: |
+        source $HOME/openquake/bin/activate
+        sphinx-build -b html doc_src/source doc_src/build/html
+        touch doc_src/build/html/.nojekyll
+
+    - name: Deploy to GitHub Pages
+      uses: peaceiris/actions-gh-pages@v4
+      with:
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+        publish_branch: gh-pages
+        publish_dir: doc_src/build/html/
+        commit_message: "deploy docs from master"

.github/workflows/docs_preview.yaml

@@ -0,0 +1,48 @@
+name: docs preview
+
+on:
+  push:
+    branches: [ docs ]
+
+jobs:
+  build-and-deploy:
+    name: build and deploy docs preview
+    runs-on: ubuntu-latest
+    env:
+      MPLBACKEND: 'Agg'
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python 3.11
+      uses: actions/setup-python@v4
+      with:
+        python-version: 3.11
+
+    - name: Install OQ and dependencies
+      run: |
+        sudo apt-get install -y libspatialindex-dev
+        git clone --depth=1 https://github.com/gem/oq-engine.git
+        cd oq-engine
+        python ./install.py devel
+        cd ..
+        source $HOME/openquake/bin/activate
+        pip install h3
+        pip install -r requirements.txt
+        pip install -e .
+        pip install sphinx furo recommonmark
+
+    - name: Build HTML docs
+      run: |
+        source $HOME/openquake/bin/activate
+        sphinx-build -b html doc_src/source doc_src/build/html
+        touch doc_src/build/html/.nojekyll
+
+    - name: Deploy preview to gh-pages/preview/docs
+      uses: peaceiris/actions-gh-pages@v4
+      with:
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+        publish_branch: gh-pages
+        publish_dir: doc_src/build/html/
+        destination_dir: preview/docs
+        commit_message: "docs preview from docs branch"

.github/workflows/test.yaml

@@ -0,0 +1,37 @@
+name: tests
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+  schedule:
+    - cron: "0 1 * * *"
+
+jobs:
+  test:
+    name: pytest
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python 3.11
+      uses: actions/setup-python@v4
+      with:
+        python-version: 3.11
+    - name: Install OQ and dependencies
+      run: |
+        sudo apt-get install libspatialindex-dev
+        git clone --depth=1 https://github.com/gem/oq-engine.git
+        cd oq-engine
+        python ./install.py devel
+        cd ..
+        source $HOME/openquake/bin/activate
+        pip install h3
+        pip install -r requirements.txt
+        pip install -e .
+        deactivate
+    - name: Run test with pytest
+      run: |
+        source $HOME/openquake/bin/activate
+        pytest openquake tests -W ignore::UserWarning