summaryrefslogtreecommitdiffstats
path: root/Doc/library/xml.etree.elementtree.rst
Commit message (Collapse)AuthorAgeFilesLines
* Fix typo in XMLParser doc (#124129)Jacob Walls2024-09-201-1/+1
|
* gh-123213: Fixed xml.etree.ElementTree.Element.extend and assignment to no ↵Bar Harel2024-08-231-1/+1
| | | | longer hide exceptions (GH-123214)
* Docs: Fix duplicate object description warnings (#122068)Adam Turner2024-07-201-0/+1
|
* Fix typo in ElementTree docs (#120342)naglis2024-06-111-1/+1
|
* gh-119577: Adjust DeprecationWarning when testing element truth values in ↵Jacob Walls2024-06-071-3/+4
| | | | | ElementTree (GH-119762) Adjust DeprecationWarning when testing element truth values in ElementTree, we're planning to go with the more natural True return rather than a disruptive harder to code around exception raise, and are deferring the behavior change for a few more releases.
* docs: module page titles should not start with a link to themselves (#117099)Ned Batchelder2024-05-081-2/+2
|
* gh-101549: fix documentation of xml.etree.ElementInclude (#101550)Mikhail B2024-04-111-20/+15
| | | | | Co-authored-by: Serhiy Storchaka <storchaka@gmail.com> Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
* Docs: specify XML document name in xml.etree.elementtree example (#24223)Moshe Kaplan2024-04-011-1/+1
|
* gh-115398: Suggest use of `hasattr` with checking for 3.13 Expat API ↵Sebastian Pipping2024-03-061-0/+10
| | | | | availability (GH-116278) Suggest use of "hasattr" with checking for 3.13 Expat API availability
* gh-115398: Expose Expat >=2.6.0 reparse deferral API (CVE-2023-52425) ↵Sebastian Pipping2024-02-291-0/+29
| | | | | | | | | | | | | | | | | | | | | (GH-115623) Allow controlling Expat >=2.6.0 reparse deferral (CVE-2023-52425) by adding five new methods: - `xml.etree.ElementTree.XMLParser.flush` - `xml.etree.ElementTree.XMLPullParser.flush` - `xml.parsers.expat.xmlparser.GetReparseDeferralEnabled` - `xml.parsers.expat.xmlparser.SetReparseDeferralEnabled` - `xml.sax.expatreader.ExpatParser.flush` Based on the "flush" idea from https://github.com/python/cpython/pull/115138#issuecomment-1932444270 . ### Notes - Please treat as a security fix related to CVE-2023-52425. Includes code suggested-by: Snild Dolkow <snild@sony.com> and by core dev Serhiy Storchaka.
* gh-69893: Add the close() method for xml.etree.ElementTree.iterparse() ↵Serhiy Storchaka2024-02-041-0/+5
| | | | iterator (GH-114534)
* Fix typos in ElementTree documentation (GH-108848)Christophe Nanteuil2024-02-011-3/+3
| | | PI objects instead of comment objects.
* Docs: align usage of versionadded/versionchanged with recommended practice ↵Erlend E. Aasland2024-01-221-12/+12
| | | | | | (#114409) Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM> Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
* gh-93607: document `root` attribute of `iterparse` (#99410)Prometheus33752023-10-311-1/+3
| | | | | Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com> Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
* typo: missing line of output in pull parser example (#111068)Don Patterson2023-10-231-0/+1
|
* gh-101100: Fix sphinx warnings in `Doc/library/xml.etree.elementtree.rst` ↵Nikita Sobolev2023-09-241-1/+6
| | | | | (#109799) gh-101100: Fix shpinx warnings in `Doc/library/xml.etree.elementtree.rst`
* gh-83122: Deprecate testing element truth values in `ElementTree` (#31149)Jacob Walls2023-01-231-3/+6
| | | | | | | When testing element truth values, emit a DeprecationWarning in all implementations. This had emitted a FutureWarning in the rarely used python-only implementation since ~2.7 and has always been documented as a behavior not to rely on. Matching an element in a tree search but having it test False can be unexpected. Raising the warning enables making the choice to finally raise an exception for this ambiguous behavior in the future.
* gh-99087: Add missing newline for prompts in docs (GH-98993)Stanley2022-12-091-0/+1
| | | Add newline for prompts so copying to REPL does not cause errors.
* bpo-46879: Fix incorrect sphinx object names in doc (GH-31615)Martin Fischer2022-05-191-0/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | API members documented in sphinx have an object name, which allow the documentation to be linked from other projects. Sphinx calculates the object name by prefixing the current module name to the directive argument, e.g: .. module:: foo .. function:: bar.baz becomes foo.bar.baz. Since these anchors aren't displayed in the documentation, some mistakes have crept in, namely the Python stdlib documentation currently contains the objects: * asyncio.asyncio.subprocess.DEVNULL * asyncio.asyncio.subprocess.PIPE * asyncio.asyncio.subprocess.STDOUT * asyncio.asyncio.subprocess.Process * multiprocessing.sharedctypes.multiprocessing.Manager * xml.etree.ElementTree.xml.etree.ElementInclude This commit fixes this by making use of the :module: option which without an argument makes sphinx take the directive argument as is for the object name (avoiding the prefixing of the current module name that led to these broken object names). Co-authored-by: Łukasz Langa <lukasz@langa.pl>
* Remove effbot urls (GH-26308)E-Paine2021-05-221-7/+0
|
* bpo-40624: Add support for the XPath != operator in xml.etree (GH-22147)Ammar Askar2020-11-091-0/+18
|
* bpo-41892: Clarify that an example in the ElementTree docs explicitly avoids ↵scoder2020-10-041-0/+6
| | | | modifying an XML tree while iterating over it. (GH-22464)
* bpo-36543: Revert "bpo-36543: Remove the xml.etree.cElementTree module." ↵Serhiy Storchaka2020-06-101-0/+2
| | | | | | | (GH-20117) * Revert "bpo-36543: Remove the xml.etree.cElementTree module. (GH-19108)" This reverts commit b33e52511a59c6da7132c226b7f7489b092a33eb.
* bpo-33187: Document 3.9 changes to xml.etree.ElementInclude.include (GH-20438)Shantanu2020-06-081-2/+11
| | | | Looks like the merging of bpo-33187 and bpo-20928 was racy, resulting in this change going undocumented.
* bpo-38738: Fix formatting of True and False. (GH-17083)Serhiy Storchaka2019-11-121-2/+2
| | | | | | | | | * "Return true/false" is replaced with "Return ``True``/``False``" if the function actually returns a bool. * Fixed formatting of some True and False literals (now in monospace). * Replaced "True/False" with "true/false" if it can be not only bool. * Replaced some 1/0 with True/False if it corresponds the code. * "Returns <bool>" is replaced with "Return <bool>".
* bpo-33187: Document ElementInclude (XInclude) support in ElementTree (GH-8861)Anjali Bansal2019-09-111-0/+89
|
* bpo-36543: Remove old-deprecated ElementTree features. (GH-12707)Serhiy Storchaka2019-09-011-18/+0
| | | | | Remove methods Element.getchildren(), Element.getiterator() and ElementTree.getiterator() and the xml.etree.cElementTree module.
* bpo-14465: Add an indent() function to xml.etree.ElementTree to pretty-print ↵Stefan Behnel2019-08-231-0/+12
| | | | XML trees (GH-15200)
* bpo-34160: explain how to deal with attribute order in ElementTree (GH-14867)Stefan Behnel2019-07-241-2/+40
| | | | | | | * Fix the formatting in the documentation of the tostring() functions. * bpo-34160: Document that the tostring() and tostringlist() functions also preserve the attribute order now. * bpo-34160: Add an explanation of how users should deal with the attribute order.
* bpo-28238: Implement "{*}tag" and "{ns}*" wildcard tag selection support for ↵Stefan Behnel2019-05-031-2/+15
| | | | ElementPath, and extend the surrounding tests and docs. (GH-12997)
* bpo-13611: C14N 2.0 implementation for ElementTree (GH-12966)Stefan Behnel2019-05-011-0/+60
| | | | | | | * Implement C14N 2.0 as a new canonicalize() function in ElementTree. Missing features: - prefix renaming in XPath expressions (tag and attribute text is supported) - preservation of original prefixes given redundant namespace declarations
* bpo-36676: Namespace prefix aware parsing support for the ET.XMLParser ↵Stefan Behnel2019-05-011-2/+20
| | | | | target (GH-12885) * bpo-36676: Implement namespace prefix aware parsing support for the XMLParser target in ElementTree.
* bpo-36673: Implement comment/PI parsing support for the TreeBuilder in ↵Stefan Behnel2019-05-011-12/+53
| | | | | | | | ElementTree. (#12883) * bpo-36673: Implement comment/PI parsing support for the TreeBuilder in ElementTree. * bpo-36673: Rewrite the comment/PI factory handling for the TreeBuilder in "_elementtree" to make it use the same factories as the ElementTree module, and to make it explicit when the comments/PIs are inserted into the tree and when they are not (which is the default).
* bpo-30485: Change the prefix for defining the default namespace in ↵Stefan Behnel2019-04-181-3/+3
| | | | ElementPath from None to '' since there is existing code that uses that and it's more convenient to have an all-string-keys dict (e.g. when sorting items etc.). (#12860)
* bpo-30485: support a default prefix mapping in ElementPath by passing None ↵Stefan Behnel2019-04-141-3/+6
| | | | as prefix (#1823)
* bpo-36227: ElementTree.tostring() default_namespace and xml_declaration ↵Bernt Røskar Brenna2019-04-141-6/+15
| | | | | arguments (GH-12225) Add new keyword arguments "default_namespace" and "xml_declaration" to functions ET.tostring() and ET.tostringlist(), as known from ElementTree.write().
* bpo-28235: Fix xml.etree.ElementTree.fromstring docs (GH-11903)Manjusaka2019-02-221-2/+4
|
* bpo-34160: Preserve user specified order of Element attributes (GH-10163)Raymond Hettinger2018-10-281-0/+8
|
* bpo-29209: Remove old-deprecated features in ElementTree. (GH-6769)Serhiy Storchaka2018-07-241-16/+9
| | | | | Also make getchildren() and getiterator() emitting a DeprecationWarning instead of PendingDeprecationWarning.
* bpo-32800: Update link to w3c doc for xml default namespaces (GH-5609)sblondon2018-02-101-1/+1
| | | The new link is given in a red box on the old page.
* bpo-31648: Improve ElementPath (#3835)scoder2017-09-301-0/+5
| | | | | * Allow whitespace inside of ElementPath predicates. * Add ElementPath predicate support for text comparison of the current node, like "[.='text']".
* bpo-30380: Fix Sphinx 1.6.1 warnings. (#1613)Serhiy Storchaka2017-05-161-1/+1
| | | | | | | | * Use explicit numbering for footnotes referred by explicit number. * Restore missed footnote reference in stdtypes.rst. * Fix literal strings formatting in howto/urllib2.rst. * Update susp-ignored.csv for zipapp.rst. * Fix suspicious mark up in Misc/NEWS.
* Issue #19795: Mark up True and False as literal text instead of bold.Serhiy Storchaka2016-10-191-1/+1
|
* Issue #22558: Add remaining doc links to source code for Python-coded modules.Terry Jan Reedy2016-06-111-0/+5
| | | | | Reformat header above separator line (added if missing) to a common format. Patch by Yoni Lavi.
* Issue #23921: Standardized documentation whitespace formatting.Serhiy Storchaka2016-05-101-13/+13
| | | | Original patch by James Edwards.
* Issue #26736: Used HTTPS for external links in the documentation if possible.Serhiy Storchaka2016-05-071-4/+4
|
* Correct “an” → “a” with “Unicode”, “user”, “UTF”, etcMartin Panter2016-04-151-1/+1
| | | | This affects documentation, code comments, and a debugging messages.
* Closes #26444: typo fixes.Georg Brandl2016-02-261-7/+7
|
* Issue #25161: Add full stops in documentation; patch by Takase ArihiroMartin Panter2015-10-101-1/+1
|
* Issue #24079: Improve description of the text and tail attributes forNed Deily2015-08-181-11/+19
| | | | ElementTree Element objects. Initial patch by Martin Panter.
generated by cgit v0.12 at 2025-09-12 08:02:08 (GMT)