aboutsummaryrefslogtreecommitdiff
path: root/.github/workflows/api-docs.yml
blob: 2cecd2af6d7280282c872081f4efb46f3dd86220 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
# Check if any PR needs to run the autogenerate script
name: Autogenerate API docs and types
on:
  pull_request:
    types: [opened, synchronize, reopened, ready_for_review]
    paths:
      - 'src/nvim/api/*.[ch]'
      - 'src/nvim/eval.lua'
      - 'runtime/lua/**.lua'
      - 'runtime/doc/**'

jobs:
  regen-api-docs-and-types:
    runs-on: ubuntu-latest
    if: github.event.pull_request.draft == false
    permissions:
      contents: write
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
      - name: Install dependencies
        run: |
          ./.github/scripts/install_deps.sh
          sudo apt-get install -y doxygen python3-msgpack
      - uses: ./.github/actions/cache

      - name: Generate docs
        run: |
          make doc
          printf 'UPDATED_DOCS=%s\n' $([ -z "$(git diff)" ]; echo $?) >> $GITHUB_OUTPUT

      - name: FAIL, PR has not committed doc changes
        if: ${{ steps.docs.outputs.UPDATED_DOCS != 0 }}
        run: |
          echo "Job failed, run 'make doc' and commit your doc changes."
          echo "The doc generation produces the following changes:"
          git diff --color --exit-code