Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

docs: translating to Spanish complex-python-package-builds.md #337

Merged
merged 4 commits into from
Sep 14, 2024
Merged

docs: translating to Spanish complex-python-package-builds.md #337

Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
048055e
docs: translating to Spanish complex-python-package-builds.md
RobPasMue Jul 14, 2024
8039cdf
Merge branch 'main' into docs/complex-python-package-builds-to-spanish
RobPasMue Aug 12, 2024
0d950a5
Apply suggestions from code review
RobPasMue Sep 9, 2024
65a624b
Merge branch 'main' into docs/complex-python-package-builds-to-spanish
flpm Sep 14, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
62 changes: 58 additions & 4 deletions locales/es/LC_MESSAGES/package-structure-code.po
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 "
RobPasMue marked this conversation as resolved.
Show resolved Hide resolved
"pocas extensiones simples en otro lenguaje como C o C++."

#: ../../package-structure-code/complex-python-package-builds.md:6
msgid ""
Expand All @@ -669,17 +671,31 @@ 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 "
RobPasMue marked this conversation as resolved.
Show resolved Hide resolved
"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 "
RobPasMue marked this conversation as resolved.
Show resolved Hide resolved
"compilación. Para obtener una descripción general y una discusión exhaustiva "
RobPasMue marked this conversation as resolved.
Show resolved Hide resolved
"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 ""
"You can classify Python package complexity into three general categories."
" 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 "
RobPasMue marked this conversation as resolved.
Show resolved Hide resolved
"frontend y backend correctas."
RobPasMue marked this conversation as resolved.
Show resolved Hide resolved

#: ../../package-structure-code/complex-python-package-builds.md:14
msgid ""
Expand All @@ -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 "
RobPasMue marked this conversation as resolved.
Show resolved Hide resolved
"elegir una herramienta a continuación que tenga las características que desea y, "
RobPasMue marked this conversation as resolved.
Show resolved Hide resolved
"¡tomar una decisión!."
RobPasMue marked this conversation as resolved.
Show resolved Hide resolved

#: ../../package-structure-code/complex-python-package-builds.md:16
msgid ""
Expand All @@ -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 "
RobPasMue marked this conversation as resolved.
Show resolved Hide resolved
"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 "
RobPasMue marked this conversation as resolved.
Show resolved Hide resolved
"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."
RobPasMue marked this conversation as resolved.
Show resolved Hide resolved

#: ../../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 ""
Expand All @@ -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 ""
Expand All @@ -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`) "
RobPasMue marked this conversation as resolved.
Show resolved Hide resolved
"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."
RobPasMue marked this conversation as resolved.
Show resolved Hide resolved

#: ../../package-structure-code/complex-python-package-builds.md:37
msgid ""
Expand All @@ -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"
RobPasMue marked this conversation as resolved.
Show resolved Hide resolved

#: ../../package-structure-code/declare-dependencies.md:8
#: ../../package-structure-code/declare-dependencies.md:375
Expand Down
2 changes: 1 addition & 1 deletion package-structure-code/complex-python-package-builds.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Loading