[Python-checkins] Warn that compile() can crash when compiling to an AST object (GH-6043)

Fri Mar 9 16:13:36 EST 2018

https://github.com/python/cpython/commit/f7a6ff6fcab32a53f262ba3f8a072c27afc330d7
commit: f7a6ff6fcab32a53f262ba3f8a072c27afc330d7
branch: master
author: Brett Cannon <brettcannon at users.noreply.github.com>
committer: GitHub <noreply at github.com>
date: 2018年03月09日T13:13:32-08:00
summary:
Warn that compile() can crash when compiling to an AST object (GH-6043)
files:
M Doc/library/functions.rst

diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index bfb813cf3906..3ddd280f77eb 100644
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -274,6 +274,12 @@ are always available. They are listed here in alphabetical order.
 character. This is to facilitate detection of incomplete and complete
 statements in the :mod:`code` module.
 
+ .. warning::
+
+ It is possible to crash the Python interpreter with a
+ sufficiently large/complex string when compiling to an AST
+ object due to stack depth limitations in Python's AST compiler.
+
 .. versionchanged:: 3.2
 Allowed use of Windows and Mac newlines. Also input in ``'exec'`` mode
 does not have to end in a newline anymore. Added the *optimize* parameter.
