From: Sebastian Pipping <sebastian@pipping.org>
Date: Wed, 6 Mar 2024 19:08:25 +0000 (+0100)
Subject: gh-115398: Suggest use of `hasattr` with checking for 3.13 Expat API availability... 
X-Git-Tag: v3.13.0a5~81
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=73807eb634315f70a464a18feaae33d9e065de09;p=thirdparty%2FPython%2Fcpython.git

gh-115398: Suggest use of `hasattr` with checking for 3.13 Expat API availability (GH-116278)

Suggest use of "hasattr" with checking for 3.13 Expat API availability
---

diff --git a/Doc/library/pyexpat.rst b/Doc/library/pyexpat.rst
index c897ec9e47b7..c4b4e6319277 100644
--- a/Doc/library/pyexpat.rst
+++ b/Doc/library/pyexpat.rst
@@ -217,6 +217,11 @@ XMLParser Objects
    Calling ``SetReparseDeferralEnabled(True)`` allows re-enabling reparse
    deferral.
 
+   Note that :meth:`SetReparseDeferralEnabled` has been backported to some
+   prior releases of CPython as a security fix.  Check for availability of
+   :meth:`SetReparseDeferralEnabled` using :func:`hasattr` if used in code
+   running across a variety of Python versions.
+
    .. versionadded:: 3.13
 
 .. method:: xmlparser.GetReparseDeferralEnabled()
diff --git a/Doc/library/xml.etree.elementtree.rst b/Doc/library/xml.etree.elementtree.rst
index 19c7af452e2b..5955647588fa 100644
--- a/Doc/library/xml.etree.elementtree.rst
+++ b/Doc/library/xml.etree.elementtree.rst
@@ -1402,6 +1402,11 @@ XMLParser Objects
       Disabling reparse deferral has security consequences; please see
       :meth:`xml.parsers.expat.xmlparser.SetReparseDeferralEnabled` for details.
 
+      Note that :meth:`flush` has been backported to some prior releases of
+      CPython as a security fix.  Check for availability of :meth:`flush`
+      using :func:`hasattr` if used in code running across a variety of Python
+      versions.
+
       .. versionadded:: 3.13
 
 
@@ -1475,6 +1480,11 @@ XMLPullParser Objects
       Disabling reparse deferral has security consequences; please see
       :meth:`xml.parsers.expat.xmlparser.SetReparseDeferralEnabled` for details.
 
+      Note that :meth:`flush` has been backported to some prior releases of
+      CPython as a security fix.  Check for availability of :meth:`flush`
+      using :func:`hasattr` if used in code running across a variety of Python
+      versions.
+
       .. versionadded:: 3.13
 
    .. method:: close()