From 138e8a1b983546f10aa0a1430c64899b303a9c12 Mon Sep 17 00:00:00 2001 From: Roberto Pastor Muela <37798125+RobPasMue@users.noreply.github.com> Date: Sun, 14 Jul 2024 19:44:41 +0200 Subject: [PATCH 1/2] docs: translate to Spanish declare-dependencies.md --- .../es/LC_MESSAGES/package-structure-code.po | 288 ++++++++++++++---- 1 file changed, 233 insertions(+), 55 deletions(-) diff --git a/locales/es/LC_MESSAGES/package-structure-code.po b/locales/es/LC_MESSAGES/package-structure-code.po index 90bc3f35..067b7a41 100644 --- a/locales/es/LC_MESSAGES/package-structure-code.po +++ b/locales/es/LC_MESSAGES/package-structure-code.po @@ -755,7 +755,7 @@ msgstr "" #: ../../package-structure-code/declare-dependencies.md:375 #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:25 msgid "Todo" -msgstr "" +msgstr "Todo" #: ../../package-structure-code/declare-dependencies.md:10 msgid "" @@ -784,33 +784,35 @@ msgstr "" #: ../../package-structure-code/declare-dependencies.md:22 msgid "Python Package Dependencies" -msgstr "" +msgstr "Dependencias de paquetes de Python" #: ../../package-structure-code/declare-dependencies.md:24 msgid "What is a package dependency?" -msgstr "" +msgstr "¿Qué es una dependencia de paquete?" #: ../../package-structure-code/declare-dependencies.md:26 msgid "" "A Python package dependency refers to an external package or software " "that your Python project:" msgstr "" +"Una dependencia de paquete de Python se refiere a un paquete externo o " +"software que su proyecto de Python:" #: ../../package-structure-code/declare-dependencies.md:29 msgid "needs to function properly." -msgstr "" +msgstr "neceista para funcionar correctamente." #: ../../package-structure-code/declare-dependencies.md:30 msgid "" "requires if someone wants to develop / work on improving your package " "locally or" -msgstr "" +msgstr "requiere si alguien quiere desarrollar / trabajar en mejorar su paquete localmente o" #: ../../package-structure-code/declare-dependencies.md:31 msgid "" "requires if a user wants to add additional functionality (that is not " "core) to your package" -msgstr "" +msgstr "requiere si un usuario quiere agregar funcionalidad adicional (que no es esencial) a su paquete" #: ../../package-structure-code/declare-dependencies.md:33 msgid "" @@ -818,10 +820,12 @@ msgid "" "software that is called within the code of your project or during " "development of your package." msgstr "" +"Una dependencia no es parte del código de su proyecto. Es un paquete o " +"software que se llama dentro del código de su proyecto o durante el desarrollo de su paquete." #: ../../package-structure-code/declare-dependencies.md:37 msgid "Understanding optional vs. required dependencies" -msgstr "" +msgstr "Entendiendo las dependencias opcionales vs. requeridas" #: ../../package-structure-code/declare-dependencies.md:38 msgid "" @@ -830,10 +834,13 @@ msgid "" "your `pyproject.toml` file. If they are optional, they will be listed in " "the `[optional.dependencies]` table of your `pyproject.toml`." msgstr "" +"Puede pensar en las dependencias como opcionales o requeridas. Si son requeridas, " +"se listarán en la tabla `[dependency] =` de su archivo `pyproject.toml`. Si son " +"opcionales, se listarán en la tabla `[optional.dependencies]` de su `pyproject.toml`." #: ../../package-structure-code/declare-dependencies.md:40 msgid "You will learn about both below." -msgstr "" +msgstr "Aprenderá sobre ambos a continuación." #: ../../package-structure-code/declare-dependencies.md:46 msgid "" @@ -848,10 +855,20 @@ msgid "" "optional and add additional functionality to your package. Not all " "packages will have feature dependencies." msgstr "" +"Hay dos grupos amplios de dependencias de paquetes de Python: las que son " +"opcionales y las que son requeridas. Los paquetes requeridos son aquellos que " +"un usuario necesita para usar su paquete. Las dependencias opcionales son " +"paquetes que un usuario puede elegir instalar para agregar funcionalidad a su " +"paquete. Dentro de esos 2 grupos, hay tres casos de uso en los que puede pensar. " +"1. Las dependencias principales son **requeridas** para que un usuario use su paquete. " +"2. Las dependencias de desarrollo son opcionales y solo son necesarias si alguien " +"desea trabajar en su paquete localmente. 3. Finalmente, las dependencias de " +"funcionalidades son opcionales y agregan funcionalidad adicional a su paquete. No " +"todos los paquetes tendrán dependencias de funcionalidades." #: ../../package-structure-code/declare-dependencies.md:51 msgid "Required (or core) dependencies" -msgstr "" +msgstr "Dependencias requeridas (o principales)" #: ../../package-structure-code/declare-dependencies.md:53 msgid "" @@ -861,11 +878,16 @@ msgid "" "required dependencies in the `[dependency]=` table of your " "`pyproject.toml` file." msgstr "" +"Las dependencias requeridas se llaman directamente dentro del código de su " +"paquete. En esta página nos referimos a estas dependencias como **dependencias " +"principales** ya que son necesarias para ejecutar su paquete. Debería colocar " +"las dependencias principales o requeridas en la tabla `[dependency]=` de su " +"archivo `pyproject.toml`." #: ../../package-structure-code/declare-dependencies.md:56 #: ../../package-structure-code/declare-dependencies.md:147 msgid "Optional dependencies" -msgstr "" +msgstr "Dependencias opcionales" #: ../../package-structure-code/declare-dependencies.md:58 msgid "" @@ -873,6 +895,8 @@ msgid "" "depending upon their needs. There are two broad groups of optional " "dependencies:" msgstr "" +"Las dependencias opcionales pueden ser instaladas opcionalmente por los usuarios " +"dependiendo de sus necesidades. Hay dos grupos amplios de dependencias opcionales:" #: ../../package-structure-code/declare-dependencies.md:61 msgid "" @@ -882,12 +906,19 @@ msgid "" "such as `black` and even automation tools such as `nox` or `tox` that run" " tasks." msgstr "" +"**Dependencias de desarrollo**: Estas son dependencias que son necesarias para " +"apoyar el desarrollo de su paquete. Incluyen herramientas para ejecutar pruebas " +"como `pytest`, linters (como `flake8` y `ruff`) y formateadores de código como " +"`black` e incluso herramientas de automatización como `nox` o `tox` que ejecutan " +"tareas." #: ../../package-structure-code/declare-dependencies.md:63 msgid "" "**Feature dependencies:** These are dependencies that a user can chose to" " install to add functionality to your package." msgstr "" +"**Dependencias de funcionalidades:** Estas son dependencias que un usuario puede " +"elegir instalar para agregar funcionalidad a su paquete." #: ../../package-structure-code/declare-dependencies.md:65 msgid "" @@ -896,10 +927,14 @@ msgid "" "This ensures that when you call a function in a specific dependency, it " "is available in your user's environment." msgstr "" +"Cuando se instala un proyecto de Python, el administrador de paquetes de Python " +"(ya sea `pip` o `conda`) instala automáticamente las dependencias de su paquete. " +"Esto garantiza que cuando llame a una función en una dependencia específica, esté " +"disponible en el entorno de su usuario." #: ../../package-structure-code/declare-dependencies.md:70 msgid "Dependencies can be added to your pyproject.toml file" -msgstr "" +msgstr "Las dependencias se pueden agregar a su archivo pyproject.toml" #: ../../package-structure-code/declare-dependencies.md:72 msgid "" @@ -908,10 +943,14 @@ msgid "" " metadata for your package. On this page, you will learn how to specify " "different types of dependencies in your `pyproject.toml`." msgstr "" +"En la página de descripción general de [pyproject.toml](pyproject-toml-python-package-" +"metadata), aprendió cómo configurar un archivo **pyproject.toml** con metadatos " +"básicos para su paquete. En esta página, aprenderá cómo especificar diferentes " +"tipos de dependencias en su `pyproject.toml`." #: ../../package-structure-code/declare-dependencies.md:79 msgid "How do you declare dependencies?" -msgstr "" +msgstr "¿Cómo declarar dependencias?" #: ../../package-structure-code/declare-dependencies.md:81 msgid "" @@ -920,6 +959,10 @@ msgid "" "with your package is declared in a single place, making it simpler for " "users and contributors to understand your package infrastructure." msgstr "" +"Recomendamos que declare sus dependencias utilizando su archivo `pyproject.toml`. " +"Esto garantiza que todos los metadatos asociados con su paquete se declaren en un " +"solo lugar, lo que facilita a los usuarios y colaboradores comprender la infraestructura " +"de su paquete." #: ../../package-structure-code/declare-dependencies.md:86 msgid "" @@ -929,10 +972,15 @@ msgid "" " however that some projects still maintain a `requirements.txt` file for " "specific local development needs." msgstr "" +"Anteriormente, era común usar un archivo `requirements.txt` para declarar las " +"dependencias del paquete. Sin embargo, en los últimos años, el ecosistema ha " +"pasado a almacenar esta información en su archivo **pyproject.toml**. Sin embargo, " +"puede notar que algunos proyectos todavía mantienen un archivo `requirements.txt` " +"para necesidades específicas de desarrollo local." #: ../../package-structure-code/declare-dependencies.md:92 msgid "Other ways you may see packages storing dependencies" -msgstr "" +msgstr "Otros métodos que puede ver para almacenar dependencias de paquetes" #: ../../package-structure-code/declare-dependencies.md:95 msgid "" @@ -943,10 +991,15 @@ msgid "" "documentation](https://setuptools.pypa.io/en/latest/userguide/dependency_management.html" "#declaring-required-dependency)" msgstr "" +"Si un proyecto contiene extensiones escritas en otros lenguajes, es posible que " +"necesite un archivo `setup.py`. O puede contribuir a un paquete que esté utilizando " +"`setup.cfg` para la declaración de dependencias. [Obtenga más información sobre esto en la " +"documentación de setuptools](https://setuptools.pypa.io/en/latest/userguide/dependency_management.html" +"#declaring-required-dependency)" #: ../../package-structure-code/declare-dependencies.md:100 msgid "Add required dependencies to your pyproject.toml file" -msgstr "" +msgstr "Añaadir dependencias requeridas a su archivo pyproject.toml" #: ../../package-structure-code/declare-dependencies.md:102 msgid "" @@ -956,6 +1009,10 @@ msgid "" "`[project]` table of your **pyproject.toml** file. This looks something " "like this:" msgstr "" +"Las dependencias principales de su proyecto deben ser instaladas por un administrador " +"de paquetes como `pip` o `conda` cuando un usuario instala su paquete. Puede agregar " +"esas dependencias a la matriz `dependencies` ubicada dentro de la tabla `[project]` de su " +"archivo **pyproject.toml**. Se asemejará a lo siguiente:" #: ../../package-structure-code/declare-dependencies.md:121 msgid "" @@ -964,16 +1021,22 @@ msgid "" "number of additional packages that your users must install as well as the" " number of packages that depend upon your package must also install." msgstr "" +"Idealmente, solo debería enumerar los paquetes que son necesarios para instalar " +"y usar su paquete en la sección `[dependencies]`. Esto minimiza la cantidad de " +"paquetes adicionales que sus usuarios deben instalar, así como la cantidad de " +"paquetes que dependen de su paquete que también deben instalar." #: ../../package-structure-code/declare-dependencies.md:128 msgid "" "Remember that fewer dependencies to install reduces the likelihood of " "version mismatches in user environments." msgstr "" +"Recuerde que menos dependencias para instalar reduce la probabilidad de " +"desajustes de versiones en los entornos de los usuarios." #: ../../package-structure-code/declare-dependencies.md:131 msgid "A dependency example" -msgstr "" +msgstr "Un ejemplo de dependencia" #: ../../package-structure-code/declare-dependencies.md:133 msgid "" @@ -982,18 +1045,22 @@ msgid "" "`plotMe` package, you use the `seaborn` package to stylize our plots and " "also `numpy` to process array formatted data." msgstr "" +"Digamos que tiene un paquete llamado `plotMe` que crea gráficos hermosos de " +"datos almacenados en matrices `numpy`. Para crear gráficos con el paquete " +"`plotMe`, utiliza el paquete `seaborn` para estilizar los gráficos y " +"también `numpy` para procesar datos formateados en matrices." #: ../../package-structure-code/declare-dependencies.md:135 msgid "In the example above, the plotMe package, depends upon two packages:" -msgstr "" +msgstr "En el ejemplo anterior, el paquete plotMe depende de dos paquetes:" #: ../../package-structure-code/declare-dependencies.md:137 msgid "seaborn" -msgstr "" +msgstr "seaborn" #: ../../package-structure-code/declare-dependencies.md:138 msgid "numpy" -msgstr "" +msgstr "numpy" #: ../../package-structure-code/declare-dependencies.md:140 msgid "" @@ -1001,6 +1068,9 @@ msgid "" "when installed, you also need to ensure that they have both of those " "required `dependencies` installed in their environment too." msgstr "" +"Esto significa que para que plotMe funcione en un `entorno` de usuario cuando " +"se instala, también debe asegurarse de que tengan instaladas esas dos `dependencias` " +"requeridas en su entorno." #: ../../package-structure-code/declare-dependencies.md:142 msgid "" @@ -1009,10 +1079,14 @@ msgid "" " and that a package manager (`pip` or `conda`) will automatically install" " it into a user's environment alongside your package:" msgstr "" +"Declarar una dependencia en su archivo `pyproject.toml` garantizará que se " +"liste como una dependencia requerida cuando su paquete se publique en PyPI y " +"que un administrador de paquetes (`pip` o `conda`) la instalará automáticamente " +"en el entorno de un usuario junto con su paquete:" #: ../../package-structure-code/declare-dependencies.md:144 msgid "`python -m pip install plotMe`" -msgstr "" +msgstr "`python -m pip install plotMe`" #: ../../package-structure-code/declare-dependencies.md:149 msgid "" @@ -1021,18 +1095,22 @@ msgid "" "development dependencies. These are the dependencies that a user needs to" " work on your package locally and perform tasks such as:" msgstr "" +"Las dependencias opcionales para construir su documentación, ejecutar sus tests " +"y construir los archivos de distribución de su paquete a menudo se denominan dependencias " +"de desarrollo. Estas son las dependencias que un usuario necesita para trabajar en su " +"paquete localmente y realizar tareas como:" #: ../../package-structure-code/declare-dependencies.md:151 msgid "running your test suite" -msgstr "" +msgstr "correr su suite de tests" #: ../../package-structure-code/declare-dependencies.md:152 msgid "building your documentation" -msgstr "" +msgstr "construir su documentación" #: ../../package-structure-code/declare-dependencies.md:153 msgid "linting and other code cleanup tools" -msgstr "" +msgstr "linting y otras herramientas de limpieza de código" #: ../../package-structure-code/declare-dependencies.md:155 msgid "" @@ -1041,12 +1119,17 @@ msgid "" "optional and should also be placed in the `[optional.dependencies]` " "table." msgstr "" +"Estas dependencias se consideran opcionales, porque no son necesarias para " +"instalar y usar su paquete. Las dependencias de funcionalidades se consideran " +"opcionales y también deben colocarse en la tabla `[optional.dependencies]`." #: ../../package-structure-code/declare-dependencies.md:158 msgid "" "Optional dependencies can be stored in an `[optional.dependencies]` table" " in your **pyproject.toml** file." msgstr "" +"Las dependencias opcionales se pueden almacenar en una tabla `[optional.dependencies]` " +"en su archivo **pyproject.toml**." #: ../../package-structure-code/declare-dependencies.md:161 msgid "" @@ -1056,30 +1139,35 @@ msgid "" "`[project]` table discussed above which contains a single array with a " "single list of required packages." msgstr "" +"Es importante tener en cuenta que dentro de la tabla `[optional.dependencies]`, " +"puede almacenar dependencias opcionales adicionales dentro de subgrupos con nombre. " +"Esta es una tabla diferente que la matriz de dependencias ubicada dentro de la tabla " +"`[project]` discutida anteriormente que contiene una sola matriz con una lista única de " +"paquetes requeridos." #: ../../package-structure-code/declare-dependencies.md:163 msgid "Create optional dependency groups" -msgstr "" +msgstr "Crear grupos de dependencias opcionales" #: ../../package-structure-code/declare-dependencies.md:165 msgid "To declare optional dependencies in your **pyproject.toml** file:" -msgstr "" +msgstr "Para declarar dependencias opcionales en su archivo **pyproject.toml**:" #: ../../package-structure-code/declare-dependencies.md:167 msgid "Add a `[optional.dependencies]` table to your **pyproject.toml** file." -msgstr "" +msgstr "Añada una tabla `[optional.dependencies]` a su archivo **pyproject.toml**." #: ../../package-structure-code/declare-dependencies.md:168 msgid "Create named groups of dependencies using the syntax:" -msgstr "" +msgstr "Crear grupos nombrados de dependencias utilizando la sintaxis:" #: ../../package-structure-code/declare-dependencies.md:170 msgid "`group-name = [\"dep1\", \"dep2\"]`" -msgstr "" +msgstr "`group-name = [\"dep1\", \"dep2\"]`" #: ../../package-structure-code/declare-dependencies.md:172 msgid "Installing packages from GitHub / Gitlab" -msgstr "" +msgstr "Instalando paquetes desde GitHub / Gitlab" #: ../../package-structure-code/declare-dependencies.md:175 msgid "" @@ -1087,6 +1175,9 @@ msgid "" "using a `git+https` installation approach, you can do so using the " "pyproject.toml file like so:" msgstr "" +"Si tiene dependencias que deben instalarse directamente desde GitHub utilizando " +"un enfoque de instalación `git+https`, puede hacerlo utilizando el archivo " +"pyproject.toml de la siguiente manera:" #: ../../package-structure-code/declare-dependencies.md:185 msgid "" @@ -1094,6 +1185,9 @@ msgid "" "hosted project, you will need to point to a specific commit/tag/hash of " "that repository in order to upload your project to PyPI" msgstr "" +"IMPORTANTE: Por razones de seguridad, si su biblioteca depende de un proyecto " +"alojado en GitHub, deberá apuntar a un commit/tag/hash específico de ese repositorio " +"para cargar su proyecto en PyPI" #: ../../package-structure-code/declare-dependencies.md:190 msgid "" @@ -1101,10 +1195,12 @@ msgid "" "named: tests, docs and lint. We've also added a set of feature " "dependencies." msgstr "" +"A continuación, hemos creado tres conjuntos de dependencias de desarrollo opcionales " +"llamadas: tests, docs y lint. También hemos agregado un conjunto de dependencias de funcionalidades." #: ../../package-structure-code/declare-dependencies.md:213 msgid "Additional dependency resources" -msgstr "" +msgstr "Recursos de dependencias adicionales" #: ../../package-structure-code/declare-dependencies.md:215 msgid "" @@ -1112,6 +1208,9 @@ msgid "" "dependencies](https://packaging.python.org/en/latest/specifications" "/declaring-project-metadata/#dependencies-optional-dependencies)" msgstr "" +"[Más información: Vea la descripción general de PyPA sobre la declaración de dependencias " +"opcionales](https://packaging.python.org/en/latest/specifications" +"/declaring-project-metadata/#dependencies-optional-dependencies)" #: ../../package-structure-code/declare-dependencies.md:217 msgid "" @@ -1119,10 +1218,12 @@ msgid "" "specifiers](https://packaging.python.org/en/latest/specifications" "/dependency-specifiers/)" msgstr "" +"[Especificadores de dependencias](https://packaging.python.org/en/latest/specifications" +"/dependency-specifiers/)" #: ../../package-structure-code/declare-dependencies.md:221 msgid "Install dependency groups" -msgstr "" +msgstr "Instalar grupos de dependencias" #: ../../package-structure-code/declare-dependencies.md:226 msgid "" @@ -1137,6 +1238,14 @@ msgid "" "with both the package dependencies - your-package, seaborn and numpy and " "also the tests dependencies including pytest and pytest-cov" msgstr "" +"Diagrama que muestra un 'diagrama de ven' con tres secciones que representan los " +"grupos de dependencias mencionados anteriormente - docs, funcionalidades y tests. En el centro " +"se lee su-paquete y se enumeran las dependencias principales de ese paquete - seaborn y numpy. A la " +"derecha hay dos flechas. La primera muestra el comando python - m pip install su-paquete. Luego muestra " +"cómo instalar su paquete. De esa manera instala solo el paquete y las dos dependencias principales en el " +"entorno de un usuario. A continuación hay una segunda flecha con python -m pip install suPaquete[tests]. " +"Esto lleva a un entorno con las dependencias del paquete - su-paquete, seaborn y numpy y también las dependencias " +"de tests, incluidas pytest y pytest-cov." #: ../../package-structure-code/declare-dependencies.md:228 msgid "" @@ -1146,20 +1255,27 @@ msgid "" "package and its core dependencies plus any of the dependencies listed " "within the tests array of your `[optional.dependencies]` table." msgstr "" +"Cuando un usuario instala su paquete localmente usando python -m pip install " +"su-paquete, solo su paquete y sus dependencias principales se instalan. Cuando " +"instalan su paquete `[tests]`, pip instalará tanto su paquete como sus dependencias " +"principales, además de cualquiera de las dependencias enumeradas dentro de la matriz de tests " +"de su tabla `[optional.dependencies]`." #: ../../package-structure-code/declare-dependencies.md:231 msgid "Using `python -m pip install` vs. `pip install`" -msgstr "" +msgstr "Usando `python -m pip install` vs. `pip install`" #: ../../package-structure-code/declare-dependencies.md:233 msgid "" "In all of the examples in this guide, you will notice we are calling " "`pip` using the syntax:" msgstr "" +"En todos los ejemplos de esta guía, notará que estamos llamando a `pip` utilizando " +"la sintaxis:" #: ../../package-structure-code/declare-dependencies.md:236 msgid "`python -m pip`" -msgstr "" +msgstr "`python -m pip`" #: ../../package-structure-code/declare-dependencies.md:238 msgid "" @@ -1168,135 +1284,159 @@ msgid "" "environment. We strongly suggest that you use this approach whenever you " "call `pip` to avoid installation conflicts." msgstr "" +"Llamar a pip usando `python -m` asegura que la versión de `pip` que está utilizando para " +"instalar su paquete provenga de su entorno de Python activo actual. Le sugerimos " +"encarecidamente que utilice este enfoque siempre que llame a `pip` para evitar conflictos de instalación." + #: ../../package-structure-code/declare-dependencies.md:242 msgid "" "To ensure this works as you want it to, activate your package's " "development environment prior to installing anything using `pip`." msgstr "" +"Para asegurarse de que esto funcione como desea, active el entorno de desarrollo de su " +"paquete antes de instalar cualquier cosa usando `pip`." #: ../../package-structure-code/declare-dependencies.md:246 msgid "" "You can install development dependencies using the groups that you " "defined above using the syntax:" msgstr "" +"Puede instalar dependencias de desarrollo utilizando los grupos que definió anteriormente " +"usando la sintaxis:" #: ../../package-structure-code/declare-dependencies.md:249 msgid "`python -m pip install \".[docs]\"`" -msgstr "" +msgstr "`python -m pip install \".[docs]\"`" #: ../../package-structure-code/declare-dependencies.md:251 msgid "Above you install:" -msgstr "" +msgstr "Previamente instaló:" #: ../../package-structure-code/declare-dependencies.md:252 msgid "dependencies needed for your documentation (`docs`)," -msgstr "" +msgstr "dependencias necesarias para su documentación (`docs`)," #: ../../package-structure-code/declare-dependencies.md:253 msgid "required package dependencies in the `dependency` array and" -msgstr "" +msgstr "dependencias de paquetes requeridas en la matriz `dependency` y" #: ../../package-structure-code/declare-dependencies.md:254 msgid "your package" -msgstr "" +msgstr "su paquete" #: ../../package-structure-code/declare-dependencies.md:256 msgid "" "using pip. Below you install your package, required dependencies and " "optional test dependencies." msgstr "" +"usando pip. A continuación, instala su paquete, las dependencias " +"requeridas y las dependencias de tests opcionales." #: ../../package-structure-code/declare-dependencies.md:259 #: ../../package-structure-code/declare-dependencies.md:277 msgid "`python -m pip install \".[tests]\"`" -msgstr "" +msgstr "`python -m pip install \".[tests]\"`" #: ../../package-structure-code/declare-dependencies.md:261 msgid "" "You can install multiple dependency groups in the " "`[optional.dependencies]` table using:" msgstr "" +"Puede instalar múltiples grupos de dependencias en la tabla `[optional.dependencies]` " +"usando:" #: ../../package-structure-code/declare-dependencies.md:263 msgid "`python -m pip install \".[docs, tests, lint]\"`" -msgstr "" +msgstr "`python -m pip install \".[docs, tests, lint]\"`" #: ../../package-structure-code/declare-dependencies.md:266 msgid "For zsh shell users" -msgstr "" +msgstr "Para usuarios de shell zsh" #: ../../package-structure-code/declare-dependencies.md:270 msgid "" "There are different shell applications that you and your package " "contributors might use." msgstr "" +"Hay diferentes aplicaciones de shell que usted y los colaboradores de su paquete " +"podrían usar." #: ../../package-structure-code/declare-dependencies.md:271 msgid "zsh is the shell that comes by default on newer Mac OS computers" -msgstr "" +msgstr "zsh es la shell que viene por defecto en los ordenadored Mac OS más nuevos" #: ../../package-structure-code/declare-dependencies.md:272 msgid "Windows users may use a tool such as git bash" -msgstr "" +msgstr "Usuarios de Windows pueden usar una herramienta como git bash" #: ../../package-structure-code/declare-dependencies.md:274 msgid "" "Some shells don't support unquoted brackets (`[tests]`) which is why we " "add quotes to the command in this guide like this:" msgstr "" +"Algunas shells no admiten corchetes sin comillas (`[tests]`), por eso agregamos comillas " +"al comando en esta guía de la siguiente manera:" #: ../../package-structure-code/declare-dependencies.md:279 msgid "" "In some cases you may see commands without the quotes in guidebooks or " "contributing guides like the example below:" msgstr "" +"En algunos casos, puede ver comandos sin comillas en guías o guías de contribución como " +"el ejemplo a continuación:" #: ../../package-structure-code/declare-dependencies.md:282 msgid "`python -m pip install your-package[tests]`" -msgstr "" +msgstr "`python -m pip install your-package[tests]`" #: ../../package-structure-code/declare-dependencies.md:284 msgid "" "Calling your-package[tests] without the double quotes will work on some " "shells *but not all*." msgstr "" +"Llamar a su-paquete[tests] sin las comillas dobles funcionará en algunas" +" shells *pero no en todas*." #: ../../package-structure-code/declare-dependencies.md:287 msgid "Combining sets of dependencies" -msgstr "" +msgstr "Combina conjuntos de dependencias" #: ../../package-structure-code/declare-dependencies.md:289 msgid "" "Above we reviewed how to install dependencies from your `pyproject.toml`." " In some cases you may want to group sets of dependencies like so:" msgstr "" +"Anteriormente hemos revisado cómo instalar dependencias desde su `pyproject.toml`. " +"En algunos casos, es posible que desee agrupar conjuntos de dependencias de la siguiente manera:" #: ../../package-structure-code/declare-dependencies.md:302 msgid "" "The above allows you to install both the tests and docs dependency lists " "using the command:" msgstr "" +"Lo anterior le permite instalar tanto las listas de dependencias de tests como de docs " +"usando el comando:" #: ../../package-structure-code/declare-dependencies.md:305 msgid "`python -m pip install \".[dev]\"`" -msgstr "" +msgstr "`python -m pip install \".[dev]\"`" #: ../../package-structure-code/declare-dependencies.md:308 msgid "When you install dependencies using the above syntax:" -msgstr "" +msgstr "Cuando instala dependencias utilizando la sintaxis anterior:" #: ../../package-structure-code/declare-dependencies.md:310 msgid "`python -m pip install \".[tests, docs]\"`" -msgstr "" +msgstr "`python -m pip install \".[tests, docs]\"`" #: ../../package-structure-code/declare-dependencies.md:312 msgid "`pip` will also install your package and its core dependencies." -msgstr "" +msgstr "`pip` también instalará su paquete y sus dependencias principales." #: ../../package-structure-code/declare-dependencies.md:316 msgid "Where does conda fit in?" -msgstr "" +msgstr "Dónde encaja conda?" #: ../../package-structure-code/declare-dependencies.md:319 msgid "" @@ -1307,14 +1447,20 @@ msgid "" "](publish-python-package-pypi-conda.md), people can install both your " "package and all of it's dependencies with one command." msgstr "" +"El archivo `pyproject.toml` le permite enumerar cualquier paquete de Python publicado " +"en PyPI (o en GitHub / GitLab) como una dependencia. Una vez que cree este archivo, " +"declare dependencias, [construya su paquete](python-package-" +"distribution-files-sdist-wheel.md) y [publique su paquete en PyPI" +"](publish-python-package-pypi-conda.md), las personas pueden instalar tanto su " +"paquete como todas sus dependencias con un solo comando." #: ../../package-structure-code/declare-dependencies.md:322 msgid "`python -m pip install your-package`" -msgstr "" +msgstr "`python -m pip install your-package`" #: ../../package-structure-code/declare-dependencies.md:324 msgid "This works great if your package is pure-python (no other languages used)." -msgstr "" +msgstr "Esto funciona muy bien si su paquete es de Python puro (no se utilizan otros lenguajes)." #: ../../package-structure-code/declare-dependencies.md:326 msgid "" @@ -1323,10 +1469,13 @@ msgid "" " distribution of tools that have code written in both Python and " "languages other than Python." msgstr "" +"Algunos paquetes, especialmente en el ecosistema científico de Python, requieren " +"dependencias que no están escritas en Python. Conda se creó para admitir la distribución " +"de herramientas que tienen código escrito tanto en Python como en otros lenguajes que no sean Python." #: ../../package-structure-code/declare-dependencies.md:329 msgid "Support conda users with environment.yml files" -msgstr "" +msgstr "Apoye a los usuarios de conda con archivos environment.yml" #: ../../package-structure-code/declare-dependencies.md:331 msgid "" @@ -1335,6 +1484,9 @@ msgid "" " a recipe using grayskull](https://www.pyopensci.org/python-package-guide" "/package-structure-code/publish-python-package-pypi-conda.html)." msgstr "" +"El flujo de trabajo anterior asume que desea publicar su paquete en PyPI. Y luego " +"planea publicar en conda-forge (opcionalmente), [enviando una receta usando grayskull" +"](https://www.pyopensci.org/python-package-guide/package-structure-code/publish-python-package-pypi-conda.html)." #: ../../package-structure-code/declare-dependencies.md:333 msgid "" @@ -1343,10 +1495,13 @@ msgid "" "conda environment will also help you test that your package installs as " "you expect into a conda environment." msgstr "" +"Si desea apoyar a los usuarios de conda, es posible que también desee mantener un entorno " +"de conda que puedan usar para instalar su paquete. Mantener un entorno de conda también " +"le ayudará a probar que su paquete se instala como espera en un entorno de conda." #: ../../package-structure-code/declare-dependencies.md:336 msgid "A note for conda users" -msgstr "" +msgstr "Una nota para los usuarios de conda" #: ../../package-structure-code/declare-dependencies.md:339 msgid "" @@ -1355,6 +1510,9 @@ msgid "" " using pip in general), dependencies will be installed from PyPI rather " "than conda." msgstr "" +"Si utiliza un entorno de conda para desarrollar su herramienta, tenga en cuenta que " +"cuando instala su paquete usando `python -m pip install -e .` (o usando pip en general), " +"las dependencias se instalarán desde PyPI en lugar de conda." #: ../../package-structure-code/declare-dependencies.md:341 msgid "" @@ -1363,6 +1521,9 @@ msgid "" "important if you have a spatial package that requires geospatial system " "libraries like GDAL or another system-level dependency." msgstr "" +"Por lo tanto, si está ejecutando un entorno de conda, instalar su paquete en modo \"editable\" " +"puede provocar conflictos de dependencia. Esto es particularmente importante si tiene un paquete " +"que requiere bibliotecas de sistema geoespaciales como GDAL u otra dependencia de nivel de sistema." #: ../../package-structure-code/declare-dependencies.md:343 msgid "" @@ -1370,16 +1531,21 @@ msgid "" "-e . --no-deps` to only install the package. And install the rest of your" " dependencies using a conda environment file." msgstr "" +"Alternativamente, puede instalar su paquete usando `python -m pip install -e . --no-deps` " +"para instalar solo el paquete. Instale el resto de sus dependencias usando un archivo de " +"entorno de conda." #: ../../package-structure-code/declare-dependencies.md:346 msgid "Dependencies in Read the Docs" -msgstr "" +msgstr "Dependencias en Read the Docs" #: ../../package-structure-code/declare-dependencies.md:348 msgid "" "Now that you have your dependencies specified in your project, you can " "use them to support other workflows such as publishing to Read the Docs." msgstr "" +"Ahora que ha especificado sus dependencias en su proyecto, puede usarlas para " +"apoyar otros flujos de trabajo como la publicación en Read the Docs." #: ../../package-structure-code/declare-dependencies.md:350 msgid "" @@ -1387,28 +1553,37 @@ msgid "" " a continuous integration / continuous deployment service that " "automatically builds and publishes your documentation." msgstr "" +"[Read the Docs](https://readthedocs.org) es una plataforma de documentación con un " +"servicio de integración continua / implementación continua que construye y publica " +"automáticamente su documentación." #: ../../package-structure-code/declare-dependencies.md:352 msgid "" "If you are using Read the Docs to build your documentation, then you may " "need to install your dependencies using a **readthedocs.yaml** file." msgstr "" +"Si está utilizando Read the Docs para construir su documentación, entonces es posible " +"que necesite instalar sus dependencias utilizando un archivo **readthedocs.yaml**." #: ../../package-structure-code/declare-dependencies.md:354 msgid "" "Below is an example of installing the **docs** section of your dependency" " table in the pyproject.toml file within a readthedocs.yaml file." msgstr "" +"A continuación se muestra un ejemplo de cómo instalar la sección **docs** de su tabla de dependencias " +"en el archivo pyproject.toml dentro de un archivo readthedocs.yaml." #: ../../package-structure-code/declare-dependencies.md:366 msgid "Read the Docs and Python packages" -msgstr "" +msgstr "Read the Docs y paquetes de Python" #: ../../package-structure-code/declare-dependencies.md:370 msgid "" "[Learn more about creating a `readthedocs.yaml` file here. " "](https://docs.readthedocs.io/en/stable/config-file/index.html)" msgstr "" +"[Aprenda más sobre cómo crear un archivo `readthedocs.yaml` aquí. " +"](https://docs.readthedocs.io/en/stable/config-file/index.html)" #: ../../package-structure-code/declare-dependencies.md:371 msgid "" @@ -1416,6 +1591,9 @@ msgid "" "can learn more here.](https://docs.readthedocs.io/en/stable/build-" "customization.html#install-dependencies-with-poetry)" msgstr "" +"Si desea instalar dependencias usando Poetry en Read the Docs, [puede aprender más aquí. " +"](https://docs.readthedocs.io/en/stable/build-" +"customization.html#install-dependencies-with-poetry)" #: ../../package-structure-code/declare-dependencies.md:376 msgid "This is hidden. TO" From 1265c51c42b6ffa35d2e1295a3c8b98688fc4551 Mon Sep 17 00:00:00 2001 From: Roberto Pastor Muela <37798125+RobPasMue@users.noreply.github.com> Date: Mon, 30 Sep 2024 08:28:49 +0200 Subject: [PATCH 2/2] Apply suggestions from code review Co-authored-by: Felipe Moreno --- .../es/LC_MESSAGES/package-structure-code.po | 40 +++++++++---------- 1 file changed, 20 insertions(+), 20 deletions(-) diff --git a/locales/es/LC_MESSAGES/package-structure-code.po b/locales/es/LC_MESSAGES/package-structure-code.po index f52cf870..95be85f5 100644 --- a/locales/es/LC_MESSAGES/package-structure-code.po +++ b/locales/es/LC_MESSAGES/package-structure-code.po @@ -854,7 +854,7 @@ msgstr "" #: ../../package-structure-code/declare-dependencies.md:29 msgid "needs to function properly." -msgstr "neceista para funcionar correctamente." +msgstr "necesita para funcionar correctamente." #: ../../package-structure-code/declare-dependencies.md:30 msgid "" @@ -889,12 +889,12 @@ msgid "" "the `[optional.dependencies]` table of your `pyproject.toml`." msgstr "" "Puede pensar en las dependencias como opcionales o requeridas. Si son requeridas, " -"se listarán en la tabla `[dependency] =` de su archivo `pyproject.toml`. Si son " +"se listarán con la clave `dependency` en la tabla `project` de su archivo `pyproject.toml`. Si son " "opcionales, se listarán en la tabla `[optional.dependencies]` de su `pyproject.toml`." #: ../../package-structure-code/declare-dependencies.md:40 msgid "You will learn about both below." -msgstr "Aprenderá sobre ambos a continuación." +msgstr "Aprenderá sobre ambos tipos a continuación." #: ../../package-structure-code/declare-dependencies.md:46 msgid "" @@ -909,7 +909,7 @@ msgid "" "optional and add additional functionality to your package. Not all " "packages will have feature dependencies." msgstr "" -"Hay dos grupos amplios de dependencias de paquetes de Python: las que son " +"Hay dos tipos de dependencias de paquetes de Python: las que son " "opcionales y las que son requeridas. Los paquetes requeridos son aquellos que " "un usuario necesita para usar su paquete. Las dependencias opcionales son " "paquetes que un usuario puede elegir instalar para agregar funcionalidad a su " @@ -935,7 +935,7 @@ msgstr "" "Las dependencias requeridas se llaman directamente dentro del código de su " "paquete. En esta página nos referimos a estas dependencias como **dependencias " "principales** ya que son necesarias para ejecutar su paquete. Debería colocar " -"las dependencias principales o requeridas en la tabla `[dependency]=` de su " +"las dependencias principales o requeridas en la clave `dependency` de la tabla `[project]` de su " "archivo `pyproject.toml`." #: ../../package-structure-code/declare-dependencies.md:56 @@ -1053,7 +1053,7 @@ msgstr "" #: ../../package-structure-code/declare-dependencies.md:100 msgid "Add required dependencies to your pyproject.toml file" -msgstr "Añaadir dependencias requeridas a su archivo pyproject.toml" +msgstr "Añadir dependencias requeridas a su archivo pyproject.toml" #: ../../package-structure-code/declare-dependencies.md:102 msgid "" @@ -1065,7 +1065,7 @@ msgid "" msgstr "" "Las dependencias principales de su proyecto deben ser instaladas por un administrador " "de paquetes como `pip` o `conda` cuando un usuario instala su paquete. Puede agregar " -"esas dependencias a la matriz `dependencies` ubicada dentro de la tabla `[project]` de su " +"esas dependencias a la clave `dependencies` ubicada dentro de la tabla `[project]` de su " "archivo **pyproject.toml**. Se asemejará a lo siguiente:" #: ../../package-structure-code/declare-dependencies.md:121 @@ -1076,7 +1076,7 @@ msgid "" " number of packages that depend upon your package must also install." msgstr "" "Idealmente, solo debería enumerar los paquetes que son necesarios para instalar " -"y usar su paquete en la sección `[dependencies]`. Esto minimiza la cantidad de " +"y usar su paquete en la clave `dependencies` de la tabla `[project]`. Esto minimiza la cantidad de " "paquetes adicionales que sus usuarios deben instalar, así como la cantidad de " "paquetes que dependen de su paquete que también deben instalar." @@ -1182,7 +1182,7 @@ msgid "" "Optional dependencies can be stored in an `[optional.dependencies]` table" " in your **pyproject.toml** file." msgstr "" -"Las dependencias opcionales se pueden almacenar en una tabla `[optional.dependencies]` " +"Las dependencias opcionales se pueden almacenar en una tabla `[project.optional-dependencies]` " "en su archivo **pyproject.toml**." #: ../../package-structure-code/declare-dependencies.md:161 @@ -1193,7 +1193,7 @@ msgid "" "`[project]` table discussed above which contains a single array with a " "single list of required packages." msgstr "" -"Es importante tener en cuenta que dentro de la tabla `[optional.dependencies]`, " +"Es importante tener en cuenta que dentro de la tabla `[project.optional-dependencies]`, " "puede almacenar dependencias opcionales adicionales dentro de subgrupos con nombre. " "Esta es una tabla diferente que la matriz de dependencias ubicada dentro de la tabla " "`[project]` discutida anteriormente que contiene una sola matriz con una lista única de " @@ -1209,7 +1209,7 @@ msgstr "Para declarar dependencias opcionales en su archivo **pyproject.toml**:" #: ../../package-structure-code/declare-dependencies.md:167 msgid "Add a `[optional.dependencies]` table to your **pyproject.toml** file." -msgstr "Añada una tabla `[optional.dependencies]` a su archivo **pyproject.toml**." +msgstr "Añada una tabla `[project.optional-dependencies]` a su archivo **pyproject.toml**." #: ../../package-structure-code/declare-dependencies.md:168 msgid "Create named groups of dependencies using the syntax:" @@ -1292,7 +1292,7 @@ msgid "" "with both the package dependencies - your-package, seaborn and numpy and " "also the tests dependencies including pytest and pytest-cov" msgstr "" -"Diagrama que muestra un 'diagrama de ven' con tres secciones que representan los " +"Diagrama que muestra un 'diagrama de Venn' con tres secciones que representan los " "grupos de dependencias mencionados anteriormente - docs, funcionalidades y tests. En el centro " "se lee su-paquete y se enumeran las dependencias principales de ese paquete - seaborn y numpy. A la " "derecha hay dos flechas. La primera muestra el comando python - m pip install su-paquete. Luego muestra " @@ -1309,11 +1309,11 @@ msgid "" "package and its core dependencies plus any of the dependencies listed " "within the tests array of your `[optional.dependencies]` table." msgstr "" -"Cuando un usuario instala su paquete localmente usando python -m pip install " -"su-paquete, solo su paquete y sus dependencias principales se instalan. Cuando " -"instalan su paquete `[tests]`, pip instalará tanto su paquete como sus dependencias " +"Cuando un usuario instala su paquete localmente usando `python -m pip install " +"su-paquete`, solo su paquete y sus dependencias principales se instalan. Cuando " +"instalan su paquete `python -m pip install your-package[tests]`, pip instalará tanto su paquete como sus dependencias " "principales, además de cualquiera de las dependencias enumeradas dentro de la matriz de tests " -"de su tabla `[optional.dependencies]`." +"de su tabla `[project.optional-dependencies]`." #: ../../package-structure-code/declare-dependencies.md:231 msgid "Using `python -m pip install` vs. `pip install`" @@ -1340,7 +1340,7 @@ msgid "" msgstr "" "Llamar a pip usando `python -m` asegura que la versión de `pip` que está utilizando para " "instalar su paquete provenga de su entorno de Python activo actual. Le sugerimos " -"encarecidamente que utilice este enfoque siempre que llame a `pip` para evitar conflictos de instalación." +"encarecidamente que utilice este método siempre que llame a `pip` para evitar conflictos de instalación." #: ../../package-structure-code/declare-dependencies.md:242 @@ -1373,7 +1373,7 @@ msgstr "dependencias necesarias para su documentación (`docs`)," #: ../../package-structure-code/declare-dependencies.md:253 msgid "required package dependencies in the `dependency` array and" -msgstr "dependencias de paquetes requeridas en la matriz `dependency` y" +msgstr "dependencias de paquetes requeridas en la matriz `dependencies` y" #: ../../package-structure-code/declare-dependencies.md:254 msgid "your package" @@ -1397,7 +1397,7 @@ msgid "" "You can install multiple dependency groups in the " "`[optional.dependencies]` table using:" msgstr "" -"Puede instalar múltiples grupos de dependencias en la tabla `[optional.dependencies]` " +"Puede instalar múltiples grupos de dependencias en la tabla `[project.optional-dependencies]` " "usando:" #: ../../package-structure-code/declare-dependencies.md:263 @@ -1461,7 +1461,7 @@ msgid "" "Above we reviewed how to install dependencies from your `pyproject.toml`." " In some cases you may want to group sets of dependencies like so:" msgstr "" -"Anteriormente hemos revisado cómo instalar dependencias desde su `pyproject.toml`. " +"Anteriormente hemos discutido cómo instalar dependencias desde su `pyproject.toml`. " "En algunos casos, es posible que desee agrupar conjuntos de dependencias de la siguiente manera:" #: ../../package-structure-code/declare-dependencies.md:302