From 048055e70b812167f8ca1324ac30e5fd6d2c07bf Mon Sep 17 00:00:00 2001 From: Roberto Pastor Muela <37798125+RobPasMue@users.noreply.github.com> Date: Sun, 14 Jul 2024 19:42:39 +0200 Subject: [PATCH 1/2] docs: translating to Spanish complex-python-package-builds.md --- .../es/LC_MESSAGES/package-structure-code.po | 62 +++++++++++++++++-- .../complex-python-package-builds.md | 2 +- 2 files changed, 59 insertions(+), 5 deletions(-) diff --git a/locales/es/LC_MESSAGES/package-structure-code.po b/locales/es/LC_MESSAGES/package-structure-code.po index 90bc3f35..cd683368 100644 --- a/locales/es/LC_MESSAGES/package-structure-code.po +++ b/locales/es/LC_MESSAGES/package-structure-code.po @@ -648,13 +648,15 @@ msgstr "" #: ../../package-structure-code/complex-python-package-builds.md:1 msgid "Complex Python package builds" -msgstr "" +msgstr "Compilaciones complejas de paquetes de Python" #: ../../package-structure-code/complex-python-package-builds.md:3 msgid "" "This guide is focused on packages that are either pure-python or that " "have a few simple extensions in another language such as C or C++." msgstr "" +"Esta guía se centra en paquetes que son Python puros o que tienen unas " +"pocas extensiones simples en otro lenguaje como C o C++." #: ../../package-structure-code/complex-python-package-builds.md:6 msgid "" @@ -669,10 +671,21 @@ msgid "" "an overview and thorough discussion of these nuances, please see [this " "site.](https://pypackaging-native.github.io/)" msgstr "" +"En el futuro, queremos proporcionar recursos para flujos de trabajo de " +"empaquetado que requieran compilaciones más complejas. Si tiene preguntas " +"sobre estos tipos de paquetes, por favor [agregue una pregunta a nuestro " +"foro](https://pyopensci.discourse.group/) o abra una [solicitud sobre esta guía " +"específicamente en el repositorio](https://github.com/pyOpenSci/python-package-guide/issues). " +"Hay muchos matices para construir y distribuir paquetes de Python que tienen " +"extensiones compiladas que requieren dependencias que no están desarrolladas en Python en tiempo de " +"compilación. Para obtener una descripción general y una discusión exhaustiva " +"de estos matices, consulte [este sitio.](https://pypackaging-native.github.io/)" + + #: ../../package-structure-code/complex-python-package-builds.md:8 msgid "Pure Python Packages vs. packages with extensions in other languages" -msgstr "" +msgstr "Paquetes de Python puros vs. paquetes con extensiones en otros lenguajes" #: ../../package-structure-code/complex-python-package-builds.md:10 msgid "" @@ -680,6 +693,9 @@ msgid "" " These categories can in turn help you select the correct package " "frontend and backend tools." msgstr "" +"Se puede clasificar la complejidad de los paquetes de Python en tres categorías. " +"Estas categorías, a su vez, pueden ayudarlo a seleccionar las herramientas de " +"frontend y backend correctas." #: ../../package-structure-code/complex-python-package-builds.md:14 msgid "" @@ -688,6 +704,10 @@ msgid "" "chose a tool below that has the features that you want and be done with " "your decision!" msgstr "" +"**Paquetes de Python puros:** son paquetes que solo dependen de Python para " +"trabajar. Construir un paquete de Python puro es más simple. Como tal, puede " +"elegir una herramienta a continuación que tenga las características que desea y, " +"¡tomar una decisión!." #: ../../package-structure-code/complex-python-package-builds.md:16 msgid "" @@ -700,22 +720,38 @@ msgid "" "that supports additional build setups. We suggest that you chose build " "tool that supports custom build steps like Hatch." msgstr "" +"**Paquetes de Python con extensiones en otros lenguajes:** Estos paquetes tienen " +"componentes adicionales llamados extensiones escritas en otros lenguajes (como C o C++). " +"Si tiene un paquete con extensiones no escritas en Python, entonces debe seleccionar " +"una herramienta de backend de compilación que permita pasos de compilación adicionales " +"necesarios para compilar su código de extensión. Además, si desea utilizar una herramienta " +"de frontend para ayudar a su flujo de trabajo, deberá seleccionar una herramienta que admita " +"configuraciones de compilación adicionales. Sugerimos que elija una herramienta de compilación " +"que admita pasos de compilación personalizados como Hatch." #: ../../package-structure-code/complex-python-package-builds.md:18 msgid "" "**Python packages that have extensions written in different languages " "(e.g. Fortran and C++) or that have non Python dependencies that are " -"difficult to install (e.g. GDAL)** These packages often have complex " +"difficult to install (e.g. GDAL):** These packages often have complex " "build steps (more complex than a package with just a few C extensions for" " instance). As such, these packages require tools such as [scikit-" "build](https://scikit-build.readthedocs.io/en/latest/) or [meson-" "python](https://mesonbuild.com/Python-module.html) to build. NOTE: you " "can use meson-python with PDM." msgstr "" +"**Paquetes de Python que tienen extensiones escritas en diferentes lenguajes " +"(por ejemplo, Fortran y C++) o que tienen dependencias no escritas en Python " +"que son difíciles de instalar (por ejemplo, GDAL):** Estos paquetes a menudo " +"tienen pasos de compilación complejos (más complejos que un paquete con solo " +"algunas extensiones en C, por ejemplo). Como tal, estos paquetes requieren " +"herramientas como [scikit-build](https://scikit-build.readthedocs.io/en/latest/) " +"o [meson-python](https://mesonbuild.com/Python-module.html) para construir. NOTA: " +"puede usar meson-python con PDM." #: ../../package-structure-code/complex-python-package-builds.md:21 msgid "Mixing frontend and backend projects" -msgstr "" +msgstr "Mezclar proyectos de frontend y backend" #: ../../package-structure-code/complex-python-package-builds.md:23 msgid "" @@ -728,6 +764,13 @@ msgid "" "package-build-tools) for more information about frontend and backend " "compatibility." msgstr "" +"A veces es necesario o deseable usar un frontend de compilación con un backend " +"de compilación alternativo. Esto se debe a que algunos frontends no tienen un " +"backend predeterminado (`build`), y esta elección recae en el mantenedor. Otros " +"backends (`hatch`) tienen un backend preferido (`hatchling`) pero permiten al " +"mantenedor migrar a otro, mientras que algunos backends (`poetry`) solo funcionan " +"con un solo backend (`poetry-core`). Consulte (#python-package-build-tools) para " +"obtener más información sobre la compatibilidad de frontend y backend." #: ../../package-structure-code/complex-python-package-builds.md:29 msgid "" @@ -742,6 +785,14 @@ msgid "" "[plugins](https://hatch.pypa.io/1.9/plugins/about/) or be replaced by a " "backend that is already capable of building extension modules." msgstr "" +"En esta guía de empaquetado, recomendamos usar `hatch` junto con su backend " +"preferido `hatchling`. Si bien esto será adecuado para la mayoría de los paquetes, " +"se puede usar un backend alternativo con Hatch si es necesario al crear un módulo de " +"extensión. Un módulo de extensión de Python es uno que está compuesto, ya sea en parte " +"o en su totalidad, de código compilado. En este caso, el backend elegido (como `meson-python`) " +"debe saber cómo compilar el lenguaje de extensión y vincularlo a Python. `hatchling` no sabe " +"cómo hacer esto por sí solo y debe hacer uso de [plugins](https://hatch.pypa.io/1.9/plugins/about/) " +"o ser reemplazado por un backend que ya sea capaz de construir módulos de extensión." #: ../../package-structure-code/complex-python-package-builds.md:37 msgid "" @@ -750,6 +801,9 @@ msgid "" " command, or from following the packaging tutorial, you may have to make " "a change like this" msgstr "" +"Para usar un backend diferente, deberá editar el `pyproject.toml` de su proyecto. " +"Si tiene un `pyproject.toml` generado por el comando `hatch`, o siguiendo el tutorial " +"de empaquetado, es posible que deba hacer un cambio como este" #: ../../package-structure-code/declare-dependencies.md:8 #: ../../package-structure-code/declare-dependencies.md:375 diff --git a/package-structure-code/complex-python-package-builds.md b/package-structure-code/complex-python-package-builds.md index cc9be2f8..0fb8c910 100644 --- a/package-structure-code/complex-python-package-builds.md +++ b/package-structure-code/complex-python-package-builds.md @@ -15,7 +15,7 @@ backend tools. 2. **Python packages with non-Python extensions:** These packages have additional components called extensions written in other languages (such as C or C++). If you have a package with non-Python extensions, then you need to select a build backend tool that allows additional build steps needed to compile your extension code. Further, if you wish to use a frontend tool to support your workflow, you will need to select a tool that supports additional build setups. We suggest that you chose build tool that supports custom build steps like Hatch. -3. **Python packages that have extensions written in different languages (e.g. Fortran and C++) or that have non Python dependencies that are difficult to install (e.g. GDAL)** These packages often have complex build steps (more complex than a package with just a few C extensions for instance). As such, these packages require tools such as [scikit-build](https://scikit-build.readthedocs.io/en/latest/) +3. **Python packages that have extensions written in different languages (e.g. Fortran and C++) or that have non Python dependencies that are difficult to install (e.g. GDAL):** These packages often have complex build steps (more complex than a package with just a few C extensions for instance). As such, these packages require tools such as [scikit-build](https://scikit-build.readthedocs.io/en/latest/) or [meson-python](https://mesonbuild.com/Python-module.html) to build. NOTE: you can use meson-python with PDM. ## Mixing frontend and backend projects From 0d950a57389c1645af0b2bc062f9c5b5811baeb4 Mon Sep 17 00:00:00 2001 From: Roberto Pastor Muela <37798125+RobPasMue@users.noreply.github.com> Date: Mon, 9 Sep 2024 09:25:05 +0200 Subject: [PATCH 2/2] Apply suggestions from code review Co-authored-by: Felipe Moreno --- .../es/LC_MESSAGES/package-structure-code.po | 30 +++++++++---------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/locales/es/LC_MESSAGES/package-structure-code.po b/locales/es/LC_MESSAGES/package-structure-code.po index bcb11e1e..d155a546 100644 --- a/locales/es/LC_MESSAGES/package-structure-code.po +++ b/locales/es/LC_MESSAGES/package-structure-code.po @@ -655,7 +655,7 @@ msgid "" "This guide is focused on packages that are either pure-python or that " "have a few simple extensions in another language such as C or C++." msgstr "" -"Esta guía se centra en paquetes que son Python puros o que tienen unas " +"Esta guía se centra en paquetes que solamente utilizan Python o que tienen unas " "pocas extensiones simples en otro lenguaje como C o C++." #: ../../package-structure-code/complex-python-package-builds.md:6 @@ -674,11 +674,11 @@ msgstr "" "En el futuro, queremos proporcionar recursos para flujos de trabajo de " "empaquetado que requieran compilaciones más complejas. Si tiene preguntas " "sobre estos tipos de paquetes, por favor [agregue una pregunta a nuestro " -"foro](https://pyopensci.discourse.group/) o abra una [solicitud sobre esta guía " +"foro](https://pyopensci.discourse.group/) o abra una [issue sobre esta guía " "específicamente en el repositorio](https://github.com/pyOpenSci/python-package-guide/issues). " "Hay muchos matices para construir y distribuir paquetes de Python que tienen " -"extensiones compiladas que requieren dependencias que no están desarrolladas en Python en tiempo de " -"compilación. Para obtener una descripción general y una discusión exhaustiva " +"extensiones compiladas que requieren dependencias en otros lenguajes en el momento de " +"construcción del paquete. Para obtener una descripción general y una discusión exhaustiva " "de estos matices, consulte [este sitio.](https://pypackaging-native.github.io/)" @@ -694,8 +694,8 @@ msgid "" "frontend and backend tools." msgstr "" "Se puede clasificar la complejidad de los paquetes de Python en tres categorías. " -"Estas categorías, a su vez, pueden ayudarlo a seleccionar las herramientas de " -"frontend y backend correctas." +"Estas categorías, a su vez, pueden ayudarlo a seleccionar las mejores herramientas de " +"frontend y backend." #: ../../package-structure-code/complex-python-package-builds.md:14 msgid "" @@ -705,9 +705,9 @@ msgid "" "your decision!" msgstr "" "**Paquetes de Python puros:** son paquetes que solo dependen de Python para " -"trabajar. Construir un paquete de Python puro es más simple. Como tal, puede " -"elegir una herramienta a continuación que tenga las características que desea y, " -"¡tomar una decisión!." +"funcionar. Construir un paquete de Python puro es más simple. Como tal, puede " +"elegir una herramienta a continuación que tenga las características que desea " +"sin tener que considerar muchos detalles." #: ../../package-structure-code/complex-python-package-builds.md:16 msgid "" @@ -722,12 +722,12 @@ msgid "" msgstr "" "**Paquetes de Python con extensiones en otros lenguajes:** Estos paquetes tienen " "componentes adicionales llamados extensiones escritas en otros lenguajes (como C o C++). " -"Si tiene un paquete con extensiones no escritas en Python, entonces debe seleccionar " +"Si tiene un paquete con extensiones no escritas en otros lenguajes, debe seleccionar " "una herramienta de backend de compilación que permita pasos de compilación adicionales " -"necesarios para compilar su código de extensión. Además, si desea utilizar una herramienta " +"necesarios para compilar su código en estos lenguajes. Además, si desea utilizar una herramienta " "de frontend para ayudar a su flujo de trabajo, deberá seleccionar una herramienta que admita " "configuraciones de compilación adicionales. Sugerimos que elija una herramienta de compilación " -"que admita pasos de compilación personalizados como Hatch." +"que admita pasos de compilación personalizados como por ejemplo Hatch." #: ../../package-structure-code/complex-python-package-builds.md:18 msgid "" @@ -789,10 +789,10 @@ msgstr "" "preferido `hatchling`. Si bien esto será adecuado para la mayoría de los paquetes, " "se puede usar un backend alternativo con Hatch si es necesario al crear un módulo de " "extensión. Un módulo de extensión de Python es uno que está compuesto, ya sea en parte " -"o en su totalidad, de código compilado. En este caso, el backend elegido (como `meson-python`) " +"o en su totalidad, de código compilado en otro lenguaje. En este caso, el backend elegido (como `meson-python`) " "debe saber cómo compilar el lenguaje de extensión y vincularlo a Python. `hatchling` no sabe " "cómo hacer esto por sí solo y debe hacer uso de [plugins](https://hatch.pypa.io/1.9/plugins/about/) " -"o ser reemplazado por un backend que ya sea capaz de construir módulos de extensión." +"o cambiar un backend que sea capaz de construir módulos de extensión." #: ../../package-structure-code/complex-python-package-builds.md:37 msgid "" @@ -803,7 +803,7 @@ msgid "" msgstr "" "Para usar un backend diferente, deberá editar el `pyproject.toml` de su proyecto. " "Si tiene un `pyproject.toml` generado por el comando `hatch`, o siguiendo el tutorial " -"de empaquetado, es posible que deba hacer un cambio como este" +"de empaquetado, probablemente tendrá hacer un cambio como este" #: ../../package-structure-code/declare-dependencies.md:8 #: ../../package-structure-code/declare-dependencies.md:375