python-docs-fr/library/configparser.po

479 lines
17 KiB
Plaintext
Raw Normal View History

2016-10-30 09:46:26 +00:00
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 1990-2016, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 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 <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\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::"
2018-10-10 16:34:12 +00:00
msgstr "Par exemple ::"
2016-10-30 09:46:26 +00:00
#: ../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 ""