# SOME DESCRIPTIVE TITLE. # Copyright (C) 1990-2016, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 2.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2016-10-30 10:44+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #: ../Doc/library/configparser.rst:2 msgid ":mod:`ConfigParser` --- Configuration file parser" msgstr "" #: ../Doc/library/configparser.rst:14 msgid "" "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." msgstr "" #: ../Doc/library/configparser.rst:24 msgid "" "This module defines the class :class:`ConfigParser`. The :class:" "`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." msgstr "" #: ../Doc/library/configparser.rst:32 msgid "" "This library does *not* interpret or write the value-type prefixes used in " "the Windows Registry extended version of INI syntax." msgstr "" #: ../Doc/library/configparser.rst:39 ../Doc/library/configparser.rst:224 msgid "Module :mod:`shlex`" msgstr "" #: ../Doc/library/configparser.rst:38 ../Doc/library/configparser.rst:224 msgid "" "Support for a creating Unix shell-like mini-languages which can be used as " "an alternate format for application configuration files." msgstr "" #: ../Doc/library/configparser.rst:42 msgid "Module :mod:`json`" msgstr "" #: ../Doc/library/configparser.rst:42 msgid "" "The json module implements a subset of JavaScript syntax which can also be " "used for this purpose." msgstr "" #: ../Doc/library/configparser.rst:45 msgid "" "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." msgstr "" #: ../Doc/library/configparser.rst:54 msgid "" "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.)" msgstr "" #: ../Doc/library/configparser.rst:61 msgid "" "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." msgstr "" #: ../Doc/library/configparser.rst:66 msgid "For example::" msgstr "Par exemple ::" #: ../Doc/library/configparser.rst:74 msgid "" "would resolve the ``%(dir)s`` to the value of ``dir`` (``frob`` in this " "case). All reference expansions are done on demand." msgstr "" #: ../Doc/library/configparser.rst:77 msgid "" "Default values can be specified by passing them into the :class:" "`ConfigParser` constructor as a dictionary. Additional defaults may be " "passed into the :meth:`get` method which will override all others." msgstr "" #: ../Doc/library/configparser.rst:81 msgid "" "Sections are normally stored in a built-in dictionary. An alternative " "dictionary type can be passed to the :class:`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." msgstr "" #: ../Doc/library/configparser.rst:89 msgid "" "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``." msgstr "" #: ../Doc/library/configparser.rst:96 msgid "This class does not support the magical interpolation behavior." msgstr "" #: ../Doc/library/configparser.rst:99 msgid "" "All option names are passed through the :meth:`optionxform` method. Its " "default implementation converts option names to lower case." msgstr "" #: ../Doc/library/configparser.rst:104 ../Doc/library/configparser.rst:128 #: ../Doc/library/configparser.rst:147 msgid "*dict_type* was added." msgstr "" #: ../Doc/library/configparser.rst:107 ../Doc/library/configparser.rst:131 #: ../Doc/library/configparser.rst:150 msgid "" "The default *dict_type* is :class:`collections.OrderedDict`. " "*allow_no_value* was added." msgstr "" #: ../Doc/library/configparser.rst:114 msgid "" "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*." msgstr "" #: ../Doc/library/configparser.rst:121 msgid "" "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." msgstr "" #: ../Doc/library/configparser.rst:138 msgid "" "Derived class of :class:`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." msgstr "" #: ../Doc/library/configparser.rst:157 msgid "Base class for all other configparser exceptions." msgstr "" #: ../Doc/library/configparser.rst:162 msgid "Exception raised when a specified section is not found." msgstr "" #: ../Doc/library/configparser.rst:167 msgid "" "Exception raised if :meth:`add_section` is called with the name of a section " "that is already present." msgstr "" #: ../Doc/library/configparser.rst:173 msgid "" "Exception raised when a specified option is not found in the specified " "section." msgstr "" #: ../Doc/library/configparser.rst:178 msgid "" "Base class for exceptions raised when problems occur performing string " "interpolation." msgstr "" #: ../Doc/library/configparser.rst:184 msgid "" "Exception raised when string interpolation cannot be completed because the " "number of iterations exceeds :const:`MAX_INTERPOLATION_DEPTH`. Subclass of :" "exc:`InterpolationError`." msgstr "" #: ../Doc/library/configparser.rst:191 msgid "" "Exception raised when an option referenced from a value does not exist. " "Subclass of :exc:`InterpolationError`." msgstr "" #: ../Doc/library/configparser.rst:199 msgid "" "Exception raised when the source text into which substitutions are made does " "not conform to the required syntax. Subclass of :exc:`InterpolationError`." msgstr "" #: ../Doc/library/configparser.rst:207 msgid "" "Exception raised when attempting to parse a file which has no section " "headers." msgstr "" #: ../Doc/library/configparser.rst:212 msgid "Exception raised when errors occur attempting to parse a file." msgstr "" #: ../Doc/library/configparser.rst:217 msgid "" "The maximum depth for recursive interpolation for :meth:`get` when the *raw* " "parameter is false. This is relevant only for the :class:`ConfigParser` " "class." msgstr "" #: ../Doc/library/configparser.rst:231 msgid "RawConfigParser Objects" msgstr "" #: ../Doc/library/configparser.rst:233 msgid ":class:`RawConfigParser` instances have the following methods:" msgstr "" #: ../Doc/library/configparser.rst:238 msgid "Return a dictionary containing the instance-wide defaults." msgstr "" #: ../Doc/library/configparser.rst:243 msgid "" "Return a list of the sections available; ``DEFAULT`` is not included in the " "list." msgstr "" #: ../Doc/library/configparser.rst:249 msgid "" "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." msgstr "" #: ../Doc/library/configparser.rst:256 msgid "" "Indicates whether the named section is present in the configuration. The " "``DEFAULT`` section is not acknowledged." msgstr "" #: ../Doc/library/configparser.rst:262 msgid "Returns a list of options available in the specified *section*." msgstr "" #: ../Doc/library/configparser.rst:267 msgid "" "If the given section exists, and contains the given option, return :const:" "`True`; otherwise return :const:`False`." msgstr "" #: ../Doc/library/configparser.rst:275 msgid "" "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` 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 files::" msgstr "" #: ../Doc/library/configparser.rst:293 msgid "Returns list of successfully parsed filenames." msgstr "" #: ../Doc/library/configparser.rst:299 msgid "" "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 ````." msgstr "" #: ../Doc/library/configparser.rst:307 msgid "Get an *option* value for the named *section*." msgstr "" #: ../Doc/library/configparser.rst:312 msgid "" "A convenience method which coerces the *option* in the specified *section* " "to an integer." msgstr "" #: ../Doc/library/configparser.rst:318 msgid "" "A convenience method which coerces the *option* in the specified *section* " "to a floating point number." msgstr "" #: ../Doc/library/configparser.rst:324 msgid "" "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`." msgstr "" #: ../Doc/library/configparser.rst:334 msgid "" "Return a list of ``(name, value)`` pairs for each option in the given " "*section*." msgstr "" #: ../Doc/library/configparser.rst:339 msgid "" "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` 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." msgstr "" #: ../Doc/library/configparser.rst:350 msgid "" "Write a representation of the configuration to the specified file object. " "This representation can be parsed by a future :meth:`read` call." msgstr "" #: ../Doc/library/configparser.rst:358 msgid "" "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`." msgstr "" #: ../Doc/library/configparser.rst:367 msgid "" "Remove the specified *section* from the configuration. If the section in " "fact existed, return ``True``. Otherwise return ``False``." msgstr "" #: ../Doc/library/configparser.rst:373 msgid "" "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." msgstr "" #: ../Doc/library/configparser.rst:379 msgid "" "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::" msgstr "" #: ../Doc/library/configparser.rst:388 msgid "" "Note that when reading configuration files, whitespace around the option " "names are stripped before :meth:`optionxform` is called." msgstr "" #: ../Doc/library/configparser.rst:395 msgid "ConfigParser Objects" msgstr "" #: ../Doc/library/configparser.rst:397 msgid "" "The :class:`ConfigParser` class extends some methods of the :class:" "`RawConfigParser` interface, adding some optional arguments." msgstr "" #: ../Doc/library/configparser.rst:403 msgid "" "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." msgstr "" #: ../Doc/library/configparser.rst:407 msgid "" "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." msgstr "" #: ../Doc/library/configparser.rst:413 msgid "" "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` " "method." msgstr "" #: ../Doc/library/configparser.rst:422 msgid "SafeConfigParser Objects" msgstr "" #: ../Doc/library/configparser.rst:424 msgid "" "The :class:`SafeConfigParser` class implements the same extended interface " "as :class:`ConfigParser`, with the following addition:" msgstr "" #: ../Doc/library/configparser.rst:430 msgid "" "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." msgstr "" #: ../Doc/library/configparser.rst:438 msgid "Examples" msgstr "Exemples" #: ../Doc/library/configparser.rst:440 msgid "An example of writing to a configuration file::" msgstr "" #: ../Doc/library/configparser.rst:465 msgid "An example of reading the configuration file again::" msgstr "" #: ../Doc/library/configparser.rst:483 msgid "" "To get interpolation, you will need to use a :class:`ConfigParser` or :class:" "`SafeConfigParser`::" msgstr "" #: ../Doc/library/configparser.rst:500 msgid "" "Defaults are available in all three types of ConfigParsers. They are used in " "interpolation if an option used is not defined elsewhere. ::" msgstr "" #: ../Doc/library/configparser.rst:514 msgid "" "The function ``opt_move`` below can be used to move options between " "sections::" msgstr "" #: ../Doc/library/configparser.rst:526 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 ""