Merge branch '3.12' into traduccion-types

.github/workflows/main.yml

@@ -52,7 +52,7 @@ jobs:
       - 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@v41
+        uses: tj-actions/changed-files@v45
         with:
           files: |
              **/*.po
@@ -77,7 +77,7 @@ jobs:
           diff -Naur TRANSLATORS <(LANG=es python scripts/sort.py < TRANSLATORS)
       - name: Powrap
         if: steps.po-files-to-check.outputs.any_po_files_to_check == 'true'
-        run: powrap --check --quiet ${{ steps.po-files-to-check.outputs.po_files_to_check }}
+        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 }}
@@ -88,13 +88,5 @@ jobs:
       # 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

@@ -37,7 +37,7 @@ jobs:
           python -m pip install -r base-branch/requirements.txt
       - name: Obtiene lista de archivos con cambios
         id: changed-files
-        uses: tj-actions/changed-files@v41
+        uses: tj-actions/changed-files@v45
         with:
           files: |
             **/*.po
@@ -62,7 +62,7 @@ jobs:
       pull-requests: write
     steps:
       - name: Agregar comentario con entradas faltantes
-        uses: thollander/actions-comment-pull-request@v2
+        uses: thollander/actions-comment-pull-request@v3
         with:
           message: ${{ needs.define-comment.outputs.comment }}
-          comment_tag: missing-entries
+          comment-tag: missing-entries

.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

.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

Makefile

@@ -20,6 +20,7 @@ OUTPUT_DOCTREE      := $(CPYTHON_WORKDIR)/Doc/build/doctree
 OUTPUT_HTML         := $(CPYTHON_WORKDIR)/Doc/build/html
 LOCALE_DIR          := $(CPYTHON_WORKDIR)/locale
 POSPELL_TMP_DIR     := .pospell
+SPHINX_JOBS         := auto
 
 
 .PHONY: help
@@ -38,22 +39,15 @@ help:
 #        before this. If passing SPHINXERRORHANDLING='', warnings will not be
 #        treated as errors, which is good to skip simple Sphinx syntax mistakes.
 .PHONY: build
-build: setup
-	# FIXME: Relative paths for includes in 'cpython'
-	# See more about this at https://github.com/python/python-docs-es/issues/1844
-	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
+build: setup do_build
+
+.PHONY: do_build
+do_build:
 	# Normal build
-	PYTHONWARNINGS=ignore::FutureWarning,ignore::RuntimeWarning $(VENV)/bin/sphinx-build -j auto -W --keep-going -b html -d $(OUTPUT_DOCTREE) -D language=$(LANGUAGE) . $(OUTPUT_HTML) && \
+	PYTHONWARNINGS=ignore::FutureWarning,ignore::RuntimeWarning $(VENV)/bin/sphinx-build -j $(SPHINX_JOBS) -W --keep-going -b html -d $(OUTPUT_DOCTREE) -D language=$(LANGUAGE) . $(OUTPUT_HTML) && \
 		echo "Success! Open file://`pwd`/$(OUTPUT_HTML)/index.html, " \
 			"or run 'make serve' to see them in http://localhost:8000";
 
-
 # setup: After running "venv" target, prepare that virtual environment with
 #        a local clone of cpython repository and the translation files.
 #        If the directories exists, only update the cpython repository and

README.md

@@ -1,6 +1,6 @@
 # Traducción al Español de la Documentación de Python
-![Build Status](https://github.com/python/python-docs-es/actions/workflows/main.yml/badge.svg?branch=3.11 "Build Status")
-![Documentation Status](https://readthedocs.org/projects/python-docs-es/badge/?version=3.11 "Documentation Status")
+![Build Status](https://github.com/python/python-docs-es/actions/workflows/main.yml/badge.svg?branch=3.12 "Build Status")
+![Documentation Status](https://readthedocs.org/projects/python-docs-es/badge/?version=3.12 "Documentation Status")
 ## ¿Cómo contribuir?
 
 Tenemos una guía que te ayudará a contribuir. Por favor

TRANSLATORS

@@ -125,8 +125,8 @@ José Carlos Álvarez González (@jcaalzago)
 José Daniel Gonzalez (@jdgc14)
 Jose Ignacio Riaño Chico
 José Luis Cantilo (@jcantilo)
-José Luis Salgado Banda (@josephLSalgado)
 José Miguel Hernández Cabrera (@miguelheca)
+Joseph Salgado (@xooseph)
 Juan Alegría (@zejiran)
 Juan Antonio Lagos (@alochimpasplum)
 Juan Biondi (@yeyeto2788)
@@ -219,6 +219,7 @@ Samantha Valdez A. (@samvaldez)
 Santiago E Fraire Willemoes (@Woile)
 Santiago Piccinini (@spiccinini)
 Screpnik Claudia Raquel
+Sebastian Melo (@CarpioWeen1)
 Sergio Delgado Quintero (@sdelquin)
 Sergio Infante (@neosergio)
 Silvina Tamburini (@silvinabt87)
@@ -229,7 +230,7 @@ Sumit Kashyap
 Summerok
 Tatiana Delgadillo (@Tai543)
 Tony-Rome
-Ulises Alexander Argüelles Monjaraz (@UlisesAlexanderAM)
+Ulises Alexander Arguelles Monjaraz (@UlisesAlexanderAM)
 Victor Carlos (@tuxtitlan)
 Víctor Yelicich
 Victoria Perez Mola (@victoriapm)
@@ -242,3 +243,4 @@ Xavi Rambla Centellas (@xavirambla)
 Yennifer Paola Herrera Ariza (@Yenniferh)
 Yohanna Padrino (@Yo-hanaPR)
 zejiran
+Zodac (@zodacdev)

c-api/apiabiversion.po

@@ -11,15 +11,16 @@ msgstr ""
 "Project-Id-Version: Python 3.8\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2023-10-12 19:43+0200\n"
-"PO-Revision-Date: 2022-10-31 21:13-0300\n"
+"PO-Revision-Date: 2024-10-31 01:00-0400\n"
 "Last-Translator: \n"
-"Language: es\n"
 "Language-Team: python-doc-es\n"
-"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+"Language: es\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=utf-8\n"
 "Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
 "Generated-By: Babel 2.13.0\n"
+"X-Generator: Poedit 3.5\n"
 
 #: ../Doc/c-api/apiabiversion.rst:7
 msgid "API and ABI Versioning"
@@ -182,12 +183,14 @@ msgstr ""
 #: ../Doc/c-api/apiabiversion.rst:61
 msgid "Use this for numeric comparisons, e.g. ``#if PY_VERSION_HEX >= ...``."
 msgstr ""
+"Use esto para comparaciones numéricas, por ejemplo ``#if PY_VERSION_HEX "
+">= ...``."
 
 #: ../Doc/c-api/apiabiversion.rst:63
-#, fuzzy
 msgid "This version is also available via the symbol :c:var:`Py_Version`."
 msgstr ""
-"Esta versión también está disponible a través del símbolo :data:`Py_Version`."
+"Esta versión también está disponible a través del símbolo :c:var:"
+"`Py_Version`."
 
 #: ../Doc/c-api/apiabiversion.rst:67
 msgid ""

c-api/bytearray.po

@@ -11,15 +11,16 @@ msgstr ""
 "Project-Id-Version: Python 3.8\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2023-10-12 19:43+0200\n"
-"PO-Revision-Date: 2022-11-05 12:32-0300\n"
+"PO-Revision-Date: 2024-10-29 21:11-0400\n"
 "Last-Translator: Sofía Denner <sofi.denner@gmail.com>\n"
-"Language: es\n"
 "Language-Team: python-doc-es\n"
-"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+"Language: es\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=utf-8\n"
 "Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
 "Generated-By: Babel 2.13.0\n"
+"X-Generator: Poedit 3.5\n"
 
 #: ../Doc/c-api/bytearray.rst:6
 msgid "Byte Array Objects"
@@ -128,9 +129,8 @@ msgstr ""
 
 #: ../Doc/c-api/bytearray.rst:8
 msgid "object"
-msgstr ""
+msgstr "object"
 
 #: ../Doc/c-api/bytearray.rst:8
-#, fuzzy
 msgid "bytearray"
-msgstr "Objetos de arreglos de bytes (*bytearrays*)"
+msgstr "bytearray"

c-api/float.po

@@ -11,15 +11,16 @@ msgstr ""
 "Project-Id-Version: Python 3.8\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2023-10-12 19:43+0200\n"
-"PO-Revision-Date: 2022-12-01 10:01+0400\n"
+"PO-Revision-Date: 2024-09-26 15:15-0600\n"
 "Last-Translator: Cristián Maureira-Fredes <cmaureirafredes@gmail.com>\n"
-"Language: es\n"
 "Language-Team: python-doc-es\n"
-"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+"Language: es\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=utf-8\n"
 "Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
 "Generated-By: Babel 2.13.0\n"
+"X-Generator: Poedit 3.0.1\n"
 
 #: ../Doc/c-api/float.rst:6
 msgid "Floating Point Objects"
@@ -73,7 +74,6 @@ msgstr ""
 "de error."
 
 #: ../Doc/c-api/float.rst:47
-#, fuzzy
 msgid ""
 "Return a C :c:expr:`double` representation of the contents of *pyfloat*.  If "
 "*pyfloat* is not a Python floating point object but has a :meth:`~object."
@@ -84,16 +84,15 @@ msgid ""
 msgstr ""
 "Retorna una representación C :c:expr:`double` de los contenidos de "
 "*pyfloat*. Si *pyfloat* no es un objeto de punto flotante de Python pero "
-"tiene un método :meth:`__float__`, primero se llamará a este método para "
-"convertir *pyfloat* en un flotante. Si ``__float __()`` no está definido, "
-"entonces recurre a :meth:`__index__`. Este método retorna ``-1.0`` en caso "
-"de falla, por lo que se debe llamar a :c:func:`PyErr_Occurred` para "
-"verificar si hay errores."
+"tiene un método :meth:`~object.__float__`, este método será llamado primero "
+"para convertir *pyfloat* en un flotante. Si :meth:`!__float __` no está "
+"definido, entonces recurre a :meth:`~object.__index__`. Este método retorna "
+"``-1.0`` en caso de falla, por lo que se debe llamar a :c:func:"
+"`PyErr_Occurred` para verificar si hay errores."
 
 #: ../Doc/c-api/float.rst:54
-#, fuzzy
 msgid "Use :meth:`~object.__index__` if available."
-msgstr "Utilice :meth:`__index__` si está disponible."
+msgstr "Utilice :meth:`~object.__index__` si está disponible."
 
 #: ../Doc/c-api/float.rst:60
 msgid ""
@@ -185,7 +184,6 @@ msgid "Pack functions"
 msgstr "Funciones de Empaquetado"
 
 #: ../Doc/c-api/float.rst:109
-#, fuzzy
 msgid ""
 "The pack routines write 2, 4 or 8 bytes, starting at *p*. *le* is an :c:expr:"
 "`int` argument, non-zero if you want the bytes string in little-endian "
@@ -195,12 +193,12 @@ msgid ""
 "to ``1`` on big endian processor, or ``0`` on little endian processor."
 msgstr ""
 "Las rutinas de empaquetado escriben 2, 4 o 8 bytes, comenzando en *p*. *le* "
-"es un argumento :c:expr:`int`, distinto de cero si desea la cadena bytes con "
-"criterio little-endian (exponente al final, en ``p+1``, ``p+3``, o ``p+6`` "
-"``p+7``), cero si se necesita el criterio big-endian (exponente primero, en "
-"*p*). La constante :c:data:`PY_BIG_ENDIAN` se puede usar para usar el endian "
-"nativo: es igual a ``1`` en el procesador big endian, o ``0`` en el "
-"procesador little endian."
+"es un argumento :c:expr:`int`, distinto de cero si desea que la cadena de "
+"bytes esté en formato little-endian (exponente al final, en ``p+1``, "
+"``p+3``, o ``p+6`` ``p+7``), y cero si desea el formato big-endian "
+"(exponente primero, en *p*). La constante :c:macro:`PY_BIG_ENDIAN` se puede "
+"usar para emplear el endian nativo: es igual a ``1`` en el procesador big-"
+"endian, o ``0`` en el procesador little-endian."
 
 #: ../Doc/c-api/float.rst:116
 msgid ""
@@ -242,7 +240,6 @@ msgid "Unpack functions"
 msgstr "Funciones de Desempaquetado"
 
 #: ../Doc/c-api/float.rst:140
-#, fuzzy
 msgid ""
 "The unpack routines read 2, 4 or 8 bytes, starting at *p*.  *le* is an :c:"
 "expr:`int` argument, non-zero if the bytes string is in little-endian format "
@@ -251,13 +248,13 @@ msgid ""
 "be used to use the native endian: it is equal to ``1`` on big endian "
 "processor, or ``0`` on little endian processor."
 msgstr ""
-"Las rutinas de desempaquetado leen 2, 4 o 8 bytes, comenzando en *p*. *le* "
-"es un argumento :c:expr:`int` , distinto de cero si la cadena bytes usa el "
-"criterio little-endian (exponente al final, en ``p+1``, ``p+3`` o ``p+6`` y "
-"``p+7``), cero si usa el criterio big-endian (exponente primero, en *p*). La "
-"constante :c:data:`PY_BIG_ENDIAN` se puede usar para usar el endian: es "
-"igual a ``1`` en el procesador big endian, o ``0`` en el procesador little "
-"endian."
+"Las rutinas de desempaquetado leen 2, 4 u 8 bytes, comenzando en *p*. *le* "
+"es un argumento :c:expr:`int` , distinto de cero si la cadena bytes está en "
+"formato little-endian (exponente al final, en ``p+1``, ``p+3`` o ``p+6`` y "
+"``p+7``), cero si está en formato big-endian (exponente primero, en *p*). La "
+"constante :c:macro:`PY_BIG_ENDIAN` se puede usar para utilizar el endian "
+"nativo: es igual a ``1`` en un procesador big endian, o ``0`` en un "
+"procesador little-endian."
 
 #: ../Doc/c-api/float.rst:147
 msgid ""
@@ -294,9 +291,8 @@ msgstr ""
 
 #: ../Doc/c-api/float.rst:8
 msgid "object"
-msgstr ""
+msgstr "object"
 
 #: ../Doc/c-api/float.rst:8
-#, fuzzy
 msgid "floating point"
-msgstr "Objetos de punto flotante"
+msgstr "floating point"

c-api/marshal.po

@@ -11,15 +11,16 @@ msgstr ""
 "Project-Id-Version: Python 3.8\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2023-10-12 19:43+0200\n"
-"PO-Revision-Date: 2022-10-30 17:51-0600\n"
+"PO-Revision-Date: 2024-10-28 21:01-0400\n"
 "Last-Translator: Cristián Maureira-Fredes <cmaureirafredes@gmail.com>\n"
-"Language: es\n"
 "Language-Team: python-doc-es\n"
-"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+"Language: es\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=utf-8\n"
 "Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
 "Generated-By: Babel 2.13.0\n"
+"X-Generator: Poedit 3.5\n"
 
 #: ../Doc/c-api/marshal.rst:6
 msgid "Data marshalling support"
@@ -73,6 +74,8 @@ msgid ""
 "This function can fail, in which case it sets the error indicator. Use :c:"
 "func:`PyErr_Occurred` to check for that."
 msgstr ""
+"Esta función puede fallar, en cuyo caso establece el indicador de error. "
+"Utiliza :c:func:`PyErr_Occurred` para comprobarlo."
 
 #: ../Doc/c-api/marshal.rst:33
 msgid ""