nonebot2/.github/workflows/api_docs.yml

name: Build API Doc

on:
  pull_request:
    types: [ opened, synchronize, reopened ]
    branches: [ master, dev ]

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v2
        with:
          ref: ${{ github.event.pull_request.head.sha }}
          
      - name: Set up Python
        uses: actions/setup-python@v2
        with:
          python-version: 3.8
          architecture: "x64"

      - name: Install Dependences
        run: |
          python -m pip install --upgrade pip
          pip install poetry
          poetry install

      - name: Build Doc
        run: poetry run sphinx-build -M markdown ./docs_build ./build
      
      - name: Copy Files
        run: cp ./build/markdown/*.md ./docs/api/
      
      - run: |
          git config user.name nonebot
          git config user.email nonebot@nonebot.dev
          git add .
          git diff-index --quiet HEAD || git commit -m ":memo: update api docs"
          git remote -vv
          git remote add target ${{github.event.pull_request.head.repo.clone_url}}
          git push target HEAD:${{github.event.pull_request.head.ref}}