llvm-project

1
name: Release Doxygen
2

3
permissions:
4
  contents: read
5

6
on:
7
  workflow_dispatch:
8
    inputs:
9
      release-version:
10
        description: 'Release Version'
11
        required: true
12
        type: string
13
      upload:
14
        description: 'Upload documentation'
15
        required: false
16
        type: boolean
17

18
  workflow_call:
19
    inputs:
20
      release-version:
21
        description: 'Release Version'
22
        required: true
23
        type: string
24
      upload:
25
        description: 'Upload documentation'
26
        required: false
27
        type: boolean
28

29
jobs:
30
  release-doxygen:
31
    name: Build and Upload Release Doxygen
32
    runs-on: ubuntu-latest
33
    permissions:
34
      contents: write
35
    env:
36
      upload: ${{ inputs.upload && !contains(inputs.release-version, 'rc') }}
37
    steps:
38
      - name: Checkout LLVM
39
        uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
40

41
      - name: Setup Python env
42
        uses: actions/setup-python@v5
43
        with:
44
          cache: 'pip'
45
          cache-dependency-path: './llvm/docs/requirements.txt'
46

47
      - name: Install Dependencies
48
        run: |
49
          sudo apt-get update
50
          sudo apt-get install -y \
51
              doxygen \
52
              graphviz \
53
              python3-github \
54
              ninja-build \
55
              texlive-font-utils
56
          pip3 install --user -r ./llvm/docs/requirements.txt
57

58
      - name: Build Doxygen
59
        run: |
60
          ./llvm/utils/release/build-docs.sh -release "${{ inputs.release-version }}" -no-sphinx
61

62
      - name: Upload Doxygen
63
        if: env.upload
64
        env:
65
          GITHUB_TOKEN: ${{ github.token }}
66
        run: |
67
          ./llvm/utils/release/github-upload-release.py --token "$GITHUB_TOKEN" --release "${{ inputs.release-version }}" --user "${{ github.actor }}" upload --files ./*doxygen*.tar.xz
68