python-docs-fr/library/xml.sax.reader.po

# Copyright (C) 2001-2018, Python Software Foundation
# For licence information, see README file.
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2020-08-24 09:01+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
"Language: fr\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#: library/xml.sax.reader.rst:2
msgid ":mod:`xml.sax.xmlreader` --- Interface for XML parsers"
msgstr ""

#: library/xml.sax.reader.rst:10
msgid "**Source code:** :source:`Lib/xml/sax/xmlreader.py`"
msgstr ""

#: library/xml.sax.reader.rst:14
msgid ""
"SAX parsers implement the :class:`XMLReader` interface. They are implemented "
"in a Python module, which must provide a function :func:`create_parser`. "
"This function is invoked by  :func:`xml.sax.make_parser` with no arguments "
"to create a new  parser object."
msgstr ""

#: library/xml.sax.reader.rst:22
msgid "Base class which can be inherited by SAX parsers."
msgstr ""

#: library/xml.sax.reader.rst:27
msgid ""
"In some cases, it is desirable not to parse an input source at once, but to "
"feed chunks of the document as they get available. Note that the reader will "
"normally not read the entire file, but read it in chunks as well; still :"
"meth:`parse` won't return until the entire document is processed. So these "
"interfaces should be used if the blocking behaviour of :meth:`parse` is not "
"desirable."
msgstr ""

#: library/xml.sax.reader.rst:33
msgid ""
"When the parser is instantiated it is ready to begin accepting data from the "
"feed method immediately. After parsing has been finished with a call to "
"close the reset method must be called to make the parser ready to accept new "
"data, either from feed or using the parse method."
msgstr ""

#: library/xml.sax.reader.rst:38
msgid ""
"Note that these methods must *not* be called during parsing, that is, after "
"parse has been called and before it returns."
msgstr ""

#: library/xml.sax.reader.rst:41
msgid ""
"By default, the class also implements the parse method of the XMLReader "
"interface using the feed, close and reset methods of the IncrementalParser "
"interface as a convenience to SAX 2.0 driver writers."
msgstr ""

#: library/xml.sax.reader.rst:48
msgid ""
"Interface for associating a SAX event with a document location. A locator "
"object will return valid results only during calls to DocumentHandler "
"methods; at any other time, the results are unpredictable. If information is "
"not available, methods may return ``None``."
msgstr ""

#: library/xml.sax.reader.rst:56
msgid ""
"Encapsulation of the information needed by the :class:`XMLReader` to read "
"entities."
msgstr ""

#: library/xml.sax.reader.rst:59
msgid ""
"This class may include information about the public identifier, system "
"identifier, byte stream (possibly with character encoding information) and/"
"or the character stream of an entity."
msgstr ""

#: library/xml.sax.reader.rst:63
msgid ""
"Applications will create objects of this class for use in the :meth:"
"`XMLReader.parse` method and for returning from EntityResolver.resolveEntity."
msgstr ""

#: library/xml.sax.reader.rst:67
msgid ""
"An :class:`InputSource` belongs to the application, the :class:`XMLReader` "
"is not allowed to modify :class:`InputSource` objects passed to it from the "
"application, although it may make copies and modify those."
msgstr ""

#: library/xml.sax.reader.rst:74
msgid ""
"This is an implementation of the :class:`Attributes` interface (see section :"
"ref:`attributes-objects`).  This is a dictionary-like object which "
"represents the element attributes in a :meth:`startElement` call. In "
"addition to the most useful dictionary operations, it supports a number of "
"other methods as described by the interface. Objects of this class should be "
"instantiated by readers; *attrs* must be a dictionary-like object containing "
"a mapping from attribute names to attribute values."
msgstr ""

#: library/xml.sax.reader.rst:85
msgid ""
"Namespace-aware variant of :class:`AttributesImpl`, which will be passed to :"
"meth:`startElementNS`. It is derived from :class:`AttributesImpl`, but "
"understands attribute names as two-tuples of *namespaceURI* and *localname*. "
"In addition, it provides a number of methods expecting qualified names as "
"they appear in the original document.  This class implements the :class:"
"`AttributesNS` interface (see section :ref:`attributes-ns-objects`)."
msgstr ""

#: library/xml.sax.reader.rst:96
msgid "XMLReader Objects"
msgstr ""

#: library/xml.sax.reader.rst:98
msgid "The :class:`XMLReader` interface supports the following methods:"
msgstr ""

#: library/xml.sax.reader.rst:103
msgid ""
"Process an input source, producing SAX events. The *source* object can be a "
"system identifier (a string identifying the input source -- typically a file "
"name or a URL), a :class:`pathlib.Path` or :term:`path-like <path-like "
"object>` object, or an :class:`InputSource` object. When :meth:`parse` "
"returns, the input is completely processed, and the parser object can be "
"discarded or reset."
msgstr ""

#: library/xml.sax.reader.rst:110
msgid "Added support of character streams."
msgstr ""

#: library/xml.sax.reader.rst:113
msgid "Added support of path-like objects."
msgstr ""

#: library/xml.sax.reader.rst:119
msgid "Return the current :class:`~xml.sax.handler.ContentHandler`."
msgstr ""

#: library/xml.sax.reader.rst:124
msgid ""
"Set the current :class:`~xml.sax.handler.ContentHandler`.  If no :class:"
"`~xml.sax.handler.ContentHandler` is set, content events will be discarded."
msgstr ""

#: library/xml.sax.reader.rst:131
msgid "Return the current :class:`~xml.sax.handler.DTDHandler`."
msgstr ""

#: library/xml.sax.reader.rst:136
msgid ""
"Set the current :class:`~xml.sax.handler.DTDHandler`.  If no :class:`~xml."
"sax.handler.DTDHandler` is set, DTD events will be discarded."
msgstr ""

#: library/xml.sax.reader.rst:143
msgid "Return the current :class:`~xml.sax.handler.EntityResolver`."
msgstr ""

#: library/xml.sax.reader.rst:148
msgid ""
"Set the current :class:`~xml.sax.handler.EntityResolver`.  If no :class:"
"`~xml.sax.handler.EntityResolver` is set, attempts to resolve an external "
"entity will result in opening the system identifier for the entity, and fail "
"if it is not available."
msgstr ""

#: library/xml.sax.reader.rst:156
msgid "Return the current :class:`~xml.sax.handler.ErrorHandler`."
msgstr ""

#: library/xml.sax.reader.rst:161
msgid ""
"Set the current error handler.  If no :class:`~xml.sax.handler.ErrorHandler` "
"is set, errors will be raised as exceptions, and warnings will be printed."
msgstr ""

#: library/xml.sax.reader.rst:167
msgid "Allow an application to set the locale for errors and warnings."
msgstr ""

#: library/xml.sax.reader.rst:169
msgid ""
"SAX parsers are not required to provide localization for errors and "
"warnings; if they cannot support the requested locale, however, they must "
"raise a SAX exception.  Applications may request a locale change in the "
"middle of a parse."
msgstr ""

#: library/xml.sax.reader.rst:176
msgid ""
"Return the current setting for feature *featurename*.  If the feature is not "
"recognized, :exc:`SAXNotRecognizedException` is raised. The well-known "
"featurenames are listed in the module :mod:`xml.sax.handler`."
msgstr ""

#: library/xml.sax.reader.rst:183
msgid ""
"Set the *featurename* to *value*. If the feature is not recognized, :exc:"
"`SAXNotRecognizedException` is raised. If the feature or its setting is not "
"supported by the parser, *SAXNotSupportedException* is raised."
msgstr ""

#: library/xml.sax.reader.rst:190
msgid ""
"Return the current setting for property *propertyname*. If the property is "
"not recognized, a :exc:`SAXNotRecognizedException` is raised. The well-known "
"propertynames are listed in the module :mod:`xml.sax.handler`."
msgstr ""

#: library/xml.sax.reader.rst:197
msgid ""
"Set the *propertyname* to *value*. If the property is not recognized, :exc:"
"`SAXNotRecognizedException` is raised. If the property or its setting is not "
"supported by the parser, *SAXNotSupportedException* is raised."
msgstr ""

#: library/xml.sax.reader.rst:205
msgid "IncrementalParser Objects"
msgstr ""

#: library/xml.sax.reader.rst:207
msgid ""
"Instances of :class:`IncrementalParser` offer the following additional "
"methods:"
msgstr ""

#: library/xml.sax.reader.rst:212
msgid "Process a chunk of *data*."
msgstr ""

#: library/xml.sax.reader.rst:217
msgid ""
"Assume the end of the document. That will check well-formedness conditions "
"that can be checked only at the end, invoke handlers, and may clean up "
"resources allocated during parsing."
msgstr ""

#: library/xml.sax.reader.rst:224
msgid ""
"This method is called after close has been called to reset the parser so "
"that it is ready to parse new documents. The results of calling parse or "
"feed after close without calling reset are undefined."
msgstr ""

#: library/xml.sax.reader.rst:232
msgid "Locator Objects"
msgstr ""

#: library/xml.sax.reader.rst:234
msgid "Instances of :class:`Locator` provide these methods:"
msgstr ""

#: library/xml.sax.reader.rst:239
msgid "Return the column number where the current event begins."
msgstr ""

#: library/xml.sax.reader.rst:244
msgid "Return the line number where the current event begins."
msgstr ""

#: library/xml.sax.reader.rst:249
msgid "Return the public identifier for the current event."
msgstr ""

#: library/xml.sax.reader.rst:254
msgid "Return the system identifier for the current event."
msgstr ""

#: library/xml.sax.reader.rst:260
msgid "InputSource Objects"
msgstr ""

#: library/xml.sax.reader.rst:265
msgid "Sets the public identifier of this :class:`InputSource`."
msgstr ""

#: library/xml.sax.reader.rst:270
msgid "Returns the public identifier of this :class:`InputSource`."
msgstr ""

#: library/xml.sax.reader.rst:275
msgid "Sets the system identifier of this :class:`InputSource`."
msgstr ""

#: library/xml.sax.reader.rst:280
msgid "Returns the system identifier of this :class:`InputSource`."
msgstr ""

#: library/xml.sax.reader.rst:285
msgid "Sets the character encoding of this :class:`InputSource`."
msgstr ""

#: library/xml.sax.reader.rst:287
msgid ""
"The encoding must be a string acceptable for an XML encoding declaration "
"(see section 4.3.3 of the XML recommendation)."
msgstr ""

#: library/xml.sax.reader.rst:290
msgid ""
"The encoding attribute of the :class:`InputSource` is ignored if the :class:"
"`InputSource` also contains a character stream."
msgstr ""

#: library/xml.sax.reader.rst:296
msgid "Get the character encoding of this InputSource."
msgstr ""

#: library/xml.sax.reader.rst:301
msgid "Set the byte stream (a :term:`binary file`) for this input source."
msgstr ""

#: library/xml.sax.reader.rst:303
msgid ""
"The SAX parser will ignore this if there is also a character stream "
"specified, but it will use a byte stream in preference to opening a URI "
"connection itself."
msgstr ""

#: library/xml.sax.reader.rst:306
msgid ""
"If the application knows the character encoding of the byte stream, it "
"should set it with the setEncoding method."
msgstr ""

#: library/xml.sax.reader.rst:312
msgid "Get the byte stream for this input source."
msgstr ""

#: library/xml.sax.reader.rst:314
msgid ""
"The getEncoding method will return the character encoding for this byte "
"stream, or ``None`` if unknown."
msgstr ""

#: library/xml.sax.reader.rst:320
msgid "Set the character stream (a :term:`text file`) for this input source."
msgstr ""

#: library/xml.sax.reader.rst:322
msgid ""
"If there is a character stream specified, the SAX parser will ignore any "
"byte stream and will not attempt to open a URI connection to the system "
"identifier."
msgstr ""

#: library/xml.sax.reader.rst:328
msgid "Get the character stream for this input source."
msgstr ""

#: library/xml.sax.reader.rst:334
msgid "The :class:`Attributes` Interface"
msgstr ""

#: library/xml.sax.reader.rst:336
msgid ""
":class:`Attributes` objects implement a portion of the :term:`mapping "
"protocol <mapping>`, including the methods :meth:`~collections.abc.Mapping."
"copy`, :meth:`~collections.abc.Mapping.get`, :meth:`~object.__contains__`, :"
"meth:`~collections.abc.Mapping.items`, :meth:`~collections.abc.Mapping."
"keys`, and :meth:`~collections.abc.Mapping.values`.  The following methods "
"are also provided:"
msgstr ""

#: library/xml.sax.reader.rst:346
msgid "Return the number of attributes."
msgstr ""

#: library/xml.sax.reader.rst:351
msgid "Return the names of the attributes."
msgstr ""

#: library/xml.sax.reader.rst:356
msgid ""
"Returns the type of the attribute *name*, which is normally ``'CDATA'``."
msgstr ""

#: library/xml.sax.reader.rst:361
msgid "Return the value of attribute *name*."
msgstr ""

#: library/xml.sax.reader.rst:370
msgid "The :class:`AttributesNS` Interface"
msgstr ""

#: library/xml.sax.reader.rst:372
msgid ""
"This interface is a subtype of the :class:`Attributes` interface (see "
"section :ref:`attributes-objects`).  All methods supported by that interface "
"are also available on :class:`AttributesNS` objects."
msgstr ""

#: library/xml.sax.reader.rst:376
msgid "The following methods are also available:"
msgstr ""

#: library/xml.sax.reader.rst:381
msgid "Return the value for a qualified name."
msgstr ""

#: library/xml.sax.reader.rst:386
msgid "Return the ``(namespace, localname)`` pair for a qualified *name*."
msgstr ""

#: library/xml.sax.reader.rst:391
msgid "Return the qualified name for a ``(namespace, localname)`` pair."
msgstr ""

#: library/xml.sax.reader.rst:396
msgid "Return the qualified names of all attributes."
msgstr ""