summaryrefslogtreecommitdiffstats
path: root/Doc/library/xml.etree.elementtree.rst
Commit message (Collapse)AuthorAgeFilesLines
* [3.12] docs: module page titles should not start with a link to themselves ↵Miss Islington (bot)2024-05-081-2/+2
| | | | | | | | (GH-117099) (#118791) docs: module page titles should not start with a link to themselves (GH-117099) (cherry picked from commit bcb435ee8ff41b5ec5d879ee0b6651f146a66151) Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
* [3.12] gh-101549: fix documentation of xml.etree.ElementInclude (GH-101550) ↵Miss Islington (bot)2024-04-111-20/+15
| | | | | | | | (#117754) Co-authored-by: Mikhail B <55960560+mbel0@users.noreply.github.com> Co-authored-by: Serhiy Storchaka <storchaka@gmail.com> Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
* [3.12] Docs: specify XML document name in xml.etree.elementtree example ↵Miss Islington (bot)2024-04-011-1/+1
| | | | | | | (GH-24223) (#117429) (cherry picked from commit 9dae05ee59eeba0e67af2a46f2a2907c9f8d7e4a) Co-authored-by: Moshe Kaplan <mosheekaplan@gmail.com>
* [3.12] gh-115398: Expose Expat >=2.6.0 reparse deferral API (CVE-2023-52425) ↵Sebastian Pipping2024-03-061-0/+39
| | | | | | | | | | | | | | | | | | | | | | | | | (GH-115623) (GH-116248) 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 . - Please treat as a security fix related to CVE-2023-52425. (cherry picked from commit 6a95676bb526261434dd068d6c49927c44d24a9b) (cherry picked from commit 73807eb634315f70a464a18feaae33d9e065de09) (cherry picked from commit eda2963378a3c292cf6bb202bb00e94e46ee6d90) --------- Includes code suggested-by: Snild Dolkow <snild@sony.com> and by core dev Serhiy Storchaka. Co-authored-by: Gregory P. Smith <greg@krypto.org>
* [3.12] Fix typos in ElementTree documentation (GH-108848) (GH-114854)Miss Islington (bot)2024-02-011-3/+3
| | | | | | PI objects instead of comment objects. (cherry picked from commit de6f97cd3519c5d8528d8ca1bb00fce4e9969671) Co-authored-by: Christophe Nanteuil <35002064+christopheNan@users.noreply.github.com>
* [3.12] Docs: align usage of versionadded/versionchanged with recommended ↵Erlend E. Aasland2024-01-231-12/+12
| | | | | | | | practice (#114409) (#114472) (cherry picked from commit 1d7bddd9612bcbaaedbc837e2936de773e855411) Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM> Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
* [3.12] gh-93607: document `root` attribute of `iterparse` (GH-99410) (#111555)Miss Islington (bot)2023-10-311-1/+3
| | | | | | Co-authored-by: Prometheus3375 <35541026+Prometheus3375@users.noreply.github.com> Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com> Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
* [3.12] typo: missing line of output in pull parser example (GH-111068) (#111217)Miss Islington (bot)2023-10-231-0/+1
| | | | Co-authored-by: Don Patterson <37046246+don-patterson@users.noreply.github.com>
* [3.12] gh-101100: Fix sphinx warnings in ↵Miss Islington (bot)2023-09-241-1/+6
| | | | | | | | | | | `Doc/library/xml.etree.elementtree.rst` (GH-109799) (#109800) gh-101100: Fix sphinx warnings in `Doc/library/xml.etree.elementtree.rst` (GH-109799) (cherry picked from commit 649768fb6781ba810df44017fee1975a11d65e2f) gh-101100: Fix shpinx warnings in `Doc/library/xml.etree.elementtree.rst` Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
* 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.
* Issue #23729: Improve docs for ElementTree namespace parsingRaymond Hettinger2015-03-311-8/+10
|
* Issue 23729: Document ElementTree namespace handling and fix an omission in ↵Raymond Hettinger2015-03-221-0/+68
| | | | the XPATH predicate table.
* Fixing broken links in doc, part 4: some more breaks and redirectsGeorg Brandl2014-10-291-1/+1
|
* Issue #20375: Clarify ET's parsing of comments and processing instructions.Eli Bendersky2014-04-031-0/+22
| | | | Based on patch by Nikolaus Rath.
* Minor readability improvement.Raymond Hettinger2014-03-291-1/+1
|
* Merge in all documentation changes since branching 3.4.0rc1.Larry Hastings2014-03-161-1/+2
|
* Fix empty strings to empty bytes objects.Serhiy Storchaka2014-02-061-1/+1
|\