# 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-03-19 11:16+0100\n"

"PO-Revision-Date: 2020-05-29 17:19-0700\n"

"Last-Translator: \n"

"Language: es_US\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.8.0\n"

#: ../Doc/howto/logging.rst:3

msgid "Logging HOWTO"

msgstr "HOWTO Hacer Registros (*Logging*)"

#: ../Doc/howto/logging.rst

msgid "Author"

msgstr "Autor"

#: ../Doc/howto/logging.rst:5

msgid "Vinay Sajip <vinay_sajip at red-dove dot com>"

msgstr "Vinay Sajip <vinay_sajip at red-dove dot com>"

#: ../Doc/howto/logging.rst:12

msgid "Basic Logging Tutorial"

msgstr "Tutorial Básico de *Logging*"

#: ../Doc/howto/logging.rst:14

msgid ""

"Logging is a means of tracking events that happen when some software runs. "

"The software's developer adds logging calls to their code to indicate that "

"certain events have occurred. An event is described by a descriptive message "

"which can optionally contain variable data (i.e. data that is potentially "

"different for each occurrence of the event). Events also have an importance "

"which the developer ascribes to the event; the importance can also be called "

"the *level* or *severity*."

msgstr ""

"*Logging* es un medio de rastrear los eventos que ocurren cuando se ejecuta "

"algún software. El desarrollador del software agrega llamadas de registro a "

"su código para indicar que ciertos eventos han ocurrido. Un evento se "

"describe mediante un mensaje descriptivo que puede contener opcionalmente "

"datos variables (es decir, datos que son potencialmente diferentes para cada "

"ocurrencia del evento). Los eventos también tienen una importancia que el "

"desarrollador atribuye al evento; la importancia también puede llamarse el "

"*nivel* o la *severidad*."

#: ../Doc/howto/logging.rst:23

msgid "When to use logging"

msgstr "Cuándo usar *logging*"

#: ../Doc/howto/logging.rst:25

msgid ""

"Logging provides a set of convenience functions for simple logging usage. "

"These are :func:`debug`, :func:`info`, :func:`warning`, :func:`error` and :"

"func:`critical`. To determine when to use logging, see the table below, "

"which states, for each of a set of common tasks, the best tool to use for it."

msgstr ""

"*Logging* proporciona un conjunto de funciones convenientes para un uso "

"sencillo de registro. Estas son :func:`debug`, :func:`info`, :func:"

"`warning`, :func:`error` y :func:`critical`. Para determinar cuándo usar el "

"registro, vea la tabla de abajo, que indica, para cada una de las tareas "

"comunes, la mejor herramienta a usar para ello."

#: ../Doc/howto/logging.rst:31

msgid "Task you want to perform"

msgstr "La tarea que quieres realizar"

#: ../Doc/howto/logging.rst:31

msgid "The best tool for the task"

msgstr "La mejor herramienta para la tarea"

#: ../Doc/howto/logging.rst:33

msgid ""

"Display console output for ordinary usage of a command line script or program"

msgstr ""

"Mostrar salidas de la consola para el uso ordinario de un programa o guión "

"(script) de línea de comandos"

#: ../Doc/howto/logging.rst:33

msgid ":func:`print`"

msgstr ":func:`print`"

#: ../Doc/howto/logging.rst:37

msgid ""

"Report events that occur during normal operation of a program (e.g. for "

"status monitoring or fault investigation)"

msgstr ""

"Reportar eventos que ocurren durante el funcionamiento normal de un programa "

"(por ejemplo, para la supervisión del estado o la investigación de fallos)"

#: ../Doc/howto/logging.rst:37

msgid ""

":func:`logging.info` (or :func:`logging.debug` for very detailed output for "

"diagnostic purposes)"

msgstr ""

":func:`logging.info` (o :func:`logging.debug` para salidas de registro muy "

"detalladas con fines de diagnóstico)"

#: ../Doc/howto/logging.rst:42

msgid "Issue a warning regarding a particular runtime event"

msgstr ""

"Emitir una advertencia con respecto a un evento de tiempo de ejecución en "

"particular"

#: ../Doc/howto/logging.rst:42

msgid ""

":func:`warnings.warn` in library code if the issue is avoidable and the "

"client application should be modified to eliminate the warning"

msgstr ""

":func:`warnings.warn` en el código de la biblioteca si el problema es "

"evitable y la aplicación cliente debe ser modificada para eliminar la "

"advertencia"

#: ../Doc/howto/logging.rst:47

msgid ""

":func:`logging.warning` if there is nothing the client application can do "

"about the situation, but the event should still be noted"

msgstr ""

":func:`logging.warning` si no hay nada que la aplicación cliente pueda hacer "

"sobre la situación, pero el evento debe ser anotado"

#: ../Doc/howto/logging.rst:52

msgid "Report an error regarding a particular runtime event"

msgstr ""

"Reportar un error con respecto a un evento particular al tiempo de ejecución"

#: ../Doc/howto/logging.rst:52

msgid "Raise an exception"

msgstr "Lanza una excepción"

#: ../Doc/howto/logging.rst:55

msgid ""

"Report suppression of an error without raising an exception (e.g. error "

"handler in a long-running server process)"

msgstr ""

"Reporta la supresión de un error sin invocar una excepción (por ejemplo, el "

"manejador de errores en un proceso de servidor de larga duración)"

#: ../Doc/howto/logging.rst:55

msgid ""

":func:`logging.error`, :func:`logging.exception` or :func:`logging.critical` "

"as appropriate for the specific error and application domain"

msgstr ""

":func:`logging.error`, :func:`logging.exception` o :func:`logging.critical` "

"según sea apropiado para el error específico y el dominio de la aplicación"

#: ../Doc/howto/logging.rst:62

msgid ""

"The logging functions are named after the level or severity of the events "

"they are used to track. The standard levels and their applicability are "

"described below (in increasing order of severity):"

msgstr ""

"Las funciones de registro se denominan según el nivel o la gravedad de los "

"eventos que se utilizan para rastrear. A continuación se describen los "

"niveles estándar y su aplicabilidad (en orden creciente de gravedad):"

#: ../Doc/howto/logging.rst:69 ../Doc/howto/logging.rst:855

msgid "Level"

msgstr "Nivel"

#: ../Doc/howto/logging.rst:69

msgid "When it's used"

msgstr "Cuando es usado"

#: ../Doc/howto/logging.rst:71 ../Doc/howto/logging.rst:865

msgid "``DEBUG``"

msgstr "``DEBUG``"

#: ../Doc/howto/logging.rst:71

msgid ""

"Detailed information, typically of interest only when diagnosing problems."

msgstr ""

"Información detallada, típicamente de interés sólo durante el diagnóstico de "

"problemas."

#: ../Doc/howto/logging.rst:74 ../Doc/howto/logging.rst:863

msgid "``INFO``"

msgstr "``INFO``"

#: ../Doc/howto/logging.rst:74

msgid "Confirmation that things are working as expected."

msgstr "Confirmación de que las cosas están funcionando como se esperaba."

#: ../Doc/howto/logging.rst:77 ../Doc/howto/logging.rst:861

msgid "``WARNING``"

msgstr "``WARNING``"

#: ../Doc/howto/logging.rst:77

msgid ""

"An indication that something unexpected happened, or indicative of some "

"problem in the near future (e.g. 'disk space low'). The software is still "

"working as expected."

msgstr ""

"Un indicio de que algo inesperado sucedió, o indicativo de algún problema en "

"el futuro cercano (por ejemplo, \"espacio de disco bajo\"). El software "

"sigue funcionando como se esperaba."

#: ../Doc/howto/logging.rst:82 ../Doc/howto/logging.rst:859

msgid "``ERROR``"

msgstr "``ERROR``"

#: ../Doc/howto/logging.rst:82

msgid ""

"Due to a more serious problem, the software has not been able to perform "

"some function."

msgstr ""

"Debido a un problema más grave, el software no ha sido capaz de realizar "

"alguna función."

#: ../Doc/howto/logging.rst:85 ../Doc/howto/logging.rst:857

msgid "``CRITICAL``"

msgstr "``CRITICAL``"

#: ../Doc/howto/logging.rst:85

msgid ""

"A serious error, indicating that the program itself may be unable to "

"continue running."

msgstr ""

"Un grave error, que indica que el programa en sí mismo puede ser incapaz de "

"seguir funcionando."

#: ../Doc/howto/logging.rst:89

msgid ""

"The default level is ``WARNING``, which means that only events of this level "

"and above will be tracked, unless the logging package is configured to do "

"otherwise."

msgstr ""

"El nivel por defecto es ``WARNING``, lo que significa que sólo los eventos "

"de este nivel y superiores serán rastreados, a menos que el paquete de "

"registro esté configurado para hacer lo contrario."

#: ../Doc/howto/logging.rst:93

msgid ""

"Events that are tracked can be handled in different ways. The simplest way "

"of handling tracked events is to print them to the console. Another common "

"way is to write them to a disk file."

msgstr ""

"Los eventos que se rastrean pueden ser manejados en diferentes maneras. La "

"forma más simple de manejar los eventos rastreados es imprimirlos en la "

"consola o terminal. Otra forma común es escribirlos en un archivo de disco."

#: ../Doc/howto/logging.rst:101

msgid "A simple example"

msgstr "Un simple ejemplo"

#: ../Doc/howto/logging.rst:103

msgid "A very simple example is::"

msgstr "Un ejemplo muy simple es::"

#: ../Doc/howto/logging.rst:109

msgid "If you type these lines into a script and run it, you'll see:"

msgstr "Si escribes estas líneas en un script y lo ejecutas, verás:"

#: ../Doc/howto/logging.rst:115

msgid ""

"printed out on the console. The ``INFO`` message doesn't appear because the "

"default level is ``WARNING``. The printed message includes the indication of "

"the level and the description of the event provided in the logging call, i."

"e. 'Watch out!'. Don't worry about the 'root' part for now: it will be "

"explained later. The actual output can be formatted quite flexibly if you "

"need that; formatting options will also be explained later."

msgstr ""

"impreso en la consola. El mensaje ``INFO`` no aparece porque el nivel por "

"defecto es ``WARNING``. El mensaje impreso incluye la indicación del nivel y "

"la descripción del evento proporcionado en la llamada de registro, es decir, "

"\"¡Cuidado!\". No te preocupes por la parte de la ‘root’ por ahora: se "

"explicará más adelante. La salida real puede ser formateada con bastante "

"flexibilidad si lo necesita; las opciones de formato también se explicarán "

"más adelante."

#: ../Doc/howto/logging.rst:124

msgid "Logging to a file"

msgstr "Logging a un archivo"

#: ../Doc/howto/logging.rst:126

msgid ""

"A very common situation is that of recording logging events in a file, so "

"let's look at that next. Be sure to try the following in a newly-started "

"Python interpreter, and don't just continue from the session described "

"above::"

msgstr ""

"Una situación muy común es la de registrar archivos de log, así que veamos "

"eso a continuación. Asegúrese de intentar lo siguiente en un intérprete de "

"Python recién iniciado, y no sólo continúe de la sesión descrita "

"anteriormente::"

#: ../Doc/howto/logging.rst:137

msgid ""

"The *encoding* argument was added. In earlier Python versions, or if not "

"specified, the encoding used is the default value used by :func:`open`. "

"While not shown in the above example, an *errors* argument can also now be "

"passed, which determines how encoding errors are handled. For available "

"values and the default, see the documentation for :func:`open`."

msgstr ""

#: ../Doc/howto/logging.rst:144

msgid ""

"And now if we open the file and look at what we have, we should find the log "

"messages:"

msgstr ""

"Y ahora si abrimos el archivo y miramos lo que tenemos, deberíamos encontrar "

"los mensajes de registro:"

#: ../Doc/howto/logging.rst:154

msgid ""

"This example also shows how you can set the logging level which acts as the "

"threshold for tracking. In this case, because we set the threshold to "

"``DEBUG``, all of the messages were printed."

msgstr ""

"Este ejemplo también muestra cómo se puede establecer el nivel de registro "

"que actúa como umbral para el rastreo. En este caso, como establecimos el "

"umbral en ``DEBUG``, todos los mensajes fueron impresos."

#: ../Doc/howto/logging.rst:158

msgid ""

"If you want to set the logging level from a command-line option such as:"

msgstr ""

"Si quieres establecer el nivel de registro desde una opción de línea de "

"comandos como:"

#: ../Doc/howto/logging.rst:164

msgid ""

"and you have the value of the parameter passed for ``--log`` in some "

"variable *loglevel*, you can use::"

msgstr ""

"y tienes el valor del parámetro pasado por ``--log`` en alguna variable "

"*loglevel*, puedes usar::"

#: ../Doc/howto/logging.rst:169

msgid ""

"to get the value which you'll pass to :func:`basicConfig` via the *level* "

"argument. You may want to error check any user input value, perhaps as in "

"the following example::"

msgstr ""

"para obtener el valor que pasarás a :func:`basicConfig` mediante el "

"argumento *level*. Puede que quieras comprobar un error por cualquier valor "

"de entrada del usuario, quizás como en el siguiente ejemplo::"

#: ../Doc/howto/logging.rst:181

msgid ""

"The call to :func:`basicConfig` should come *before* any calls to :func:"

"`debug`, :func:`info` etc. As it's intended as a one-off simple "

"configuration facility, only the first call will actually do anything: "

"subsequent calls are effectively no-ops."

msgstr ""

"La llamada a :func:`basicConfig` debería venir *antes* de cualquier llamada "

"a :func:`debug`, :func:`info` etc. Como se pretende hacer una simple "

"facilidad de configuración única, sólo la primera llamada hará realmente "

"algo: las llamadas subsiguientes son efectivamente no-ops."

#: ../Doc/howto/logging.rst:186

msgid ""

"If you run the above script several times, the messages from successive runs "

"are appended to the file *example.log*. If you want each run to start "

"afresh, not remembering the messages from earlier runs, you can specify the "

"*filemode* argument, by changing the call in the above example to::"

msgstr ""

"Si ejecutas el script anterior varias veces, los mensajes de las ejecuciones "

"sucesivas se añaden al archivo *example.log*. Si quieres que cada ejecución "

"se inicie de nuevo, sin recordar los mensajes de ejecuciones anteriores, "

"puedes especificar el argumento *filemode*, cambiando la llamada en el "

"ejemplo anterior a::"

#: ../Doc/howto/logging.rst:193

msgid ""

"The output will be the same as before, but the log file is no longer "

"appended to, so the messages from earlier runs are lost."

msgstr ""

"La impresión será la misma que antes, pero el archivo de registro ya no se "

"adjunta, por lo que los mensajes de las ejecuciones anteriores se pierden."

#: ../Doc/howto/logging.rst:198

msgid "Logging from multiple modules"

msgstr "*Logging* de múltiples módulos"

#: ../Doc/howto/logging.rst:200

msgid ""

"If your program consists of multiple modules, here's an example of how you "

"could organize logging in it::"

msgstr ""

"Si su programa consiste de múltiples módulos, aquí hay un ejemplo de cómo "

"podría organizar el inicio de sesión en él::"

#: ../Doc/howto/logging.rst:224

msgid "If you run *myapp.py*, you should see this in *myapp.log*:"

msgstr "Si ejecutas *myapp.py*, deberías ver esto en *myapp.log*:"

#: ../Doc/howto/logging.rst:232

msgid ""

"which is hopefully what you were expecting to see. You can generalize this "

"to multiple modules, using the pattern in *mylib.py*. Note that for this "

"simple usage pattern, you won't know, by looking in the log file, *where* in "

"your application your messages came from, apart from looking at the event "

"description. If you want to track the location of your messages, you'll need "

"to refer to the documentation beyond the tutorial level -- see :ref:`logging-"

"advanced-tutorial`."

msgstr ""

"que es lo que esperabas ver. Puedes generalizar esto a múltiples módulos, "

"usando el modelo en *mylib.py*. Ten en cuenta que para este simple patrón de "

"uso, no sabrás, mirando en el archivo de registro, *donde* en tu aplicación "

"vinieron tus mensajes, aparte de mirar la descripción del evento. Si quieres "

"rastrear la ubicación de tus mensajes, tendrás que consultar la "

"documentación más allá del nivel del tutorial -- ver :ref:`logging-advanced-"

"tutorial`."

#: ../Doc/howto/logging.rst:242

msgid "Logging variable data"

msgstr "Registrar datos de variables"

#: ../Doc/howto/logging.rst:244

msgid ""

"To log variable data, use a format string for the event description message "

"and append the variable data as arguments. For example::"

msgstr ""

"Para registrar los datos de variables, utilice una cadena de formato para el "

"mensaje de descripción del evento y añada los datos variables como "

"argumentos. Por ejemplo::"

#: ../Doc/howto/logging.rst:250

msgid "will display:"

msgstr "se mostrará:"

#: ../Doc/howto/logging.rst:256

#, python-format

msgid ""

"As you can see, merging of variable data into the event description message "

"uses the old, %-style of string formatting. This is for backwards "

"compatibility: the logging package pre-dates newer formatting options such "

"as :meth:`str.format` and :class:`string.Template`. These newer formatting "

"options *are* supported, but exploring them is outside the scope of this "

"tutorial: see :ref:`formatting-styles` for more information."

msgstr ""

"Como puedes ver, la fusión de datos de variables en el mensaje de "

"descripción de eventos utiliza el viejo estilo % de formato de cadena de "

"caracteres. Esto es para compatibilidad retrospectiva : el paquete de "

"registro precede las nuevas opciones de formato como :meth:`str.format` y :"

"class:`string.Template`. Estas nuevas opciones de formato *son* compatibles, "

"pero explorarlas está fuera del alcance de este tutorial: ver :ref:"

"`formatting-styles` para más información."

#: ../Doc/howto/logging.rst:265

msgid "Changing the format of displayed messages"

msgstr "Cambiar el formato de los mensajes mostrados"

#: ../Doc/howto/logging.rst:267

msgid ""

"To change the format which is used to display messages, you need to specify "

"the format you want to use::"

msgstr ""

"Para cambiar el formato que se utiliza para visualizar los mensajes, es "

"necesario especificar el formato que se desea utilizar::"

#: ../Doc/howto/logging.rst:276

msgid "which would print:"

msgstr "que se imprimirá:"

#: ../Doc/howto/logging.rst:284

msgid ""

"Notice that the 'root' which appeared in earlier examples has disappeared. "

"For a full set of things that can appear in format strings, you can refer to "

"the documentation for :ref:`logrecord-attributes`, but for simple usage, you "

"just need the *levelname* (severity), *message* (event description, "

"including variable data) and perhaps to display when the event occurred. "

"This is described in the next section."

msgstr ""

"Noten que la ‘root’ que aparecía en los ejemplos anteriores ha desaparecido. "

"Para un conjunto completo de cosas que pueden aparecer en formato de "

"cadenas, puede consultar la documentación de :ref:`logrecord-attributes`, "

"pero para un uso sencillo, sólo necesita el *levelname* (gravedad), "

"*message* (descripción del evento, incluyendo los datos variables) y tal vez "

"mostrar cuándo ocurrió el evento. Esto se describe en la siguiente sección."

#: ../Doc/howto/logging.rst:293

msgid "Displaying the date/time in messages"

msgstr "Visualización de la fecha/hora en los mensajes"

#: ../Doc/howto/logging.rst:295

#, python-format

msgid ""

"To display the date and time of an event, you would place '%(asctime)s' in "

"your format string::"

msgstr ""

"Para mostrar la fecha y la hora de un evento, usted colocaría '%(asctime)s' "

"en su cadena de formato::"

#: ../Doc/howto/logging.rst:302

msgid "which should print something like this:"

msgstr "que debería imprimir algo como esto:"

#: ../Doc/howto/logging.rst:308

msgid ""

"The default format for date/time display (shown above) is like ISO8601 or :"

"rfc:`3339`. If you need more control over the formatting of the date/time, "

"provide a *datefmt* argument to ``basicConfig``, as in this example::"

msgstr ""

"El formato por defecto para la visualización de la fecha/hora (mostrado "

"arriba) es como ISO8601 o :rfc:`3339`. Si necesita más control sobre el "

"formato de la fecha/hora, proporcione un argumento *datefmt* a "

"``basicConfig``, como en este ejemplo::"

#: ../Doc/howto/logging.rst:316

msgid "which would display something like this:"

msgstr "que mostraría algo como esto:"

#: ../Doc/howto/logging.rst:322

msgid ""

"The format of the *datefmt* argument is the same as supported by :func:`time."

"strftime`."

msgstr ""

"El formato del argumento *datefmt* es el mismo que el soportado por :func:"

"`time.strftime`."

#: ../Doc/howto/logging.rst:327

msgid "Next Steps"

msgstr "Próximos pasos"

#: ../Doc/howto/logging.rst:329

msgid ""

"That concludes the basic tutorial. It should be enough to get you up and "

"running with logging. There's a lot more that the logging package offers, "

"but to get the best out of it, you'll need to invest a little more of your "

"time in reading the following sections. If you're ready for that, grab some "

"of your favourite beverage and carry on."

msgstr ""

"Eso concluye el tutorial básico. Debería ser suficiente para ponerte en "

"marcha con el registro. Hay mucho más que el paquete de registro ofrece, "

"pero para obtener lo mejor de él, tendrá que invertir un poco más de su "

"tiempo en la lectura de las siguientes secciones. Si estás listo para eso, "

"toma un poco de tu bebida favorita y sigue adelante."

#: ../Doc/howto/logging.rst:335

msgid ""

"If your logging needs are simple, then use the above examples to incorporate "

"logging into your own scripts, and if you run into problems or don't "

"understand something, please post a question on the comp.lang.python Usenet "

"group (available at https://groups.google.com/forum/#!forum/comp.lang."

"python) and you should receive help before too long."

msgstr ""

"Si sus necesidades de registro son sencillas, utilice los ejemplos previos "

"para incorporar el registro en sus propios scripts, y si tiene problemas o "

"no entiende algo, por favor publique una pregunta en el grupo Usenet de comp."

"lang.python (disponible en https://groups.google.com/forum/#!forum/comp.lang."

"python) y debería recibir ayuda antes de que transcurra demasiado tiempo."

#: ../Doc/howto/logging.rst:341

msgid ""

"Still here? You can carry on reading the next few sections, which provide a "

"slightly more advanced/in-depth tutorial than the basic one above. After "

"that, you can take a look at the :ref:`logging-cookbook`."

msgstr ""

"¿Todavía esta aquí? Puedes seguir leyendo las siguientes secciones, que "

"proporcionan un tutorial un poco más avanzado y profundo que el básico de "

"arriba. Después de eso, puedes echar un vistazo al :ref:`logging-cookbook`."

#: ../Doc/howto/logging.rst:349

msgid "Advanced Logging Tutorial"

msgstr "Tutorial de registro avanzado"

#: ../Doc/howto/logging.rst:351

msgid ""

"The logging library takes a modular approach and offers several categories "

"of components: loggers, handlers, filters, and formatters."

msgstr ""

"La biblioteca de logging adopta un enfoque modular y ofrece varias "

"categorías de componentes: registradores, gestores, filtros y formateadores."

#: ../Doc/howto/logging.rst:354

msgid "Loggers expose the interface that application code directly uses."

msgstr ""

"Los registradores exponen la interfaz que el código de la aplicación utiliza "

"directamente."

#: ../Doc/howto/logging.rst:355

msgid ""

"Handlers send the log records (created by loggers) to the appropriate "

"destination."

msgstr ""

"Los gestores envían los registros de log (creados por los registradores) al "

"destino apropiado."

#: ../Doc/howto/logging.rst:357

msgid ""

"Filters provide a finer grained facility for determining which log records "

"to output."

msgstr ""

"Los filtros proporcionan una instalación de grano más fino para determinar "

"qué registros de log se deben producir."

#: ../Doc/howto/logging.rst:359

msgid "Formatters specify the layout of log records in the final output."

msgstr ""

"Los formatos especifican la disposición de los archivos de log en el "

"resultado final."

#: ../Doc/howto/logging.rst:361

msgid ""

"Log event information is passed between loggers, handlers, filters and "

"formatters in a :class:`LogRecord` instance."

msgstr ""

"La información de los eventos de registro se pasa entre los registradores, "

"gestores, filtros y formateadores en una instancia :class:`LogRecord`."

#: ../Doc/howto/logging.rst:364

msgid ""

"Logging is performed by calling methods on instances of the :class:`Logger` "

"class (hereafter called :dfn:`loggers`). Each instance has a name, and they "

"are conceptually arranged in a namespace hierarchy using dots (periods) as "

"separators. For example, a logger named 'scan' is the parent of loggers "

"'scan.text', 'scan.html' and 'scan.pdf'. Logger names can be anything you "

"want, and indicate the area of an application in which a logged message "

"originates."

msgstr ""

"El registro se realiza llamando a métodos en instancias de la clase :class:"

"`Logger` (de aquí en adelante llamada :dfn:`loggers`). Cada instancia tiene "

"un nombre, y se organizan conceptualmente en una jerarquía de espacios de "

"nombres utilizando puntos (puntos) como separadores. Por ejemplo, un "

"registrador llamado 'scan' es el padre de los registradores 'scan.text', "

"'scan.html' y 'scan.pdf'. Los nombres de los registradores pueden ser "

"cualquier cosa que se desee, e indican el área de una aplicación en la que "

"se origina un mensaje registrado."

#: ../Doc/howto/logging.rst:371

msgid ""

"A good convention to use when naming loggers is to use a module-level "

"logger, in each module which uses logging, named as follows::"

msgstr ""

"Una buena convención que se puede utilizar para nombrar a los registradores "

"es utilizar un registrador a nivel de módulo, en cada módulo que utilice el "

"registro, llamado de la siguiente manera::"

#: ../Doc/howto/logging.rst:376

msgid ""

"This means that logger names track the package/module hierarchy, and it's "

"intuitively obvious where events are logged just from the logger name."

msgstr ""

"Esto significa que los nombres de los registradores rastrean la jerarquía de "

"paquetes/módulos, y es intuitivamente obvio donde se registran los eventos "

"sólo a partir del nombre del registrador."

#: ../Doc/howto/logging.rst:379

msgid ""

"The root of the hierarchy of loggers is called the root logger. That's the "

"logger used by the functions :func:`debug`, :func:`info`, :func:`warning`, :"

"func:`error` and :func:`critical`, which just call the same-named method of "

"the root logger. The functions and the methods have the same signatures. The "

"root logger's name is printed as 'root' in the logged output."

msgstr ""

"La raíz de la jerarquía de los registradores se llama root *logger*. Ese es "

"el registrador usado por las funciones :func:`debug`, :func:`info`, :func:"

"`warning`, :func:`error` y :func:`critícal`, que sólo llaman al mismo método "

"del registrador raíz. Las funciones y los métodos tienen las mismas firmas. "

"El nombre del root *logger* se imprime como ‘root’ en la salida registrada."

#: ../Doc/howto/logging.rst:385

msgid ""

"It is, of course, possible to log messages to different destinations. "

"Support is included in the package for writing log messages to files, HTTP "

"GET/POST locations, email via SMTP, generic sockets, queues, or OS-specific "

"logging mechanisms such as syslog or the Windows NT event log. Destinations "

"are served by :dfn:`handler` classes. You can create your own log "

"destination class if you have special requirements not met by any of the "

"built-in handler classes."

msgstr ""

"Por supuesto, es posible registrar mensajes a diferentes destinos. El "

"paquete incluye soporte para escribir mensajes de registro en archivos, "

"ubicaciones HTTP GET/POST, correo electrónico a través de SMTP, sockets "

"genéricos, colas o mecanismos de registro específicos del sistema operativo "

"como syslog o el registro de eventos de Windows NT. Los destinos son "

"servidos por clases :dfn:`handler`. Puedes crear tu propia clase de destino "

"de registro si tienes requisitos especiales que no se cumplen con ninguna de "

"las clases de gestor incorporadas."

#: ../Doc/howto/logging.rst:392

msgid ""

"By default, no destination is set for any logging messages. You can specify "

"a destination (such as console or file) by using :func:`basicConfig` as in "

"the tutorial examples. If you call the functions :func:`debug`, :func:"

"`info`, :func:`warning`, :func:`error` and :func:`critical`, they will check "

"to see if no destination is set; and if one is not set, they will set a "

"destination of the console (``sys.stderr``) and a default format for the "

"displayed message before delegating to the root logger to do the actual "

"message output."

msgstr ""

"Por defecto, no se establece ningún destino para los mensajes de registro. "

"Puede especificar un destino (como consola o archivo) usando :func:"

"`basicConfig` como en los ejemplos del tutorial. Si llama a las funciones :"

"func:`debug`, :func:`info`, :func:`warning`, :func:`error` y :func:"

"`critical`, ellas comprobarán si no hay ningún destino establecido; y si no "

"hay ninguno establecido, establecerán un destino de la consola (``sys."

"stderr``) y un formato por defecto para el mensaje mostrado antes de delegar "

"en el registrador root para hacer la salida real del mensaje."

#: ../Doc/howto/logging.rst:400

msgid "The default format set by :func:`basicConfig` for messages is:"

msgstr ""

"El formato por defecto establecido por :func:`basicConfig` para los mensajes "

"es:"

#: ../Doc/howto/logging.rst:406

msgid ""

"You can change this by passing a format string to :func:`basicConfig` with "

"the *format* keyword argument. For all options regarding how a format string "

"is constructed, see :ref:`formatter-objects`."

msgstr ""

"Puedes cambiar esto pasando una cadena de formato a :func:`basicConfig` con "

"el argumento de la palabra clave *format*. Para todas las opciones relativas "

"a cómo se construye una cadena de formato, ver :ref:`formatter-objects`."

#: ../Doc/howto/logging.rst:411

msgid "Logging Flow"

msgstr "Flujo de Registro"

#: ../Doc/howto/logging.rst:413

msgid ""

"The flow of log event information in loggers and handlers is illustrated in "

"the following diagram."

msgstr ""

"En el siguiente diagrama se ilustra el flujo de información de los eventos "

"de registro en los registradores y gestores."

#: ../Doc/howto/logging.rst:419

msgid "Loggers"

msgstr "Registradores"

#: ../Doc/howto/logging.rst:421

msgid ""

":class:`Logger` objects have a threefold job. First, they expose several "

"methods to application code so that applications can log messages at "

"runtime. Second, logger objects determine which log messages to act upon "

"based upon severity (the default filtering facility) or filter objects. "

"Third, logger objects pass along relevant log messages to all interested log "

"handlers."

msgstr ""

"Los objetos de :class:`Logger` tienen un trabajo triple. Primero, exponen "

"varios métodos al código de la aplicación para que las aplicaciones puedan "

"registrar mensajes en tiempo de ejecución. Segundo, los objetos *logger* "

"determinan sobre qué mensajes de registro actuar en base de la severidad (la "

"facilidad de filtrado por defecto) o los objetos de filtro. Tercero, los "

"objetos registradores pasan los mensajes de registro relevantes a todos los "

"manejadores de registro interesados."

#: ../Doc/howto/logging.rst:427

msgid ""

"The most widely used methods on logger objects fall into two categories: "

"configuration and message sending."

msgstr ""

"Los métodos más utilizados en los objetos de registro se dividen en dos "

"categorías: configuración y envío de mensajes."

#: ../Doc/howto/logging.rst:430

msgid "These are the most common configuration methods:"

msgstr "Estos son los métodos de configuración más comunes:"

#: ../Doc/howto/logging.rst:432

msgid ""

":meth:`Logger.setLevel` specifies the lowest-severity log message a logger "

"will handle, where debug is the lowest built-in severity level and critical "

"is the highest built-in severity. For example, if the severity level is "

"INFO, the logger will handle only INFO, WARNING, ERROR, and CRITICAL "

"messages and will ignore DEBUG messages."

msgstr ""

":meth:`Logger.setLevel` especifica el mensaje de registro de menor gravedad "

"que un registrador manejará, donde debug es el nivel de gravedad incorporado "

"más bajo y *critical* es el de mayor gravedad incorporado. Por ejemplo, si "

"el nivel de severidad es INFO, el registrador sólo manejará los mensajes "

"INFO, WARNING, ERROR y CRITICAL e ignorará los mensajes DEBUG."

#: ../Doc/howto/logging.rst:438

msgid ""

":meth:`Logger.addHandler` and :meth:`Logger.removeHandler` add and remove "

"handler objects from the logger object. Handlers are covered in more detail "

"in :ref:`handler-basic`."

msgstr ""

":meth:`Logger.addHandler` y :meth:`Logger.removeHandler` agregan y quitan "

"los objetos *handler* del objeto *logger*. Los manejadores (*handlers*) se "

"tratan con más detalle en :ref:`handler-basic`."

#: ../Doc/howto/logging.rst:442

msgid ""

":meth:`Logger.addFilter` and :meth:`Logger.removeFilter` add and remove "

"filter objects from the logger object. Filters are covered in more detail "

"in :ref:`filter`."

msgstr ""

":meth:`Logger.addFilter` y :meth:`Logger.removeFilter` agregan y quitan los "

"objetos de filtro del objeto logger. Los filtros se tratan con más detalle "

"en :ref:`filter`."

#: ../Doc/howto/logging.rst:446

msgid ""

"You don't need to always call these methods on every logger you create. See "

"the last two paragraphs in this section."

msgstr ""

"No es necesario que siempre llames a estos métodos en cada registrador que "

"crees. Vea los dos últimos párrafos de esta sección."

#: ../Doc/howto/logging.rst:449

msgid ""

"With the logger object configured, the following methods create log messages:"

msgstr ""

"Con el objeto *logger* configurado, los siguientes métodos crean mensajes de "

"log:"

#: ../Doc/howto/logging.rst:451

#, python-format

msgid ""

":meth:`Logger.debug`, :meth:`Logger.info`, :meth:`Logger.warning`, :meth:"

"`Logger.error`, and :meth:`Logger.critical` all create log records with a "

"message and a level that corresponds to their respective method names. The "

"message is actually a format string, which may contain the standard string "

"substitution syntax of ``%s``, ``%d``, ``%f``, and so on. The rest of their "

"arguments is a list of objects that correspond with the substitution fields "

"in the message. With regard to ``**kwargs``, the logging methods care only "

"about a keyword of ``exc_info`` and use it to determine whether to log "

"exception information."

msgstr ""

":meth:`Logger.debug`, :meth:`Logger.info`, :meth:`Logger.warning`, :meth:"

"`Logger.error`, y :meth:`Logger.critical` todos crean registros de registro "

"con un mensaje y un nivel que corresponde a sus respectivos nombres de "

"método. El mensaje es en realidad una cadena de formato, que puede contener "

"la sintaxis estándar de sustitución de cadenas de ``%s``, ``%d``, ``%f``, y "

"así sucesivamente. El resto de sus argumentos es una lista de objetos que "

"se corresponden con los campos de sustitución del mensaje. Con respecto a "

"``**kwargs``, los métodos de registro sólo se preocupan por una palabra "

"clave de ``exc_info`` y la usan para determinar si registran información de "

"excepción."

#: ../Doc/howto/logging.rst:461

msgid ""

":meth:`Logger.exception` creates a log message similar to :meth:`Logger."

"error`. The difference is that :meth:`Logger.exception` dumps a stack trace "

"along with it. Call this method only from an exception handler."

msgstr ""

":meth:`Logger.exception` crea un mensaje de registro similar a :meth:`Logger."

"error`. La diferencia es que :meth:`Logger.exception` vuelca un rastro de "

"pila junto con él. Llama a este método sólo desde un manejador de "

"excepciones."

#: ../Doc/howto/logging.rst:465

msgid ""

":meth:`Logger.log` takes a log level as an explicit argument. This is a "

"little more verbose for logging messages than using the log level "

"convenience methods listed above, but this is how to log at custom log "

"levels."

msgstr ""

":meth:`Logger.log` toma un nivel de log como argumento explícito. Esto es "

"un poco más verboso para el registro de mensajes que usar los métodos de "

"conveniencia de nivel de registro listados arriba, pero así es como se "

"registra en niveles de registro personalizados."

#: ../Doc/howto/logging.rst:469

msgid ""

":func:`getLogger` returns a reference to a logger instance with the "

"specified name if it is provided, or ``root`` if not. The names are period-"

"separated hierarchical structures. Multiple calls to :func:`getLogger` with "

"the same name will return a reference to the same logger object. Loggers "

"that are further down in the hierarchical list are children of loggers "

"higher up in the list. For example, given a logger with a name of ``foo``, "

"loggers with names of ``foo.bar``, ``foo.bar.baz``, and ``foo.bam`` are all "

"descendants of ``foo``."

msgstr ""

":func:`getLogger` retorna una referencia a una instancia de *logger* con el "

"nombre especificado si se proporciona, o ``root`` si no. Los nombres son "

"estructuras jerárquicas separadas por períodos. Múltiples llamadas a :func:"

"`getLogger` con el mismo nombre retornarán una referencia al mismo objeto "

"*logger*. Los *loggers* que están más abajo en la lista jerárquica son "

"hijos de los *loggers* que están más arriba en la lista. Por ejemplo, dado "

"un *logger* con un nombre de ``foo``, los *loggers* con nombres de ``foo."

"bar``, ``foo.bar.baz``, y ``foo.bam`` son todos descendientes de ``foo``."

#: ../Doc/howto/logging.rst:477

msgid ""

"Loggers have a concept of *effective level*. If a level is not explicitly "

"set on a logger, the level of its parent is used instead as its effective "

"level. If the parent has no explicit level set, *its* parent is examined, "

"and so on - all ancestors are searched until an explicitly set level is "

"found. The root logger always has an explicit level set (``WARNING`` by "

"default). When deciding whether to process an event, the effective level of "

"the logger is used to determine whether the event is passed to the logger's "

"handlers."

msgstr ""

"Los registradores tienen un concepto de *nivel efectivo*. Si un nivel no se "

"establece explícitamente en un registrador, el nivel de su clase padre se "

"utiliza en su lugar como su nivel efectivo. Si el padre no tiene un nivel "

"explícito establecido, *su* padre es examinado, y así sucesivamente - se "

"buscan todos los ancestros hasta que se encuentra un nivel explícitamente "

"establecido. El registrador raíz siempre tiene un conjunto de niveles "

"explícito (``Advertencia`` por defecto). Cuando se decide si se procesa un "

"evento, el nivel efectivo del registrador se utiliza para determinar si el "

"evento se pasa a los manejadores del registrador."

#: ../Doc/howto/logging.rst:485

msgid ""

"Child loggers propagate messages up to the handlers associated with their "

"ancestor loggers. Because of this, it is unnecessary to define and configure "

"handlers for all the loggers an application uses. It is sufficient to "

"configure handlers for a top-level logger and create child loggers as "

"needed. (You can, however, turn off propagation by setting the *propagate* "

"attribute of a logger to ``False``.)"

msgstr ""

"Los *loggers* inferiores propagan mensajes hasta los gestores asociados con "

"sus *loggers* ancestros. Debido a esto, no es necesario definir y configurar "

"los manejadores para todos los registradores que utiliza una aplicación. "

"Basta con configurar los manejadores para un registrador de nivel superior y "

"crear registradores hijos según sea necesario. (Sin embargo, puedes "

"desactivar la propagación estableciendo el atributo *propagate* de un "

"*logger* en ``False``.)"

#: ../Doc/howto/logging.rst:496

msgid "Handlers"

msgstr "Gestores"

#: ../Doc/howto/logging.rst:498

msgid ""

":class:`~logging.Handler` objects are responsible for dispatching the "

"appropriate log messages (based on the log messages' severity) to the "

"handler's specified destination. :class:`Logger` objects can add zero or "

"more handler objects to themselves with an :meth:`~Logger.addHandler` "

"method. As an example scenario, an application may want to send all log "

"messages to a log file, all log messages of error or higher to stdout, and "

"all messages of critical to an email address. This scenario requires three "

"individual handlers where each handler is responsible for sending messages "

"of a specific severity to a specific location."

msgstr ""

"Los objetos :class:`~logging.Handler` son responsables de enviar los "

"mensajes de registro apropiados (basados en la severidad de los mensajes de "

"registro) al destino especificado por el handler. :class:`Logger` los "

"objetos pueden añadir cero o más objetos *handler* a sí mismos con un "

"método :meth:`~Logger.addHandler`. Como escenario de ejemplo, una "

"aplicación puede querer enviar todos los mensajes de registro a un archivo "

"de registro, todos los mensajes de registro de error o superiores a stdout, "

"y todos los mensajes de crítico a una dirección de correo electrónico. Este "

"escenario requiere tres manejadores individuales donde cada manejador es "

"responsable de enviar mensajes de una severidad específica a una ubicación "

"específica."

#: ../Doc/howto/logging.rst:508

msgid ""

"The standard library includes quite a few handler types (see :ref:`useful-"

"handlers`); the tutorials use mainly :class:`StreamHandler` and :class:"

"`FileHandler` in its examples."

msgstr ""

"La biblioteca estándar incluye bastantes tipos de *handler* (ver :ref:"

"`useful-handlers`); los tutoriales usan principalmente :class:"

"`StreamHandler` y :class:`FileHandler` en sus ejemplos."

#: ../Doc/howto/logging.rst:512

msgid ""

"There are very few methods in a handler for application developers to "

"concern themselves with. The only handler methods that seem relevant for "

"application developers who are using the built-in handler objects (that is, "

"not creating custom handlers) are the following configuration methods:"

msgstr ""

"Hay muy pocos métodos en un manejador para que los desarrolladores de "

"aplicaciones se preocupen. Los únicos métodos de manejador que parecen "

"relevantes para los desarrolladores de aplicaciones que utilizan los objetos "

"de manejador incorporados (es decir, que no crean manejadores "

"personalizados) son los siguientes métodos de configuración:"

#: ../Doc/howto/logging.rst:517

msgid ""

"The :meth:`~Handler.setLevel` method, just as in logger objects, specifies "

"the lowest severity that will be dispatched to the appropriate destination. "

"Why are there two :func:`setLevel` methods? The level set in the logger "

"determines which severity of messages it will pass to its handlers. The "

"level set in each handler determines which messages that handler will send "

"on."

msgstr ""

"El método :meth:`~Handler.setLevel`, al igual que en los objetos de "

"*logger*, especifica la menor gravedad que será enviada al destino "

"apropiado. ¿Por qué hay dos métodos :func:`setLevel`? El nivel establecido "

"en el registrador determina qué gravedad de los mensajes pasará a sus "

"manejadores. El nivel establecido en cada manejador determina qué mensajes "

"enviará ese manejador."

#: ../Doc/howto/logging.rst:523

msgid ""

":meth:`~Handler.setFormatter` selects a Formatter object for this handler to "

"use."

msgstr ""

":meth:`~Handler.setFormatter` selecciona un objeto *Formatter* para que este "

"*handler* lo use."

#: ../Doc/howto/logging.rst:526

msgid ""

":meth:`~Handler.addFilter` and :meth:`~Handler.removeFilter` respectively "

"configure and deconfigure filter objects on handlers."

msgstr ""

":meth:`~Handler.addFilter` y :meth:`~Handler.removeFilter` respectivamente "