weftspace/.github/workflows/docs.yml at main · mOctave/weftspace · GitHub

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
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
name: Documentation

on:
  push:
    branches: ["main"]
  workflow_dispatch:

jobs:
  changed:
    uses: ./.github/workflows/changed.yml

  java:
    needs: changed
    if: ${{ needs.changed.outputs.java == 'true' || needs.changed.outputs.actions == 'true' || needs.changed.outputs.siteindex == 'true' }}
    runs-on: ubuntu-latest
    permissions:
      contents: read
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-java@v4
        with:
          java-version: '17'
          distribution: 'oracle'
      - name: Remove old content
        run: rm -rf ./site/java
      - name: Build site
        run: mvn site
        working-directory: ./java
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
      - name: Upload artifacts
        uses: actions/upload-artifact@v4
        with:
          name: java
          path: ./java/target/site

  python:
    needs: changed
    if: ${{ needs.changed.outputs.python == 'true' || needs.changed.outputs.actions == 'true' || needs.changed.outputs.siteindex == 'true' }}
    runs-on: ubuntu-latest
    permissions:
      contents: read
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: '3.x'
      - name: Install dev dependencies
        run: |
          python -m pip install --upgrade pip
          pip install -e ".[dev]"
        working-directory: ./python
      - name: Build site
        run: pdoc --html weftspace
        working-directory: ./python
      - name: Upload artifacts
        uses: actions/upload-artifact@v4
        with:
          name: python
          path: ./python/html
      - name: Build tests
        run: pdoc -o htmltests/ --html tests
        working-directory: ./python
      - name: Upload test artifacts
        uses: actions/upload-artifact@v4
        with:
          name: python-tests
          path: ./python/htmltests

  # I'm sure there's a better way to handle this, but this should work to
  # prevent merge conflicts and reduce commit count so I'm just going to
  # use it. Feel free to improve it if you want.
  commit-all:
    needs: [java, python]
    if: |
      always() &&
      needs.java.result == 'success' &&
      needs.python.result == 'success'
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      - uses: actions/checkout@v4
      - name: Remove old content
        run: |
          rm -rf ./site/java
          rm -rf ./site/python
          mkdir ./site/python
      - name: Download Java site
        uses: actions/download-artifact@v4
        with:
          name: java
          path: ./site/java
      - name: Download Python site
        uses: actions/download-artifact@v4
        with:
          name: python
          path: ./site/python
      - name: Download Python test site
        uses: actions/download-artifact@v4
        with:
          name: python-tests
          path: ./site/python
      - name: Commit changes
        uses: EndBug/add-and-commit@v9
        with:
          message: 'chore: Update site (Java, Python)'
          default_author: github_actions
          add: ./site/**/*

  commit-java:
    needs: [java, python]
    if: |
      always() &&
      needs.java.result == 'success' &&
      needs.python.result == 'skipped'
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      - uses: actions/checkout@v4
      - name: Remove old content
        run: |
          rm -rf ./site/java
      - name: Download Java site
        uses: actions/download-artifact@v4
        with:
          name: java
          path: ./site/java
      - name: Commit changes
        uses: EndBug/add-and-commit@v9
        with:
          message: 'chore: Update site (Java, Python)'
          default_author: github_actions
          add: ./site/**/*

  commit-python:
    needs: [java, python]
    if: |
      always() &&
      needs.java.result == 'skipped' &&
      needs.python.result == 'success'
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      - uses: actions/checkout@v4
      - name: Remove old content
        run: |
          rm -rf ./site/python
          mkdir ./site/python
      - name: Download Python site
        uses: actions/download-artifact@v4
        with:
          name: python
          path: ./site/python
      - name: Download Python test site
        uses: actions/download-artifact@v4
        with:
          name: python-tests
          path: ./site/python
      - name: Commit changes
        uses: EndBug/add-and-commit@v9
        with:
          message: 'chore: Update site (Java, Python)'
          default_author: github_actions
          add: ./site/**/*