ci: add Transifex translation and source push workflow

Author: BHUVANSH855

.github/workflows/transifex-push.yml

@@ -1,55 +1,125 @@
+
 name: Push Translations to Transifex
 
 on:
+  push:
+    branches:
+      - "3.15"
+    paths:
+      - "**/*.po"
+
   workflow_dispatch:
     inputs:
-      version:
-        description: "Python documentation version"
+      push_translations:
+        description: "Push Punjabi translations to Transifex"
         required: true
-        type: choice
-        options:
-          - "3.13"
-          - "3.14"
-          - "3.15"
-        default: "3.15"
+        type: boolean
+        default: true
+      push_sources:
+        description: "Generate and push CPython source templates"
+        required: true
+        type: boolean
+        default: false
 
 permissions:
   contents: read
 
+concurrency:
+  group: transifex-push-${{ github.ref }}
+  cancel-in-progress: false
+
 jobs:
   push-translations:
+    name: Push Punjabi translations
+    if: github.actor != 'github-actions[bot]' && (github.event_name == 'push' || inputs.push_translations)
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout translation repository
+        uses: actions/checkout@v4
+        with:
+          persist-credentials: false
+
+      - name: Install Transifex CLI
+        working-directory: /usr/local/bin
+        run: |
+          curl -fsSL https://raw.githubusercontent.com/transifex/cli/master/install.sh | bash -s -- v1.6.16
+
+      - name: Push Punjabi translations
+        env:
+          TX_TOKEN: ${{ secrets.TX_TOKEN }}
+        run: |
+          tx push --translation --languages pa --use-git-timestamps
+
+  push-sources:
+    name: Generate and push source templates
+    needs: push-translations
+    if: ${{ always() && github.event_name == 'workflow_dispatch' && inputs.push_sources && (needs.push-translations.result == 'success' || needs.push-translations.result == 'skipped') }}
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout translation repository
+        uses: actions/checkout@v4
         with:
-          ref: ${{ inputs.version }}
-          fetch-depth: 0
+          persist-credentials: false
 
-      - uses: actions/setup-python@v5
+      - name: Checkout CPython 3.15
+        uses: actions/checkout@v4
         with:
-          python-version: "3.x"
+          repository: python/cpython
+          ref: "3.15"
+          path: cpython
+          persist-credentials: false
 
-      - name: Install Dependencies
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install documentation build dependencies
         run: |
           sudo apt-get update
           sudo apt-get install -y gettext
-          pip install requests cogapp polib transifex-python sphinx-intl blurb six
-          curl -o- https://raw.githubusercontent.com/transifex/cli/master/install.sh | bash
-        working-directory: /usr/local/bin
+          python -m pip install -r cpython/Doc/requirements.txt
 
-      - name: Recreate Transifex configuration
+      - name: Generate gettext source templates
         run: |
-          curl -O https://raw.githubusercontent.com/python-docs-translations/transifex-automations/master/sample-workflows/transifex-util.py
-          chmod +x transifex-util.py
-          ./transifex-util.py recreate_tx_config \
-            --language pa \
-            --project-slug python-newest \
-            --version ${{ inputs.version }}
-        env:
-          TX_TOKEN: ${{ secrets.TX_TOKEN }}
+          make -C cpython/Doc gettext
+          test -d cpython/Doc/build/gettext
+          mkdir -p gettext
+          cp -a cpython/Doc/build/gettext/. gettext/
+
+      - name: Validate configured source templates
+        run: |
+          python - <<'PY'
+          import configparser
+          from pathlib import Path
+
+          config = configparser.ConfigParser()
+          if not config.read(".tx/config"):
+              raise SystemExit("ERROR: .tx/config could not be read")
 
-      - name: Push translations to Transifex
-        run: tx push --translation --languages pa --use-git-timestamps
+          missing = []
+          for section in config.sections():
+              source = config.get(section, "source_file", fallback="").strip()
+              if source and not Path(source).is_file():
+                  missing.append(f"{section}: {source}")
+
+          if missing:
+              print("Missing source templates:")
+              print("\n".join(missing))
+              raise SystemExit(1)
+
+          print("All configured source templates exist.")
+          PY
+
+      - name: Install Transifex CLI
+        working-directory: /usr/local/bin
+        run: |
+          curl -fsSL https://raw.githubusercontent.com/transifex/cli/master/install.sh | bash -s -- v1.6.16
+
+      - name: Push source templates
         env:
           TX_TOKEN: ${{ secrets.TX_TOKEN }}
+        run: |
+          tx push --source --skip