httomo_docs.yml

name: HTTomo docs

on:
  workflow_dispatch:
  pull_request:
    branches:
      - main
  push:
    branches:
      - main

jobs:
  build-docs-publish:
    runs-on: ubuntu-latest
    defaults:
      run:
        shell: bash -el {0}
    steps:
        - name: Checkout repository code
          uses: actions/checkout@v4

        - name: Setup Python 3.10
          uses: actions/setup-python@v4
          with:
            python-version: '3.10'

        - name: httomo-docs
          uses: conda-incubator/setup-miniconda@v2
          with:
            auto-update-conda: false
            activate-environment: httomo-docs
            environment-file: ./docs/source/doc-conda-requirements.yml

        - name: Install httomo-backends
          run: |
            pip install --no-deps httomo-backends

        - name: Generate full yaml pipelines using directives
          run: |
            python ./docs/source/scripts/yaml_pipelines_generator.py -i ./docs/source/pipelines_full/gpu_pipeline1_directive.yaml -o ./docs/source/pipelines_full/gpu_pipeline1.yaml

        - name: Build docs
          run: sphinx-build -a -E -b html ./docs/source/ ./docs/build/

        - name: Publish docs
          if: github.ref_type == 'tag' || github.ref_name == 'main'
          run: ghp-import -n -p -f ./docs/build
          env:
            GITHUB_TOKEN: ${{ github.token }}