Rebuild data model documentation #745
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| name: Rebuild data model documentation | |
| on: | |
| workflow_dispatch: | |
| schedule: | |
| - cron: '17 1 * * *' # 01:17 every night | |
| jobs: | |
| datamodel-doc: | |
| runs-on: ubuntu-latest | |
| if: github.repository == 'AliceO2Group/AliceO2' | |
| steps: | |
| - name: Checkout O2 | |
| uses: actions/checkout@v3 | |
| with: | |
| path: O2 | |
| persist-credentials: false | |
| - name: Checkout O2Physics | |
| uses: actions/checkout@v3 | |
| with: | |
| repository: AliceO2Group/O2Physics | |
| path: O2Physics | |
| persist-credentials: false | |
| - name: Checkout documentation | |
| uses: actions/checkout@v3 | |
| with: | |
| repository: AliceO2Group/analysis-framework | |
| path: analysis-framework | |
| persist-credentials: false | |
| # To push the updated branch, we need a non-shallow clone. | |
| fetch-depth: 0 | |
| - name: Create PR branch in docs | |
| working-directory: analysis-framework | |
| run: | | |
| git config --global user.email 'alibuild@cern.ch' | |
| git config --global user.name 'ALICE Action Bot' | |
| # Overwrite branch, creating a new one based on HEAD | |
| git checkout -B auto-datamodel-doc | |
| - name: Set up Python | |
| uses: actions/setup-python@v2 | |
| with: | |
| python-version: 3.x | |
| - name: Install prerequisites | |
| run: | | |
| python3 -m pip install --user -U numpy nltk | |
| python3 -m nltk.downloader -d ~/nltk_data punkt | |
| python3 -m nltk.downloader -d ~/nltk_data punkt_tab | |
| - name: Generate documentation | |
| run: exec bash -exo pipefail O2/scripts/datamodel-doc/update-datamodel.sh | |
| - name: Send pull request with updated docs | |
| env: | |
| GITHUB_TOKEN: ${{ secrets.ALIBUILD_GITHUB_TOKEN }} | |
| working-directory: analysis-framework/docs/datamodel | |
| run: | | |
| # git diff --quiet exits with 1 if any tracked files have changed, and | |
| # with 0 otherwise. | |
| set -e | |
| if git diff --quiet; then | |
| exit # Nothing has changed, so no need to send a PR. | |
| fi | |
| git add ao2dTables.md helperTaskTables.md pwgTables.md joinsAndIterators.md | |
| git commit -m 'Automatic data model update' | |
| git remote set-url origin "https://alibuild:$GITHUB_TOKEN@github.com/alibuild/analysis-framework" | |
| git push -f origin auto-datamodel-doc | |
| # Send pull request | |
| # We need to use "gh" ourselves because alisw/pull-request gets | |
| # confused when multiple repos are checked out. | |
| GH_TOKEN="$GITHUB_TOKEN" gh pr create -R AliceO2Group/analysis-framework -B master \ | |
| --no-maintainer-edit -t 'Automatic data model update' -b "This update \ | |
| to the data model documentation was automatically created from \ | |
| tonight's O2 dev branch." || true | |
| # If the PR already exists, hub fails, but we've just force-pushed, so we don't need a new PR. |