[Python-checkins] bpo-39159: Declare error that might be raised from literal_eval (GH-19899)

rhettinger webhook-mailer at python.org
Mon Dec 21 19:15:55 EST 2020


https://github.com/python/cpython/commit/fbc7723778be01b8f3bb72d2dcac15ab9fbb9923
commit: fbc7723778be01b8f3bb72d2dcac15ab9fbb9923
branch: master
author: Batuhan Taskaya <isidentical at gmail.com>
committer: rhettinger <rhettinger at users.noreply.github.com>
date: 2020-12-21T16:15:40-08:00
summary:

bpo-39159: Declare error that might be raised from literal_eval (GH-19899)

files:
M Doc/library/ast.rst

diff --git a/Doc/library/ast.rst b/Doc/library/ast.rst
index 8a5c6ec5f1279..9149a53e0dca8 100644
--- a/Doc/library/ast.rst
+++ b/Doc/library/ast.rst
@@ -1576,7 +1576,7 @@ and classes for traversing abstract syntax trees:
    Safely evaluate an expression node or a string containing a Python literal or
    container display.  The string or node provided may only consist of the
    following Python literal structures: strings, bytes, numbers, tuples, lists,
-   dicts, sets, booleans, and ``None``.
+   dicts, sets, booleans, ``None`` and ``Ellipsis``.
 
    This can be used for safely evaluating strings containing Python values from
    untrusted sources without the need to parse the values oneself.  It is not
@@ -1588,6 +1588,10 @@ and classes for traversing abstract syntax trees:
       sufficiently large/complex string due to stack depth limitations
       in Python's AST compiler.
 
+      It can raise :exc:`ValueError`, :exc:`TypeError`, :exc:`SyntaxError`,
+      :exc:`MemoryError` and :exc:`RecursionError` depending on the malformed
+      input.
+
    .. versionchanged:: 3.2
       Now allows bytes and set literals.
 



More information about the Python-checkins mailing list