examples.po

# Copyright (C) 2001-2020, Python Software Foundation
# This file is distributed under the same license as the Python package.
# Maintained by the python-doc-es workteam.
# docs-es@python.org /
# https://mail.python.org/mailman3/lists/docs-es.python.org/
# Check https://github.com/python/python-docs-es/blob/3.8/TRANSLATORS to
# get the list of volunteers
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3.8\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2021-10-16 21:42+0200\n"
"PO-Revision-Date: 2021-11-26 14:35+0100\n"
"Last-Translator: Cristián Maureira-Fredes <cmaureirafredes@gmail.com>\n"
"Language: es\n"
"Language-Team: python-doc-es\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.9.1\n"
"X-Generator: Poedit 3.0\n"

#: ../Doc/distutils/examples.rst:5
msgid "Distutils Examples"
msgstr "Ejemplos de distutils"

#: ../Doc/distutils/_setuptools_disclaimer.rst:3
msgid ""
"This document is being retained solely until the ``setuptools`` "
"documentation at https://setuptools.readthedocs.io/en/latest/setuptools.html "
"independently covers all of the relevant information currently included here."
msgstr ""
"Este documento se conserva únicamente hasta que la documentación de "
"``setuptools`` en https://setuptools.readthedocs.io/en/latest/setuptools."
"html cubra de forma independiente toda la información relevante que se "
"incluye actualmente aquí."

#: ../Doc/distutils/examples.rst:9
msgid ""
"This chapter provides a number of basic examples to help get started with "
"distutils.  Additional information about using distutils can be found in the "
"Distutils Cookbook."
msgstr ""
"Este capitulo provee varios ejemplos básicos para ayudar a comenzar con "
"distutils. Información adicional sobre el uso de distutils puede ser "
"encontrado en el Distutils Cookbook."

#: ../Doc/distutils/examples.rst:16
msgid "`Distutils Cookbook <https://wiki.python.org/moin/Distutils/Cookbook>`_"
msgstr ""
"`Distutils Cookbook <https://wiki.python.org/moin/Distutils/Cookbook>`_"

#: ../Doc/distutils/examples.rst:17
msgid ""
"Collection of recipes showing how to achieve more control over distutils."
msgstr ""
"Colección de recetas que muestran como lograr mayor control sobre distutils."

#: ../Doc/distutils/examples.rst:23
msgid "Pure Python distribution (by module)"
msgstr "Distribución de Python pura (por módulo)"

#: ../Doc/distutils/examples.rst:25
msgid ""
"If you're just distributing a couple of modules, especially if they don't "
"live in a particular package, you can specify them individually using the "
"``py_modules`` option in the setup script."
msgstr ""
"Si solo distribuyes un par de módulos, especialmente si no viven en un "
"paquete en particular, puedes especificarlos individualmente usando la "
"opción ``py_modules`` en el script de instalación."

#: ../Doc/distutils/examples.rst:29
msgid ""
"In the simplest case, you'll have two files to worry about: a setup script "
"and the single module you're distributing, :file:`foo.py` in this example::"
msgstr ""
"En el caso más simple, tendrás dos archivos de los cuales preocuparte: un "
"script de instalación y el único modulo que estás distribuyendo, en este "
"ejemplo :file:`foo.py`::"

#: ../Doc/distutils/examples.rst:36
msgid ""
"(In all diagrams in this section, *<root>* will refer to the distribution "
"root directory.)  A minimal setup script to describe this situation would "
"be::"
msgstr ""
"(En todos los diagramas en esta sección, *<root>* se referirá al directorio "
"raíz de la distribución.) Un script de instalación mínimo para describir "
"esta situación seria::"

#: ../Doc/distutils/examples.rst:45
msgid ""
"Note that the name of the distribution is specified independently with the "
"``name`` option, and there's no rule that says it has to be the same as the "
"name of the sole module in the distribution (although that's probably a good "
"convention to follow).  However, the distribution name is used to generate "
"filenames, so you should stick to letters, digits, underscores, and hyphens."
msgstr ""
"Observe que el nombre de la distribución esta especificada de forma "
"independiente con la opción ``name``, y no hay ninguna regla que diga que "
"tiene que ser el mismo que el nombre del único modulo de la distribución "
"(aunque probablemente sea una buena convención a seguir). Sin embargo, el "
"nombre de la distribución es usado para generar nombres de archivo, así que "
"deberías limitarte a letras, dígitos, guión bajo, y guiones."

#: ../Doc/distutils/examples.rst:51
msgid ""
"Since ``py_modules`` is a list, you can of course specify multiple modules, "
"eg. if you're distributing modules :mod:`foo` and :mod:`bar`, your setup "
"might look like this::"
msgstr ""
"Dado que ``py_modules`` es una lista, puedes por supuesto especificar "
"múltiples módulos, por ejemplo, si estás distribuyendo los módulos :mod:"
"`foo` y :mod:`bar`, tu configuración podría verse así::"

#: ../Doc/distutils/examples.rst:60
msgid "and the setup script might be  ::"
msgstr "y el script de instalación podría ser::"

#: ../Doc/distutils/examples.rst:68
msgid ""
"You can put module source files into another directory, but if you have "
"enough modules to do that, it's probably easier to specify modules by "
"package rather than listing them individually."
msgstr ""
"Puedes poner los archivos fuente de los módulos en otro directorio, pero si "
"tienes suficientes módulos para hacerlo, probablemente sea mas fácil "
"especificar los módulos por paquete en lugar de enumerarlos individualmente."

#: ../Doc/distutils/examples.rst:76
msgid "Pure Python distribution (by package)"
msgstr "Distribución de Python pura (por paquete)"

#: ../Doc/distutils/examples.rst:78
msgid ""
"If you have more than a couple of modules to distribute, especially if they "
"are in multiple packages, it's probably easier to specify whole packages "
"rather than individual modules.  This works even if your modules are not in "
"a package; you can just tell the Distutils to process modules from the root "
"package, and that works the same as any other package (except that you don't "
"have to have an :file:`__init__.py` file)."
msgstr ""
"Si tienes más de un par de módulos para distribuir, especialmente si están "
"en múltiples paquetes, probablemente sea más fácil especificar paquetes "
"completos en lugar de módulos individuales. Esto funciona incluso si sus "
"módulos no están en un paquete; solo puedes decirle a los Distutils que "
"procese los módulos desde el paquete raíz, y eso funciona igual que "
"cualquier otro paquete (excepto que no tiene que tener un archivo :file:"
"`__init__.py`."

#: ../Doc/distutils/examples.rst:85
msgid "The setup script from the last example could also be written as  ::"
msgstr ""
"El script de instalación del último ejemplo también podría ser escrito como::"

#: ../Doc/distutils/examples.rst:93
msgid "(The empty string stands for the root package.)"
msgstr "(La cadena de caracteres vacía representa el paquete raíz.)"

#: ../Doc/distutils/examples.rst:95
msgid ""
"If those two files are moved into a subdirectory, but remain in the root "
"package, e.g.::"
msgstr ""
"Si esos dos archivos son movidos a un subdirectorio, pero permanecen en el "
"paquete raíz, por ejemplo::"

#: ../Doc/distutils/examples.rst:103
msgid ""
"then you would still specify the root package, but you have to tell the "
"Distutils where source files in the root package live::"
msgstr ""
"entonces seguirías especificando el paquete raíz, pero tienes que decirle a "
"los Distutils dónde viven los archivos fuente del paquete raíz::"

#: ../Doc/distutils/examples.rst:113
msgid ""
"More typically, though, you will want to distribute multiple modules in the "
"same package (or in sub-packages).  For example, if the :mod:`foo`  and :mod:"
"`bar` modules belong in package :mod:`foobar`, one way to layout your source "
"tree is ::"
msgstr ""
"No obstante, lo mas típico es que quieras distribuir múltiples módulos en el "
"mismo paquete (o en subpaquetes). Por ejemplo, si los módulos :mod:`foo` y :"
"mod:`bar` pertenecen al paquete :mod:`foobar`, una forma de diseñar su "
"estructura fuente es::"

#: ../Doc/distutils/examples.rst:125
msgid ""
"This is in fact the default layout expected by the Distutils, and the one "
"that requires the least work to describe in your setup script::"
msgstr ""
"Este es, de hecho, la distribución por defecto esperada por los Distutils, y "
"la que requiere menos trabajo para describir en su script de instalación::"

#: ../Doc/distutils/examples.rst:134
msgid ""
"If you want to put modules in directories not named for their package, then "
"you need to use the ``package_dir`` option again.  For example, if the :file:"
"`src` directory holds modules in the :mod:`foobar` package::"
msgstr ""
"Si quieres poner módulos en directorios no nombrados por su paquete, "
"entonces necesitas usar la opción ``package_dir`` otra vez. Por ejemplo, si "
"el directorio :file:`src` contiene los módulos en el paquete :mod:`foobar`::"

#: ../Doc/distutils/examples.rst:145
msgid "an appropriate setup script would be  ::"
msgstr "un script de instalación apropiado sería::"

#: ../Doc/distutils/examples.rst:154
msgid ""
"Or, you might put modules from your main package right in the distribution "
"root::"
msgstr ""
"O, podrías poner módulos de tu paquete principal justo en la raíz de la "
"distribución::"

#: ../Doc/distutils/examples.rst:163
msgid "in which case your setup script would be  ::"
msgstr "en cuyo caso tu script de instalación sería::"

#: ../Doc/distutils/examples.rst:172
msgid "(The empty string also stands for the current directory.)"
msgstr ""
"(La cadena de caracteres vacía también representa el directorio actual.)"

#: ../Doc/distutils/examples.rst:174
msgid ""
"If you have sub-packages, they must be explicitly listed in ``packages``, "
"but any entries in ``package_dir`` automatically extend to sub-packages. (In "
"other words, the Distutils does *not* scan your source tree, trying to "
"figure out which directories correspond to Python packages by looking for :"
"file:`__init__.py` files.)  Thus, if the default layout grows a sub-package::"
msgstr ""
"Si tienes subpaquetes, deben ser listados explícitamente en ``packages``, "
"pero cualquier entrada en ``package_dir`` se extiende automáticamente a los "
"subpaquetes. (En otras palabras, los Distutils *no* escanean tu estructura "
"fuente, intentando descubrir que directorios corresponden a los paquetes de "
"Python buscando por archivos :file:`__init__.py`.) Por lo tanto, si la "
"distribución por defecto hace crece un subpaquete::"

#: ../Doc/distutils/examples.rst:190
msgid "then the corresponding setup script would be  ::"
msgstr "entonces el script de instalación correspondiente sería::"

#: ../Doc/distutils/examples.rst:202
msgid "Single extension module"
msgstr "Módulo de extensión única"

#: ../Doc/distutils/examples.rst:204
msgid ""
"Extension modules are specified using the ``ext_modules`` option. "
"``package_dir`` has no effect on where extension source files are found; it "
"only affects the source for pure Python modules.  The simplest  case, a "
"single extension module in a single C source file, is::"
msgstr ""
"Los módulos de extensión son especificados usando la opción ``ext_modules``. "
"``package_dir`` no tiene efecto sobre donde se encuentren los archivos "
"fuente de la extensión; solo afecta a la fuente de los módulos de Python "
"puro. El mas simple caso, un único modulo de extensión en un único archivo "
"fuente de C, es::"

#: ../Doc/distutils/examples.rst:213
msgid ""
"If the :mod:`foo` extension belongs in the root package, the setup script "
"for this could be  ::"
msgstr ""
"Si la extensión :mod:`foo` pertenece al paquete raíz, el script de "
"instalación para este podría ser::"

#: ../Doc/distutils/examples.rst:223
msgid "If the extension actually belongs in a package, say :mod:`foopkg`, then"
msgstr ""
"Si la extensión realmente pertenece a un paquete, digamos :mod:`foopkg`, "
"entonces"

#: ../Doc/distutils/examples.rst:225
msgid ""
"With exactly the same source tree layout, this extension can be put in the :"
"mod:`foopkg` package simply by changing the name of the extension::"
msgstr ""
"Con exactamente la misma distribución del árbol fuente, esta extensión puede "
"ser puesta en el paquete :mod:`foopkg` simplemente cambiando el nombre de la "
"extensión::"

#: ../Doc/distutils/examples.rst:236
msgid "Checking a package"
msgstr "Verificando un paquete"

#: ../Doc/distutils/examples.rst:238
msgid ""
"The ``check`` command allows you to verify if your package meta-data meet "
"the minimum requirements to build a distribution."
msgstr ""
"El comando ``check`` le permite verificar si los metadatos de su paquete "
"cumplen los requisitos mínimos para construir la distribución."

#: ../Doc/distutils/examples.rst:241
msgid ""
"To run it, just call it using your :file:`setup.py` script. If something is "
"missing, ``check`` will display a warning."
msgstr ""
"Para ejecutarlo, sólo tienes que llamarlo usando tu script :file:`setup.py`. "
"Si falta algo, ``check`` mostrará una advertencia."

#: ../Doc/distutils/examples.rst:244
msgid "Let's take an example with a simple script::"
msgstr "Tomemos un ejemplo con un script simple::"

#: ../Doc/distutils/examples.rst:250
msgid "Running the ``check`` command will display some warnings:"
msgstr "La ejecución del comando ``check`` mostrará algunas advertencias:"

#: ../Doc/distutils/examples.rst:261
msgid ""
"If you use the reStructuredText syntax in the ``long_description`` field and "
"`docutils`_  is installed you can check if the syntax is fine with the "
"``check`` command, using the ``restructuredtext`` option."
msgstr ""
"Si usas la sintaxis ``reStructuredText`` en el campo ``long_description`` y "
"`docutils`_ esta instalado puedes comprobar si la sintaxis está bien con el "
"comando ``check``, usando la opción ``restructuredtext``."

#: ../Doc/distutils/examples.rst:265
msgid "For example, if the :file:`setup.py` script is changed like this::"
msgstr "Por ejemplo, si el script :file:`setup.py` es cambiado así::"

#: ../Doc/distutils/examples.rst:280
msgid ""
"Where the long description is broken, ``check`` will be able to detect it by "
"using the :mod:`docutils` parser:"
msgstr ""
"Donde se rompa la descripción larga, ``check`` será capaz de detectarla "
"usando el analizador :mod:`docutils`:"

#: ../Doc/distutils/examples.rst:291
msgid "Reading the metadata"
msgstr "Leyendo los metadatos"

#: ../Doc/distutils/examples.rst:293
msgid ""
"The :func:`distutils.core.setup` function provides a command-line interface "
"that allows you to query the metadata fields of a project through the "
"``setup.py`` script of a given project:"
msgstr ""
"La función :func:`distutils.core.setup` provee una interfaz de línea de "
"comandos que te permite consultar los campos de metadatos de un proyecto a "
"través del script ``setup.py`` de un proyecto dado:"

#: ../Doc/distutils/examples.rst:302
msgid ""
"This call reads the ``name`` metadata by running the :func:`distutils.core."
"setup`  function. Although, when a source or binary distribution is created "
"with Distutils, the metadata fields are written in a static file called :"
"file:`PKG-INFO`. When a Distutils-based project is installed in Python, the :"
"file:`PKG-INFO` file is copied alongside the modules and packages of the "
"distribution under :file:`NAME-VERSION-pyX.X.egg-info`, where ``NAME`` is "
"the name of the project, ``VERSION`` its version as defined in the Metadata, "
"and ``pyX.X`` the major and minor version of Python like ``2.7`` or ``3.2``."
msgstr ""
"Esta llamada lee los metadatos de ``name`` ejecutando la función :func:"
"`distutils.core.setup`. Aunque, cuando se crea una distribución fuente o "
"binaria con Distutils, los campos de metadatos son escritos en un archivo "
"estático llamado :file:`PKG-INFO`. Cuando un proyecto basado en Distutils es "
"instalado en Python, el archivo :file:`PKG-INFO` es copiado junto con los "
"módulos y paquetes de la distribución en :file:`NAME-VERSION-pyX.X.egg-"
"info`, donde ``NAME`` es el nombre del proyecto, ``VERSION`` su versión como "
"se define en los metadatos, y ``pyX.X`` la versión mayor y menor de Python "
"como ``2.7`` o ``3.2``."

#: ../Doc/distutils/examples.rst:312
msgid ""
"You can read back this static file, by using the :class:`distutils.dist."
"DistributionMetadata` class and its :func:`read_pkg_file` method::"
msgstr ""
"Puedes leer de nuevo este archivo estático usando la clase :class:`distutils."
"dist.DistributionMetadata` y su método :func:`read_pkg_file`::"

#: ../Doc/distutils/examples.rst:326
msgid ""
"Notice that the class can also be instantiated with a metadata file path to "
"loads its values::"
msgstr ""
"Note que la clase también puede ser instanciada con una ruta de archivo de "
"metadatos para cargar sus valores::"