[Python-checkins] gh-95778: Mention sys.set_int_max_str_digits() in error message (GH-96874)

Fri Sep 16 14:30:11 EDT 2022

https://github.com/python/cpython/commit/ce11f39de53a7b1bb54e77c1f0ce15f020ef4536
commit: ce11f39de53a7b1bb54e77c1f0ce15f020ef4536
branch: 3.10
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: miss-islington <31488909+miss-islington at users.noreply.github.com>
date: 2022年09月16日T11:30:05-07:00
summary:
gh-95778: Mention sys.set_int_max_str_digits() in error message (GH-96874)
When ValueError is raised if an integer is larger than the limit,
mention sys.set_int_max_str_digits() in the error message.
(cherry picked from commit e841ffc915e82e5ea6e3b473205417d63494808d)
Co-authored-by: Victor Stinner <vstinner at python.org>
files:
A Misc/NEWS.d/next/Core and Builtins/2022-09-16-19-02-40.gh-issue-95778.cJmnst.rst
M Doc/library/stdtypes.rst
M Objects/longobject.c

diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index c82a6ad2d04e..a91b44fadd04 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -5440,7 +5440,7 @@ When an operation would exceed the limit, a :exc:`ValueError` is raised:
 >>> _ = int('2' * 5432)
 Traceback (most recent call last):
 ...
- ValueError: Exceeds the limit (4300) for integer string conversion: value has 5432 digits.
+ ValueError: Exceeds the limit (4300) for integer string conversion: value has 5432 digits; use sys.set_int_max_str_digits() to increase the limit.
 >>> i = int('2' * 4300)
 >>> len(str(i))
 4300
@@ -5448,7 +5448,7 @@ When an operation would exceed the limit, a :exc:`ValueError` is raised:
 >>> len(str(i_squared))
 Traceback (most recent call last):
 ...
- ValueError: Exceeds the limit (4300) for integer string conversion: value has 8599 digits.
+ ValueError: Exceeds the limit (4300) for integer string conversion: value has 8599 digits; use sys.set_int_max_str_digits() to increase the limit.
 >>> len(hex(i_squared))
 7144
 >>> assert int(hex(i_squared), base=16) == i*i # Hexadecimal is unlimited.
diff --git a/Misc/NEWS.d/next/Core and Builtins/2022-09-16-19-02-40.gh-issue-95778.cJmnst.rst b/Misc/NEWS.d/next/Core and Builtins/2022-09-16-19-02-40.gh-issue-95778.cJmnst.rst
new file mode 100644
index 000000000000..ebf63778a605
--- /dev/null
+++ b/Misc/NEWS.d/next/Core and Builtins/2022-09-16-19-02-40.gh-issue-95778.cJmnst.rst	
@@ -0,0 +1,3 @@
+When :exc:`ValueError` is raised if an integer is larger than the limit,
+mention the :func:`sys.set_int_max_str_digits` function in the error message.
+Patch by Victor Stinner.
diff --git a/Objects/longobject.c b/Objects/longobject.c
index aea5edc99064..fe4395ac5ed8 100644
--- a/Objects/longobject.c
+++ b/Objects/longobject.c
@@ -36,8 +36,8 @@ _Py_IDENTIFIER(big);
 #define IS_SMALL_INT(ival) (-NSMALLNEGINTS <= (ival) && (ival) < NSMALLPOSINTS)
 #define IS_SMALL_UINT(ival) ((ival) < NSMALLPOSINTS)
 
-#define _MAX_STR_DIGITS_ERROR_FMT_TO_INT "Exceeds the limit (%d) for integer string conversion: value has %zd digits"
-#define _MAX_STR_DIGITS_ERROR_FMT_TO_STR "Exceeds the limit (%d) for integer string conversion"
+#define _MAX_STR_DIGITS_ERROR_FMT_TO_INT "Exceeds the limit (%d) for integer string conversion: value has %zd digits; use sys.set_int_max_str_digits() to increase the limit"
+#define _MAX_STR_DIGITS_ERROR_FMT_TO_STR "Exceeds the limit (%d) for integer string conversion; use sys.set_int_max_str_digits() to increase the limit"
 
 static PyObject *
 get_small_int(sdigit ival)
