# 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: 2023-01-15 22:33+0100\n" "PO-Revision-Date: 2022-02-10 10:17+0100\n" "Last-Translator: Arnaud Fréalle \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" "X-Generator: Poedit 3.0\n" #: library/xml.etree.elementtree.rst:2 msgid ":mod:`xml.etree.ElementTree` --- The ElementTree XML API" msgstr ":mod:`xml.etree.ElementTree` — L'API ElementTree XML" #: library/xml.etree.elementtree.rst:9 msgid "**Source code:** :source:`Lib/xml/etree/ElementTree.py`" msgstr "**Code Source:** :source:`Lib/xml/etree/ElementTree.py`" #: library/xml.etree.elementtree.rst:13 msgid "" "The :mod:`xml.etree.ElementTree` module implements a simple and efficient " "API for parsing and creating XML data." msgstr "" "Le module :mod:`xml.etree.ElementTree` implémente une API simple et " "efficace pour analyser et créer des données XML." #: library/xml.etree.elementtree.rst:16 msgid "This module will use a fast implementation whenever available." msgstr "" "Ce module utilise une implémentation rapide chaque fois que c'est possible." #: library/xml.etree.elementtree.rst:19 msgid "The :mod:`xml.etree.cElementTree` module is deprecated." msgstr "Le module :mod:`xml.etree.cElementTree` est obsolète." #: library/xml.etree.elementtree.rst:25 #, fuzzy msgid "" "The :mod:`xml.etree.ElementTree` module is not secure against maliciously " "constructed data. If you need to parse untrusted or unauthenticated data " "see :ref:`xml-vulnerabilities`." msgstr "" "Le module :mod:`xml.sax` n'est pas sécurisé contre les données construites " "de façon malveillante. Si vous avez besoin d'analyser des données non " "sécurisées ou non authentifiées, voir :ref:`xml-vulnerabilities`." #: library/xml.etree.elementtree.rst:30 msgid "Tutorial" msgstr "Tutoriel" #: library/xml.etree.elementtree.rst:32 msgid "" "This is a short tutorial for using :mod:`xml.etree.ElementTree` (``ET`` in " "short). The goal is to demonstrate some of the building blocks and basic " "concepts of the module." msgstr "" "Ceci est un petit tutoriel pour utiliser :mod:`xml.etree.ElementTree` " "(``ET``). Le but est de démontrer quelques composants et les concepts " "basiques du module." #: library/xml.etree.elementtree.rst:37 msgid "XML tree and elements" msgstr "Arborescence et éléments XML" #: library/xml.etree.elementtree.rst:39 msgid "" "XML is an inherently hierarchical data format, and the most natural way to " "represent it is with a tree. ``ET`` has two classes for this purpose - :" "class:`ElementTree` represents the whole XML document as a tree, and :class:" "`Element` represents a single node in this tree. Interactions with the " "whole document (reading and writing to/from files) are usually done on the :" "class:`ElementTree` level. Interactions with a single XML element and its " "sub-elements are done on the :class:`Element` level." msgstr "" "XML est un format de données fondamentalement hiérarchique et la façon la " "plus naturelle de la représenter est avec un arbre. ``ET`` a deux classes " "pour ce but- :class:`ElementTree` représente l'ensemble du document XML " "comme un arbre et :class:`Element` est représenté en tant que nœud dans cet " "arbre. Les interactions (lire et écrire vers/depuis des fichiers) sur le " "document sont habituellement effectués au niveau de :class:`ElementTree`. " "Les interactions sur un seul élément XML et ses sous-éléments sont effectués " "au niveau de :class:`Element`." #: library/xml.etree.elementtree.rst:50 msgid "Parsing XML" msgstr "Analyse XML" #: library/xml.etree.elementtree.rst:52 msgid "" "We'll be using the following XML document as the sample data for this " "section:" msgstr "" "Nous utilisons le document XML suivant comme exemple pour cette section :" #: library/xml.etree.elementtree.rst:80 msgid "We can import this data by reading from a file::" msgstr "Nous pouvons importer cette donnée en lisant un fichier ::" #: library/xml.etree.elementtree.rst:86 msgid "Or directly from a string::" msgstr "Ou depuis une chaîne de caractères ::" #: library/xml.etree.elementtree.rst:90 msgid "" ":func:`fromstring` parses XML from a string directly into an :class:" "`Element`, which is the root element of the parsed tree. Other parsing " "functions may create an :class:`ElementTree`. Check the documentation to be " "sure." msgstr "" ":func:`fromstring` analyse le XML depuis une chaîne de caractères vers un :" "class:`Element`, ce dernier est l'élément racine de l'arbre analysé. " "D'Autres fonctions d'analyse peuvent créer un :class:`ElementTree`. " "Vérifier la documentation pour être sûr." #: library/xml.etree.elementtree.rst:94 msgid "" "As an :class:`Element`, ``root`` has a tag and a dictionary of attributes::" msgstr "" "Comme :class:`Element`, ``root`` a une balise et un dictionnaire " "d'attributs ::" #: library/xml.etree.elementtree.rst:101 msgid "It also has children nodes over which we can iterate::" msgstr "Il contient aussi des nœuds enfants que nous pouvons itérer ::" #: library/xml.etree.elementtree.rst:110 msgid "Children are nested, and we can access specific child nodes by index::" msgstr "" "Les enfants sont imbriqués et nous pouvons accéder aux nœuds enfants " "spécifiques via un index ::" #: library/xml.etree.elementtree.rst:118 msgid "" "Not all elements of the XML input will end up as elements of the parsed " "tree. Currently, this module skips over any XML comments, processing " "instructions, and document type declarations in the input. Nevertheless, " "trees built using this module's API rather than parsing from XML text can " "have comments and processing instructions in them; they will be included " "when generating XML output. A document type declaration may be accessed by " "passing a custom :class:`TreeBuilder` instance to the :class:`XMLParser` " "constructor." msgstr "" "Les éléments du XML d'entrée ne sont pas tous considérés comme des éléments " "de l'arborescence. Souvent, le module ignore les commentaires XML, les " "instructions de traitements et la déclaration du type de document dans " "l'entrée. Néanmoins, les arborescences sont construites en utilisant l'API " "du module plutôt que d'analyser depuis un texte XML qui peut contenir des " "commentaires et des instructions de traitements ; ils peuvent être inclus " "lors de la génération du XML de sortie. Le type de déclaration du document " "est accessible en passant par une instance de :class:`TreeBuilder` dans le " "constructeur de :class:`XMLParser`." #: library/xml.etree.elementtree.rst:132 msgid "Pull API for non-blocking parsing" msgstr "API à flux tiré" #: library/xml.etree.elementtree.rst:134 msgid "" "Most parsing functions provided by this module require the whole document to " "be read at once before returning any result. It is possible to use an :" "class:`XMLParser` and feed data into it incrementally, but it is a push API " "that calls methods on a callback target, which is too low-level and " "inconvenient for most needs. Sometimes what the user really wants is to be " "able to parse XML incrementally, without blocking operations, while enjoying " "the convenience of fully constructed :class:`Element` objects." msgstr "" #: library/xml.etree.elementtree.rst:142 msgid "" "The most powerful tool for doing this is :class:`XMLPullParser`. It does " "not require a blocking read to obtain the XML data, and is instead fed with " "data incrementally with :meth:`XMLPullParser.feed` calls. To get the parsed " "XML elements, call :meth:`XMLPullParser.read_events`. Here is an example::" msgstr "" #: library/xml.etree.elementtree.rst:158 msgid "" "The obvious use case is applications that operate in a non-blocking fashion " "where the XML data is being received from a socket or read incrementally " "from some storage device. In such cases, blocking reads are unacceptable." msgstr "" #: library/xml.etree.elementtree.rst:162 msgid "" "Because it's so flexible, :class:`XMLPullParser` can be inconvenient to use " "for simpler use-cases. If you don't mind your application blocking on " "reading XML data but would still like to have incremental parsing " "capabilities, take a look at :func:`iterparse`. It can be useful when " "you're reading a large XML document and don't want to hold it wholly in " "memory." msgstr "" #: library/xml.etree.elementtree.rst:169 msgid "Finding interesting elements" msgstr "Trouver les éléments d'intérêt" #: library/xml.etree.elementtree.rst:171 msgid "" ":class:`Element` has some useful methods that help iterate recursively over " "all the sub-tree below it (its children, their children, and so on). For " "example, :meth:`Element.iter`::" msgstr "" ":class:`Element` a quelques méthodes très utiles qui aident à parcourir " "récursivement tous les sous-arbres (ses enfants, leurs enfants et ainsi de " "suite). Par exemple, :meth:`Element.iter` ::" #: library/xml.etree.elementtree.rst:184 msgid "" ":meth:`Element.findall` finds only elements with a tag which are direct " "children of the current element. :meth:`Element.find` finds the *first* " "child with a particular tag, and :attr:`Element.text` accesses the element's " "text content. :meth:`Element.get` accesses the element's attributes::" msgstr "" ":meth:`Element.findall` récupère seulement les éléments avec une balise qui " "sont les descendants directs de l'élément courant. :meth:`Element.find` " "récupère le *premier* élément avec une balise particulière et :attr:`Element." "text` accède au contenu textuel de l'élément. :meth:`Element.get` accède " "aux attributs de l'élément ::" #: library/xml.etree.elementtree.rst:198 msgid "" "More sophisticated specification of which elements to look for is possible " "by using :ref:`XPath `." msgstr "" #: library/xml.etree.elementtree.rst:202 msgid "Modifying an XML File" msgstr "Modification d'un fichier XML" #: library/xml.etree.elementtree.rst:204 msgid "" ":class:`ElementTree` provides a simple way to build XML documents and write " "them to files. The :meth:`ElementTree.write` method serves this purpose." msgstr "" #: library/xml.etree.elementtree.rst:207 msgid "" "Once created, an :class:`Element` object may be manipulated by directly " "changing its fields (such as :attr:`Element.text`), adding and modifying " "attributes (:meth:`Element.set` method), as well as adding new children (for " "example with :meth:`Element.append`)." msgstr "" #: library/xml.etree.elementtree.rst:212 msgid "" "Let's say we want to add one to each country's rank, and add an ``updated`` " "attribute to the rank element::" msgstr "" #: library/xml.etree.elementtree.rst:222 library/xml.etree.elementtree.rst:266 msgid "Our XML now looks like this:" msgstr "Maintenant, notre XML ressemble à ceci :" #: library/xml.etree.elementtree.rst:250 msgid "" "We can remove elements using :meth:`Element.remove`. Let's say we want to " "remove all countries with a rank higher than 50::" msgstr "" #: library/xml.etree.elementtree.rst:261 msgid "" "Note that concurrent modification while iterating can lead to problems, just " "like when iterating and modifying Python lists or dicts. Therefore, the " "example first collects all matching elements with ``root.findall()``, and " "only then iterates over the list of matches." msgstr "" #: library/xml.etree.elementtree.rst:288 msgid "Building XML documents" msgstr "Création de documents XML" #: library/xml.etree.elementtree.rst:290 msgid "" "The :func:`SubElement` function also provides a convenient way to create new " "sub-elements for a given element::" msgstr "" #: library/xml.etree.elementtree.rst:301 msgid "Parsing XML with Namespaces" msgstr "Analyse d'un XML avec des espaces de noms" #: library/xml.etree.elementtree.rst:303 msgid "" "If the XML input has `namespaces `__, tags and attributes with prefixes in the form ``prefix:" "sometag`` get expanded to ``{uri}sometag`` where the *prefix* is replaced by " "the full *URI*. Also, if there is a `default namespace `__, that full URI gets prepended to all of the non-" "prefixed tags." msgstr "" #: library/xml.etree.elementtree.rst:311 msgid "" "Here is an XML example that incorporates two namespaces, one with the prefix " "\"fictional\" and the other serving as the default namespace:" msgstr "" #: library/xml.etree.elementtree.rst:332 msgid "" "One way to search and explore this XML example is to manually add the URI to " "every tag or attribute in the xpath of a :meth:`~Element.find` or :meth:" "`~Element.findall`::" msgstr "" #: library/xml.etree.elementtree.rst:343 msgid "" "A better way to search the namespaced XML example is to create a dictionary " "with your own prefixes and use those in the search functions::" msgstr "" #: library/xml.etree.elementtree.rst:355 msgid "These two approaches both output::" msgstr "Ces deux approches donnent le même résultat ::" #: library/xml.etree.elementtree.rst:369 msgid "XPath support" msgstr "Prise en charge de XPath" #: library/xml.etree.elementtree.rst:371 msgid "" "This module provides limited support for `XPath expressions `_ for locating elements in a tree. The goal is to support a " "small subset of the abbreviated syntax; a full XPath engine is outside the " "scope of the module." msgstr "" #: library/xml.etree.elementtree.rst:377 library/xml.etree.elementtree.rst:769 msgid "Example" msgstr "Exemple" #: library/xml.etree.elementtree.rst:379 msgid "" "Here's an example that demonstrates some of the XPath capabilities of the " "module. We'll be using the ``countrydata`` XML document from the :ref:" "`Parsing XML ` section::" msgstr "" #: library/xml.etree.elementtree.rst:403 msgid "" "For XML with namespaces, use the usual qualified ``{namespace}tag`` " "notation::" msgstr "" #: library/xml.etree.elementtree.rst:410 msgid "Supported XPath syntax" msgstr "Prise en charge de la syntaxe XPath" #: library/xml.etree.elementtree.rst:415 msgid "Syntax" msgstr "Syntaxe" #: library/xml.etree.elementtree.rst:415 msgid "Meaning" msgstr "Signification" #: library/xml.etree.elementtree.rst:417 msgid "``tag``" msgstr "``tag``" #: library/xml.etree.elementtree.rst:417 msgid "" "Selects all child elements with the given tag. For example, ``spam`` selects " "all child elements named ``spam``, and ``spam/egg`` selects all " "grandchildren named ``egg`` in all children named ``spam``. ``{namespace}" "*`` selects all tags in the given namespace, ``{*}spam`` selects tags named " "``spam`` in any (or no) namespace, and ``{}*`` only selects tags that are " "not in a namespace." msgstr "" "Sélectionne tous les éléments enfants avec une balise donnée. Par exemple, " "``spam`` sélectionne tous les éléments enfants nommés ``spam`` et ``spam/" "egg`` sélectionne tous les petits-enfants nommés ``egg`` dans les enfants " "nommés ``spam``. ``{namespace}*`` sélectionne toutes les balises dans " "l'espace de nom donné, ``{*}spam`` sélectionne les balises nommées ``spam`` " "dans n'importe quel (ou aucun) espace de nom et ``{}*`` sélectionne " "seulement les balises qui ne sont pas dans un espace de nom." #: library/xml.etree.elementtree.rst:426 msgid "Support for star-wildcards was added." msgstr "" #: library/xml.etree.elementtree.rst:429 msgid "``*``" msgstr "``*``" #: library/xml.etree.elementtree.rst:429 msgid "" "Selects all child elements, including comments and processing instructions. " "For example, ``*/egg`` selects all grandchildren named ``egg``." msgstr "" #: library/xml.etree.elementtree.rst:433 msgid "``.``" msgstr "``.``" #: library/xml.etree.elementtree.rst:433 msgid "" "Selects the current node. This is mostly useful at the beginning of the " "path, to indicate that it's a relative path." msgstr "" #: library/xml.etree.elementtree.rst:437 msgid "``//``" msgstr "``//``" #: library/xml.etree.elementtree.rst:437 msgid "" "Selects all subelements, on all levels beneath the current element. For " "example, ``.//egg`` selects all ``egg`` elements in the entire tree." msgstr "" #: library/xml.etree.elementtree.rst:441 msgid "``..``" msgstr "``..``" #: library/xml.etree.elementtree.rst:441 msgid "" "Selects the parent element. Returns ``None`` if the path attempts to reach " "the ancestors of the start element (the element ``find`` was called on)." msgstr "" #: library/xml.etree.elementtree.rst:445 msgid "``[@attrib]``" msgstr "``[@attrib]``" #: library/xml.etree.elementtree.rst:445 msgid "Selects all elements that have the given attribute." msgstr "" #: library/xml.etree.elementtree.rst:447 msgid "``[@attrib='value']``" msgstr "``[@attrib='value']``" #: library/xml.etree.elementtree.rst:447 msgid "" "Selects all elements for which the given attribute has the given value. The " "value cannot contain quotes." msgstr "" #: library/xml.etree.elementtree.rst:451 #, fuzzy msgid "``[@attrib!='value']``" msgstr "``[@attrib='value']``" #: library/xml.etree.elementtree.rst:451 msgid "" "Selects all elements for which the given attribute does not have the given " "value. The value cannot contain quotes." msgstr "" #: library/xml.etree.elementtree.rst:457 msgid "``[tag]``" msgstr "``[tag]``" #: library/xml.etree.elementtree.rst:457 msgid "" "Selects all elements that have a child named ``tag``. Only immediate " "children are supported." msgstr "" #: library/xml.etree.elementtree.rst:460 msgid "``[.='text']``" msgstr "``[.='text']``" #: library/xml.etree.elementtree.rst:460 msgid "" "Selects all elements whose complete text content, including descendants, " "equals the given ``text``." msgstr "" #: library/xml.etree.elementtree.rst:465 #, fuzzy msgid "``[.!='text']``" msgstr "``[.='text']``" #: library/xml.etree.elementtree.rst:465 msgid "" "Selects all elements whose complete text content, including descendants, " "does not equal the given ``text``." msgstr "" #: library/xml.etree.elementtree.rst:471 msgid "``[tag='text']``" msgstr "``[tag='text']``" #: library/xml.etree.elementtree.rst:471 msgid "" "Selects all elements that have a child named ``tag`` whose complete text " "content, including descendants, equals the given ``text``." msgstr "" #: library/xml.etree.elementtree.rst:475 #, fuzzy msgid "``[tag!='text']``" msgstr "``[tag='text']``" #: library/xml.etree.elementtree.rst:475 msgid "" "Selects all elements that have a child named ``tag`` whose complete text " "content, including descendants, does not equal the given ``text``." msgstr "" #: library/xml.etree.elementtree.rst:481 msgid "``[position]``" msgstr "``[position]``" #: library/xml.etree.elementtree.rst:481 msgid "" "Selects all elements that are located at the given position. The position " "can be either an integer (1 is the first position), the expression " "``last()`` (for the last position), or a position relative to the last " "position (e.g. ``last()-1``)." msgstr "" #: library/xml.etree.elementtree.rst:488 msgid "" "Predicates (expressions within square brackets) must be preceded by a tag " "name, an asterisk, or another predicate. ``position`` predicates must be " "preceded by a tag name." msgstr "" #: library/xml.etree.elementtree.rst:493 library/xml.etree.elementtree.rst:821 msgid "Reference" msgstr "Référence" #: library/xml.etree.elementtree.rst:498 library/xml.etree.elementtree.rst:826 msgid "Functions" msgstr "Fonctions" #: library/xml.etree.elementtree.rst:502 msgid "`C14N 2.0 `_ transformation function." msgstr "" "`C14N 2.0 `_ fonction de transformation." #: library/xml.etree.elementtree.rst:504 msgid "" "Canonicalization is a way to normalise XML output in a way that allows byte-" "by-byte comparisons and digital signatures. It reduced the freedom that XML " "serializers have and instead generates a more constrained XML " "representation. The main restrictions regard the placement of namespace " "declarations, the ordering of attributes, and ignorable whitespace." msgstr "" #: library/xml.etree.elementtree.rst:510 msgid "" "This function takes an XML data string (*xml_data*) or a file path or file-" "like object (*from_file*) as input, converts it to the canonical form, and " "writes it out using the *out* file(-like) object, if provided, or returns it " "as a text string if not. The output file receives text, not bytes. It " "should therefore be opened in text mode with ``utf-8`` encoding." msgstr "" #: library/xml.etree.elementtree.rst:517 #, fuzzy msgid "Typical uses::" msgstr "Usage typique ::" #: library/xml.etree.elementtree.rst:528 msgid "The configuration *options* are as follows:" msgstr "Les *options* de configuration sont les suivantes :" #: library/xml.etree.elementtree.rst:530 msgid "*with_comments*: set to true to include comments (default: false)" msgstr "" "*with_comments* : attribue à vrai pour inclure les commentaires (par " "défaut : faux)" #: library/xml.etree.elementtree.rst:531 msgid "" "*strip_text*: set to true to strip whitespace before and after text content" msgstr "" #: library/xml.etree.elementtree.rst:532 library/xml.etree.elementtree.rst:534 msgid "(default: false)" msgstr "(par défaut : faux)" #: library/xml.etree.elementtree.rst:533 msgid "" "*rewrite_prefixes*: set to true to replace namespace prefixes by " "\"n{number}\"" msgstr "" #: library/xml.etree.elementtree.rst:535 msgid "*qname_aware_tags*: a set of qname aware tag names in which prefixes" msgstr "" #: library/xml.etree.elementtree.rst:536 library/xml.etree.elementtree.rst:538 msgid "should be replaced in text content (default: empty)" msgstr "" #: library/xml.etree.elementtree.rst:537 msgid "" "*qname_aware_attrs*: a set of qname aware attribute names in which prefixes" msgstr "" #: library/xml.etree.elementtree.rst:539 msgid "*exclude_attrs*: a set of attribute names that should not be serialised" msgstr "" #: library/xml.etree.elementtree.rst:540 msgid "*exclude_tags*: a set of tag names that should not be serialised" msgstr "" #: library/xml.etree.elementtree.rst:542 msgid "" "In the option list above, \"a set\" refers to any collection or iterable of " "strings, no ordering is expected." msgstr "" #: library/xml.etree.elementtree.rst:550 msgid "" "Comment element factory. This factory function creates a special element " "that will be serialized as an XML comment by the standard serializer. The " "comment string can be either a bytestring or a Unicode string. *text* is a " "string containing the comment string. Returns an element instance " "representing a comment." msgstr "" #: library/xml.etree.elementtree.rst:556 msgid "" "Note that :class:`XMLParser` skips over comments in the input instead of " "creating comment objects for them. An :class:`ElementTree` will only contain " "comment nodes if they have been inserted into to the tree using one of the :" "class:`Element` methods." msgstr "" #: library/xml.etree.elementtree.rst:563 msgid "" "Writes an element tree or element structure to sys.stdout. This function " "should be used for debugging only." msgstr "" #: library/xml.etree.elementtree.rst:566 msgid "" "The exact output format is implementation dependent. In this version, it's " "written as an ordinary XML file." msgstr "" #: library/xml.etree.elementtree.rst:569 msgid "*elem* is an element tree or an individual element." msgstr "*elem* est un élément de l'arborescence ou un élément individuel." #: library/xml.etree.elementtree.rst:571 msgid "" "The :func:`dump` function now preserves the attribute order specified by the " "user." msgstr "" #: library/xml.etree.elementtree.rst:578 msgid "" "Parses an XML section from a string constant. Same as :func:`XML`. *text* " "is a string containing XML data. *parser* is an optional parser instance. " "If not given, the standard :class:`XMLParser` parser is used. Returns an :" "class:`Element` instance." msgstr "" #: library/xml.etree.elementtree.rst:586 msgid "" "Parses an XML document from a sequence of string fragments. *sequence* is a " "list or other sequence containing XML data fragments. *parser* is an " "optional parser instance. If not given, the standard :class:`XMLParser` " "parser is used. Returns an :class:`Element` instance." msgstr "" #: library/xml.etree.elementtree.rst:596 msgid "" "Appends whitespace to the subtree to indent the tree visually. This can be " "used to generate pretty-printed XML output. *tree* can be an Element or " "ElementTree. *space* is the whitespace string that will be inserted for " "each indentation level, two space characters by default. For indenting " "partial subtrees inside of an already indented tree, pass the initial " "indentation level as *level*." msgstr "" #: library/xml.etree.elementtree.rst:608 msgid "" "Check if an object appears to be a valid element object. *element* is an " "element instance. Return ``True`` if this is an element object." msgstr "" #: library/xml.etree.elementtree.rst:614 msgid "" "Parses an XML section into an element tree incrementally, and reports what's " "going on to the user. *source* is a filename or :term:`file object` " "containing XML data. *events* is a sequence of events to report back. The " "supported events are the strings ``\"start\"``, ``\"end\"``, " "``\"comment\"``, ``\"pi\"``, ``\"start-ns\"`` and ``\"end-ns\"`` (the \"ns\" " "events are used to get detailed namespace information). If *events* is " "omitted, only ``\"end\"`` events are reported. *parser* is an optional " "parser instance. If not given, the standard :class:`XMLParser` parser is " "used. *parser* must be a subclass of :class:`XMLParser` and can only use " "the default :class:`TreeBuilder` as a target. Returns an :term:`iterator` " "providing ``(event, elem)`` pairs." msgstr "" #: library/xml.etree.elementtree.rst:626 msgid "" "Note that while :func:`iterparse` builds the tree incrementally, it issues " "blocking reads on *source* (or the file it names). As such, it's unsuitable " "for applications where blocking reads can't be made. For fully non-blocking " "parsing, see :class:`XMLPullParser`." msgstr "" #: library/xml.etree.elementtree.rst:633 msgid "" ":func:`iterparse` only guarantees that it has seen the \">\" character of a " "starting tag when it emits a \"start\" event, so the attributes are defined, " "but the contents of the text and tail attributes are undefined at that " "point. The same applies to the element children; they may or may not be " "present." msgstr "" #: library/xml.etree.elementtree.rst:639 library/xml.etree.elementtree.rst:1469 msgid "If you need a fully populated element, look for \"end\" events instead." msgstr "" #: library/xml.etree.elementtree.rst:641 msgid "The *parser* argument." msgstr "L'argument *parser*." #: library/xml.etree.elementtree.rst:644 library/xml.etree.elementtree.rst:1473 msgid "The ``comment`` and ``pi`` events were added." msgstr "Les évènements ``comment`` et ``pi`` ont été ajoutés." #: library/xml.etree.elementtree.rst:650 msgid "" "Parses an XML section into an element tree. *source* is a filename or file " "object containing XML data. *parser* is an optional parser instance. If " "not given, the standard :class:`XMLParser` parser is used. Returns an :" "class:`ElementTree` instance." msgstr "" #: library/xml.etree.elementtree.rst:658 msgid "" "PI element factory. This factory function creates a special element that " "will be serialized as an XML processing instruction. *target* is a string " "containing the PI target. *text* is a string containing the PI contents, if " "given. Returns an element instance, representing a processing instruction." msgstr "" #: library/xml.etree.elementtree.rst:663 msgid "" "Note that :class:`XMLParser` skips over processing instructions in the input " "instead of creating comment objects for them. An :class:`ElementTree` will " "only contain processing instruction nodes if they have been inserted into to " "the tree using one of the :class:`Element` methods." msgstr "" #: library/xml.etree.elementtree.rst:671 msgid "" "Registers a namespace prefix. The registry is global, and any existing " "mapping for either the given prefix or the namespace URI will be removed. " "*prefix* is a namespace prefix. *uri* is a namespace uri. Tags and " "attributes in this namespace will be serialized with the given prefix, if at " "all possible." msgstr "" #: library/xml.etree.elementtree.rst:682 msgid "" "Subelement factory. This function creates an element instance, and appends " "it to an existing element." msgstr "" #: library/xml.etree.elementtree.rst:685 msgid "" "The element name, attribute names, and attribute values can be either " "bytestrings or Unicode strings. *parent* is the parent element. *tag* is " "the subelement name. *attrib* is an optional dictionary, containing element " "attributes. *extra* contains additional attributes, given as keyword " "arguments. Returns an element instance." msgstr "" #: library/xml.etree.elementtree.rst:696 msgid "" "Generates a string representation of an XML element, including all " "subelements. *element* is an :class:`Element` instance. *encoding* [1]_ is " "the output encoding (default is US-ASCII). Use ``encoding=\"unicode\"`` to " "generate a Unicode string (otherwise, a bytestring is generated). *method* " "is either ``\"xml\"``, ``\"html\"`` or ``\"text\"`` (default is " "``\"xml\"``). *xml_declaration*, *default_namespace* and " "*short_empty_elements* has the same meaning as in :meth:`ElementTree.write`. " "Returns an (optionally) encoded string containing the XML data." msgstr "" #: library/xml.etree.elementtree.rst:705 library/xml.etree.elementtree.rst:732 #: library/xml.etree.elementtree.rst:1181 msgid "The *short_empty_elements* parameter." msgstr "Le paramètre *short_empty_elements*." #: library/xml.etree.elementtree.rst:708 library/xml.etree.elementtree.rst:735 msgid "The *xml_declaration* and *default_namespace* parameters." msgstr "Les paramètres *xml_declaration* et *default_namespace*." #: library/xml.etree.elementtree.rst:711 msgid "" "The :func:`tostring` function now preserves the attribute order specified by " "the user." msgstr "" #: library/xml.etree.elementtree.rst:720 msgid "" "Generates a string representation of an XML element, including all " "subelements. *element* is an :class:`Element` instance. *encoding* [1]_ is " "the output encoding (default is US-ASCII). Use ``encoding=\"unicode\"`` to " "generate a Unicode string (otherwise, a bytestring is generated). *method* " "is either ``\"xml\"``, ``\"html\"`` or ``\"text\"`` (default is " "``\"xml\"``). *xml_declaration*, *default_namespace* and " "*short_empty_elements* has the same meaning as in :meth:`ElementTree.write`. " "Returns a list of (optionally) encoded strings containing the XML data. It " "does not guarantee any specific sequence, except that ``b\"\"." "join(tostringlist(element)) == tostring(element)``." msgstr "" #: library/xml.etree.elementtree.rst:738 msgid "" "The :func:`tostringlist` function now preserves the attribute order " "specified by the user." msgstr "" #: library/xml.etree.elementtree.rst:745 msgid "" "Parses an XML section from a string constant. This function can be used to " "embed \"XML literals\" in Python code. *text* is a string containing XML " "data. *parser* is an optional parser instance. If not given, the standard :" "class:`XMLParser` parser is used. Returns an :class:`Element` instance." msgstr "" #: library/xml.etree.elementtree.rst:753 msgid "" "Parses an XML section from a string constant, and also returns a dictionary " "which maps from element id:s to elements. *text* is a string containing XML " "data. *parser* is an optional parser instance. If not given, the standard :" "class:`XMLParser` parser is used. Returns a tuple containing an :class:" "`Element` instance and a dictionary." msgstr "" #: library/xml.etree.elementtree.rst:763 msgid "XInclude support" msgstr "Prise en charge de XInclude" #: library/xml.etree.elementtree.rst:765 msgid "" "This module provides limited support for `XInclude directives `_, via the :mod:`xml.etree.ElementInclude` helper " "module. This module can be used to insert subtrees and text strings into " "element trees, based on information in the tree." msgstr "" #: library/xml.etree.elementtree.rst:771 msgid "" "Here's an example that demonstrates use of the XInclude module. To include " "an XML document in the current document, use the ``{http://www.w3.org/2001/" "XInclude}include`` element and set the **parse** attribute to ``\"xml\"``, " "and use the **href** attribute to specify the document to include." msgstr "" #: library/xml.etree.elementtree.rst:780 msgid "" "By default, the **href** attribute is treated as a file name. You can use " "custom loaders to override this behaviour. Also note that the standard " "helper does not support XPointer syntax." msgstr "" #: library/xml.etree.elementtree.rst:782 msgid "" "To process this file, load it as usual, and pass the root element to the :" "mod:`xml.etree.ElementTree` module:" msgstr "" #: library/xml.etree.elementtree.rst:793 msgid "" "The ElementInclude module replaces the ``{http://www.w3.org/2001/XInclude}" "include`` element with the root element from the **source.xml** document. " "The result might look something like this:" msgstr "" #: library/xml.etree.elementtree.rst:801 msgid "" "If the **parse** attribute is omitted, it defaults to \"xml\". The href " "attribute is required." msgstr "" #: library/xml.etree.elementtree.rst:803 msgid "" "To include a text document, use the ``{http://www.w3.org/2001/XInclude}" "include`` element, and set the **parse** attribute to \"text\":" msgstr "" #: library/xml.etree.elementtree.rst:812 msgid "The result might look something like:" msgstr "" #: library/xml.etree.elementtree.rst:831 msgid "" "Default loader. This default loader reads an included resource from disk. " "*href* is a URL. *parse* is for parse mode either \"xml\" or \"text\". " "*encoding* is an optional text encoding. If not given, encoding is " "``utf-8``. Returns the expanded resource. If the parse mode is " "``\"xml\"``, this is an ElementTree instance. If the parse mode is " "\"text\", this is a Unicode string. If the loader fails, it can return None " "or raise an exception." msgstr "" #: library/xml.etree.elementtree.rst:843 msgid "" "This function expands XInclude directives. *elem* is the root element. " "*loader* is an optional resource loader. If omitted, it defaults to :func:" "`default_loader`. If given, it should be a callable that implements the same " "interface as :func:`default_loader`. *base_url* is base URL of the original " "file, to resolve relative include file references. *max_depth* is the " "maximum number of recursive inclusions. Limited to reduce the risk of " "malicious content explosion. Pass a negative value to disable the limitation." msgstr "" #: library/xml.etree.elementtree.rst:851 msgid "" "Returns the expanded resource. If the parse mode is ``\"xml\"``, this is an " "ElementTree instance. If the parse mode is \"text\", this is a Unicode " "string. If the loader fails, it can return None or raise an exception." msgstr "" #: library/xml.etree.elementtree.rst:856 msgid "The *base_url* and *max_depth* parameters." msgstr "Les paramètres *base_url* et *max_depth*." #: library/xml.etree.elementtree.rst:863 msgid "Element Objects" msgstr "Objets Element" #: library/xml.etree.elementtree.rst:867 msgid "" "Element class. This class defines the Element interface, and provides a " "reference implementation of this interface." msgstr "" "Classe Element. Cette classe définit l'interface Element et fournit une " "implémentation de référence de cette interface." #: library/xml.etree.elementtree.rst:870 msgid "" "The element name, attribute names, and attribute values can be either " "bytestrings or Unicode strings. *tag* is the element name. *attrib* is an " "optional dictionary, containing element attributes. *extra* contains " "additional attributes, given as keyword arguments." msgstr "" #: library/xml.etree.elementtree.rst:878 msgid "" "A string identifying what kind of data this element represents (the element " "type, in other words)." msgstr "" #: library/xml.etree.elementtree.rst:885 msgid "" "These attributes can be used to hold additional data associated with the " "element. Their values are usually strings but may be any application-" "specific object. If the element is created from an XML file, the *text* " "attribute holds either the text between the element's start tag and its " "first child or end tag, or ``None``, and the *tail* attribute holds either " "the text between the element's end tag and the next tag, or ``None``. For " "the XML data" msgstr "" #: library/xml.etree.elementtree.rst:897 msgid "" "the *a* element has ``None`` for both *text* and *tail* attributes, the *b* " "element has *text* ``\"1\"`` and *tail* ``\"4\"``, the *c* element has " "*text* ``\"2\"`` and *tail* ``None``, and the *d* element has *text* " "``None`` and *tail* ``\"3\"``." msgstr "" #: library/xml.etree.elementtree.rst:902 msgid "" "To collect the inner text of an element, see :meth:`itertext`, for example " "``\"\".join(element.itertext())``." msgstr "" #: library/xml.etree.elementtree.rst:905 msgid "Applications may store arbitrary objects in these attributes." msgstr "" #: library/xml.etree.elementtree.rst:910 msgid "" "A dictionary containing the element's attributes. Note that while the " "*attrib* value is always a real mutable Python dictionary, an ElementTree " "implementation may choose to use another internal representation, and create " "the dictionary only if someone asks for it. To take advantage of such " "implementations, use the dictionary methods below whenever possible." msgstr "" #: library/xml.etree.elementtree.rst:916 msgid "The following dictionary-like methods work on the element attributes." msgstr "" "Les méthodes dictionnaire-compatibles suivantes traitent les attributs de " "l'élément." #: library/xml.etree.elementtree.rst:921 msgid "" "Resets an element. This function removes all subelements, clears all " "attributes, and sets the text and tail attributes to ``None``." msgstr "" #: library/xml.etree.elementtree.rst:927 msgid "Gets the element attribute named *key*." msgstr "Accède à l'attribut de l'élément nommé *key*." #: library/xml.etree.elementtree.rst:929 msgid "" "Returns the attribute value, or *default* if the attribute was not found." msgstr "" "Renvoie la valeur de l'attribut ou *default* si l'attribut n'a pas été " "trouvé." #: library/xml.etree.elementtree.rst:934 msgid "" "Returns the element attributes as a sequence of (name, value) pairs. The " "attributes are returned in an arbitrary order." msgstr "" "Renvoie les attributs de l'élément comme une séquence de paire (nom, " "valeur). Les attributs sont renvoyés un l'ordre arbitraire." #: library/xml.etree.elementtree.rst:940 msgid "" "Returns the elements attribute names as a list. The names are returned in " "an arbitrary order." msgstr "" #: library/xml.etree.elementtree.rst:946 msgid "Set the attribute *key* on the element to *value*." msgstr "Change l'attribut *key* à l'élément *value*." #: library/xml.etree.elementtree.rst:948 msgid "The following methods work on the element's children (subelements)." msgstr "Les méthodes suivantes traitent les éléments enfants (sous-éléments)." #: library/xml.etree.elementtree.rst:953 msgid "" "Adds the element *subelement* to the end of this element's internal list of " "subelements. Raises :exc:`TypeError` if *subelement* is not an :class:" "`Element`." msgstr "" #: library/xml.etree.elementtree.rst:960 msgid "" "Appends *subelements* from a sequence object with zero or more elements. " "Raises :exc:`TypeError` if a subelement is not an :class:`Element`." msgstr "" #: library/xml.etree.elementtree.rst:968 msgid "" "Finds the first subelement matching *match*. *match* may be a tag name or " "a :ref:`path `. Returns an element instance or " "``None``. *namespaces* is an optional mapping from namespace prefix to full " "name. Pass ``''`` as prefix to move all unprefixed tag names in the " "expression into the given namespace." msgstr "" #: library/xml.etree.elementtree.rst:977 msgid "" "Finds all matching subelements, by tag name or :ref:`path `. Returns a list containing all matching elements in document " "order. *namespaces* is an optional mapping from namespace prefix to full " "name. Pass ``''`` as prefix to move all unprefixed tag names in the " "expression into the given namespace." msgstr "" #: library/xml.etree.elementtree.rst:986 msgid "" "Finds text for the first subelement matching *match*. *match* may be a tag " "name or a :ref:`path `. Returns the text content of the " "first matching element, or *default* if no element was found. Note that if " "the matching element has no text content an empty string is returned. " "*namespaces* is an optional mapping from namespace prefix to full name. " "Pass ``''`` as prefix to move all unprefixed tag names in the expression " "into the given namespace." msgstr "" #: library/xml.etree.elementtree.rst:997 msgid "" "Inserts *subelement* at the given position in this element. Raises :exc:" "`TypeError` if *subelement* is not an :class:`Element`." msgstr "" #: library/xml.etree.elementtree.rst:1003 msgid "" "Creates a tree :term:`iterator` with the current element as the root. The " "iterator iterates over this element and all elements below it, in document " "(depth first) order. If *tag* is not ``None`` or ``'*'``, only elements " "whose tag equals *tag* are returned from the iterator. If the tree " "structure is modified during iteration, the result is undefined." msgstr "" #: library/xml.etree.elementtree.rst:1014 msgid "" "Finds all matching subelements, by tag name or :ref:`path `. Returns an iterable yielding all matching elements in document " "order. *namespaces* is an optional mapping from namespace prefix to full " "name." msgstr "" #: library/xml.etree.elementtree.rst:1025 msgid "" "Creates a text iterator. The iterator loops over this element and all " "subelements, in document order, and returns all inner text." msgstr "" #: library/xml.etree.elementtree.rst:1033 msgid "" "Creates a new element object of the same type as this element. Do not call " "this method, use the :func:`SubElement` factory function instead." msgstr "" #: library/xml.etree.elementtree.rst:1039 msgid "" "Removes *subelement* from the element. Unlike the find\\* methods this " "method compares elements based on the instance identity, not on tag value or " "contents." msgstr "" #: library/xml.etree.elementtree.rst:1043 msgid "" ":class:`Element` objects also support the following sequence type methods " "for working with subelements: :meth:`~object.__delitem__`, :meth:`~object." "__getitem__`, :meth:`~object.__setitem__`, :meth:`~object.__len__`." msgstr "" #: library/xml.etree.elementtree.rst:1048 msgid "" "Caution: Elements with no subelements will test as ``False``. This behavior " "will change in future versions. Use specific ``len(elem)`` or ``elem is " "None`` test instead. ::" msgstr "" #: library/xml.etree.elementtree.rst:1060 msgid "" "Prior to Python 3.8, the serialisation order of the XML attributes of " "elements was artificially made predictable by sorting the attributes by " "their name. Based on the now guaranteed ordering of dicts, this arbitrary " "reordering was removed in Python 3.8 to preserve the order in which " "attributes were originally parsed or created by user code." msgstr "" #: library/xml.etree.elementtree.rst:1066 msgid "" "In general, user code should try not to depend on a specific ordering of " "attributes, given that the `XML Information Set `_ explicitly excludes the attribute order from conveying " "information. Code should be prepared to deal with any ordering on input. In " "cases where deterministic XML output is required, e.g. for cryptographic " "signing or test data sets, canonical serialisation is available with the :" "func:`canonicalize` function." msgstr "" #: library/xml.etree.elementtree.rst:1074 msgid "" "In cases where canonical output is not applicable but a specific attribute " "order is still desirable on output, code should aim for creating the " "attributes directly in the desired order, to avoid perceptual mismatches for " "readers of the code. In cases where this is difficult to achieve, a recipe " "like the following can be applied prior to serialisation to enforce an order " "independently from the Element creation::" msgstr "" #: library/xml.etree.elementtree.rst:1094 msgid "ElementTree Objects" msgstr "Objets ElementTree" #: library/xml.etree.elementtree.rst:1099 msgid "" "ElementTree wrapper class. This class represents an entire element " "hierarchy, and adds some extra support for serialization to and from " "standard XML." msgstr "" #: library/xml.etree.elementtree.rst:1103 msgid "" "*element* is the root element. The tree is initialized with the contents of " "the XML *file* if given." msgstr "" #: library/xml.etree.elementtree.rst:1109 msgid "" "Replaces the root element for this tree. This discards the current contents " "of the tree, and replaces it with the given element. Use with care. " "*element* is an element instance." msgstr "" #: library/xml.etree.elementtree.rst:1116 msgid "Same as :meth:`Element.find`, starting at the root of the tree." msgstr "Comme :meth:`Element.find`, commence à la racine de l'arbre." #: library/xml.etree.elementtree.rst:1121 msgid "Same as :meth:`Element.findall`, starting at the root of the tree." msgstr "" #: library/xml.etree.elementtree.rst:1126 msgid "Same as :meth:`Element.findtext`, starting at the root of the tree." msgstr "" #: library/xml.etree.elementtree.rst:1131 msgid "Returns the root element for this tree." msgstr "Renvoie l'élément racine de l'arbre." #: library/xml.etree.elementtree.rst:1136 msgid "" "Creates and returns a tree iterator for the root element. The iterator " "loops over all elements in this tree, in section order. *tag* is the tag to " "look for (default is to return all elements)." msgstr "" #: library/xml.etree.elementtree.rst:1143 msgid "Same as :meth:`Element.iterfind`, starting at the root of the tree." msgstr "" #: library/xml.etree.elementtree.rst:1150 msgid "" "Loads an external XML section into this element tree. *source* is a file " "name or :term:`file object`. *parser* is an optional parser instance. If " "not given, the standard :class:`XMLParser` parser is used. Returns the " "section root element." msgstr "" #: library/xml.etree.elementtree.rst:1160 msgid "" "Writes the element tree to a file, as XML. *file* is a file name, or a :" "term:`file object` opened for writing. *encoding* [1]_ is the output " "encoding (default is US-ASCII). *xml_declaration* controls if an XML " "declaration should be added to the file. Use ``False`` for never, ``True`` " "for always, ``None`` for only if not US-ASCII or UTF-8 or Unicode (default " "is ``None``). *default_namespace* sets the default XML namespace (for " "\"xmlns\"). *method* is either ``\"xml\"``, ``\"html\"`` or ``\"text\"`` " "(default is ``\"xml\"``). The keyword-only *short_empty_elements* parameter " "controls the formatting of elements that contain no content. If ``True`` " "(the default), they are emitted as a single self-closed tag, otherwise they " "are emitted as a pair of start/end tags." msgstr "" #: library/xml.etree.elementtree.rst:1174 msgid "" "The output is either a string (:class:`str`) or binary (:class:`bytes`). " "This is controlled by the *encoding* argument. If *encoding* is " "``\"unicode\"``, the output is a string; otherwise, it's binary. Note that " "this may conflict with the type of *file* if it's an open :term:`file " "object`; make sure you do not try to write a string to a binary stream and " "vice versa." msgstr "" #: library/xml.etree.elementtree.rst:1184 msgid "" "The :meth:`write` method now preserves the attribute order specified by the " "user." msgstr "" #: library/xml.etree.elementtree.rst:1189 msgid "This is the XML file that is going to be manipulated::" msgstr "" #: library/xml.etree.elementtree.rst:1201 msgid "" "Example of changing the attribute \"target\" of every link in first " "paragraph::" msgstr "" #: library/xml.etree.elementtree.rst:1220 msgid "QName Objects" msgstr "Objets QName" #: library/xml.etree.elementtree.rst:1225 msgid "" "QName wrapper. This can be used to wrap a QName attribute value, in order " "to get proper namespace handling on output. *text_or_uri* is a string " "containing the QName value, in the form {uri}local, or, if the tag argument " "is given, the URI part of a QName. If *tag* is given, the first argument is " "interpreted as a URI, and this argument is interpreted as a local name. :" "class:`QName` instances are opaque." msgstr "" #: library/xml.etree.elementtree.rst:1237 msgid "TreeBuilder Objects" msgstr "Objets TreeBuilder" #: library/xml.etree.elementtree.rst:1243 msgid "" "Generic element structure builder. This builder converts a sequence of " "start, data, end, comment and pi method calls to a well-formed element " "structure. You can use this class to build an element structure using a " "custom XML parser, or a parser for some other XML-like format." msgstr "" #: library/xml.etree.elementtree.rst:1248 msgid "" "*element_factory*, when given, must be a callable accepting two positional " "arguments: a tag and a dict of attributes. It is expected to return a new " "element instance." msgstr "" #: library/xml.etree.elementtree.rst:1252 msgid "" "The *comment_factory* and *pi_factory* functions, when given, should behave " "like the :func:`Comment` and :func:`ProcessingInstruction` functions to " "create comments and processing instructions. When not given, the default " "factories will be used. When *insert_comments* and/or *insert_pis* is true, " "comments/pis will be inserted into the tree if they appear within the root " "element (but not outside of it)." msgstr "" #: library/xml.etree.elementtree.rst:1261 msgid "" "Flushes the builder buffers, and returns the toplevel document element. " "Returns an :class:`Element` instance." msgstr "" #: library/xml.etree.elementtree.rst:1267 msgid "" "Adds text to the current element. *data* is a string. This should be " "either a bytestring, or a Unicode string." msgstr "" "Ajoute du texte à l'élément courant. *data* est une chaîne de caractères. " "Cela peut être une chaîne d'octets ou une chaîne Unicode." #: library/xml.etree.elementtree.rst:1273 msgid "" "Closes the current element. *tag* is the element name. Returns the closed " "element." msgstr "" "Ferme l'élément courant. *tag* est le nom de l'élément. Renvoie l'élément " "fermé." #: library/xml.etree.elementtree.rst:1279 msgid "" "Opens a new element. *tag* is the element name. *attrs* is a dictionary " "containing element attributes. Returns the opened element." msgstr "" #: library/xml.etree.elementtree.rst:1285 msgid "" "Creates a comment with the given *text*. If ``insert_comments`` is true, " "this will also add it to the tree." msgstr "" #: library/xml.etree.elementtree.rst:1293 msgid "" "Creates a comment with the given *target* name and *text*. If " "``insert_pis`` is true, this will also add it to the tree." msgstr "" #: library/xml.etree.elementtree.rst:1299 msgid "" "In addition, a custom :class:`TreeBuilder` object can provide the following " "methods:" msgstr "" #: library/xml.etree.elementtree.rst:1304 msgid "" "Handles a doctype declaration. *name* is the doctype name. *pubid* is the " "public identifier. *system* is the system identifier. This method does not " "exist on the default :class:`TreeBuilder` class." msgstr "" #: library/xml.etree.elementtree.rst:1312 msgid "" "Is called whenever the parser encounters a new namespace declaration, before " "the ``start()`` callback for the opening element that defines it. *prefix* " "is ``''`` for the default namespace and the declared namespace prefix name " "otherwise. *uri* is the namespace URI." msgstr "" #: library/xml.etree.elementtree.rst:1321 msgid "" "Is called after the ``end()`` callback of an element that declared a " "namespace prefix mapping, with the name of the *prefix* that went out of " "scope." msgstr "" #: library/xml.etree.elementtree.rst:1333 msgid "" "A `C14N 2.0 `_ writer. Arguments are the " "same as for the :func:`canonicalize` function. This class does not build a " "tree but translates the callback events directly into a serialised form " "using the *write* function." msgstr "" #: library/xml.etree.elementtree.rst:1344 msgid "XMLParser Objects" msgstr "Objets XMLParser" #: library/xml.etree.elementtree.rst:1349 msgid "" "This class is the low-level building block of the module. It uses :mod:`xml." "parsers.expat` for efficient, event-based parsing of XML. It can be fed XML " "data incrementally with the :meth:`feed` method, and parsing events are " "translated to a push API - by invoking callbacks on the *target* object. If " "*target* is omitted, the standard :class:`TreeBuilder` is used. If " "*encoding* [1]_ is given, the value overrides the encoding specified in the " "XML file." msgstr "" #: library/xml.etree.elementtree.rst:1357 msgid "" "Parameters are now :ref:`keyword-only `. The *html* " "argument no longer supported." msgstr "" #: library/xml.etree.elementtree.rst:1364 msgid "" "Finishes feeding data to the parser. Returns the result of calling the " "``close()`` method of the *target* passed during construction; by default, " "this is the toplevel document element." msgstr "" #: library/xml.etree.elementtree.rst:1371 msgid "Feeds data to the parser. *data* is encoded data." msgstr "" #: library/xml.etree.elementtree.rst:1373 msgid "" ":meth:`XMLParser.feed` calls *target*\\'s ``start(tag, attrs_dict)`` method " "for each opening tag, its ``end(tag)`` method for each closing tag, and data " "is processed by method ``data(data)``. For further supported callback " "methods, see the :class:`TreeBuilder` class. :meth:`XMLParser.close` calls " "*target*\\'s method ``close()``. :class:`XMLParser` can be used not only for " "building a tree structure. This is an example of counting the maximum depth " "of an XML file::" msgstr "" #: library/xml.etree.elementtree.rst:1417 msgid "XMLPullParser Objects" msgstr "Objets XMLPullParser" #: library/xml.etree.elementtree.rst:1421 msgid "" "A pull parser suitable for non-blocking applications. Its input-side API is " "similar to that of :class:`XMLParser`, but instead of pushing calls to a " "callback target, :class:`XMLPullParser` collects an internal list of parsing " "events and lets the user read from it. *events* is a sequence of events to " "report back. The supported events are the strings ``\"start\"``, " "``\"end\"``, ``\"comment\"``, ``\"pi\"``, ``\"start-ns\"`` and ``\"end-" "ns\"`` (the \"ns\" events are used to get detailed namespace information). " "If *events* is omitted, only ``\"end\"`` events are reported." msgstr "" #: library/xml.etree.elementtree.rst:1432 msgid "Feed the given bytes data to the parser." msgstr "" #: library/xml.etree.elementtree.rst:1436 msgid "" "Signal the parser that the data stream is terminated. Unlike :meth:" "`XMLParser.close`, this method always returns :const:`None`. Any events not " "yet retrieved when the parser is closed can still be read with :meth:" "`read_events`." msgstr "" #: library/xml.etree.elementtree.rst:1443 msgid "" "Return an iterator over the events which have been encountered in the data " "fed to the parser. The iterator yields ``(event, elem)`` pairs, where " "*event* is a string representing the type of event (e.g. ``\"end\"``) and " "*elem* is the encountered :class:`Element` object, or other context value as " "follows." msgstr "" #: library/xml.etree.elementtree.rst:1449 msgid "``start``, ``end``: the current Element." msgstr "" #: library/xml.etree.elementtree.rst:1450 msgid "``comment``, ``pi``: the current comment / processing instruction" msgstr "" #: library/xml.etree.elementtree.rst:1451 msgid "" "``start-ns``: a tuple ``(prefix, uri)`` naming the declared namespace " "mapping." msgstr "" #: library/xml.etree.elementtree.rst:1453 msgid "``end-ns``: :const:`None` (this may change in a future version)" msgstr "" #: library/xml.etree.elementtree.rst:1455 msgid "" "Events provided in a previous call to :meth:`read_events` will not be " "yielded again. Events are consumed from the internal queue only when they " "are retrieved from the iterator, so multiple readers iterating in parallel " "over iterators obtained from :meth:`read_events` will have unpredictable " "results." msgstr "" #: library/xml.etree.elementtree.rst:1463 msgid "" ":class:`XMLPullParser` only guarantees that it has seen the \">\" character " "of a starting tag when it emits a \"start\" event, so the attributes are " "defined, but the contents of the text and tail attributes are undefined at " "that point. The same applies to the element children; they may or may not " "be present." msgstr "" #: library/xml.etree.elementtree.rst:1478 msgid "Exceptions" msgstr "Exceptions" #: library/xml.etree.elementtree.rst:1482 msgid "" "XML parse error, raised by the various parsing methods in this module when " "parsing fails. The string representation of an instance of this exception " "will contain a user-friendly error message. In addition, it will have the " "following attributes available:" msgstr "" #: library/xml.etree.elementtree.rst:1489 msgid "" "A numeric error code from the expat parser. See the documentation of :mod:" "`xml.parsers.expat` for the list of error codes and their meanings." msgstr "" #: library/xml.etree.elementtree.rst:1494 msgid "" "A tuple of *line*, *column* numbers, specifying where the error occurred." msgstr "" "Un *n*-uplet de numéro de *ligne*, de *colonne* indiquant le lieu " "d'apparition de l'erreur." #: library/xml.etree.elementtree.rst:1497 msgid "Footnotes" msgstr "Notes" #: library/xml.etree.elementtree.rst:1498 msgid "" "The encoding string included in XML output should conform to the appropriate " "standards. For example, \"UTF-8\" is valid, but \"UTF8\" is not. See " "https://www.w3.org/TR/2006/REC-xml11-20060816/#NT-EncodingDecl and https://" "www.iana.org/assignments/character-sets/character-sets.xhtml." msgstr "" "La chaîne de caractères encodée inclue dans la sortie XML doit être conforme " "aux standards. Par exemple, « UTF-8 » est valide, mais pas « UTF8 ». Voir " "https://www.w3.org/TR/2006/REC-xml11-20060816/#NT-EncodingDecl et https://" "www.iana.org/assignments/character-sets/character-sets.xhtml."