From: Batuhan Taskaya <isidentical@gmail.com>
Date: Tue, 22 Dec 2020 00:15:40 +0000 (+0300)
Subject: bpo-39159: Declare error that might be raised from literal_eval (GH-19899)
X-Git-Tag: v3.10.0a4~110
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=fbc7723778be01b8f3bb72d2dcac15ab9fbb9923;p=thirdparty%2FPython%2Fcpython.git

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

diff --git a/Doc/library/ast.rst b/Doc/library/ast.rst
index 8a5c6ec5f127..9149a53e0dca 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.