-
Notifications
You must be signed in to change notification settings - Fork 37
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
39d2ed1
commit 963e088
Showing
9 changed files
with
462 additions
and
121 deletions.
There are no files selected for viewing
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
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,132 @@ | ||
# Run pull request tests and validation for openedx-translations | ||
|
||
name: CI | ||
|
||
on: | ||
- pull_request | ||
|
||
jobs: | ||
# Run unit and integration tests for Python | ||
python-tests: | ||
runs-on: ubuntu-latest | ||
steps: | ||
# Clones the openedx-translations repo | ||
- name: clone openedx/openedx-translations | ||
uses: actions/checkout@v3 | ||
|
||
- name: Install gettext | ||
run: | | ||
sudo apt install -y gettext | ||
- name: setup python | ||
uses: actions/setup-python@v4 | ||
with: | ||
python-version: '3.8' | ||
|
||
- name: Run python tests | ||
run: | | ||
make test_requirements | ||
make test | ||
# Validate translation files | ||
validate-po-files: | ||
needs: python-tests | ||
runs-on: ubuntu-latest | ||
steps: | ||
- name: clone openedx/openedx-translations | ||
uses: actions/checkout@v3 | ||
|
||
- name: Install gettext | ||
run: | | ||
sudo apt install -y gettext | ||
- name: Allow editing translation files for bot pull requests | ||
env: | ||
# secrets can't be used in job conditionals, so we set them to env here | ||
TRANSIFEX_APP_ACTOR_NAME: "${{ secrets.TRANSIFEX_APP_ACTOR_NAME }}" | ||
TRANSIFEX_APP_ACTOR_ID: "${{ secrets.TRANSIFEX_APP_ACTOR_ID }}" | ||
if: "${{ github.actor == env.TRANSIFEX_APP_ACTOR_NAME && github.actor_id == env.TRANSIFEX_APP_ACTOR_ID }}" | ||
run: | | ||
echo "VALIDATION_OPTIONS=--mark-fuzzy" >> "$GITHUB_ENV" | ||
- name: Validate translation files | ||
id: validate_translation_files | ||
run: | | ||
has_errors=0 | ||
python scripts/validate_translation_files.py $VALIDATION_OPTIONS 2>error_log.txt || has_errors=1 | ||
cat error_log.txt # Print the errors to the console for debugging | ||
# Save the validation errors to an output variable | ||
{ | ||
echo 'ERROR_LOG<<EOF' | ||
fold -w 100 -s error_log.txt | ||
echo EOF | ||
} >> "$GITHUB_OUTPUT" | ||
exit $has_errors | ||
- name: Commit changes to git | ||
if: ${{ always() && !github.event.pull_request.head.repo.fork }} | ||
run: | | ||
# Commit if there are changes to translation files | ||
if ! git diff --no-ext-diff --quiet --exit-code; then | ||
git config --global user.email "[email protected]" | ||
git config --global user.name "edx-transifex-bot" | ||
git add . | ||
git commit -m "fix: mark invalid entries as fuzzy" -- translations/ | ||
fi | ||
- name: Post translation validation results as a pull request comment | ||
# Due to GitHub Actions security reasons posting a comment isn't possible on fork pull requests. | ||
# This shouldn't be an issue, because bots writes directly to this repository. | ||
if: ${{ always() && !github.event.pull_request.head.repo.fork }} | ||
uses: mshick/add-pr-comment@7c0890544fb33b0bdd2e59467fbacb62e028a096 | ||
with: | ||
message: | | ||
:white_check_mark: All translation files are valid. | ||
``` | ||
${{ steps.validate_translation_files.outputs.ERROR_LOG }} | ||
``` | ||
This comment has been posted by the `validate-translation-files.yml` GitHub Actions workflow. | ||
message-failure: | | ||
:warning: There are errors in the translation files: | ||
``` | ||
${{ steps.validate_translation_files.outputs.ERROR_LOG }} | ||
``` | ||
This comment has been posted by the `validate-translation-files.yml` GitHub Actions workflow. | ||
# Run commitlint on the commit messages in a pull request. | ||
commitlint: | ||
needs: validate-translation-files | ||
uses: openedx/.github/.github/workflows/commitlint.yml@master | ||
|
||
|
||
# Automatically merge pull requests created by the "Transifex Integration" github app | ||
# https://github.com/apps/transifex-integration | ||
automerge-transifex-app-pr: | ||
needs: commitlint | ||
runs-on: ubuntu-latest | ||
# Merges the pull request | ||
steps: | ||
- name: clone repository | ||
uses: actions/checkout@v3 | ||
- name: auto-merge pull request | ||
env: | ||
# secrets can't be used in job conditionals, so we set them to env here | ||
TRANSIFEX_APP_ACTOR_NAME: "${{ secrets.TRANSIFEX_APP_ACTOR_NAME }}" | ||
TRANSIFEX_APP_ACTOR_ID: "${{ secrets.TRANSIFEX_APP_ACTOR_ID }}" | ||
# This token requires Write access to the openedx-translations repo | ||
GITHUB_TOKEN: ${{ secrets.EDX_TRANSIFEX_BOT_GITHUB_TOKEN }} | ||
PR_NUMBER: ${{ github.event.number }} | ||
if: "${{ github.actor == env.TRANSIFEX_APP_ACTOR_NAME && github.actor_id == env.TRANSIFEX_APP_ACTOR_ID }}" | ||
run: | | ||
# Add the pull request to the merge queue with --rebase commit strategy | ||
gh pr merge ${{ github.head_ref }} --rebase --auto |
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
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
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
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,98 @@ | ||
Mark invalid entries in po files as fuzzy | ||
######################################### | ||
|
||
Context | ||
******* | ||
As of the `OEP-58`_, the Transifex GitHub App is used to sync Translations. | ||
These translations are validated by `LexiQA`_, built-in Transifex quality | ||
checks, and human reviewers. During this synchronization process, the | ||
`Transifex GitHub App`_ creates pull requests to this repository. The | ||
translations in the pull requests are then validated by ``msgfmt`` in CI. | ||
|
||
Problem | ||
******* | ||
There are times when the translations being synchronized fail ``msgfmt`` | ||
validation. This prevents the pull requests from being merged. | ||
|
||
|
||
Design Decision | ||
*************** | ||
|
||
A GitHub Actions workflow will be implemented to mark invalid entries in | ||
synchronized ``.po`` files as ``fuzzy``. This will update pull requests | ||
created by the `Transifex GitHub App`_. | ||
|
||
To ensure a safe and reliable workflow, the following workflows will be | ||
combined into one single workflow with multiple jobs: | ||
|
||
#. Run ``python-tests.yml`` to validate the python code | ||
#. Then, run ``validate-translation-files.yml`` which performs the following: | ||
|
||
#. Validate the po-files using ``msgfmt`` | ||
#. Notify the translators about the invalid entries via the preferred | ||
communication channel (Slack, Transifex, GitHub) | ||
#. Edit the po files to mark invalid entries as ``fuzzy``, so it's | ||
excluded from ``.mo`` files | ||
#. Revalidate the files | ||
|
||
#. Commit the updated entries | ||
#. Run ``commitlint`` | ||
#. Push updated entries to the PR branch | ||
#. Automatically merge the PR | ||
|
||
|
||
Informing the Translators | ||
************************* | ||
Translators can be notified about invalid translations via Slack, Transifex | ||
or GitHub issues depending on the community's preference. | ||
|
||
Pros and Cons | ||
************* | ||
|
||
**Pros** | ||
|
||
* New valid strings would make it into the ``.mo`` files | ||
* There's no need for manual intervention, therefore it's fast and won't | ||
create a backlog of pull requests. | ||
* Rejected strings are easily identifiable by looking in the code, so it's | ||
easy to fix them. | ||
* Translators can be notified about invalid translations via Slack, Transifex, | ||
GitHub depending on the community's preference. | ||
|
||
|
||
**Cons** | ||
|
||
* The workflow script runs and edits the pull request, which can be | ||
confusing for the reviewers. | ||
* Previously valid entries are going to be overwritten with new ``fuzzy`` | ||
strings which will make those entries to be shown in source language | ||
(English). | ||
|
||
Rejected Alternative: Keep pull requests open | ||
********************************************* | ||
|
||
- **Create a Transifex issue only:** It would be possible to identify the | ||
faulty entries and create a Transifex issue via API to the faulty entries. | ||
However, this would require attention from the translators | ||
team, which can take a rather long time therefore creating a backlog of | ||
invalid entries. Additionally, Transifex issues are not understood or used | ||
by most of the Open edX community. | ||
|
||
- **Post errors on Slack only:** Post the errors on Slack and ask the | ||
translators | ||
to fix them. Same as the previous option, not all translators are on Slack. | ||
Additionally, this option would have a slow feedback loop causing the pull | ||
requests backlog to build-up. | ||
|
||
- **Mark faulty entries as unreviewed only:** Use the Transifex API to mark | ||
the the invalid entries as unreviewed, then pull only | ||
reviewed entries into this repository. | ||
This option would require an extensive use the of the Transifex API, | ||
and pull again which can be complex to implement. Additionally, this option | ||
would have a slow feedback loop causing the pull requests backlog to | ||
build-up. | ||
|
||
|
||
.. _OEP-58: https://open-edx-proposals.readthedocs.io/en/latest/architectural-decisions/oep-0058-arch-translations-management.html | ||
.. _LexiQA: https://help.transifex.com/en/articles/6219179-lexiqa | ||
.. _Transifex GitHub App: https://github.com/apps/transifex-integration |
Oops, something went wrong.