Update translations after syncing with upstream (#68)

Author: sepehr-rs

.github/workflows/sync-with-cpython.yml

@@ -6,7 +6,7 @@ on:
   workflow_dispatch:
     inputs:
       cpython_tag:
-        description: 'CPython tag to sync against (e.g. v3.14)'
+        description: 'CPython tag to sync against (e.g. 3.14)'
         required: false
         default: '3.14'
 
@@ -57,11 +57,26 @@ jobs:
             --repo ${{ github.repository }} \
             2>/dev/null || true
 
-      - name: Open issue for fuzzy strings
+      - name: Open issue for new and fuzzy strings
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
           tmpfile=$(mktemp)
+
+          # --- New PO files (untracked, since nothing is staged yet) ---
+          new_files=$(git ls-files --others --exclude-standard -- '*.po' \
+            ':(exclude).cpython-src' ':(exclude).pot-templates')
+          if [ -n "$new_files" ]; then
+            new_count=$(echo "$new_files" | wc -l)
+            {
+              echo "## 🆕 New PO files ($new_count)"
+              echo "$new_files" | sed 's/^/- `/; s/$/`/'
+              echo ""
+            } >> "$tmpfile"
+          fi
+
+          # --- Fuzzy strings ---
+          fuzzy_out=$(mktemp)
           while IFS= read -r f; do
             fuzzy=$(msgattrib --only-fuzzy --no-obsolete "$f" 2>/dev/null)
             if [ -n "$fuzzy" ]; then
@@ -80,27 +95,35 @@ jobs:
                   next
                 }
               ')
-              count=$(echo "$entries" | grep -c '^- ' || echo 0)
-              if [ "$count" -gt 0 ]; then
-                echo "### $f ($count fuzzy)" >> "$tmpfile"
-                echo "$entries" | head -20 >> "$tmpfile"
-                echo "" >> "$tmpfile"
+              count=$(echo "$entries" | grep -c '^- ' || true)
+              if [ "${count:-0}" -gt 0 ]; then
+                echo "### $f ($count fuzzy)" >> "$fuzzy_out"
+                echo "$entries" | head -20 >> "$fuzzy_out"
+                echo "" >> "$fuzzy_out"
               fi
             fi
           done < <(find . -name "*.po" \
             -not -path "./.git/*" \
             -not -path "./.cpython-src/*" \
             -not -path "./.pot-templates/*")
+
+          if [ -s "$fuzzy_out" ]; then
+            {
+              echo "## 🔍 Fuzzy strings"
+              cat "$fuzzy_out"
+            } >> "$tmpfile"
+          fi
+
+          # --- One issue for both ---
           if [ -s "$tmpfile" ]; then
+            echo "Triggered by sync with \`$CPYTHON_TAG\`." >> "$tmpfile"
             gh issue create \
-              --title "🔍 Fuzzy strings need review after CPython sync ($(date +%Y-%m-%d))" \
-              --body "$(cat "$tmpfile")
-
-          Triggered by sync with \`$CPYTHON_TAG\`." \
+              --title "🔍 Translation review needed after CPython sync ($(date +%Y-%m-%d))" \
+              --body-file "$tmpfile" \
               --label "translation" \
               --repo ${{ github.repository }}
           fi
-          rm -f "$tmpfile"
+          rm -f "$tmpfile" "$fuzzy_out"
 
       - name: Stage changes
         run: git add --all

.readthedocs.yml

@@ -5,7 +5,7 @@ build:
   tools:
     python: "3.12"
   commands:
-    - git clone --depth 1 --branch v3.14 https://github.com/python/cpython venv/cpython
+    - git clone --depth 1 --branch 3.14 https://github.com/python/cpython venv/cpython
     - pip install -r venv/cpython/Doc/requirements.txt
     # Pin Sphinx separately: requirements.txt may resolve to an older version,
     # and 9.1.0+ is needed for the reordered- ref / translated-display-text

builtins/functions.po

@@ -20,16 +20,36 @@ msgstr ""
 "Content-Transfer-Encoding: 8bit\n"
 
 msgid "Python built-ins reference"
-msgstr ""
+msgstr "ارجاع توکارهای پایتون"
 
 msgid "Python comes with a number of built-in functions and classes."
-msgstr ""
+msgstr "پایتون با تعداد زیادی تابع و کلاس توکار ارائه می‌شود."
 
-msgid "The built-in classes include data types that would normally be considered part of the \"core\" of a language, such as numbers and lists.  For these types, the Python language core defines the form of literals and places some constraints on their semantics, but does not fully define the semantics."
+msgid ""
+"The built-in classes include data types that would normally be considered "
+"part of the \"core\" of a language, such as numbers and lists.  For these "
+"types, the Python language core defines the form of literals and places some"
+" constraints on their semantics, but does not fully define the semantics."
 msgstr ""
+"کلاس‌های توکار شامل انواع داده‌ای هستند که معمولاً بخشی از «هسته» یک زبان "
+"محسوب می‌شوند، مانند اعداد و فهرست‌ها.  برای این انواع، هسته زبان پایتون شکل"
+" مقادیر لفظی را تعریف می‌کند و محدودیت‌هایی بر معناشان می‌گذارد، اما معناشان"
+" را به طور کامل تعریف نمی‌کند."
 
-msgid "The built-ins also include functions and exceptions --- objects that can be used by all Python code without the need of an :keyword:`import` statement. Some of these are defined by the core language, but many are not essential for the core semantics and are only described here."
+msgid ""
+"The built-ins also include functions and exceptions --- objects that can be "
+"used by all Python code without the need of an :keyword:`import` statement. "
+"Some of these are defined by the core language, but many are not essential "
+"for the core semantics and are only described here."
 msgstr ""
+"توکارها همچنین شامل توابع و استثناها --- اشیاء‌ای که می‌توانند توسط تمام "
+"کدهای پایتون بدون نیاز به دستور :keyword:`import` استفاده شوند --- می‌باشند."
+" برخی از این‌ها توسط زبان هسته تعریف شده‌اند، اما بسیاری برای معنای هسته "
+"ضروری نیستند و فقط در اینجا توصیف شده‌اند."
 
-msgid "In addition to the built-ins, Python provides an extensive importable standard library, see :ref:`library-index`."
+msgid ""
+"In addition to the built-ins, Python provides an extensive importable "
+"standard library, see :ref:`library-index`."
 msgstr ""
+"علاوه بر توکارها، پایتون یک کتابخانه استاندارد گسترده و قابل‌وارد کردن فراهم"
+" می‌کند، به :ref:`library-index` مراجعه کنید."