Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

Closes #22525: clarify documentation for ast.literal_eval().

This commit is contained in:
Georg Brandl 2014-11-05 20:20:28 +01:00
parent b811a97859
commit b9b389efed
1 changed files with 8 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
Doc/library/ast.rst
View File

@ -115,13 +115,15 @@ and classes for traversing abstract syntax trees:
.. function:: literal_eval(node_or_string) .. function:: literal_eval(node_or_string)
Safely evaluate an expression node or a string containing a Python Safely evaluate an expression node or a string containing a Python literal or
expression. The string or node provided may only consist of the following container display. The string or node provided may only consist of the
Python literal structures: strings, bytes, numbers, tuples, lists, dicts, following Python literal structures: strings, bytes, numbers, tuples, lists,
sets, booleans, and ``None``. dicts, sets, booleans, and ``None``.
This can be used for safely evaluating strings containing Python expressions This can be used for safely evaluating strings containing Python values from
from untrusted sources without the need to parse the values oneself. 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.
.. versionchanged:: 3.2 .. versionchanged:: 3.2
Now allows bytes and set literals. Now allows bytes and set literals.