From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Fri, 10 Jul 2026 09:51:58 +0000 (+0200)
Subject: [3.15] gh-145633: Allow PyFloat_Pack8 & PyFloat_UnPack* to fail in future CPython... 
X-Git-Tag: v3.15.0b4~53
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=45a769f26108257758cab941f9a344685fe29b14;p=thirdparty%2FPython%2Fcpython.git

[3.15] gh-145633: Allow PyFloat_Pack8 & PyFloat_UnPack* to fail in future CPython versions (GH-153440) (#153490)

gh-145633: Allow PyFloat_Pack8 & PyFloat_UnPack* to fail in future CPython versions (GH-153440)
(cherry picked from commit 9324f84b0f5722d165456b5858a683a2c82eefd2)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
---

diff --git a/Doc/c-api/float.rst b/Doc/c-api/float.rst
index a12ad11abb10..c484b3e5bdb5 100644
--- a/Doc/c-api/float.rst
+++ b/Doc/c-api/float.rst
@@ -233,9 +233,6 @@ most likely :exc:`OverflowError`).
 
    Pack a C double as the IEEE 754 binary64 double precision format.
 
-   .. impl-detail::
-      This function always succeeds in CPython.
-
 
 Unpack functions
 ^^^^^^^^^^^^^^^^
@@ -251,9 +248,6 @@ Return value: The unpacked double.  On error, this is ``-1.0`` and
 :c:func:`PyErr_Occurred` is true (and an exception is set, most likely
 :exc:`OverflowError`).
 
-.. impl-detail::
-    These functions always succeed in CPython.
-
 .. c:function:: double PyFloat_Unpack2(const char *p, int le)
 
    Unpack the IEEE 754 binary16 half-precision format as a C double.
diff --git a/Misc/NEWS.d/next/C_API/2026-07-09-16-46-30.gh-issue-145633.jyNwAs.rst b/Misc/NEWS.d/next/C_API/2026-07-09-16-46-30.gh-issue-145633.jyNwAs.rst
new file mode 100644
index 000000000000..cdb68372b6ba
--- /dev/null
+++ b/Misc/NEWS.d/next/C_API/2026-07-09-16-46-30.gh-issue-145633.jyNwAs.rst
@@ -0,0 +1,2 @@
+:c:func:`PyFloat_Pack8` and ``PyFloat_Unpack*`` functions are no longer
+guaranteed to always succeed on CPython.