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

Brett Cannon webhook-mailer at python.org
Fri Mar 9 16:40:41 EST 2018

commit: 19b42fe97cc15ff123f7ccb61a26fed817e850f7
branch: 3.6
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: Brett Cannon <brettcannon at users.noreply.github.com>
date: 2018-03-09T13:40:39-08:00

Warn that compile() can crash when compiling to an AST object (GH-6043) (GH-6046)

(cherry picked from commit f7a6ff6fcab32a53f262ba3f8a072c27afc330d7)

Co-authored-by: Brett Cannon <brettcannon at users.noreply.github.com>

M Doc/library/functions.rst

diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index 3b479bd64294..bc4203081ed0 100644
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -260,6 +260,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.

More information about the Python-checkins mailing list