Browse Source

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

pull/9921/head
Georg Brandl 11 years ago
parent
commit
b9b389efed
  1. 16
      Doc/library/ast.rst

16
Doc/library/ast.rst

@ -115,13 +115,15 @@ and classes for traversing abstract syntax trees:
.. function:: literal_eval(node_or_string)
Safely evaluate an expression node or a string containing a Python
expression. The string or node provided may only consist of the following
Python literal structures: strings, bytes, numbers, tuples, lists, dicts,
sets, 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.
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``.
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.
.. versionchanged:: 3.2
Now allows bytes and set literals.

Loading…
Cancel
Save