Files
godot-docs/.github/workflows/sync_class_ref.yml
dependabot[bot] 78189da9d8 Bump peter-evans/create-pull-request from 5 to 6
Bumps [peter-evans/create-pull-request](https://github.com/peter-evans/create-pull-request) from 5 to 6.
- [Release notes](https://github.com/peter-evans/create-pull-request/releases)
- [Commits](https://github.com/peter-evans/create-pull-request/compare/v5...v6)

---
updated-dependencies:
- dependency-name: peter-evans/create-pull-request
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
(cherry picked from commit 4dae900c1a)
2024-07-24 20:48:33 +02:00

64 lines
2.2 KiB
YAML

name: Sync Class Reference
on:
workflow_dispatch:
# Make sure jobs cannot overlap.
concurrency:
group: classref-sync-ci-4.2
cancel-in-progress: true
jobs:
build:
name: Update class reference files based on the engine revision
runs-on: ubuntu-latest
env:
engine_rev: '4.2'
steps:
- name: Checkout the documentation repository
uses: actions/checkout@v4
- name: Checkout the engine repository
uses: actions/checkout@v4
with:
repository: 'godotengine/godot'
# Use the appropriate branch for the documentation version.
ref: ${{ env.engine_rev }}
path: './.engine-src'
- name: Store the engine revision
id: 'engine'
run: |
cd ./.engine-src
hash=$(git rev-parse HEAD)
hash_short=$(git rev-parse --short HEAD)
echo "Checked out godotengine/godot at $hash"
echo "rev_hash=$hash" >> $GITHUB_OUTPUT
echo "rev_hash_short=$hash_short" >> $GITHUB_OUTPUT
- name: Remove old documentation
run: |
rm ./classes/class_*.rst
- name: Build new documentation
run: |
./.engine-src/doc/tools/make_rst.py --color -o ./classes -l en ./.engine-src/doc/classes ./.engine-src/modules ./.engine-src/platform
- name: Submit a pull-request
uses: peter-evans/create-pull-request@v6
with:
commit-message: 'classref: Sync with current ${{ env.engine_rev }} branch (${{ steps.engine.outputs.rev_hash_short }})'
branch: 'classref/sync-${{ steps.engine.outputs.rev_hash_short }}'
add-paths: './classes'
delete-branch: true
# Configure the commit author.
author: 'Godot Organization <noreply@godotengine.org>'
committer: 'Godot Organization <noreply@godotengine.org>'
# Configure the pull-request.
title: 'classref: Sync with current ${{ env.engine_rev }} branch (${{ steps.engine.outputs.rev_hash_short }})'
body: 'Update Godot API online class reference to match the engine at https://github.com/godotengine/godot/commit/${{ steps.engine.outputs.rev_hash }} (`${{ env.engine_rev }}`).'
labels: 'area:class reference,bug,enhancement'