# 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: 2022-05-22 23:13+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" #: library/xml.sax.handler.rst:2 msgid ":mod:`xml.sax.handler` --- Base classes for SAX handlers" msgstr "" #: library/xml.sax.handler.rst:10 msgid "**Source code:** :source:`Lib/xml/sax/handler.py`" msgstr "" #: library/xml.sax.handler.rst:14 msgid "" "The SAX API defines five kinds of handlers: content handlers, DTD handlers, " "error handlers, entity resolvers and lexical handlers. 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 "" #: 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 "" #: library/xml.sax.handler.rst:31 msgid "Handle DTD events." msgstr "" #: library/xml.sax.handler.rst:33 msgid "" "This interface specifies only those DTD events required for basic parsing " "(unparsed entities and attributes)." msgstr "" #: 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 "" #: 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 "" #: library/xml.sax.handler.rst:53 msgid "" "Interface used by the parser to represent low frequency events which may not " "be of interest to many applications." msgstr "" #: library/xml.sax.handler.rst:56 msgid "" "In addition to these classes, :mod:`xml.sax.handler` provides symbolic " "constants for the feature and property names." msgstr "" #: library/xml.sax.handler.rst:62 msgid "value: ``\"http://xml.org/sax/features/namespaces\"``" msgstr "" #: library/xml.sax.handler.rst:63 msgid "true: Perform Namespace processing." msgstr "" #: library/xml.sax.handler.rst:65 msgid "" "false: Optionally do not perform Namespace processing (implies namespace-" "prefixes; default)." msgstr "" #: library/xml.sax.handler.rst:76 library/xml.sax.handler.rst:94 #: library/xml.sax.handler.rst:102 library/xml.sax.handler.rst:112 #: library/xml.sax.handler.rst:144 msgid "access: (parsing) read-only; (not parsing) read/write" msgstr "" #: library/xml.sax.handler.rst:71 msgid "value: ``\"http://xml.org/sax/features/namespace-prefixes\"``" msgstr "" #: library/xml.sax.handler.rst:73 msgid "" "true: Report the original prefixed names and attributes used for Namespace " "declarations." msgstr "" #: library/xml.sax.handler.rst:75 msgid "" "false: Do not report attributes used for Namespace declarations, and " "optionally do not report original prefixed names (default)." msgstr "" #: library/xml.sax.handler.rst:81 msgid "value: ``\"http://xml.org/sax/features/string-interning\"``" msgstr "" #: library/xml.sax.handler.rst:83 msgid "" "true: All element names, prefixes, attribute names, Namespace URIs, and " "local names are interned using the built-in intern function." msgstr "" #: library/xml.sax.handler.rst:84 msgid "" "false: Names are not necessarily interned, although they may be (default)." msgstr "" #: library/xml.sax.handler.rst:90 msgid "value: ``\"http://xml.org/sax/features/validation\"``" msgstr "" #: library/xml.sax.handler.rst:92 msgid "" "true: Report all validation errors (implies external-general-entities and " "external-parameter-entities)." msgstr "" #: library/xml.sax.handler.rst:93 msgid "false: Do not report validation errors." msgstr "" #: library/xml.sax.handler.rst:99 msgid "value: ``\"http://xml.org/sax/features/external-general-entities\"``" msgstr "" #: library/xml.sax.handler.rst:100 msgid "true: Include all external general (text) entities." msgstr "" #: library/xml.sax.handler.rst:101 msgid "false: Do not include external general entities." msgstr "" #: library/xml.sax.handler.rst:107 msgid "value: ``\"http://xml.org/sax/features/external-parameter-entities\"``" msgstr "" #: library/xml.sax.handler.rst:109 msgid "" "true: Include all external parameter entities, including the external DTD " "subset." msgstr "" #: library/xml.sax.handler.rst:111 msgid "" "false: Do not include any external parameter entities, even the external DTD " "subset." msgstr "" #: library/xml.sax.handler.rst:117 msgid "List of all features." msgstr "" #: library/xml.sax.handler.rst:122 msgid "value: ``\"http://xml.org/sax/properties/lexical-handler\"``" msgstr "" #: library/xml.sax.handler.rst:123 msgid "data type: xml.sax.handler.LexicalHandler (not supported in Python 2)" msgstr "" #: library/xml.sax.handler.rst:125 msgid "" "description: An optional extension handler for lexical events like comments." msgstr "" #: library/xml.sax.handler.rst:126 library/xml.sax.handler.rst:135 msgid "access: read/write" msgstr "" #: library/xml.sax.handler.rst:131 msgid "value: ``\"http://xml.org/sax/properties/declaration-handler\"``" msgstr "" #: library/xml.sax.handler.rst:132 msgid "data type: xml.sax.sax2lib.DeclHandler (not supported in Python 2)" msgstr "" #: library/xml.sax.handler.rst:134 msgid "" "description: An optional extension handler for DTD-related events other than " "notations and unparsed entities." msgstr "" #: library/xml.sax.handler.rst:140 msgid "value: ``\"http://xml.org/sax/properties/dom-node\"``" msgstr "" #: library/xml.sax.handler.rst:141 msgid "data type: org.w3c.dom.Node (not supported in Python 2)" msgstr "" #: library/xml.sax.handler.rst:143 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 "" #: library/xml.sax.handler.rst:149 msgid "value: ``\"http://xml.org/sax/properties/xml-string\"``" msgstr "" #: library/xml.sax.handler.rst:150 msgid "data type: Bytes" msgstr "" #: library/xml.sax.handler.rst:152 msgid "" "description: The literal string of characters that was the source for the " "current event." msgstr "" #: library/xml.sax.handler.rst:153 msgid "access: read-only" msgstr "" #: library/xml.sax.handler.rst:158 msgid "List of all known property names." msgstr "" #: library/xml.sax.handler.rst:164 msgid "ContentHandler Objects" msgstr "" #: library/xml.sax.handler.rst:166 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 "" #: library/xml.sax.handler.rst:173 msgid "" "Called by the parser to give the application a locator for locating the " "origin of document events." msgstr "" #: library/xml.sax.handler.rst:176 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 "" #: library/xml.sax.handler.rst:181 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 "" #: library/xml.sax.handler.rst:188 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 "" #: library/xml.sax.handler.rst:195 msgid "Receive notification of the beginning of a document." msgstr "" #: library/xml.sax.handler.rst:197 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 "" #: library/xml.sax.handler.rst:203 msgid "Receive notification of the end of a document." msgstr "" #: library/xml.sax.handler.rst:205 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 "" #: library/xml.sax.handler.rst:213 msgid "Begin the scope of a prefix-URI Namespace mapping." msgstr "" #: library/xml.sax.handler.rst:215 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 "" #: library/xml.sax.handler.rst:220 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 "" #: library/xml.sax.handler.rst:228 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 "" #: library/xml.sax.handler.rst:238 msgid "End the scope of a prefix-URI mapping." msgstr "" #: library/xml.sax.handler.rst:240 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 "" #: library/xml.sax.handler.rst:247 msgid "Signals the start of an element in non-namespace mode." msgstr "" #: library/xml.sax.handler.rst:249 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 "" #: library/xml.sax.handler.rst:261 msgid "Signals the end of an element in non-namespace mode." msgstr "" #: library/xml.sax.handler.rst:263 msgid "" "The *name* parameter contains the name of the element type, just as with " "the :meth:`startElement` event." msgstr "" #: library/xml.sax.handler.rst:269 msgid "Signals the start of an element in namespace mode." msgstr "" #: library/xml.sax.handler.rst:271 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 "" #: library/xml.sax.handler.rst:282 msgid "" "Parsers may set the *qname* parameter to ``None``, unless the " "``feature_namespace_prefixes`` feature is activated." msgstr "" #: library/xml.sax.handler.rst:288 msgid "Signals the end of an element in namespace mode." msgstr "" #: library/xml.sax.handler.rst:290 msgid "" "The *name* parameter contains the name of the element type, just as with " "the :meth:`startElementNS` method, likewise the *qname* parameter." msgstr "" #: library/xml.sax.handler.rst:296 msgid "Receive notification of character data." msgstr "" #: library/xml.sax.handler.rst:298 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 "" #: library/xml.sax.handler.rst:304 msgid "" "*content* may be a string or bytes instance; the ``expat`` reader module " "always produces strings." msgstr "" #: library/xml.sax.handler.rst:309 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 "" #: library/xml.sax.handler.rst:318 msgid "Receive notification of ignorable whitespace in element content." msgstr "" #: library/xml.sax.handler.rst:320 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 "" #: library/xml.sax.handler.rst:325 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 "" #: library/xml.sax.handler.rst:333 msgid "Receive notification of a processing instruction." msgstr "" #: library/xml.sax.handler.rst:335 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 "" #: library/xml.sax.handler.rst:339 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 "" #: library/xml.sax.handler.rst:345 msgid "Receive notification of a skipped entity." msgstr "" #: library/xml.sax.handler.rst:347 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 "" #: library/xml.sax.handler.rst:357 msgid "DTDHandler Objects" msgstr "" #: library/xml.sax.handler.rst:359 msgid ":class:`DTDHandler` instances provide the following methods:" msgstr "" #: library/xml.sax.handler.rst:364 msgid "Handle a notation declaration event." msgstr "" #: library/xml.sax.handler.rst:369 msgid "Handle an unparsed entity declaration event." msgstr "" #: library/xml.sax.handler.rst:375 msgid "EntityResolver Objects" msgstr "" #: library/xml.sax.handler.rst:380 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 "" #: library/xml.sax.handler.rst:388 msgid "ErrorHandler Objects" msgstr "" #: library/xml.sax.handler.rst:390 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 "" #: library/xml.sax.handler.rst:403 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 "" #: library/xml.sax.handler.rst:411 msgid "" "Called when the parser encounters an error it cannot recover from; parsing " "is expected to terminate when this method returns." msgstr "" #: library/xml.sax.handler.rst:417 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 "" #: library/xml.sax.handler.rst:426 msgid "LexicalHandler Objects" msgstr "" #: library/xml.sax.handler.rst:427 msgid "Optional SAX2 handler for lexical events." msgstr "" #: library/xml.sax.handler.rst:429 msgid "" "This handler is used to obtain lexical information about an XML document. " "Lexical information includes information describing the document encoding " "used and XML comments embedded in the document, as well as section " "boundaries for the DTD and for any CDATA sections. The lexical handlers are " "used in the same manner as content handlers." msgstr "" #: library/xml.sax.handler.rst:435 msgid "" "Set the LexicalHandler of an XMLReader by using the setProperty method with " "the property identifier ``'http://xml.org/sax/properties/lexical-handler'``." msgstr "" #: library/xml.sax.handler.rst:442 msgid "" "Reports a comment anywhere in the document (including the DTD and outside " "the document element)." msgstr "" #: library/xml.sax.handler.rst:447 msgid "" "Reports the start of the DTD declarations if the document has an associated " "DTD." msgstr "" #: library/xml.sax.handler.rst:452 msgid "Reports the end of DTD declaration." msgstr "" #: library/xml.sax.handler.rst:456 msgid "Reports the start of a CDATA marked section." msgstr "" #: library/xml.sax.handler.rst:458 msgid "" "The contents of the CDATA marked section will be reported through the " "characters handler." msgstr "" #: library/xml.sax.handler.rst:463 msgid "Reports the end of a CDATA marked section." msgstr ""