# 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 \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 `_" msgstr "" "`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, ** 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, ** 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::"