# Copyright (C) 2001-2018, Python Software Foundation # For licence information, see README file. # msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2017-04-02 22:11+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: FRENCH \n" "Language: fr\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #: ../Doc/library/xml.sax.handler.rst:2 msgid ":mod:`xml.sax.handler` --- Base classes for SAX handlers" msgstr "" #: ../Doc/library/xml.sax.handler.rst:10 msgid "**Source code:** :source:`Lib/xml/sax/handler.py`" msgstr "" #: ../Doc/library/xml.sax.handler.rst:14 msgid "" "The SAX API defines four kinds of handlers: content handlers, DTD handlers, " "error handlers, and entity resolvers. Applications normally only need to " "implement those interfaces whose events they are interested in; they can " "implement the interfaces in a single object or in multiple objects. Handler " "implementations should inherit from the base classes provided in the module :" "mod:`xml.sax.handler`, so that all methods get default implementations." msgstr "" #: ../Doc/library/xml.sax.handler.rst:24 msgid "" "This is the main callback interface in SAX, and the one most important to " "applications. The order of events in this interface mirrors the order of the " "information in the document." msgstr "" #: ../Doc/library/xml.sax.handler.rst:31 msgid "Handle DTD events." msgstr "" #: ../Doc/library/xml.sax.handler.rst:33 msgid "" "This interface specifies only those DTD events required for basic parsing " "(unparsed entities and attributes)." msgstr "" #: ../Doc/library/xml.sax.handler.rst:39 msgid "" "Basic interface for resolving entities. If you create an object implementing " "this interface, then register the object with your Parser, the parser will " "call the method in your object to resolve all external entities." msgstr "" #: ../Doc/library/xml.sax.handler.rst:46 msgid "" "Interface used by the parser to present error and warning messages to the " "application. The methods of this object control whether errors are " "immediately converted to exceptions or are handled in some other way." msgstr "" #: ../Doc/library/xml.sax.handler.rst:50 msgid "" "In addition to these classes, :mod:`xml.sax.handler` provides symbolic " "constants for the feature and property names." msgstr "" #: ../Doc/library/xml.sax.handler.rst:56 msgid "value: ``\"http://xml.org/sax/features/namespaces\"``" msgstr "" #: ../Doc/library/xml.sax.handler.rst:57 msgid "true: Perform Namespace processing." msgstr "" #: ../Doc/library/xml.sax.handler.rst:59 msgid "" "false: Optionally do not perform Namespace processing (implies namespace-" "prefixes; default)." msgstr "" #: ../Doc/library/xml.sax.handler.rst:60 ../Doc/library/xml.sax.handler.rst:70 #: ../Doc/library/xml.sax.handler.rst:79 ../Doc/library/xml.sax.handler.rst:88 #: ../Doc/library/xml.sax.handler.rst:96 ../Doc/library/xml.sax.handler.rst:106 #: ../Doc/library/xml.sax.handler.rst:138 msgid "access: (parsing) read-only; (not parsing) read/write" msgstr "" #: ../Doc/library/xml.sax.handler.rst:65 msgid "value: ``\"http://xml.org/sax/features/namespace-prefixes\"``" msgstr "" #: ../Doc/library/xml.sax.handler.rst:67 msgid "" "true: Report the original prefixed names and attributes used for Namespace " "declarations." msgstr "" #: ../Doc/library/xml.sax.handler.rst:69 msgid "" "false: Do not report attributes used for Namespace declarations, and " "optionally do not report original prefixed names (default)." msgstr "" #: ../Doc/library/xml.sax.handler.rst:75 msgid "value: ``\"http://xml.org/sax/features/string-interning\"``" msgstr "" #: ../Doc/library/xml.sax.handler.rst:77 msgid "" "true: All element names, prefixes, attribute names, Namespace URIs, and " "local names are interned using the built-in intern function." msgstr "" #: ../Doc/library/xml.sax.handler.rst:78 msgid "" "false: Names are not necessarily interned, although they may be (default)." msgstr "" #: ../Doc/library/xml.sax.handler.rst:84 msgid "value: ``\"http://xml.org/sax/features/validation\"``" msgstr "" #: ../Doc/library/xml.sax.handler.rst:86 msgid "" "true: Report all validation errors (implies external-general-entities and " "external-parameter-entities)." msgstr "" #: ../Doc/library/xml.sax.handler.rst:87 msgid "false: Do not report validation errors." msgstr "" #: ../Doc/library/xml.sax.handler.rst:93 msgid "value: ``\"http://xml.org/sax/features/external-general-entities\"``" msgstr "" #: ../Doc/library/xml.sax.handler.rst:94 msgid "true: Include all external general (text) entities." msgstr "" #: ../Doc/library/xml.sax.handler.rst:95 msgid "false: Do not include external general entities." msgstr "" #: ../Doc/library/xml.sax.handler.rst:101 msgid "value: ``\"http://xml.org/sax/features/external-parameter-entities\"``" msgstr "" #: ../Doc/library/xml.sax.handler.rst:103 msgid "" "true: Include all external parameter entities, including the external DTD " "subset." msgstr "" #: ../Doc/library/xml.sax.handler.rst:105 msgid "" "false: Do not include any external parameter entities, even the external DTD " "subset." msgstr "" #: ../Doc/library/xml.sax.handler.rst:111 msgid "List of all features." msgstr "" #: ../Doc/library/xml.sax.handler.rst:116 msgid "value: ``\"http://xml.org/sax/properties/lexical-handler\"``" msgstr "" #: ../Doc/library/xml.sax.handler.rst:117 msgid "data type: xml.sax.sax2lib.LexicalHandler (not supported in Python 2)" msgstr "" #: ../Doc/library/xml.sax.handler.rst:119 msgid "" "description: An optional extension handler for lexical events like comments." msgstr "" #: ../Doc/library/xml.sax.handler.rst:120 #: ../Doc/library/xml.sax.handler.rst:129 msgid "access: read/write" msgstr "" #: ../Doc/library/xml.sax.handler.rst:125 msgid "value: ``\"http://xml.org/sax/properties/declaration-handler\"``" msgstr "" #: ../Doc/library/xml.sax.handler.rst:126 msgid "data type: xml.sax.sax2lib.DeclHandler (not supported in Python 2)" msgstr "" #: ../Doc/library/xml.sax.handler.rst:128 msgid "" "description: An optional extension handler for DTD-related events other than " "notations and unparsed entities." msgstr "" #: ../Doc/library/xml.sax.handler.rst:134 msgid "value: ``\"http://xml.org/sax/properties/dom-node\"``" msgstr "" #: ../Doc/library/xml.sax.handler.rst:135 msgid "data type: org.w3c.dom.Node (not supported in Python 2)" msgstr "" #: ../Doc/library/xml.sax.handler.rst:137 msgid "" "description: When parsing, the current DOM node being visited if this is a " "DOM iterator; when not parsing, the root DOM node for iteration." msgstr "" #: ../Doc/library/xml.sax.handler.rst:143 msgid "value: ``\"http://xml.org/sax/properties/xml-string\"``" msgstr "" #: ../Doc/library/xml.sax.handler.rst:144 msgid "data type: String" msgstr "" #: ../Doc/library/xml.sax.handler.rst:146 msgid "" "description: The literal string of characters that was the source for the " "current event." msgstr "" #: ../Doc/library/xml.sax.handler.rst:147 msgid "access: read-only" msgstr "" #: ../Doc/library/xml.sax.handler.rst:152 msgid "List of all known property names." msgstr "" #: ../Doc/library/xml.sax.handler.rst:158 msgid "ContentHandler Objects" msgstr "" #: ../Doc/library/xml.sax.handler.rst:160 msgid "" "Users are expected to subclass :class:`ContentHandler` to support their " "application. The following methods are called by the parser on the " "appropriate events in the input document:" msgstr "" #: ../Doc/library/xml.sax.handler.rst:167 msgid "" "Called by the parser to give the application a locator for locating the " "origin of document events." msgstr "" #: ../Doc/library/xml.sax.handler.rst:170 msgid "" "SAX parsers are strongly encouraged (though not absolutely required) to " "supply a locator: if it does so, it must supply the locator to the " "application by invoking this method before invoking any of the other methods " "in the DocumentHandler interface." msgstr "" #: ../Doc/library/xml.sax.handler.rst:175 msgid "" "The locator allows the application to determine the end position of any " "document-related event, even if the parser is not reporting an error. " "Typically, the application will use this information for reporting its own " "errors (such as character content that does not match an application's " "business rules). The information returned by the locator is probably not " "sufficient for use with a search engine." msgstr "" #: ../Doc/library/xml.sax.handler.rst:182 msgid "" "Note that the locator will return correct information only during the " "invocation of the events in this interface. The application should not " "attempt to use it at any other time." msgstr "" #: ../Doc/library/xml.sax.handler.rst:189 msgid "Receive notification of the beginning of a document." msgstr "" #: ../Doc/library/xml.sax.handler.rst:191 msgid "" "The SAX parser will invoke this method only once, before any other methods " "in this interface or in DTDHandler (except for :meth:`setDocumentLocator`)." msgstr "" #: ../Doc/library/xml.sax.handler.rst:197 msgid "Receive notification of the end of a document." msgstr "" #: ../Doc/library/xml.sax.handler.rst:199 msgid "" "The SAX parser will invoke this method only once, and it will be the last " "method invoked during the parse. The parser shall not invoke this method " "until it has either abandoned parsing (because of an unrecoverable error) or " "reached the end of input." msgstr "" #: ../Doc/library/xml.sax.handler.rst:207 msgid "Begin the scope of a prefix-URI Namespace mapping." msgstr "" #: ../Doc/library/xml.sax.handler.rst:209 msgid "" "The information from this event is not necessary for normal Namespace " "processing: the SAX XML reader will automatically replace prefixes for " "element and attribute names when the ``feature_namespaces`` feature is " "enabled (the default)." msgstr "" #: ../Doc/library/xml.sax.handler.rst:214 msgid "" "There are cases, however, when applications need to use prefixes in " "character data or in attribute values, where they cannot safely be expanded " "automatically; the :meth:`startPrefixMapping` and :meth:`endPrefixMapping` " "events supply the information to the application to expand prefixes in those " "contexts itself, if necessary." msgstr "" #: ../Doc/library/xml.sax.handler.rst:222 msgid "" "Note that :meth:`startPrefixMapping` and :meth:`endPrefixMapping` events are " "not guaranteed to be properly nested relative to each-other: all :meth:" "`startPrefixMapping` events will occur before the corresponding :meth:" "`startElement` event, and all :meth:`endPrefixMapping` events will occur " "after the corresponding :meth:`endElement` event, but their order is not " "guaranteed." msgstr "" #: ../Doc/library/xml.sax.handler.rst:232 msgid "End the scope of a prefix-URI mapping." msgstr "" #: ../Doc/library/xml.sax.handler.rst:234 msgid "" "See :meth:`startPrefixMapping` for details. This event will always occur " "after the corresponding :meth:`endElement` event, but the order of :meth:" "`endPrefixMapping` events is not otherwise guaranteed." msgstr "" #: ../Doc/library/xml.sax.handler.rst:241 msgid "Signals the start of an element in non-namespace mode." msgstr "" #: ../Doc/library/xml.sax.handler.rst:243 msgid "" "The *name* parameter contains the raw XML 1.0 name of the element type as a " "string and the *attrs* parameter holds an object of the :class:`~xml.sax." "xmlreader.Attributes` interface (see :ref:`attributes-objects`) containing " "the attributes of the element. The object passed as *attrs* may be re-used " "by the parser; holding on to a reference to it is not a reliable way to keep " "a copy of the attributes. To keep a copy of the attributes, use the :meth:" "`copy` method of the *attrs* object." msgstr "" #: ../Doc/library/xml.sax.handler.rst:255 msgid "Signals the end of an element in non-namespace mode." msgstr "" #: ../Doc/library/xml.sax.handler.rst:257 msgid "" "The *name* parameter contains the name of the element type, just as with " "the :meth:`startElement` event." msgstr "" #: ../Doc/library/xml.sax.handler.rst:263 msgid "Signals the start of an element in namespace mode." msgstr "" #: ../Doc/library/xml.sax.handler.rst:265 msgid "" "The *name* parameter contains the name of the element type as a ``(uri, " "localname)`` tuple, the *qname* parameter contains the raw XML 1.0 name used " "in the source document, and the *attrs* parameter holds an instance of the :" "class:`~xml.sax.xmlreader.AttributesNS` interface (see :ref:`attributes-ns-" "objects`) containing the attributes of the element. If no namespace is " "associated with the element, the *uri* component of *name* will be " "``None``. The object passed as *attrs* may be re-used by the parser; " "holding on to a reference to it is not a reliable way to keep a copy of the " "attributes. To keep a copy of the attributes, use the :meth:`copy` method " "of the *attrs* object." msgstr "" #: ../Doc/library/xml.sax.handler.rst:276 msgid "" "Parsers may set the *qname* parameter to ``None``, unless the " "``feature_namespace_prefixes`` feature is activated." msgstr "" #: ../Doc/library/xml.sax.handler.rst:282 msgid "Signals the end of an element in namespace mode." msgstr "" #: ../Doc/library/xml.sax.handler.rst:284 msgid "" "The *name* parameter contains the name of the element type, just as with " "the :meth:`startElementNS` method, likewise the *qname* parameter." msgstr "" #: ../Doc/library/xml.sax.handler.rst:290 msgid "Receive notification of character data." msgstr "" #: ../Doc/library/xml.sax.handler.rst:292 msgid "" "The Parser will call this method to report each chunk of character data. SAX " "parsers may return all contiguous character data in a single chunk, or they " "may split it into several chunks; however, all of the characters in any " "single event must come from the same external entity so that the Locator " "provides useful information." msgstr "" #: ../Doc/library/xml.sax.handler.rst:298 msgid "" "*content* may be a string or bytes instance; the ``expat`` reader module " "always produces strings." msgstr "" #: ../Doc/library/xml.sax.handler.rst:303 msgid "" "The earlier SAX 1 interface provided by the Python XML Special Interest " "Group used a more Java-like interface for this method. Since most parsers " "used from Python did not take advantage of the older interface, the simpler " "signature was chosen to replace it. To convert old code to the new " "interface, use *content* instead of slicing content with the old *offset* " "and *length* parameters." msgstr "" #: ../Doc/library/xml.sax.handler.rst:312 msgid "Receive notification of ignorable whitespace in element content." msgstr "" #: ../Doc/library/xml.sax.handler.rst:314 msgid "" "Validating Parsers must use this method to report each chunk of ignorable " "whitespace (see the W3C XML 1.0 recommendation, section 2.10): non-" "validating parsers may also use this method if they are capable of parsing " "and using content models." msgstr "" #: ../Doc/library/xml.sax.handler.rst:319 msgid "" "SAX parsers may return all contiguous whitespace in a single chunk, or they " "may split it into several chunks; however, all of the characters in any " "single event must come from the same external entity, so that the Locator " "provides useful information." msgstr "" #: ../Doc/library/xml.sax.handler.rst:327 msgid "Receive notification of a processing instruction." msgstr "" #: ../Doc/library/xml.sax.handler.rst:329 msgid "" "The Parser will invoke this method once for each processing instruction " "found: note that processing instructions may occur before or after the main " "document element." msgstr "" #: ../Doc/library/xml.sax.handler.rst:333 msgid "" "A SAX parser should never report an XML declaration (XML 1.0, section 2.8) " "or a text declaration (XML 1.0, section 4.3.1) using this method." msgstr "" #: ../Doc/library/xml.sax.handler.rst:339 msgid "Receive notification of a skipped entity." msgstr "" #: ../Doc/library/xml.sax.handler.rst:341 msgid "" "The Parser will invoke this method once for each entity skipped. Non-" "validating processors may skip entities if they have not seen the " "declarations (because, for example, the entity was declared in an external " "DTD subset). All processors may skip external entities, depending on the " "values of the ``feature_external_ges`` and the ``feature_external_pes`` " "properties." msgstr "" #: ../Doc/library/xml.sax.handler.rst:351 msgid "DTDHandler Objects" msgstr "" #: ../Doc/library/xml.sax.handler.rst:353 msgid ":class:`DTDHandler` instances provide the following methods:" msgstr "" #: ../Doc/library/xml.sax.handler.rst:358 msgid "Handle a notation declaration event." msgstr "" #: ../Doc/library/xml.sax.handler.rst:363 msgid "Handle an unparsed entity declaration event." msgstr "" #: ../Doc/library/xml.sax.handler.rst:369 msgid "EntityResolver Objects" msgstr "" #: ../Doc/library/xml.sax.handler.rst:374 msgid "" "Resolve the system identifier of an entity and return either the system " "identifier to read from as a string, or an InputSource to read from. The " "default implementation returns *systemId*." msgstr "" #: ../Doc/library/xml.sax.handler.rst:382 msgid "ErrorHandler Objects" msgstr "" #: ../Doc/library/xml.sax.handler.rst:384 msgid "" "Objects with this interface are used to receive error and warning " "information from the :class:`~xml.sax.xmlreader.XMLReader`. If you create " "an object that implements this interface, then register the object with " "your :class:`~xml.sax.xmlreader.XMLReader`, the parser will call the methods " "in your object to report all warnings and errors. There are three levels of " "errors available: warnings, (possibly) recoverable errors, and unrecoverable " "errors. All methods take a :exc:`SAXParseException` as the only parameter. " "Errors and warnings may be converted to an exception by raising the passed-" "in exception object." msgstr "" #: ../Doc/library/xml.sax.handler.rst:397 msgid "" "Called when the parser encounters a recoverable error. If this method does " "not raise an exception, parsing may continue, but further document " "information should not be expected by the application. Allowing the parser " "to continue may allow additional errors to be discovered in the input " "document." msgstr "" #: ../Doc/library/xml.sax.handler.rst:405 msgid "" "Called when the parser encounters an error it cannot recover from; parsing " "is expected to terminate when this method returns." msgstr "" #: ../Doc/library/xml.sax.handler.rst:411 msgid "" "Called when the parser presents minor warning information to the " "application. Parsing is expected to continue when this method returns, and " "document information will continue to be passed to the application. Raising " "an exception in this method will cause parsing to end." msgstr ""