Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit 30a65e1

Browse files
xoosephxooseph
committed
merge 3.11
2 parents fce45df + 92c1afc commit 30a65e1

File tree

192 files changed

+4238
-3142
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

192 files changed

+4238
-3142
lines changed

‎.github/dependabot.yml

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
# Set update schedule for GitHub Actions
2+
3+
version: 2
4+
updates:
5+
6+
- package-ecosystem: "github-actions"
7+
directory: "/"
8+
schedule:
9+
# Check for updates to GitHub Actions every week
10+
interval: "weekly"
11+

‎.github/workflows/main.yml

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,9 @@ jobs:
1111
name: Test
1212
runs-on: ubuntu-22.04
1313
steps:
14-
- uses: actions/checkout@v2
14+
- uses: actions/checkout@v3
1515
- name: Preparar Python v3.11
16-
uses: actions/setup-python@v2
16+
uses: actions/setup-python@v4
1717
with:
1818
python-version: "3.11"
1919
- name: Sincronizar con CPython
@@ -32,6 +32,9 @@ jobs:
3232
diff -Naur TRANSLATORS <(LANG=es python scripts/sort.py < TRANSLATORS)
3333
- name: Powrap
3434
run: powrap --check --quiet **/*.po
35+
- name: Sphinx lint
36+
run: |
37+
sphinx-lint */*.po
3538
- name: Pospell
3639
run: |
3740
python scripts/check_spell.py

‎.overrides/reviewers-guide.rst

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -48,6 +48,43 @@ Tres razones por las que puede fallar el *build* de Travis:
4848

4949
Para facilitar la comparación de ficheros se emplea este programa que va a hacer que todas las líneas tengan el mismo tamaño. Solucionar este problema en nuestra traducción es muy sencillo, solo hay que instalar la herramienta powrap en nuestro entorno y ejecutar el comando ``powrap nuestro_fichero.po``
5050

51+
``sphinx-lint`` falla
52+
---------------------
53+
54+
El formato en el que la documentación de python está escrito
55+
(`reStructredText <https://es.wikipedia.org/wiki/ReStructuredText>`_ , o rst)
56+
puede ser difícil de manejar y escribir correctamente.
57+
``sphinx-lint`` ayuda a encontrar errores comunes al momento de escribir
58+
entradas en este formato, y advierte al respecto.
59+
60+
Entre los errores más comunes están:
61+
62+
* Textos literales no están separados por un espacio
63+
respecto a las palabras que lo rodean:
64+
65+
* Mal: :literal:`no hay espacio antes del\`\`literal\`\``
66+
* Mal: :literal:`después del \`\`literal \`\`no hay un espacio`
67+
* Bien: :literal:`hay espacio antes del \`\`literal\`\` y después también`
68+
69+
* Textos literales comienzan o terminan con espacios:
70+
71+
* Mal: :literal:`\`\` literal empieza con un espacio\`\``
72+
* Mal: :literal:`\`\`literal termina con un espacio \`\``
73+
* Bien: :literal:`\`\`literal no termina ni empieza con espacios\`\``
74+
75+
* Textos literales no están delineados con dos acentos fuertes:
76+
77+
* Mal: :literal:`\`\`falta uno al final :(\``
78+
* Mal: :literal:`\`falta uno al principio :(\`\``
79+
* Bien: :literal:`\`\`todo bien :)\`\``
80+
81+
* Enlaces no terminan en un guión bajo:
82+
83+
* Mal: :literal:`\`<https://python.org>\``
84+
* Mal: :literal:`\`Python <https://python.org>\``
85+
* Bien: :literal:`\`<https://python.org>\`_`
86+
* Bien: :literal:`\`Python <https://python.org>\`_`
87+
5188

5289
``pospell`` falla
5390
---------------------

‎.pre-commit-config.yaml

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,3 +11,9 @@ repos:
1111
language: python
1212
additional_dependencies: ['pospell>=1.1']
1313
files: \.po$
14+
- id: lint
15+
name: Run sphinx linting
16+
entry: sphinx-lint
17+
language: python
18+
additional_dependencies: ['sphinx-lint==0.6.7']
19+
files: \.po$

‎Makefile

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -99,6 +99,10 @@ progress: venv
9999
spell: venv
100100
$(VENV)/bin/python scripts/check_spell.py
101101

102+
.PHONY: lint
103+
lint: venv
104+
$(VENV)/bin/python -m sphinxlint */*.po
105+
102106

103107
.PHONY: wrap
104108
wrap: venv

‎TRANSLATORS

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -182,6 +182,7 @@ Paula Aragón (@pandrearro)
182182
Pedro Aaron (@paaaron)
183183
Pedro Jorge De Los Santos
184184
Qkolnek
185+
Rafael Juarez Laureano
185186
Ramiro Algozino (@ralgozino)
186187
Ramón Salado (@ramsal)
187188
Raúl Cumplido (@raulcd)

‎c-api/abstract.po

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -46,4 +46,4 @@ msgstr ""
4646
"No es posible utilizar estas funciones en objetos que no se inicializan "
4747
"correctamente, como un objeto de lista que ha sido creado por :c:func:"
4848
"`PyList_New`, pero cuyos elementos no se han establecido en algunos valores "
49-
"no-\\``NULL`` aún."
49+
"no-\\ ``NULL`` aún."

‎c-api/buffer.po

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -329,7 +329,7 @@ msgid ""
329329
"strides` and :c:member:`~Py_buffer.suboffsets` MUST be ``NULL``."
330330
msgstr ""
331331
"El número de dimensiones que representa la memoria como un arreglo n-"
332-
"dimensional. Si es `` 0``, :c:member:`~Py_buffer.buf` apunta a un solo "
332+
"dimensional. Si es ``0``, :c:member:`~Py_buffer.buf` apunta a un solo "
333333
"elemento que representa un escalar. En este caso, :c:member:`~Py_buffer."
334334
"shape`, :c:member:`~Py_buffer.strides` y :c:member:`~Py_buffer.suboffsets` "
335335
"DEBE ser ``NULL``."

‎c-api/bytes.po

Lines changed: 10 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -11,22 +11,22 @@ msgstr ""
1111
"Project-Id-Version: Python 3.8\n"
1212
"Report-Msgid-Bugs-To: \n"
1313
"POT-Creation-Date: 2022-10-25 19:47+0200\n"
14-
"PO-Revision-Date: 2021-08-01 20:18+0200\n"
14+
"PO-Revision-Date: 2022-11-01 11:48+0100\n"
1515
"Last-Translator: Cristián Maureira-Fredes <[email protected]>\n"
16-
"Language: es\n"
1716
"Language-Team: python-doc-es\n"
18-
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
17+
"Language: es\n"
1918
"MIME-Version: 1.0\n"
2019
"Content-Type: text/plain; charset=utf-8\n"
2120
"Content-Transfer-Encoding: 8bit\n"
21+
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
2222
"Generated-By: Babel 2.10.3\n"
23+
"X-Generator: Poedit 3.2\n"
2324

2425
#: ../Doc/c-api/bytes.rst:6
2526
msgid "Bytes Objects"
2627
msgstr "Objetos Bytes"
2728

2829
#: ../Doc/c-api/bytes.rst:8
29-
#, fuzzy
3030
msgid ""
3131
"These functions raise :exc:`TypeError` when expecting a bytes parameter and "
3232
"called with a non-bytes parameter."
@@ -197,7 +197,7 @@ msgstr ":attr:`%zd`"
197197

198198
#: ../Doc/c-api/bytes.rst:87
199199
msgid ":c:type:`\\ Py_ssize_t`"
200-
msgstr ""
200+
msgstr ":c:type:`\\ Py_ssize_t`"
201201

202202
#: ../Doc/c-api/bytes.rst:87
203203
msgid "Equivalent to ``printf(\"%zd\")``. [1]_"
@@ -304,7 +304,6 @@ msgid "Return the length of the bytes in bytes object *o*."
304304
msgstr "Retorna la longitud de los bytes en el objeto bytes *o*."
305305

306306
#: ../Doc/c-api/bytes.rst:137
307-
#, fuzzy
308307
msgid "Similar to :c:func:`PyBytes_Size`, but without error checking."
309308
msgstr ""
310309
"Forma macro de :c:func:`PyBytes_Size` pero sin verificación de errores."
@@ -320,15 +319,14 @@ msgid ""
320319
"`PyBytes_AsString` returns ``NULL`` and raises :exc:`TypeError`."
321320
msgstr ""
322321
"Retorna un puntero al contenido de *o*. El puntero se refiere al búfer "
323-
"interno de *o*, que consiste en bytes ``len(o) + 1``. El último byte en el "
322+
"interno de *o*, que consiste en ``len(o) + 1`` bytes. El último byte en el "
324323
"búfer siempre es nulo, independientemente de si hay otros bytes nulos. Los "
325324
"datos no deben modificarse de ninguna manera, a menos que el objeto se haya "
326325
"creado usando ``PyBytes_FromStringAndSize(NULL, size)``. No debe ser "
327326
"desasignado. Si *o* no es un objeto de bytes en absoluto, :c:func:"
328327
"`PyBytes_AsString` retorna ``NULL`` y lanza un :exc:`TypeError`."
329328

330329
#: ../Doc/c-api/bytes.rst:154
331-
#, fuzzy
332330
msgid "Similar to :c:func:`PyBytes_AsString`, but without error checking."
333331
msgstr ""
334332
"Forma macro de :c:func:`PyBytes_AsString` pero sin verificación de errores."
@@ -348,7 +346,7 @@ msgid ""
348346
"raised."
349347
msgstr ""
350348
"Si *length* es ``NULL``, el objeto bytes no puede contener bytes nulos "
351-
"incrustados; si lo hace, la función retorna ``-1`` y se lanza un :exc:"
349+
"incrustados; en caso contrario, la función retorna ``-1`` y se lanza un :exc:"
352350
"`ValueError`."
353351

354352
#: ../Doc/c-api/bytes.rst:166
@@ -361,8 +359,8 @@ msgid ""
361359
"returns ``-1`` and raises :exc:`TypeError`."
362360
msgstr ""
363361
"El búfer se refiere a un búfer interno de *obj*, que incluye un byte nulo "
364-
"adicional al final (sin contar en *length*). Los datos no deben modificarse "
365-
"de ninguna manera, a menos que el objeto se haya creado usando "
362+
"adicional al final (no está considerado en *length*). Los datos no deben "
363+
"modificarse de ninguna manera, a menos que el objeto se haya creado usando "
366364
"``PyBytes_FromStringAndSize(NULL, size)``. No debe ser desasignado. Si *obj* "
367365
"no es un objeto bytes en absoluto, :c:func:`PyBytes_AsStringAndSize` retorna "
368366
"``-1`` y lanza :exc:`TypeError`."
@@ -387,7 +385,7 @@ msgstr ""
387385
"*newpart* agregado a *bytes*; la persona que llama poseerá la nueva "
388386
"referencia. La referencia al valor anterior de *bytes* será robada. Si no se "
389387
"puede crear el nuevo objeto, la referencia anterior a *bytes* se seguirá "
390-
"descartando y el valor de *\\*bytes* se establecerá en ``NULL``; Se "
388+
"descartando y el valor de *\\*bytes* se establecerá en ``NULL``; se "
391389
"establecerá la excepción apropiada."
392390

393391
#: ../Doc/c-api/bytes.rst:189

‎c-api/init.po

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -990,10 +990,10 @@ msgstr ""
990990
"esto se forma a partir del nombre \"oficial\" del sistema operativo, "
991991
"convertido a minúsculas, seguido del número de revisión principal; por "
992992
"ejemplo, para Solaris 2.x, que también se conoce como SunOS 5.x, el valor es "
993-
"``'sunos5'``. En macOS, es `` 'darwin'``. En Windows, es ``'win'``. La "
994-
"cadena de caracteres retornada apunta al almacenamiento estático; la persona "
995-
"que llama no debe modificar su valor. El valor está disponible para el "
996-
"código de Python como ``sys.platform``."
993+
"``'sunos5'``. En macOS, es ``'darwin'``. En Windows, es ``'win'``. La cadena "
994+
"de caracteres retornada apunta al almacenamiento estático; la persona que "
995+
"llama no debe modificar su valor. El valor está disponible para el código de "
996+
"Python como ``sys.platform``."
997997

998998
#: ../Doc/c-api/init.rst:574
999999
msgid ""
@@ -1117,7 +1117,7 @@ msgstr ""
11171117
"para otros fines que no sean ejecutar una sola secuencia de comandos "
11181118
"(*script*) pasen ``0`` como *updatepath* y actualicen :data:`sys.path` si lo "
11191119
"desean. Ver `CVE-2008-5983 <https://cve.mitre.org/cgi-bin/cvename.cgi?"
1120-
"name=CVE-2008-5983>` _."
1120+
"name=CVE-2008-5983>`_."
11211121

11221122
#: ../Doc/c-api/init.rst:656
11231123
msgid ""

‎c-api/init_config.po

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2412,7 +2412,7 @@ msgstr "``pyvenv.cfg``"
24122412

24132413
#: ../Doc/c-api/init_config.rst:1463
24142414
msgid "``._pth`` file (ex: ``python._pth``)"
2415-
msgstr "archivo``._pth`` (ej: ``python._pth``)"
2415+
msgstr "archivo ``._pth`` (ej: ``python._pth``)"
24162416

24172417
#: ../Doc/c-api/init_config.rst:1464
24182418
msgid "``pybuilddir.txt`` (Unix only)"

‎c-api/intro.po

Lines changed: 32 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -11,15 +11,16 @@ msgstr ""
1111
"Project-Id-Version: Python 3.8\n"
1212
"Report-Msgid-Bugs-To: \n"
1313
"POT-Creation-Date: 2022-10-25 19:47+0200\n"
14-
"PO-Revision-Date: 2021-12-09 10:48+0800\n"
15-
"Last-Translator: Rodrigo Tobar <[email protected]>\n"
16-
"Language: es\n"
14+
"PO-Revision-Date: 2022-11-14 17:55-0500\n"
15+
"Last-Translator: David Orejuela <[email protected]>\n"
1716
"Language-Team: python-doc-es\n"
18-
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
17+
"Language: es\n"
1918
"MIME-Version: 1.0\n"
2019
"Content-Type: text/plain; charset=utf-8\n"
2120
"Content-Transfer-Encoding: 8bit\n"
21+
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
2222
"Generated-By: Babel 2.10.3\n"
23+
"X-Generator: Poedit 3.2\n"
2324

2425
#: ../Doc/c-api/intro.rst:8
2526
msgid "Introduction"
@@ -237,30 +238,43 @@ msgid ""
237238
"Ask the compiler to always inline a static inline function. The compiler can "
238239
"ignore it and decides to not inline the function."
239240
msgstr ""
241+
"Ordena al compilador a siempre usar inline en una función estática inline. "
242+
"El compilador puede ignorarlo y decidir no usar inline en la función."
240243

241244
#: ../Doc/c-api/intro.rst:119
242245
msgid ""
243246
"It can be used to inline performance critical static inline functions when "
244247
"building Python in debug mode with function inlining disabled. For example, "
245248
"MSC disables function inlining when building in debug mode."
246249
msgstr ""
250+
"Puede ser usado para usar inline en funciones estáticas inline de "
251+
"rendimiento crítico cuando se corre Python en modo de depuración con inline "
252+
"de funciones deshabilitado. Por ejemplo, MSC deshabilita el inline de "
253+
"funciones cuando se configura en modo de depuración."
247254

248255
#: ../Doc/c-api/intro.rst:123
249256
msgid ""
250257
"Marking blindly a static inline function with Py_ALWAYS_INLINE can result in "
251258
"worse performances (due to increased code size for example). The compiler is "
252259
"usually smarter than the developer for the cost/benefit analysis."
253260
msgstr ""
261+
"Marcar ciegamente una función estática inline con Py_ALWAYS_INLINE puede "
262+
"resultar en peor rendimientos (debido a un aumento del tamaño del código, "
263+
"por ejemplo). El compilador es generalmente más inteligente que el "
264+
"desarrollador para el análisis costo/beneficio."
254265

255266
#: ../Doc/c-api/intro.rst:127
256267
msgid ""
257268
"If Python is :ref:`built in debug mode <debug-build>` (if the ``Py_DEBUG`` "
258269
"macro is defined), the :c:macro:`Py_ALWAYS_INLINE` macro does nothing."
259270
msgstr ""
271+
"Si Python está :ref:`configurado en modo de depuración <debug-build>` (si el "
272+
"macro ``Py_DEBUG`` está definido), el macro :c:macro:`Py_ALWAYS_INLINE` no "
273+
"hace nada."
260274

261275
#: ../Doc/c-api/intro.rst:130
262276
msgid "It must be specified before the function return type. Usage::"
263-
msgstr ""
277+
msgstr "Debe ser especificado antes del tipo de retorno de la función. Uso::"
264278

265279
#: ../Doc/c-api/intro.rst:138
266280
msgid ""
@@ -314,10 +328,13 @@ msgid ""
314328
"consumption: useful on LTO+PGO builds which heavily inline code (see :issue:"
315329
"`33720`)."
316330
msgstr ""
331+
"Deshabilita el uso de inline en una función. Por ejemplo, reduce el consumo "
332+
"de la pila C: útil en compilaciones LTO+PGO que usan mucho inline (ver :"
333+
"issue:`33720`)."
317334

318335
#: ../Doc/c-api/intro.rst:182
319336
msgid "Usage::"
320-
msgstr ""
337+
msgstr "Uso::"
321338

322339
#: ../Doc/c-api/intro.rst:190
323340
msgid ""
@@ -812,6 +829,10 @@ msgid ""
812829
"type). See :pep:`353` for details. ``PY_SSIZE_T_MAX`` is the largest "
813830
"positive value of type :c:type:`Py_ssize_t`."
814831
msgstr ""
832+
"Un tipo integral con signo tal que ``sizeof(Py_ssize_t) == sizeof(size_t)``. "
833+
"C99 no define directamente tal cosa (size_t es un tipo integral sin signo). "
834+
"Vea :pep:`353` para más detalles. ``PY_SSIZE_T_MAX`` es el valor positivo "
835+
"más grande del tipo :c:type:`Py_ssize_t`."
815836

816837
#: ../Doc/c-api/intro.rst:551
817838
msgid "Exceptions"
@@ -1025,6 +1046,11 @@ msgid ""
10251046
"later, setting :c:member:`PyConfig.argv` and :c:member:`PyConfig.parse_argv` "
10261047
"must be set: see :ref:`Python Initialization Configuration <init-config>`."
10271048
msgstr ""
1049+
":c:func:`Py_Initialize` no establece la \"lista de argumentos de "
1050+
"script\" (``sys.argv``). Si esta variable es necesaria por el código Python "
1051+
"que se ejecutará más tarde, debe establecerse :c:member:`PyConfig.argv` y :c:"
1052+
"member:`PyConfig.parse_argv`: consulte :ref:`Python Initialization "
1053+
"Configuration <init-config>`."
10281054

10291055
#: ../Doc/c-api/intro.rst:724
10301056
msgid ""
@@ -1191,15 +1217,3 @@ msgid ""
11911217
msgstr ""
11921218
"Consulte :file:`Misc/SpecialBuilds.txt` en la distribución fuente de Python "
11931219
"para obtener información más detallada."
1194-
1195-
#~ msgid ""
1196-
#~ ":c:func:`Py_Initialize` does not set the \"script argument list\" (``sys."
1197-
#~ "argv``). If this variable is needed by Python code that will be executed "
1198-
#~ "later, it must be set explicitly with a call to ``PySys_SetArgvEx(argc, "
1199-
#~ "argv, updatepath)`` after the call to :c:func:`Py_Initialize`."
1200-
#~ msgstr ""
1201-
#~ ":c:func:`Py_Initialize` no establece la \"lista de argumentos de "
1202-
#~ "script\" (``sys.argv``). Si el código de Python necesita esta variable "
1203-
#~ "que se ejecutará más adelante, debe establecerse explícitamente con una "
1204-
#~ "llamada a ``PySys_SetArgvEx(argc, argv, updatepath)`` después de la "
1205-
#~ "llamada a :c:func:`Py_Initialize`."

‎c-api/memory.po

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1030,12 +1030,12 @@ msgid ""
10301030
"``*(p+j)`` exclusive; note that the treatment of negative indices differs "
10311031
"from a Python slice):"
10321032
msgstr ""
1033-
"Sea *S*=``sizeof(size_t)``. Se agregan ``2*S`` bytes en cada extremo de cada "
1034-
"bloque de *N* bytes solicitados. El diseño de la memoria es así, donde p "
1035-
"representa la dirección retornada por una función similar a malloc o realloc "
1036-
"(``p[i:j]`` significa el segmento de bytes de ``*(p+i)`` inclusive hasta "
1037-
"``*(p+j)`` exclusivo; tenga en cuenta que el tratamiento de los índices "
1038-
"negativos difiere de un segmento de Python):"
1033+
"Sea *S* = ``sizeof(size_t)``. Se agregan ``2*S`` bytes en cada extremo de "
1034+
"cada bloque de *N* bytes solicitados. El diseño de la memoria es así, donde "
1035+
"p representa la dirección retornada por una función similar a malloc o "
1036+
"realloc (``p[i:j]`` significa el segmento de bytes de ``*(p+i)`` inclusive "
1037+
"hasta ``*(p+j)`` exclusivo; tenga en cuenta que el tratamiento de los "
1038+
"índices negativos difiere de un segmento de Python):"
10391039

10401040
#: ../Doc/c-api/memory.rst:534
10411041
msgid "``p[-2*S:-S]``"

‎c-api/objbuffer.po

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -46,11 +46,10 @@ msgid ""
4646
"`PyArg_ParseTuple` family of functions) to get a buffer view over an object, "
4747
"and :c:func:`PyBuffer_Release` when the buffer view can be released."
4848
msgstr ""
49-
"Por lo tanto, se recomienda que llame :c:func:`PyObject_GetBuffer` (o "
50-
"``y*``o ``w*`` :ref:`format codes <arg-parsing>` con la familia de "
51-
"funciones :c:func:`PyArg_ParseTuple`) para obtener una vista de búfer sobre "
52-
"un objeto, y :c:func:`PyBuffer_Release` cuando se puede liberar la vista de "
53-
"búfer."
49+
"Por lo tanto, se recomienda que llame :c:func:`PyObject_GetBuffer` (o ``y*`` "
50+
"o ``w*`` :ref:`format codes <arg-parsing>` con la familia de funciones :c:"
51+
"func:`PyArg_ParseTuple`) para obtener una vista de búfer sobre un objeto, y :"
52+
"c:func:`PyBuffer_Release` cuando se puede liberar la vista de búfer."
5453

5554
#: ../Doc/c-api/objbuffer.rst:23
5655
msgid ""

0 commit comments

Comments
 (0)