Merge branch '3.13' into 3.10

Author: erickisos

.github/dependabot.yml

@@ -0,0 +1,11 @@
+# Set update schedule for GitHub Actions
+
+version: 2
+updates:
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      # Check for updates to GitHub Actions every week
+      interval: "weekly"
+

.github/workflows/main.yml

@@ -6,34 +6,87 @@ on:
       - 3.*
   pull_request:
 
+permissions:
+  contents: read
+
 jobs:
   test:
     name: Test
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-22.04
     steps:
-      - uses: actions/checkout@v2
-      - name: Preparar Python v3.10
-        uses: actions/setup-python@v2
+      # Obtención del código
+      - uses: actions/checkout@v4
         with:
-          python-version: "3.10"
-      - name: Sincronizar con CPython
-        run: |
-          git submodule update --init --depth=1 cpython
-      - name: Instalar dependencias
+          submodules: 'true'
+          # Necesario para que tj-actions/changed-files se ejecute
+          # dentro de un tiempo adecuado
+          fetch-depth: 2
+
+      # Instalación de dependencias
+      - name: Preparar Python v3.13
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+          cache: "pip"
+      - name: Configura dpkg/apt para ejecutarse de manera eficiente
+        uses: abbbi/github-actions-tune@v1
+      - name: Deshabilita triggers de postgresql-common
+        run: sudo sed -i '/postgresql-common/d' /var/lib/dpkg/triggers/File
+      - name: Instalar dependencias de sistema
         run: |
           sudo apt-get update
-          sudo apt-get install -y hunspell hunspell-es gettext language-pack-es
+          sudo apt-get install -y hunspell hunspell-es gettext language-pack-es locales-all
+      - name: Instalar dependencias de Python
+        run: |
           python -m pip install -r requirements.txt
+      - name: Listar paquetes y versiones
+        run: |
           pip list
           pospell --version
           powrap --version
+
+      # Cálculo de los archivos .po a verificar.
+      # En el caso de un PR, sólo se chequean los .po que se están editando,
+      # mientras que en caseo de un push a las ramas 3.* queremos revisar
+      # todos los archivos
+      - name: Obtiene la lista de archivos .po con cambios (sólo en PRs)
+        if: github.event_name == 'pull_request'
+        id: changed-po-files
+        uses: tj-actions/changed-files@v45
+        with:
+          files: |
+             **/*.po
+      - name: Calcula lista de archivos .po a revisar
+        id: po-files-to-check
+        env:
+          PO_FILES_TO_CHECK: ${{ steps.changed-po-files.conclusion == 'skipped' && '**/*.po' || steps.changed-po-files.outputs.all_changed_files }}
+        run: |
+          echo "po_files_to_check=$PO_FILES_TO_CHECK" >> $GITHUB_OUTPUT
+          echo "any_po_files_to_check=`test -n \"$PO_FILES_TO_CHECK\" && echo true || echo false`" >> $GITHUB_OUTPUT
+      - name: Muestra outputs de steps anteriores para debugueo
+        env:
+          CHANGED_PO_FILES: ${{ toJson(steps.changed-po-files) }}
+          PO_FILES_TO_CHECK: ${{ toJson(steps.po-files-to-check) }}
+        run: |
+          echo "steps.changed-po-files=$PO_FILES_TO_CHECK"
+          echo "steps.po-files-to-change.$CHANGED_PO_FILES"
+
+      # Chequeos a realizar
       - name: TRANSLATORS
         run: |
           diff -Naur TRANSLATORS <(LANG=es python scripts/sort.py < TRANSLATORS)
       - name: Powrap
-        run: powrap --check --quiet **/*.po
+        if: steps.po-files-to-check.outputs.any_po_files_to_check == 'true'
+        run: powrap --diff --check --quiet ${{ steps.po-files-to-check.outputs.po_files_to_check }}
+      - name: Sphinx lint
+        if: steps.po-files-to-check.outputs.any_po_files_to_check == 'true'
+        run: sphinx-lint ${{ steps.po-files-to-check.outputs.po_files_to_check }}
       - name: Pospell
-        run: |
-          python scripts/check_spell.py
+        if: steps.po-files-to-check.outputs.any_po_files_to_check == 'true'
+        run: python scripts/check_spell.py ${{ steps.po-files-to-check.outputs.po_files_to_check }}
+
+      # Construcción de la documentación
       - name: Construir documentación
-        run: PYTHONWARNINGS=ignore::FutureWarning sphinx-build -j auto -W --keep-going -b html -d cpython/Doc/_build/doctree -D language=es . cpython/Doc/_build/html
+        run: |
+          # Normal build
+          PYTHONWARNINGS=ignore::FutureWarning,ignore::RuntimeWarning sphinx-build -j auto -W --keep-going -b html -d cpython/Doc/_build/doctree -D language=es . cpython/Doc/_build/html

.github/workflows/pr-comment.yml

@@ -0,0 +1,68 @@
+name: Agrega comentario a PR
+
+on:
+  pull_request_target:
+
+permissions:
+  contents: read
+
+jobs:
+  define-comment:
+    name: Entradas sin traducción
+    runs-on: ubuntu-22.04
+    outputs:
+      any_changed: ${{ steps.changed-files.outputs.any_changed }}
+      comment: ${{ steps.create-pr-comment.outputs.comment }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.pull_request.head.sha }}
+          persist-credentials: false
+      - name: Preparar Python v3.13
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+          cache: "pip"
+      # checkout these files from the base branch to guarantee they haven't been
+      # modified by the PR
+      - uses: actions/checkout@v4
+        with:
+          path: base-branch
+          sparse-checkout-cone-mode: false
+          sparse-checkout: |
+            requirements.txt
+            scripts/list_missing_entries.py
+      - name: Instalar dependencias
+        run: |
+          python -m pip install -r base-branch/requirements.txt
+      - name: Obtiene lista de archivos con cambios
+        id: changed-files
+        uses: tj-actions/changed-files@v45
+        with:
+          files: |
+            **/*.po
+      - name: Calcular entradas faltantes
+        if: steps.changed-files.outputs.any_changed == 'true'
+        id: create-pr-comment
+        env:
+          CHANGED_PO_FILES: ${{ steps.changed-files.outputs.all_changed_files }}
+        run: |
+          {
+            echo 'comment<<EOF'
+            python base-branch/scripts/list_missing_entries.py --github $CHANGED_PO_FILES
+            echo EOF
+          } >> "$GITHUB_OUTPUT"
+
+  write-comment:
+    runs-on: ubuntu-22.04
+    needs: [define-comment]
+    if: needs.define-comment.outputs.any_changed == 'true'
+    permissions:
+      issues: write
+      pull-requests: write
+    steps:
+      - name: Agregar comentario con entradas faltantes
+        uses: thollander/actions-comment-pull-request@v3
+        with:
+          message: ${{ needs.define-comment.outputs.comment }}
+          comment-tag: missing-entries

.github/workflows/stale.yaml

@@ -0,0 +1,27 @@
+name: 'Cierra issues y PRs antiguos'
+on:
+  schedule:
+    - cron: '30 1 * * *'
+
+permissions:
+  contents: read
+
+jobs:
+  stale:
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      pull-requests: write
+    steps:
+      - uses: actions/stale@v9
+        with:
+          stale-pr-label: 'needs decision'
+          stale-issue-label: 'stale'
+          days-before-issue-stale: 10
+          # don't close issues, lest we miss translations
+          days-before-issue-close: -1
+          days-before-pr-stale: 7
+          days-before-pr-close: 21
+          stale-issue-message: "Este issue lleva un tiempo sin actualizaciones. ¿Estás trabajando todavía?\nSi necesitas ayuda :sos: no dudes en contactarnos en nuestro [grupo de Telegram](https://t.me/python_docs_es)."
+          stale-pr-message: "Este PR lleva un tiempo sin actualizaciones. Vamos a pedir a un admin de nuestro equipo que decida si alguien más puede finalizarlo o si tenemos que cerrarlo.\nPor favor, avisanos en caso de que aún puedas terminarlo."
+          include-only-assigned: true

.gitignore

@@ -75,3 +75,9 @@ coverage.xml
 
 # OSX
 .DS_Store
+
+.potodo/
+git_diff.po
+CONTRIBUTING.po
+reviewers-guide.po
+upgrade-python-version.po

.gitmodules

@@ -3,6 +3,3 @@
 	url = https://github.com/python/cpython.git
 	branch = 3.9
 	shallow = true
-[submodule "tutorialpyar"]
-	path = .migration/tutorialpyar
-	url = https://github.com/pyar/tutorial.git

.migration/tutorialpyar

@@ -18,8 +18,17 @@ contribución, queremos señalar algunos
 
    Si tienes cualquier duda, puedes enviarnos un email a docs-es@python.org.
 
-Antes de comenzar
------------------
+   También puedes unirte a `nuestro canal de Telegram`_ si necesitas ayuda.
+
+El proceso general de traducción son tres pasos, de los cuales el primero tendrás que
+realizar solo una vez. Te los detallamos a continuación.
+
+
+Paso 0: Configuración de Github
+-------------------------------
+
+Esta configuración la tienes que realizar sólo una vez, y con ello
+podrás realizar todas las contribuciones que quieras.
 
 #. Para enviar una traducción, necesitas tener un **fork** del repositorio_
    oficial, haciendo click en el botón encerrado en rojo.
@@ -59,32 +68,80 @@ Antes de comenzar
       ``powrap`` y ``pospell`` para poder verificar tus archivos traducidos,
       y también construir la documentación localmente.
 
-¡Comienza a traducir!
----------------------
+.. _que-archivo-traducir:
+
+Paso 1: ¿Qué archivo traducir?
+------------------------------
+
+Tenemos una `lista de issues en GitHub`_ en dónde vamos coordinando el trabajo
+realizado para no traducir dos veces lo mismo.  El proceso para traducir un
+archivo es el siguiente:
+
+
+#. Elige cualquiera de los issues que *no están asignados* a otra persona.
+#. Deja un comentario en el issue diciendo que quieres trabajar en él.
+#. Espera a que un administrador te asigne el issue.
+#. ¡Empieza a traducir!
+
+
+Paso 2: ¡Comienza a traducir!
+-----------------------------
 
-#. Selecciona un :ref:`archivo para traducir <que-archivo-traducir>`.
+#. Tener un :ref:`archivo asignado para traducir <que-archivo-traducir>`.
 
-#. Verifica que estás en la rama principal del repositorio, **3.10** (esto es muy
+#. Verifica que estás en la rama principal del repositorio, **3.12** (esto es muy
    importante para evitar crear una nueva rama a partir de una traducción
    anterior)::
 
-     git checkout 3.10
+     git checkout 3.12
 
 #. Crea una rama nueva en base al artículo en el que vayas a trabajar.  Por
-   ejemplo, si vas a trabajar en el archivo ``library/glosario.po``, usa un nombre
+   ejemplo, si vas a trabajar en el archivo ``library/ast.po``, usa un nombre
    similar a::
 
-     git checkout -b traduccion-glosario
+     git checkout -b traduccion-ast
 
 #. Una vez que hayas elegido el archivo, lo puedes abrir con el editor poedit_ y
    empezar a traducir.
 
+#. **Formato de columnas**: Si utilizas poedit_ es posible que tu archivo tenga
+   la estructura adecuada, pero te invitamos a comprobarlo con la herramienta
+   powrap_, la cual puedes instalar y utilizar por la línea de comandos.
+   Ejecuta::
+
+     powrap <directorio>/tu_archivo.po
+
+   Recuerda que tu archivo puede estar dentro de un ``<directorio>``, como
+   ``library``, con lo que tendrás que ejecutar el comando ``powrap
+   library/tu_archivo.po`` si no te encuentras en el mismo directorio de tu
+   archivo.
+
+   .. note:: Si estás en Windows y tienes problemas, mira los comentarios de
+             :ref:`powrap_windows` para más información.
+
+#. **Corrección ortográfica**: Para verificar la ortografía de tu archivo
+   puedes utilizar la herramienta pospell_ para que verifiques que todas las
+   palabras están aceptadas o incluidas en diccionarios. Para ello tenemos
+   un script de conveniencia que puedes utilizar::
+
+    python scripts/check_spell.py <directorio>/tu_archivo.po
+
+   Si alguna palabra no es reconocida, y es una palabra válida, tienes que
+   agregarla al diccionario correspondiente en el directorio dictionaries/.
+   Busca el archivo que corresponde al que estás traduciendo y si no existe, créalo.
+   Por ejemplo el diccionario del archivo ``library/ast.po`` se encuentra en
+   ``dictionaries/library_ast.po``.
+
+   .. note:: Si estás en Windows y tienes problemas, mira los comentarios de
+             :ref:`pospell_windows` para más información.
+
 #. Cuando hayas terminado tu sesión, debes guardar tus cambios y enviarlos a
-   GitHub (No olvides añadir tu nombre al archivo ``TRANSLATORS``)::
+   GitHub (No olvides añadir tu nombre al archivo ``TRANSLATORS``).
+   Si estuvieras trabajando en el archivo ``library/ast.po`` los pasos serían::
 
-     git add library/glosario.po
-     git commit -m 'Traducido archivo library/glosario'
-     git push origin traduccion-glosario
+     git add library/ast.po
+     git commit -m 'Traducido archivo library/ast'
+     git push origin traduccion-ast
 
    .. note::
 
@@ -104,22 +161,6 @@ Antes de comenzar
       :ref:`mantener actualizada <mantener-actualizada>` tu copia local antes
       de realizar el *Pull Request*.
 
-.. _que-archivo-traducir:
-
-¿Qué archivo traducir?
-----------------------
-
-Tenemos una `lista de issues en GitHub`_ en dónde vamos coordinando el trabajo
-realizado para no traducir dos veces lo mismo.  El proceso para traducir un
-archivo es el siguiente:
-
-
-#. Elige cualquiera de los issues que *no están asignados* a otra persona.
-#. Deja un comentario en el issue diciendo que quieres trabajar en él.
-#. Espera a que un administrador te asigne el issue.
-#. ¡Empieza a traducir!
-
-
 .. _a-tener-en-cuenta:
 
 A tener en cuenta
@@ -182,11 +223,6 @@ A tener en cuenta
   esperamos en nuestro chat en telegram. ¡Gracias!
 
 
-.. note::
-
-   También puedes unirte a `nuestro canal de Telegram`_ si necesitas ayuda.
-
-
 Previsualizar los cambios
 -------------------------
 
@@ -205,9 +241,9 @@ Memoria de traducción
 ---------------------
 
 Tenemos una :doc:`Memoria de Traducción <translation-memory>`, que usamos para tener consistencia con algunos
-términos. 
+términos.
 Si tienes alguna duda respecto a cómo traducir alguna palabra no te olvides de revisar este contenido.
-Del mismo modo, si luego de trabajar sobre un término *complicado* llegas a un acuerdo con otros colaboradores: 
+Del mismo modo, si luego de trabajar sobre un término *complicado* llegas a un acuerdo con otros colaboradores:
 no se olviden de agregarlo.
 
 
@@ -217,6 +253,8 @@ no se olviden de agregarlo.
 .. _ayuda oficial de GitHub para crear un Pull Request:
    https://help.github.com/es/github/collaborating-with-issues-and-pull-requests/about-pull-requests
 .. _poedit: https://poedit.net/
+.. _powrap: https://github.com/AFPy/powrap
+.. _pospell: https://github.com/AFPy/pospell
 
 .. _nuestro canal de Telegram: https://t.me/python_docs_es
 .. _la traducción al Portugués: https://docs.python.org/pt-br/3/