From: Georg Brandl Date: Wed, 5 Nov 2014 19:20:28 +0000 (+0100) Subject: Closes #22525: clarify documentation for ast.literal_eval(). X-Git-Tag: v2.7.9rc1~58 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=a1137fba8949d37da17f16c396a94e5df1e1f9b4;p=thirdparty%2FPython%2Fcpython.git Closes #22525: clarify documentation for ast.literal_eval(). --- diff --git a/Doc/library/ast.rst b/Doc/library/ast.rst index 8adc88f7da4f..cf0c32e463fe 100644 --- a/Doc/library/ast.rst +++ b/Doc/library/ast.rst @@ -132,12 +132,14 @@ and classes for traversing abstract syntax trees: .. function:: literal_eval(node_or_string) Safely evaluate an expression node or a Unicode or *Latin-1* encoded string - containing a Python expression. The string or node provided may only consist - of the following Python literal structures: strings, numbers, tuples, lists, - dicts, booleans, and ``None``. - - This can be used for safely evaluating strings containing Python expressions - from untrusted sources without the need to parse the values oneself. + containing a Python literal or container display. The string or node + provided may only consist of the following Python literal structures: + strings, numbers, tuples, lists, dicts, booleans, and ``None``. + + 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 + capable of evaluating arbitrarily complex expressions, for example involving + operators or indexing. .. function:: get_docstring(node, clean=True)