Translation #620

	name: Translation

	on:
	workflow_run:
	workflows:
	- Test
	branches:
	- main
	types:
	- completed

	env:
	I18N_BRANCH: translation/source

	jobs:
	build:
	runs-on: ubuntu-latest

	steps:
	- name: Grab the repo src
	uses: actions/checkout@v3
	with:
	fetch-depth: 0 # To reach the common commit
	- name: Set up git user as [bot]
	# Refs:
	# * https://github.community/t/github-actions-bot-email-address/17204/6
	# * https://github.com/actions/checkout/issues/13#issuecomment-724415212
	uses: fregante/setup-git-user@v1.1.0

	- name: Switch to the translation source branch
	run: \|
	sh -x

	git fetch origin \
	'+refs/heads/${{
	env.I18N_BRANCH
	}}:refs/remotes/origin/${{
	env.I18N_BRANCH
	}}'

	git checkout -B '${{ env.I18N_BRANCH }}' \
	'origin/${{ env.I18N_BRANCH }}'

	- name: >-
	Merge '${{ github.event.repository.default_branch }}'
	to '${{ env.I18N_BRANCH }}'
	run: \|
	sh -x

	git merge '${{ github.event.repository.default_branch }}'

	- name: Set up Python
	uses: actions/setup-python@v4
	with:
	python-version: >-
	3.10

	- name: Install Python tooling
	run: python -m pip install --upgrade nox virtualenv

	- name: Generate a fresh POT file out of RST documents
	run: python -m nox -s translation

	- name: Commit the POT file to Git
	run: \|
	git_hash=$(git rev-parse --short "${GITHUB_SHA}")
	git add --force locales/messages.pot
	git diff-index --quiet HEAD \|\| \
	git commit \
	-m "Update messages.pot as of version ${git_hash}" \
	locales/messages.pot

	- name: >-
	Push the updated POT file back to '${{ env.I18N_BRANCH }}'
	branch on GitHub
	if: always()
	run: \|
	git push --atomic origin 'HEAD:${{ env.I18N_BRANCH }}'

Provide feedback