python-docs-pt-br/library/configparser.po at 2.7 · python/python-docs-pt-br

500 lines (427 loc) · 18 KB
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 1990-2020, Python Software Foundation
# This file is distributed under the same license as the Python package.
# Translators:
"Project-Id-Version: Python 2.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2020-02-09 18:46+0900\n"
"PO-Revision-Date: 2018-01-20 20:59+0000\n"
"Last-Translator: tomo\n"
"Language-Team: Portuguese (Brazil) (http://www.transifex.com/python-doc/"
"python-27/language/pt_BR/)\n"
"Language: pt_BR\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=2; plural=(n > 1);\n"
#: ../../library/configparser.rst:2
msgid ":mod:`ConfigParser` --- Configuration file parser"
#: ../../library/configparser.rst:14
"The :mod:`ConfigParser` module has been renamed to :mod:`configparser` in "
"Python 3.  The :term:`2to3` tool will automatically adapt imports when "
"converting your sources to Python 3."
#: ../../library/configparser.rst:24
"This module defines the class :class:`~ConfigParser.ConfigParser`.   The :"
"class:`~ConfigParser.ConfigParser` class implements a basic configuration "
"file parser language which provides a structure similar to what you would "
"find on Microsoft Windows INI files.  You can use this to write Python "
"programs which can be customized by end users easily."
#: ../../library/configparser.rst:32
"This library does *not* interpret or write the value-type prefixes used in "
"the Windows Registry extended version of INI syntax."
"Esta biblioteca *não* interpreta ou escreve os prefixos de tipo de valor "
"usados ​​na versão estendida do Registro do Windows da sintaxe INI."
#: ../../library/configparser.rst:39 ../../library/configparser.rst:224
msgid "Module :mod:`shlex`"
msgstr "Módulo :mod:`shlex`"
#: ../../library/configparser.rst:38
"Support for creating Unix shell-like mini-languages which can be used as an "
"alternate format for application configuration files."
#: ../../library/configparser.rst:42
msgid "Module :mod:`json`"
msgstr "Módulo :mod:`json`"
#: ../../library/configparser.rst:42
"The json module implements a subset of JavaScript syntax which can also be "
"used for this purpose."
#: ../../library/configparser.rst:45
"The configuration file consists of sections, led by a ``[section]`` header "
"and followed by ``name: value`` entries, with continuations in the style of :"
"rfc:`822` (see section 3.1.1, \"LONG HEADER FIELDS\"); ``name=value`` is "
"also accepted.  Note that leading whitespace is removed from values. The "
"optional values can contain format strings which refer to other values in "
"the same section, or values in a special ``DEFAULT`` section.  Additional "
"defaults can be provided on initialization and retrieval.  Lines beginning "
"with ``'#'`` or ``';'`` are ignored and may be used to provide comments."
#: ../../library/configparser.rst:54
"Configuration files may include comments, prefixed by specific characters "
"(``#`` and ``;``).  Comments may appear on their own in an otherwise empty "
"line, or may be entered in lines holding values or section names.  In the "
"latter case, they need to be preceded by a whitespace character to be "
"recognized as a comment. (For backwards compatibility, only ``;`` starts an "
"inline comment, while ``#`` does not.)"
#: ../../library/configparser.rst:61
"On top of the core functionality, :class:`SafeConfigParser` supports "
"interpolation.  This means values can contain format strings which refer to "
"other values in the same section, or values in a special ``DEFAULT`` "
"section. Additional defaults can be provided on initialization."
#: ../../library/configparser.rst:66
msgid "For example::"
msgstr "Por exemplo::"
#: ../../library/configparser.rst:74
"would resolve the ``%(dir)s`` to the value of ``dir`` (``frob`` in this "
"case). All reference expansions are done on demand."
#: ../../library/configparser.rst:77
"Default values can be specified by passing them into the :class:"
"`~ConfigParser.ConfigParser` constructor as a dictionary.  Additional "
"defaults  may be passed into the :meth:`get` method which will override all "
#: ../../library/configparser.rst:81
"Sections are normally stored in a built-in dictionary. An alternative "
"dictionary type can be passed to the :class:`~ConfigParser.ConfigParser` "
"constructor. For example, if a dictionary type is passed that sorts its "
"keys, the sections will be sorted on write-back, as will be the keys within "
"each section."
#: ../../library/configparser.rst:89
"The basic configuration object.  When *defaults* is given, it is initialized "
"into the dictionary of intrinsic defaults.  When *dict_type* is given, it "
"will be used to create the dictionary objects for the list of sections, for "
"the options within a section, and for the default values.  When "
"*allow_no_value* is true (default: ``False``), options without values are "
"accepted; the value presented for these is ``None``."
#: ../../library/configparser.rst:96
msgid "This class does not support the magical interpolation behavior."
#: ../../library/configparser.rst:99
"All option names are passed through the :meth:`optionxform` method.  Its "
"default implementation converts option names to lower case."
#: ../../library/configparser.rst:104 ../../library/configparser.rst:128
#: ../../library/configparser.rst:147
msgid "*dict_type* was added."
#: ../../library/configparser.rst:107 ../../library/configparser.rst:131
#: ../../library/configparser.rst:150
"The default *dict_type* is :class:`collections.OrderedDict`. "
"*allow_no_value* was added."
#: ../../library/configparser.rst:114
"Derived class of :class:`RawConfigParser` that implements the magical "
"interpolation feature and adds optional arguments to the :meth:`get` and :"
"meth:`items` methods.  The values in *defaults* must be appropriate for the "
"``%()s`` string interpolation.  Note that *__name__* is an intrinsic "
"default; its value is the section name, and will override any value provided "
"in *defaults*."
#: ../../library/configparser.rst:121
"All option names used in interpolation will be passed through the :meth:"
"`optionxform` method just like any other option name reference.  Using the "
"default implementation of :meth:`optionxform`, the values ``foo %(bar)s`` "
"and ``foo %(BAR)s`` are equivalent."
#: ../../library/configparser.rst:138
"Derived class of :class:`~ConfigParser.ConfigParser` that implements a more-"
"sane variant of the magical interpolation feature.  This implementation is "
"more predictable as well. New applications should prefer this version if "
"they don't need to be compatible with older versions of Python."
#: ../../library/configparser.rst:157
msgid "Base class for all other configparser exceptions."
#: ../../library/configparser.rst:162
msgid "Exception raised when a specified section is not found."
msgstr "Exceção levantada quando uma seção especificada não é encontrada."
#: ../../library/configparser.rst:167
"Exception raised if :meth:`add_section` is called with the name of a section "
"that is already present."
#: ../../library/configparser.rst:173
"Exception raised when a specified option is not found in the specified  "
#: ../../library/configparser.rst:178
"Base class for exceptions raised when problems occur performing string "
"interpolation."
"Classe base para exceções levantadas quando ocorrem problemas ao executar a "
"interpolação de strings."
#: ../../library/configparser.rst:184
"Exception raised when string interpolation cannot be completed because the "
"number of iterations exceeds :const:`MAX_INTERPOLATION_DEPTH`. Subclass of :"
"exc:`InterpolationError`."
#: ../../library/configparser.rst:191
"Exception raised when an option referenced from a value does not exist. "
"Subclass of :exc:`InterpolationError`."
"Exceção levantada quando uma opção referenciada a partir de um valor não "
"existe. Subclasse de :exc:`InterpolationError`."
#: ../../library/configparser.rst:199
"Exception raised when the source text into which substitutions are made does "
"not conform to the required syntax. Subclass of :exc:`InterpolationError`."
#: ../../library/configparser.rst:207
"Exception raised when attempting to parse a file which has no section "
"Exceção levantada ao tentar analisar um arquivo que não possui cabeçalhos de "
#: ../../library/configparser.rst:212
msgid "Exception raised when errors occur attempting to parse a file."
msgstr "Exceção levantada quando ocorrem erros ao tentar analisar um arquivo."
#: ../../library/configparser.rst:217
"The maximum depth for recursive interpolation for :meth:`get` when the *raw* "
"parameter is false.  This is relevant only for the :class:`~ConfigParser."
"ConfigParser` class."
#: ../../library/configparser.rst:224
"Support for a creating Unix shell-like mini-languages which can be used as "
"an alternate format for application configuration files."
#: ../../library/configparser.rst:231
msgid "RawConfigParser Objects"
msgstr "Objetos RawConfigParser"
#: ../../library/configparser.rst:233
msgid ":class:`RawConfigParser` instances have the following methods:"
#: ../../library/configparser.rst:238
msgid "Return a dictionary containing the instance-wide defaults."
msgstr "Retorna um dicionário contendo os padrões de toda a instância."
#: ../../library/configparser.rst:243
"Return a list of the sections available; ``DEFAULT`` is not included in the "
#: ../../library/configparser.rst:249
"Add a section named *section* to the instance.  If a section by the given "
"name already exists, :exc:`DuplicateSectionError` is raised. If the name "
"``DEFAULT`` (or any of it's case-insensitive variants) is passed, :exc:"
"`ValueError` is raised."
#: ../../library/configparser.rst:256
"Indicates whether the named section is present in the configuration. The "
"``DEFAULT`` section is not acknowledged."
#: ../../library/configparser.rst:262
msgid "Returns a list of options available in the specified *section*."
#: ../../library/configparser.rst:267
"If the given section exists, and contains the given option, return :const:"
"`True`; otherwise return :const:`False`."
#: ../../library/configparser.rst:275
"Attempt to read and parse a list of filenames, returning a list of filenames "
"which were successfully parsed.  If *filenames* is a string or Unicode "
"string, it is treated as a single filename. If a file named in *filenames* "
"cannot be opened, that file will be ignored.  This is designed so that you "
"can specify a list of potential configuration file locations (for example, "
"the current directory, the user's home directory, and some system-wide "
"directory), and all existing configuration files in the list will be read.  "
"If none of the named files exist, the :class:`~ConfigParser.ConfigParser` "
"instance will contain an empty dataset. An application which requires "
"initial values to be loaded from a file should load the required file or "
"files using :meth:`readfp` before calling :meth:`read` for any optional "
#: ../../library/configparser.rst:293
msgid "Returns list of successfully parsed filenames."
#: ../../library/configparser.rst:299
"Read and parse configuration data from the file or file-like object in *fp* "
"(only the :meth:`readline` method is used).  If *filename* is omitted and "
"*fp* has a :attr:`name` attribute, that is used for *filename*; the default "
"is ``<???>``."
#: ../../library/configparser.rst:307
msgid "Get an *option* value for the named *section*."
#: ../../library/configparser.rst:312
"A convenience method which coerces the *option* in the specified *section* "
"to an integer."
#: ../../library/configparser.rst:318
"A convenience method which coerces the *option* in the specified *section* "
"to a floating point number."
#: ../../library/configparser.rst:324
"A convenience method which coerces the *option* in the specified *section* "
"to a Boolean value.  Note that the accepted values for the option are "
"``\"1\"``, ``\"yes\"``, ``\"true\"``, and ``\"on\"``, which cause this "
"method to return ``True``, and ``\"0\"``, ``\"no\"``, ``\"false\"``, and "
"``\"off\"``, which cause it to return ``False``.  These string values are "
"checked in a case-insensitive manner.  Any other value will cause it to "
"raise :exc:`ValueError`."
#: ../../library/configparser.rst:334
"Return a list of ``(name, value)`` pairs for each option in the given "
"*section*."
#: ../../library/configparser.rst:339
"If the given section exists, set the given option to the specified value; "
"otherwise raise :exc:`NoSectionError`.  While it is possible to use :class:"
"`RawConfigParser` (or :class:`~ConfigParser.ConfigParser` with *raw* "
"parameters set to true) for *internal* storage of non-string values, full "
"functionality (including interpolation and output to files) can only be "
"achieved using string values."
#: ../../library/configparser.rst:350
"Write a representation of the configuration to the specified file object.  "
"This representation can be parsed by a future :meth:`read` call."
#: ../../library/configparser.rst:358
"Remove the specified *option* from the specified *section*. If the section "
"does not exist, raise :exc:`NoSectionError`.  If the option existed to be "
"removed, return :const:`True`; otherwise return :const:`False`."
#: ../../library/configparser.rst:367
"Remove the specified *section* from the configuration. If the section in "
"fact existed, return ``True``. Otherwise return ``False``."
#: ../../library/configparser.rst:373
"Transforms the option name *option* as found in an input file or as passed "
"in by client code to the form that should be used in the internal "
"structures. The default implementation returns a lower-case version of "
"*option*; subclasses may override this or client code can set an attribute "
"of this name on instances to affect this behavior."
#: ../../library/configparser.rst:379
"You don't necessarily need to subclass a ConfigParser to use this method, "
"you can also re-set it on an instance, to a function that takes a string "
"argument.  Setting it to ``str``, for example, would make option names case "
"sensitive::"
#: ../../library/configparser.rst:388
"Note that when reading configuration files, whitespace around the option "
"names are stripped before :meth:`optionxform` is called."
#: ../../library/configparser.rst:395
msgid "ConfigParser Objects"
msgstr "Objetos ConfigParser"
#: ../../library/configparser.rst:397
"The :class:`~ConfigParser.ConfigParser` class extends some methods of the :"
"class:`RawConfigParser` interface, adding some optional arguments."
#: ../../library/configparser.rst:403
"Get an *option* value for the named *section*.  If *vars* is provided, it "
"must be a dictionary.  The *option* is looked up in *vars* (if provided), "
"*section*, and in *defaults* in that order."
#: ../../library/configparser.rst:407
"All the ``'%'`` interpolations are expanded in the return values, unless the "
"*raw* argument is true.  Values for interpolation keys are looked up in the "
"same manner as the option."
"Todas as interpolações ``'%'`` são expandidas nos valores de retorno, a "
"menos que o argumento *raw* seja verdadeiro. Os valores das chaves de "
"interpolação são consultados da mesma maneira que a opção."
#: ../../library/configparser.rst:413
"Return a list of ``(name, value)`` pairs for each option in the given "
"*section*. Optional arguments have the same meaning as for the :meth:`get` "
#: ../../library/configparser.rst:422
msgid "SafeConfigParser Objects"
#: ../../library/configparser.rst:424
"The :class:`SafeConfigParser` class implements the same extended interface "
"as :class:`~ConfigParser.ConfigParser`, with the following addition:"
#: ../../library/configparser.rst:430
"If the given section exists, set the given option to the specified value; "
"otherwise raise :exc:`NoSectionError`.  *value* must be a string (:class:"
"`str` or :class:`unicode`); if not, :exc:`TypeError` is raised."
#: ../../library/configparser.rst:438
msgid "Examples"
msgstr "Exemplos"
#: ../../library/configparser.rst:440
msgid "An example of writing to a configuration file::"
msgstr "Um exemplo de escrita em um arquivo de configuração::"
#: ../../library/configparser.rst:465
msgid "An example of reading the configuration file again::"
msgstr "Um exemplo de leitura do arquivo de configuração novamente::"
#: ../../library/configparser.rst:483
"To get interpolation, you will need to use a :class:`~ConfigParser."
"ConfigParser` or :class:`SafeConfigParser`::"
#: ../../library/configparser.rst:500
"Defaults are available in all three types of ConfigParsers. They are used in "
"interpolation if an option used is not defined elsewhere. ::"
#: ../../library/configparser.rst:514
"The function ``opt_move`` below can be used to move options between "
"sections::"
#: ../../library/configparser.rst:526
"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:"
Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

FilesExpand file tree

configparser.po

Latest commit

History

configparser.po

File metadata and controls
