Traduccion Mejora library/internet

.github/workflows/main.yml

@@ -6,48 +6,87 @@ on:
       - 3.*
   pull_request:
 
+permissions:
+  contents: read
+
 jobs:
   test:
     name: Test
     runs-on: ubuntu-22.04
     steps:
+      # Obtención del código
       - uses: actions/checkout@v4
+        with:
+          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.11
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: "3.11"
           cache: "pip"
-      - name: Sincronizar con CPython
-        run: |
-          git submodule update --init --depth=1 cpython
-      - name: Instalar dependencias
+      - 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
-        run: |
-          sphinx-lint */*.po
+        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: |
-          # FIXME: Relative paths for includes in 'cpython'
-          sed -i -e 's|.. include:: ../includes/wasm-notavail.rst|.. include:: ../../../../includes/wasm-notavail.rst|g' cpython/Doc/**/*.rst
-          sed -i -e 's|.. include:: ../distutils/_setuptools_disclaimer.rst|.. include:: ../../../../distutils/_setuptools_disclaimer.rst|g' cpython/Doc/**/*.rst
-          sed -i -e 's|.. include:: ./_setuptools_disclaimer.rst|.. include:: ../../../_setuptools_disclaimer.rst|g' cpython/Doc/**/*.rst
-          sed -i -e 's|.. include:: token-list.inc|.. include:: ../../../token-list.inc|g' cpython/Doc/**/*.rst
-          sed -i -e 's|.. include:: ../../using/venv-create.inc|.. include:: ../using/venv-create.inc|g' cpython/Doc/**/*.rst
-          sed -i -e 's|.. include:: ../../../using/venv-create.inc|.. include:: ../../using/venv-create.inc|g' cpython/Doc/**/*.rst
-          sed -i -e 's|.. include:: /using/venv-create.inc|.. include:: ../../../../using/venv-create.inc|g' cpython/Doc/**/*.rst
           # 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.11
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+          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

.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

.overrides/CONTRIBUTING.rst

@@ -89,11 +89,11 @@ Paso 2: ¡Comienza a traducir!
 
 #. Tener un :ref:`archivo asignado para traducir <que-archivo-traducir>`.
 
-#. Verifica que estás en la rama principal del repositorio, **3.11** (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.11
+     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/ast.po``, usa un nombre

.overrides/faq.rst

@@ -204,9 +204,9 @@ repositorio principal de la traducción). Se hace de la siguiente manera::
 
 Luego nos vamos a nuestra rama local, confirmamos e impactamos esos cambios::
 
-    git checkout 3.11
-    git merge upstream/3.11
-    git push origin 3.11
+    git checkout 3.12
+    git merge upstream/3.12
+    git push origin 3.12
 
 ¡Eso es todo!
 

.overrides/progress.rst

@@ -10,7 +10,7 @@ y otras estadísticas.
 
 .. note::
 
-   Estas listas se actualiza automáticamente cuando Pull Requests se *mergean* a la rama ``3.11``.
+   Estas listas se actualiza automáticamente cuando Pull Requests se *mergean* a la rama ``3.12``.
 
 
 En progreso

.overrides/translation-memory.rst

@@ -123,6 +123,10 @@ Dividimos esta sección en dos partes, los términos que se traducen y los que m
    docstring
      docstring. ``library/idle.po``
 
+   floor division
+     división entera a la baja
+     En este `issue`_ más información al respecto.
+
    key
      clave
 
@@ -318,3 +322,6 @@ Estas son las reglas de estilo que hemos convenido hasta el momento:
   extranjerismos.
 
   Referencia: https://www.fundeu.es/recomendacion/locuciones-latinas-latinismos-errores-frecuentes-621/
+
+
+.. _issue: https://github.com/python/python-docs-es/issues/2754

.overrides/upgrade-python-version.rst

@@ -3,33 +3,32 @@
 How to update to a new Python version
 =====================================
 
-We are currently in branch 3.10, and we want to update the strings from 3.11.
+We are currently in branch 3.11, and we want to update the strings from 3.12.
 
+#. Make sure you are in a clean state of the branch 3.11
 
-#. Make sure you are in a clean state of the branch 3.10
-
-#. Create a new branch called ``3.11``
+#. Create a new branch called ``3.12``
 
 #. Initialize the submodules::
 
      git submodule init
      git submodule update
 
-#. Fetch the `latest commit of 3.11 branch <https://github.com/python/cpython/commit/b3cafb60afeb2300002af9982d43703435b8302d>`_::
+#. Fetch the `latest commit of 3.12 branch <https://github.com/python/cpython/commit/0fb18b02c8ad56299d6a2910be0bab8ad601ef24>`_::
 
      cd cpython/
-     git fetch --depth 1 origin b3cafb60afeb2300002af9982d43703435b8302d
+     git fetch --depth 1 origin 0fb18b02c8ad56299d6a2910be0bab8ad601ef24
 
    .. note:: you could also base the hash on the 'git tag' from the desired
-             version: ``git checkout tags/v3.11.0 -b 3.11`` considering that
-             ``3.11`` doesn't exist locally.
+             version: ``git checkout tags/v3.12.0 -b 3.12`` considering that
+             ``3.12`` doesn't exist locally.
 
 #. Checkout that commit locally::
 
-     git checkout b3cafb60afeb2300002af9982d43703435b8302d
+     git checkout 0fb18b02c8ad56299d6a2910be0bab8ad601ef24
 
 #. Update the branch on the ``Makefile`` and check the ``requirements.txt`` from
-   the cpython repository, to see if upgrades on the modules like sphinx is
+   ``./cpython/Doc`` directory, to see if upgrades on the modules like sphinx is
    needed.
 
 #. Commit the update of the submodule change::
@@ -40,10 +39,16 @@ We are currently in branch 3.10, and we want to update the strings from 3.11.
    .. note:: This is important, so the later ``make build`` step will not reset
              the cpython submodule to the previous hash on the old branch.
 
+#. Create a virtual environment and install the dependencies of the project::
+
+     python -m venv env
+     source env/bin/activate  # Windows: env\Scripts\activate.bat
+     pip install -r requirements.txt
+
 #. Verify that the docs build with the new versions you changed from
    ``requirements.txt`` mainly the sphinx version::
 
-     make html
+     make build
 
    .. note::
 
@@ -54,28 +59,21 @@ We are currently in branch 3.10, and we want to update the strings from 3.11.
 
 #. Clean possible garbage (form previous builds)::
 
-     rm -rf _build ../python-docs-es-pot cpython/Doc/CONTRIBUTING.rst cpython/Doc/upgrade-python-version.rst
+     rm -rf _build ../python-docs-es-pot cpython/Doc/CONTRIBUTING.rst cpython/Doc/upgrade-python-version.rst reviewers-guide.rst
 
    .. note::
 
       The 'python-docs-es-pot' is a temporary directory that is created
       in the next step. It's included here because it might be a leftover
       from previous attempts on your machine.
 
-#. Create a virtual environment and install the dependencies of the project::
-
-     python -m venv env
-     source env/bin/activate  # Windows: env\Scripts\activate.bat
-     pip install -r requirements.txt
-
-
 #. Create the .po files from the new source code. This will generate all the .po files for version 3.11::
 
      SPHINX_GETTEXT=True sphinx-build -j auto -b gettext -d _build/doctrees . ../python-docs-es-pot
 
    .. note::
 
-      In ``../python-docs-es-pot`` directory, we will have the new .pot files with new strings from 3.11 branch.
+      In ``../python-docs-es-pot`` directory, we will have the new .pot files with new strings from 3.12 branch.
       All these strings will be *untranslated* at this point.
 
 #. Now, we update our translated files form the source language (English) with new strings::
@@ -85,8 +83,8 @@ We are currently in branch 3.10, and we want to update the strings from 3.11.
 #. At this point, all the ``.po`` files will have a different comment on each translation phrase,
    for example::
 
-     -#: ../python-docs-es/cpython/Doc/whatsnew/3.11.rst:3
-     +#: ../Doc/whatsnew/3.11.rst:3
+     -#: ../python-docs-es/cpython/Doc/whatsnew/3.12.rst:3
+     +#: ../Doc/whatsnew/3.12.rst:3
 
    As you can see, it added the path of the local repository, but you can
    remove it from it with this regular expression::
@@ -115,10 +113,16 @@ We are currently in branch 3.10, and we want to update the strings from 3.11.
    of the new branch is done. So prepare a cup of any hot beverage
    and fix them.
 
+**Once the process is completely and you are happy with the results,
+there are a few extra steps to finish the process**
 
-Once the process is completely and you are happy with the results,
-there are a few extra steps to finish the process::
+#. Upgrade GitHub Actions to use Python 3.12, by updating Python version to 3.12 in the ``.github/workflows/main.yml`` file.
 
-#. Upgrade GitHub Actions to use Python 3.11
+#. Update the *Read the Docs* project to use 3.12 in the build and also as default branch/version.
+
+#. Commit all the newly created files locally.
+
+#. Create branch 3.12 in the repository in order to merge changes there.
+
+#. Inside the github project settings, set 3.12 branch as the default branch for the repository.
 
-#. Update Read the Docs project to use 3.11 in the build and also as default branch/version

.pre-commit-config.yaml

@@ -1,6 +1,6 @@
 repos:
--   repo: https://github.com/JulienPalard/powrap
-    rev: v0.4.0
+-   repo: https://git.afpy.org/AFPy/powrap
+    rev: v1.0.2
     hooks:
     -   id: powrap
 -   repo: local