# 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: 2026-02-26 18:44-0300\n"

"PO-Revision-Date: 2023-12-24 12:44+0100\n"

"Last-Translator: Claudia Millan <clmilneb@gmail.com>\n"

"Language: es_PE\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.18.0\n"

#: ../Doc/library/configparser.rst:2

#, fuzzy

msgid ":mod:`!configparser` --- Configuration file parser"

msgstr ":mod:`configparser` --- *Parser* para archivos de configuración"

#: ../Doc/library/configparser.rst:14

msgid "**Source code:** :source:`Lib/configparser.py`"

msgstr "**Código fuente:** :source:`Lib/configparser.py`"

#: ../Doc/library/configparser.rst:24

msgid ""

"This module provides the :class:`ConfigParser` class which implements a "

"basic configuration language which provides a structure similar to what's "

"found in Microsoft Windows INI files. You can use this to write Python "

"programs which can be customized by end users easily."

msgstr ""

"Este módulo provee la clase :class:`ConfigParser`, la cual implementa un "

"lenguaje básico de configuración que proporciona una estructura similar a la "

"encontrada en los archivos INI de Microsoft Windows. Puedes utilizarla para "

"escribir programas Python que los usuarios finales puedan personalizar con "

"facilidad."

#: ../Doc/library/configparser.rst:31

msgid ""

"This library does *not* interpret or write the value-type prefixes used in "

"the Windows Registry extended version of INI syntax."

msgstr ""

"Esta biblioteca *no* interpreta o escribe los prefijos valor-tipo usados en "

"la versión extendida de la sintaxis INI, utilizada en el registro de Windows."

#: ../Doc/library/configparser.rst:36

msgid "Module :mod:`tomllib`"

msgstr "Módulo :mod:`tomllib`"

#: ../Doc/library/configparser.rst:37

msgid ""

"TOML is a well-specified format for application configuration files. It is "

"specifically designed to be an improved version of INI."

msgstr ""

"TOML es un formato bien-especificado para archivos de configuración de "

"aplicaciones. Está específicamente diseñado para ser una versión mejorada de "

"INI."

#: ../Doc/library/configparser.rst:40

msgid "Module :mod:`shlex`"

msgstr "Módulo :mod:`shlex`"

#: ../Doc/library/configparser.rst:41

msgid ""

"Support for creating Unix shell-like mini-languages which can also be used "

"for application configuration files."

msgstr ""

"Soporta la creación de un mini-lenguaje parecido a shell de Unix, que puede "

"utilizarse para archivos de configuración de aplicaciones."

#: ../Doc/library/configparser.rst:44

msgid "Module :mod:`json`"

msgstr "Módulo :mod:`json`"

#: ../Doc/library/configparser.rst:45

msgid ""

"The ``json`` module implements a subset of JavaScript syntax which is "

"sometimes used for configuration, but does not support comments."

msgstr ""

"El módulo ``json`` implementa un subconjunto de la sintaxis de JavaScript, "

"que también puede utilizarse para configuración, pero no soporta comentarios."

#: ../Doc/library/configparser.rst:61

msgid "Quick Start"

msgstr "Inicio Rápido"

#: ../Doc/library/configparser.rst:63

msgid "Let's take a very basic configuration file that looks like this:"

msgstr "Tomemos un archivo de configuración muy básico, el cual luce así:"

#: ../Doc/library/configparser.rst:65

msgid ""

"[DEFAULT]\n"

"ServerAliveInterval = 45\n"

"Compression = yes\n"

"CompressionLevel = 9\n"

"ForwardX11 = yes\n"

"\n"

"[forge.example]\n"

"User = hg\n"

"\n"

"[topsecret.server.example]\n"

"Port = 50022\n"

"ForwardX11 = no"

msgstr ""

#: ../Doc/library/configparser.rst:80

msgid ""

"The structure of INI files is described `in the following section "

"<#supported-ini-file-structure>`_. Essentially, the file consists of "

"sections, each of which contains keys with values. :mod:`configparser` "

"classes can read and write such files. Let's start by creating the above "

"configuration file programmatically."

msgstr ""

"La estructura de los archivos INI es descrita `en la siguiente sección "

"<#supported-ini-file-structure>`_. En esencia, el archivo consiste de "

"secciones, cada una de las cuales contiene claves con valores. Las clases :"

"mod:`configparser` pueden leer y escribir dichos archivos. Comencemos "

"creando el anterior archivo de configuración de forma programática."

#: ../Doc/library/configparser.rst:86

#, python-brace-format

msgid ""

">>> import configparser\n"

">>> config = configparser.ConfigParser()\n"

">>> config['DEFAULT'] = {'ServerAliveInterval': '45',\n"

"... 'Compression': 'yes',\n"

"... 'CompressionLevel': '9'}\n"

">>> config['forge.example'] = {}\n"

">>> config['forge.example']['User'] = 'hg'\n"

">>> config['topsecret.server.example'] = {}\n"

">>> topsecret = config['topsecret.server.example']\n"

">>> topsecret['Port'] = '50022' # mutates the parser\n"

">>> topsecret['ForwardX11'] = 'no' # same here\n"

">>> config['DEFAULT']['ForwardX11'] = 'yes'\n"

">>> with open('example.ini', 'w') as configfile:\n"

"... config.write(configfile)\n"

"..."

msgstr ""

#: ../Doc/library/configparser.rst:104

msgid ""

"As you can see, we can treat a config parser much like a dictionary. There "

"are differences, `outlined later <#mapping-protocol-access>`_, but the "

"behavior is very close to what you would expect from a dictionary."

msgstr ""

"Como puedes ver, podemos tratar al *config parser* como a un diccionario. "

"Existen diferencias, `descritas posteriormente <#mapping-protocol-"

"access>`_, pero su comportamiento es muy parecido al que esperarías de un "

"diccionario."

#: ../Doc/library/configparser.rst:108

msgid ""

"Now that we have created and saved a configuration file, let's read it back "

"and explore the data it holds."

msgstr ""

"Ahora que hemos creado y guardado el archivo de configuración, vamos a "

"releerlo y analizar los datos que contiene."

#: ../Doc/library/configparser.rst:111

msgid ""

">>> config = configparser.ConfigParser()\n"

">>> config.sections()\n"

"[]\n"

">>> config.read('example.ini')\n"

"['example.ini']\n"

">>> config.sections()\n"

"['forge.example', 'topsecret.server.example']\n"

">>> 'forge.example' in config\n"

"True\n"

">>> 'python.org' in config\n"

"False\n"

">>> config['forge.example']['User']\n"

"'hg'\n"

">>> config['DEFAULT']['Compression']\n"

"'yes'\n"

">>> topsecret = config['topsecret.server.example']\n"

">>> topsecret['ForwardX11']\n"

"'no'\n"

">>> topsecret['Port']\n"

"'50022'\n"

">>> for key in config['forge.example']:\n"

"... print(key)\n"

"user\n"

"compressionlevel\n"

"serveraliveinterval\n"

"compression\n"

"forwardx11\n"

">>> config['forge.example']['ForwardX11']\n"

"'yes'"

msgstr ""

#: ../Doc/library/configparser.rst:143

msgid ""

"As we can see above, the API is pretty straightforward. The only bit of "

"magic involves the ``DEFAULT`` section which provides default values for all "

"other sections [1]_. Note also that keys in sections are case-insensitive "

"and stored in lowercase [1]_."

msgstr ""

"Como podemos apreciar, la API es muy clara. La única 'porción de magia' está "

"en la sección ``DEFAULT``, la cual proporciona los valores por defecto para "

"todas las demás secciones [1]_. Observe también que las claves de las "

"secciones son insensibles a mayúsculas y minúsculas, pero se almacenan en "

"minúscula [1]_."

#: ../Doc/library/configparser.rst:148 ../Doc/library/configparser.rst:1003

#, fuzzy

msgid ""

"It is possible to read several configurations into a single :class:"

"`ConfigParser`, where the most recently added configuration has the highest "

"priority. Any conflicting keys are taken from the more recent configuration "

"while the previously existing keys are retained. The example below reads in "

"an ``override.ini`` file, which will override any conflicting keys from the "

"``example.ini`` file."

msgstr ""

"Es posible leer varias configuraciones en un único :class:`ConfigParser`, "

"siendo la configuración añadida más recientemente la que tendrá la prioridad "

"más alta. Las claves que entren en conflicto se toman de la configuración "

"más reciente mientras que las claves preexistentes se mantienen."

#: ../Doc/library/configparser.rst:155 ../Doc/library/configparser.rst:1010

msgid ""

"[DEFAULT]\n"

"ServerAliveInterval = -1"

msgstr ""

#: ../Doc/library/configparser.rst:160 ../Doc/library/configparser.rst:1015

#, python-brace-format

msgid ""

">>> config_override = configparser.ConfigParser()\n"

">>> config_override['DEFAULT'] = {'ServerAliveInterval': '-1'}\n"

">>> with open('override.ini', 'w') as configfile:\n"

"... config_override.write(configfile)\n"

"...\n"

">>> config_override = configparser.ConfigParser()\n"

">>> config_override.read(['example.ini', 'override.ini'])\n"

"['example.ini', 'override.ini']\n"

">>> print(config_override.get('DEFAULT', 'ServerAliveInterval'))\n"

"-1"

msgstr ""

#: ../Doc/library/configparser.rst:174

msgid ""

"This behaviour is equivalent to a :meth:`ConfigParser.read` call with "

"several files passed to the *filenames* parameter."

msgstr ""

"Este comportamiento es equivalente a una llamada a :meth:`ConfigParser.read` "

"pasando varios ficheros en el parámetro *filenames*."

#: ../Doc/library/configparser.rst:179

msgid "Supported Datatypes"

msgstr "Tipos de Datos Soportados"

#: ../Doc/library/configparser.rst:181

msgid ""

"Config parsers do not guess datatypes of values in configuration files, "

"always storing them internally as strings. This means that if you need "

"other datatypes, you should convert on your own:"

msgstr ""

"Los *config parsers* no especulan respecto a los tipos de datos de los "

"valores en los archivos de configuración, siempre los almacenan internamente "

"como cadenas de caracteres. Esto significa que si necesitas otros tipos de "

"datos, deberás hacer la conversión por ti mismo:"

#: ../Doc/library/configparser.rst:185

msgid ""

">>> int(topsecret['Port'])\n"

"50022\n"

">>> float(topsecret['CompressionLevel'])\n"

"9.0"

msgstr ""

#: ../Doc/library/configparser.rst:192

msgid ""

"Since this task is so common, config parsers provide a range of handy getter "

"methods to handle integers, floats and booleans. The last one is the most "

"interesting because simply passing the value to ``bool()`` would do no good "

"since ``bool('False')`` is still ``True``. This is why config parsers also "

"provide :meth:`~ConfigParser.getboolean`. This method is case-insensitive "

"and recognizes Boolean values from ``'yes'``/``'no'``, ``'on'``/``'off'``, "

"``'true'``/``'false'`` and ``'1'``/``'0'`` [1]_. For example:"

msgstr ""

"Dado que esta tarea es muy común, los *config parsers* proporcionan una "

"amplia variedad de útiles métodos de lectura (*getter*) que manejan enteros, "

"números de punto flotante y booleanos. Este último es el más interesante, "

"porque puede no ser correcto pasar simplemente el valor a ``bool()``, ya que "

"``bool('False')`` resultará en ``True``. Por esta razón los *config parsers* "

"proporcionan también el método :meth:`~ConfigParser.getboolean`. Este método "

"es insensible a mayúsculas y minúsculas, y reconoce como valores booleanos a "

"los valores ``'yes'``/``'no'``, ``'on'``/``'off'``, ``'true'``/``'false'`` "

"and ``'1'``/``'0'`` [1]_. Por ejemplo:"

#: ../Doc/library/configparser.rst:200

msgid ""

">>> topsecret.getboolean('ForwardX11')\n"

"False\n"

">>> config['forge.example'].getboolean('ForwardX11')\n"

"True\n"

">>> config.getboolean('forge.example', 'Compression')\n"

"True"

msgstr ""

#: ../Doc/library/configparser.rst:209

msgid ""

"Apart from :meth:`~ConfigParser.getboolean`, config parsers also provide "

"equivalent :meth:`~ConfigParser.getint` and :meth:`~ConfigParser.getfloat` "

"methods. You can register your own converters and customize the provided "

"ones. [1]_"

msgstr ""

"Además de :meth:`~ConfigParser.getboolean`, los *config parsers* también "

"proporcionan los métodos equivalentes :meth:`~ConfigParser.getint` y :meth:"

"`~ConfigParser.getfloat`. Puedes registrar tus propios conversores, y "

"personalizar los que se proporcionan. [1]_"

# Posterioremente se utiliza el término "fallback value", y eso, junto al

# código ejemplo, aclaran de qué se trata.

#: ../Doc/library/configparser.rst:215

msgid "Fallback Values"

msgstr "Valores de contingencia"

#: ../Doc/library/configparser.rst:217

#, fuzzy

msgid ""

"As with a dictionary, you can use a section's :meth:`~ConfigParser.get` "

"method to provide fallback values:"

msgstr ""

"Similar a un diccionario, puedes utilizar el método :meth:`get` de una "

"sección para especificar valores de contingencia (*fallback values*):"

#: ../Doc/library/configparser.rst:220

msgid ""

">>> topsecret.get('Port')\n"

"'50022'\n"

">>> topsecret.get('CompressionLevel')\n"

"'9'\n"

">>> topsecret.get('Cipher')\n"

">>> topsecret.get('Cipher', '3des-cbc')\n"

"'3des-cbc'"

msgstr ""

# Aquí he utilizado la expresión "valor de último recurso" como traducción de

# "fallback value", otras opciones son "valor alternativo", "valor auxiliar",

# "valor sustitutivo".

# No puedo usar "valor por defecto", ya que hay otros valores por defecto (los

# que se asignan en la sección DEFAULT).

#: ../Doc/library/configparser.rst:230

msgid ""

"Please note that default values have precedence over fallback values. For "

"instance, in our example the ``'CompressionLevel'`` key was specified only "

"in the ``'DEFAULT'`` section. If we try to get it from the section "

"``'topsecret.server.example'``, we will always get the default, even if we "

"specify a fallback:"

msgstr ""

"Por favor, fíjate que los valores por defecto tienen prioridad sobre los "

"valores de contingencia (*fallback*). Así, en nuestro ejemplo, la clave "

"``'CompressionLevel'`` sólo fue especificada en la sección ``'DEFAULT'``. Si "

"tratamos de obtener su valor de la sección ``'topsecret.server.example'``, "

"obtendremos siempre el valor por defecto, incluso si especificamos un valor "

"de contingencia:"

#: ../Doc/library/configparser.rst:236

msgid ""

">>> topsecret.get('CompressionLevel', '3')\n"

"'9'"

msgstr ""

#: ../Doc/library/configparser.rst:241

#, fuzzy

msgid ""

"One more thing to be aware of is that the parser-level :meth:`~ConfigParser."

"get` method provides a custom, more complex interface, maintained for "

"backwards compatibility. When using this method, a fallback value can be "

"provided via the ``fallback`` keyword-only argument:"

msgstr ""

"Otra cuestión que hay que tener en cuenta, es que el método a nivel "

"analizador (*parser*) :meth:`get` proporciona una interfaz personalizada, "

"más compleja, que se mantiene por compatibilidad con versiones anteriores. "

"Cuando se utiliza este método, se puede proporcionar un valor de "

"contingencia mediante el argumento de sólo-palabra clave (*keyword-only*) "

"``fallback``:"

#: ../Doc/library/configparser.rst:246

msgid ""

">>> config.get('forge.example', 'monster',\n"

"... fallback='No such things as monsters')\n"

"'No such things as monsters'"

msgstr ""

#: ../Doc/library/configparser.rst:252

msgid ""

"The same ``fallback`` argument can be used with the :meth:`~ConfigParser."

"getint`, :meth:`~ConfigParser.getfloat` and :meth:`~ConfigParser.getboolean` "

"methods, for example:"

msgstr ""

"El mismo argumento ``fallback`` puede utilizarse con los métodos :meth:"

"`~ConfigParser.getint`, :meth:`~ConfigParser.getfloat` y :meth:"

"`~ConfigParser.getboolean`, por ejemplo:"

#: ../Doc/library/configparser.rst:256

msgid ""

">>> 'BatchMode' in topsecret\n"

"False\n"

">>> topsecret.getboolean('BatchMode', fallback=True)\n"

"True\n"

">>> config['DEFAULT']['BatchMode'] = 'no'\n"

">>> topsecret.getboolean('BatchMode', fallback=True)\n"

"False"

msgstr ""

#: ../Doc/library/configparser.rst:268

msgid "Supported INI File Structure"

msgstr "Estructura soportada para el archivo ini"

#: ../Doc/library/configparser.rst:270

msgid ""

"A configuration file consists of sections, each led by a ``[section]`` "

"header, followed by key/value entries separated by a specific string (``=`` "

"or ``:`` by default [1]_). By default, section names are case sensitive but "

"keys are not [1]_. Leading and trailing whitespace is removed from keys and "

"values. Values can be omitted if the parser is configured to allow it [1]_, "

"in which case the key/value delimiter may also be left out. Values can also "

"span multiple lines, as long as they are indented deeper than the first line "

"of the value. Depending on the parser's mode, blank lines may be treated as "

"parts of multiline values or ignored."

msgstr ""

"Un archivo de configuración consta de secciones, cada una iniciada por una "

"cabecera ``[section]``, seguida por registros clave-valor separados por una "

"cadena de caracteres específica (``=`` ó ``:`` por defecto [1]_). De forma "

"predeterminada, los nombres de sección son sensibles a mayúsculas y "

"minúsculas pero las claves no [1]_. Los espacios al inicio y final de las "

"claves y valores son eliminados. Los valores pueden ser omitidos si el "

"*parser* está configurado para permitirlo [1]_, en cuyo caso el delimitador "

"del dato clave-valor puede ser omitido también. Los valores pueden ocupar "

"varias líneas, siempre y cuando tengan una indentación mayor que la primera "

"línea del valor. Dependiendo del modo del *parser*, las líneas en blanco "

"pueden tratarse como parte de un valor multilínea o ser ignoradas."

#: ../Doc/library/configparser.rst:280

#, fuzzy

msgid ""

"By default, a valid section name can be any string that does not contain '\\"

"\\n'. To change this, see :attr:`ConfigParser.SECTCRE`."

msgstr ""

"De forma predeterminada, un nombre de sección válido puede ser cualquier "

"cadena de texto que no contenga '\\\\n' or ']'. Para cambiar esto, consulte :"

"attr:`ConfigParser.SECTCRE`."

#: ../Doc/library/configparser.rst:283

msgid ""

"The first section name may be omitted if the parser is configured to allow "

"an unnamed top level section with ``allow_unnamed_section=True``. In this "

"case, the keys/values may be retrieved by :const:`UNNAMED_SECTION` as in "

"``config[UNNAMED_SECTION]``."

msgstr ""

#: ../Doc/library/configparser.rst:288

msgid ""

"Configuration files may include comments, prefixed by specific characters "

"(``#`` and ``;`` by default [1]_). Comments may appear on their own on an "

"otherwise empty line, possibly indented. [1]_"

msgstr ""

"Los archivos de configuración pueden incluir comentarios, con caracteres "

"específicos como prefijos (``#`` y ``;`` por defecto [1]_). Los comentarios "

"pueden ocupar su propia línea, posiblemente indentada. [1]_"

#: ../Doc/library/configparser.rst:292 ../Doc/library/configparser.rst:376

msgid "For example:"

msgstr "Por ejemplo:"

#: ../Doc/library/configparser.rst:294

msgid ""

"[Simple Values]\n"

"key=value\n"

"spaces in keys=allowed\n"

"spaces in values=allowed as well\n"

"spaces around the delimiter = obviously\n"

"you can also use : to delimit keys from values\n"

"\n"

"[All Values Are Strings]\n"

"values like this: 1000000\n"

"or this: 3.14159265359\n"

"are they treated as numbers? : no\n"

"integers, floats and booleans are held as: strings\n"

"can use the API to get converted values directly: true\n"

"\n"

"[Multiline Values]\n"

"chorus: I'm a lumberjack, and I'm okay\n"

" I sleep all night and I work all day\n"

"\n"

"[No Values]\n"

"key_without_value\n"

"empty string value here =\n"

"\n"

"[You can use comments]\n"

"# like this\n"

"; or this\n"

"\n"

"# By default only in an empty line.\n"

"# Inline comments can be harmful because they prevent users\n"

"# from using the delimiting characters as parts of values.\n"

"# That being said, this can be customized.\n"

"\n"

" [Sections Can Be Indented]\n"

" can_values_be_as_well = True\n"

" does_that_mean_anything_special = False\n"

" purpose = formatting for readability\n"

" multiline_values = are\n"

" handled just fine as\n"

" long as they are indented\n"

" deeper than the first line\n"

" of a value\n"

" # Did I mention we can indent comments, too?"

msgstr ""

#: ../Doc/library/configparser.rst:342

msgid "Unnamed Sections"

msgstr ""

#: ../Doc/library/configparser.rst:344

msgid ""

"The name of the first section (or unique) may be omitted and values "

"retrieved by the :const:`UNNAMED_SECTION` attribute."

msgstr ""

#: ../Doc/library/configparser.rst:347

msgid ""

">>> config = \"\"\"\n"

"... option = value\n"

"...\n"

"... [ Section 2 ]\n"

"... another = val\n"

"... \"\"\"\n"

">>> unnamed = configparser.ConfigParser(allow_unnamed_section=True)\n"

">>> unnamed.read_string(config)\n"

">>> unnamed.get(configparser.UNNAMED_SECTION, 'option')\n"

"'value'"

msgstr ""

#: ../Doc/library/configparser.rst:361

msgid "Interpolation of values"

msgstr "Interpolación de valores"

#: ../Doc/library/configparser.rst:363

msgid ""

"On top of the core functionality, :class:`ConfigParser` supports "

"interpolation. This means values can be preprocessed before returning them "

"from ``get()`` calls."

msgstr ""

"En el nivel superior de su funcionalidad central, :class:`ConfigParser` "

"soporta la interpolación. Esto significa que los valores pueden ser "

"preprocesados, antes de ser retornados por los llamados a ``get()``."

#: ../Doc/library/configparser.rst:371

msgid ""

"The default implementation used by :class:`ConfigParser`. It enables values "

"to contain format strings which refer to other values in the same section, "

"or values in the special default section [1]_. Additional default values "

"can be provided on initialization."

msgstr ""

"Es la implementación por defecto que utiliza :class:`ConfigParser`. Permite "

"valores que contengan cadenas de formato, que hacen referencia a otros "

"valores en la misma sección o a valores presentes en la sección especial "

"*default* [1]_. Valores por defecto adicionales pueden ser proporcionados en "

"la inicialización."

#: ../Doc/library/configparser.rst:378

#, python-format

msgid ""

"[Paths]\n"

"home_dir: /Users\n"

"my_dir: %(home_dir)s/lumberjack\n"

"my_pictures: %(my_dir)s/Pictures\n"

"\n"

"[Escape]\n"

"# use a %% to escape the % sign (% is the only character that needs to be "

"escaped):\n"

"gain: 80%%"

msgstr ""

#: ../Doc/library/configparser.rst:389

#, python-format

msgid ""

"In the example above, :class:`ConfigParser` with *interpolation* set to "

"``BasicInterpolation()`` would resolve ``%(home_dir)s`` to the value of "

"``home_dir`` (``/Users`` in this case). ``%(my_dir)s`` in effect would "

"resolve to ``/Users/lumberjack``. All interpolations are done on demand so "

"keys used in the chain of references do not have to be specified in any "

"specific order in the configuration file."

msgstr ""

"En el ejemplo anterior, :class:`ConfigParser` con la *interpolación* "

"establecida a ``BasicInterpolation()`` puede resolver ``%(home_dir)s`` al "

"valor ``home_dir`` (``/Users`` en este caso). En efecto, ``%(my_dir)s`` "

"podría resolverse como ``/Users/lumberjack``. Todas las interpolaciones son "

"realizadas bajo demanda, de modo que las claves utilizadas en la cadena de "

"referencias no requieren un orden específico en el archivo de configuración."

#: ../Doc/library/configparser.rst:396

#, python-format

msgid ""

"With ``interpolation`` set to ``None``, the parser would simply return "

"``%(my_dir)s/Pictures`` as the value of ``my_pictures`` and ``%(home_dir)s/"

"lumberjack`` as the value of ``my_dir``."

msgstr ""

"Con ``interpolation`` establecida al valor ``None``, el *parser* retornará "

"simplemente ``%(my_dir)s/Pictures`` como el valor de ``my_pictures`` y "

"``%(home_dir)s/lumberjack`` como el valor de ``my_dir``."

#: ../Doc/library/configparser.rst:404

#, python-brace-format

msgid ""

"An alternative handler for interpolation which implements a more advanced "

"syntax, used for instance in ``zc.buildout``. Extended interpolation is "

"using ``${section:option}`` to denote a value from a foreign section. "

"Interpolation can span multiple levels. For convenience, if the ``section:"

"`` part is omitted, interpolation defaults to the current section (and "

"possibly the default values from the special section)."

msgstr ""

"Es un gestor alternativo para la interpolación, que implementa una sintaxis "

"más avanzada; es utilizado, por ejemplo, en ``zc.buildout``. La "

"interpolación es extendida al utilizar ``${section:option}``, a fin de "

"especificar un valor que proviene de una sección externa. La interpolación "

"puede cubrir múltiples niveles. Por conveniencia, si la parte ``section:`` "

"es omitida, la interpolación utilizará la sección actual (y posiblemente los "

"valores por defecto establecidos en la sección especial)."

#: ../Doc/library/configparser.rst:411

msgid ""

"For example, the configuration specified above with basic interpolation, "

"would look like this with extended interpolation:"

msgstr ""

"Por ejemplo, la configuración indicada anteriormente, con interpolación "

"básica, luciría de la siguiente manera utilizando interpolación extendida:"

#: ../Doc/library/configparser.rst:414

#, python-brace-format

msgid ""

"[Paths]\n"

"home_dir: /Users\n"

"my_dir: ${home_dir}/lumberjack\n"

"my_pictures: ${my_dir}/Pictures\n"

"\n"

"[Escape]\n"

"# use a $$ to escape the $ sign ($ is the only character that needs to be "

"escaped):\n"

"cost: $$80"

msgstr ""

#: ../Doc/library/configparser.rst:425

msgid "Values from other sections can be fetched as well:"

msgstr "También pueden buscarse valores en otras secciones:"

#: ../Doc/library/configparser.rst:427

#, python-brace-format

msgid ""

"[Common]\n"

"home_dir: /Users\n"

"library_dir: /Library\n"

"system_dir: /System\n"

"macports_dir: /opt/local\n"

"\n"

"[Frameworks]\n"

"Python: 3.2\n"

"path: ${Common:system_dir}/Library/Frameworks/\n"

"\n"

"[Arthur]\n"

"nickname: Two Sheds\n"

"last_name: Jackson\n"

"my_dir: ${Common:home_dir}/twosheds\n"

"my_pictures: ${my_dir}/Pictures\n"

"python_dir: ${Frameworks:path}/Python/Versions/${Frameworks:Python}"

msgstr ""

#: ../Doc/library/configparser.rst:447

msgid "Mapping Protocol Access"

msgstr "Acceso por protocolo de mapeo"

#: ../Doc/library/configparser.rst:451

msgid ""

"Mapping protocol access is a generic name for functionality that enables "

"using custom objects as if they were dictionaries. In case of :mod:"

"`configparser`, the mapping interface implementation is using the "

"``parser['section']['option']`` notation."

msgstr ""

"El acceso por protocolo de mapeo es un nombre genérico asignado a la "

"funcionalidad que permite el uso de objetos personalizados como si fuesen "

"diccionarios. En el caso de :mod:`configparser`, la implementación de la "

"interfaz de mapeo utiliza la notación ``parser['section']['option']``."

#: ../Doc/library/configparser.rst:456

msgid ""

"``parser['section']`` in particular returns a proxy for the section's data "

"in the parser. This means that the values are not copied but they are taken "

"from the original parser on demand. What's even more important is that when "

"values are changed on a section proxy, they are actually mutated in the "

"original parser."

msgstr ""

"En particular, ``parser['section']`` retorna un proxy para los datos de la "

"sección en el *parser*. Esto significa que los valores no son copiados, sino "

"que son tomados del *parser* original sobre la marcha."

#: ../Doc/library/configparser.rst:462

msgid ""

":mod:`configparser` objects behave as close to actual dictionaries as "

"possible. The mapping interface is complete and adheres to the :class:"

"`~collections.abc.MutableMapping` ABC. However, there are a few differences "

"that should be taken into account:"

msgstr ""

"Los objetos de :mod:`configparser` se comportan de forma tan similar a un "

"diccionario como se puede. La interfaz de mapeo es completa y se ciñe a la :"

"class:`~collections.abc.MutableMapping` ABC. Sin embargo, existen unas "

"pequeñas diferencias que deben tomarse en cuenta:"

#: ../Doc/library/configparser.rst:467

msgid ""

"By default, all keys in sections are accessible in a case-insensitive manner "

"[1]_. E.g. ``for option in parser[\"section\"]`` yields only "

"``optionxform``'ed option key names. This means lowercased keys by "

"default. At the same time, for a section that holds the key ``'a'``, both "

"expressions return ``True``::"

msgstr ""

"Por defecto, todas las claves de las secciones se pueden acceder de una "

"forma insensible a mayúsculas y minúsculas [1]_. Ej. ``for option in "

"parser[\"section\"]`` entrega solamente nombres de claves de opción que han "

"pasado por ``optionxform``. Esto significa, claves en minúscula por defecto. "

"A la vez, para una sección que contiene la clave ``'a'``, ambas expresiones "

"retornan ``True``::"

#: ../Doc/library/configparser.rst:472

msgid ""

"\"a\" in parser[\"section\"]\n"

"\"A\" in parser[\"section\"]"

msgstr ""

#: ../Doc/library/configparser.rst:475

msgid ""

"All sections include ``DEFAULTSECT`` values as well which means that ``."

"clear()`` on a section may not leave the section visibly empty. This is "

"because default values cannot be deleted from the section (because "

"technically they are not there). If they are overridden in the section, "

"deleting causes the default value to be visible again. Trying to delete a "

"default value causes a :exc:`KeyError`."

msgstr ""

"Todas las secciones también incluyen valores ``DEFAULTSECT``, lo que "

"significa que ``.clear()`` en una sección puede no significar que esta quede "

"vacía de forma visible. Ello debido a que los valores por defecto no pueden "

"ser borrados de la sección (ya que técnicamente no están allí). Si fueron "

"redefinidas en la sección, su borrado ocasiona que los valores por defecto "

"sean visibles de nuevo. Cualquier intento de borrar un valor por defecto "

"ocasiona una excepción :exc:`KeyError`."

#: ../Doc/library/configparser.rst:482

msgid "``DEFAULTSECT`` cannot be removed from the parser:"

msgstr "``DEFAULTSECT`` no puede ser eliminado del *parser*:"

#: ../Doc/library/configparser.rst:484

msgid "trying to delete it raises :exc:`ValueError`,"

msgstr "el intento de borrarlo lanza una excepción :exc:`ValueError`,"

#: ../Doc/library/configparser.rst:486

msgid "``parser.clear()`` leaves it intact,"

msgstr "``parser.clear()`` lo deja intacto,"

#: ../Doc/library/configparser.rst:488

msgid "``parser.popitem()`` never returns it."

msgstr "``parser.popitem()`` nunca lo retorna."

#: ../Doc/library/configparser.rst:490

msgid ""

"``parser.get(section, option, **kwargs)`` - the second argument is **not** a "

"fallback value. Note however that the section-level ``get()`` methods are "

"compatible both with the mapping protocol and the classic configparser API."

msgstr ""

"``parser.get(section, option, **kwargs)`` - el segundo argumento **no** es "

"un valor de contingencia. Observe, sin embargo, que los métodos ``get()`` a "

"nivel de sección son compatibles tanto con el protocolo de mapeo como con la "

"API clásica de *configparser*."

#: ../Doc/library/configparser.rst:494

msgid ""

"``parser.items()`` is compatible with the mapping protocol (returns a list "

"of *section_name*, *section_proxy* pairs including the DEFAULTSECT). "

"However, this method can also be invoked with arguments: ``parser."

"items(section, raw, vars)``. The latter call returns a list of *option*, "

"*value* pairs for a specified ``section``, with all interpolations expanded "

"(unless ``raw=True`` is provided)."

msgstr ""

"``parser.items()`` es compatible con el protocolo de mapeo (retorna una "

"lista de pares *section_name*, *section_proxy* que estén incluidos en "

"DEFAULTSECT). Sin embargo, este método también puede ser invocado con los "

"argumentos: ``parser.items(section, raw, vars)``. Esta última llamada "

"retorna una lista de pares *option*, *value* para una ``section`` "

"específica, con todas las interpolaciones expandidas (a menos que se "

"especifique ``raw=True``)."

#: ../Doc/library/configparser.rst:501

msgid ""

"The mapping protocol is implemented on top of the existing legacy API so "

"that subclasses overriding the original interface still should have mappings "

"working as expected."

msgstr ""

"El protocolo de mapeo se implementa en el nivel superior de la actual API "

"heredada, de modo que esas subclases que sobre-escriben la interfaz original "

"aún deberían hacer funcionar el mapeo como se esperaría."

#: ../Doc/library/configparser.rst:507

msgid "Customizing Parser Behaviour"

msgstr "Personalizando el comportamiento del parser"

#: ../Doc/library/configparser.rst:509

msgid ""

"There are nearly as many INI format variants as there are applications using "

"it. :mod:`configparser` goes a long way to provide support for the largest "

"sensible set of INI styles available. The default functionality is mainly "

"dictated by historical background and it's very likely that you will want to "

"customize some of the features."

msgstr ""

"Existen casi tantas variantes del formato INI como aplicaciones que lo "

"usen. :mod:`configparser` llega muy lejos al proporcionar soporte al mayor "

"conjunto sensible de estilos de INI disponibles. La funcionalidad "

"predeterminada es impuesta principalmente por antecedentes históricos y es "

"muy probable que quieras personalizar algunas de las funcionalidades."

#: ../Doc/library/configparser.rst:515

#, fuzzy

msgid ""

"The most common way to change the way a specific config parser works is to "

"use the :meth:`!__init__` options:"

msgstr ""

"La forma más común para modificar cómo funciona un *config parser* "

"específico consiste en el uso de las opciones de :meth:`__init__`:"

#: ../Doc/library/configparser.rst:518

msgid "*defaults*, default value: ``None``"

msgstr "*defaults*, valor por defecto: ``None``"

#: ../Doc/library/configparser.rst:520

msgid ""

"This option accepts a dictionary of key-value pairs which will be initially "

"put in the ``DEFAULT`` section. This makes for an elegant way to support "

"concise configuration files that don't specify values which are the same as "

"the documented default."

msgstr ""

"Esta opción acepta un diccionario de pares clave-valor, que debe ser "

"colocado inicialmente en la sección ``DEFAULT``. De este modo se obtiene una "

"manera elegante de apoyar los archivos de configuración concisos, que no "

"especifican valores que sean los mismos documentados por defecto."

#: ../Doc/library/configparser.rst:525

#, fuzzy

msgid ""

"Hint: if you want to specify default values for a specific section, use :"

"meth:`~ConfigParser.read_dict` before you read the actual file."

msgstr ""

"Consejo: si quieres especificar valores por defecto para una sección "

"específica, usa :meth:`read_dict` antes de leer el archivo real."

#: ../Doc/library/configparser.rst:528

msgid "*dict_type*, default value: :class:`dict`"

msgstr "*dict_type*, valor por defecto: :class:`dict`"

#: ../Doc/library/configparser.rst:530

msgid ""

"This option has a major impact on how the mapping protocol will behave and "

"how the written configuration files look. With the standard dictionary, "

"every section is stored in the order they were added to the parser. Same "

"goes for options within sections."

msgstr ""

"Esta opción tiene un gran impacto en cómo funcionará el protocolo de mapeo, "

"y cómo lucirán los archivos de configuración a escribir. Con el diccionario "

"estándar, cada sección se almacena en el orden en que se añadieron al "

"*parser*. Lo mismo ocurre con las opciones dentro de las secciones."

#: ../Doc/library/configparser.rst:535

msgid ""

"An alternative dictionary type can be used for example to sort sections and "

"options on write-back."

msgstr ""

"Un tipo alternativo de diccionario puede ser utilizado, por ejemplo, para "

"ordenar las secciones y opciones en un modo a posteriori (*write-back*)."

#: ../Doc/library/configparser.rst:538

msgid ""

"Please note: there are ways to add a set of key-value pairs in a single "

"operation. When you use a regular dictionary in those operations, the order "

"of the keys will be ordered. For example:"

msgstr ""

"Por favor, tome en cuenta que: existen formas de agregar un par clave-valor "

"en una sola operación. Cuando se utiliza un diccionario común en tales "

"operaciones, el orden de las claves será el empleado en la creación. Por "

"ejemplo:"

#: ../Doc/library/configparser.rst:542

#, python-brace-format

msgid ""

">>> parser = configparser.ConfigParser()\n"

">>> parser.read_dict({'section1': {'key1': 'value1',\n"

"... 'key2': 'value2',\n"

"... 'key3': 'value3'},\n"

"... 'section2': {'keyA': 'valueA',\n"

"... 'keyB': 'valueB',\n"

"... 'keyC': 'valueC'},\n"

"... 'section3': {'foo': 'x',\n"

"... 'bar': 'y',\n"

"... 'baz': 'z'}\n"

"... })\n"

">>> parser.sections()\n"

"['section1', 'section2', 'section3']\n"

">>> [option for option in parser['section3']]\n"

"['foo', 'bar', 'baz']"

msgstr ""

#: ../Doc/library/configparser.rst:560

msgid "*allow_no_value*, default value: ``False``"

msgstr "*allow_no_value*, valor por defecto: ``False``"

#: ../Doc/library/configparser.rst:562

msgid ""

"Some configuration files are known to include settings without values, but "

"which otherwise conform to the syntax supported by :mod:`configparser`. The "

"*allow_no_value* parameter to the constructor can be used to indicate that "

"such values should be accepted:"

msgstr ""

"Se sabe que algunos archivos de configuración incluyen elementos sin indicar "

"un valor, aunque cumplan con la sintaxis soportada por :mod:`configparser` "

"en todo lo demás. El parámetro *allow_no_value* le indica al constructor que "

"tales valores deben ser aceptados:"

#: ../Doc/library/configparser.rst:567

msgid ""

">>> import configparser\n"

"\n"

">>> sample_config = \"\"\"\n"

"... [mysqld]\n"

"... user = mysql\n"

"... pid-file = /var/run/mysqld/mysqld.pid\n"

"... skip-external-locking\n"

"... old_passwords = 1\n"

"... skip-bdb\n"

"... # we don't need ACID today\n"

"... skip-innodb\n"

"... \"\"\"\n"

">>> config = configparser.ConfigParser(allow_no_value=True)\n"

">>> config.read_string(sample_config)\n"

"\n"

">>> # Settings with values are treated as before:\n"

">>> config[\"mysqld\"][\"user\"]\n"

"'mysql'\n"

"\n"

">>> # Settings without values provide None:\n"

">>> config[\"mysqld\"][\"skip-bdb\"]\n"

"\n"

">>> # Settings which aren't specified still raise an error:\n"

">>> config[\"mysqld\"][\"does-not-exist\"]\n"

"Traceback (most recent call last):\n"

" ...\n"

"KeyError: 'does-not-exist'"

msgstr ""

#: ../Doc/library/configparser.rst:597

msgid "*delimiters*, default value: ``('=', ':')``"

msgstr "*delimiters*, valor por defecto: ``('=', ':')``"

#: ../Doc/library/configparser.rst:599

msgid ""

"Delimiters are substrings that delimit keys from values within a section. "

"The first occurrence of a delimiting substring on a line is considered a "

"delimiter. This means values (but not keys) can contain the delimiters."

msgstr ""

"Los *delimiters* son cadenas de caracteres que separan las claves de los "

"valores dentro de una sección. La primera ocurrencia de una cadena de "

"separación en una línea se considera como un separador. Esto significa que "

"los valores pueden contener separadores, no así las claves."

#: ../Doc/library/configparser.rst:603

msgid ""

"See also the *space_around_delimiters* argument to :meth:`ConfigParser."

"write`."

msgstr ""

"Vea también el argumento *space_around_delimiters* de :meth:`ConfigParser."

"write`."

#: ../Doc/library/configparser.rst:606

msgid "*comment_prefixes*, default value: ``('#', ';')``"

msgstr "*comment_prefixes*, valor por defecto: ``('#', ';')``"

#: ../Doc/library/configparser.rst:608

msgid "*inline_comment_prefixes*, default value: ``None``"

msgstr "*inline_comment_prefixes*, valor por defecto: ``None``"

#: ../Doc/library/configparser.rst:610

msgid ""

"Comment prefixes are strings that indicate the start of a valid comment "