name: api build

on:
    push:
        tags:
          - "v*"
    workflow_dispatch:
      inputs:
        version:
          type: string
          required: true
          description: 'The version to update'

jobs:
    update-api-doc:
        runs-on: ubuntu-latest
        environment: release
        permissions:
          contents: write
          pull-requests: write
          id-token: write
        steps:
          - uses: actions/checkout@v3
    
          - uses: pdm-project/setup-pdm@v4
            name: Setup PDM
            with:
              python-version: 3.9
              cache: true
          - name: Install dependencies
            run: pdm install -dG docs
    
          - name: Remove API Doc
            run: rm -rf docs/source/api

          - name: Build API Doc
            run: |
              pdm run sphinx-apidoc -o docs/source/api hydro_roll -f -e --tocfile index
            shell: bash

          - name: Commit 
            uses: stefanzweifel/git-auto-commit-action@v5
            with:
              branch: master
              commit_message: "chore(docs): update api docs with sphinx-apidoc"