From: Batuhan Taskaya <batuhanosmantaskaya@gmail.com>
Date: Sun, 28 Jun 2020 01:11:43 +0000 (+0300)
Subject: bpo-38870: Extend subject of ast.unparse warnings (GH-21053)
X-Git-Tag: v3.10.0a1~493
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=8df1016e2ef8c0a9f4d15bf7894c284295c99d9f;p=thirdparty%2FPython%2Fcpython.git

bpo-38870: Extend subject of ast.unparse warnings (GH-21053)

- Mention that some compiler optimizations might not roundtrip
exactly (such as constant tuples and frozensets).

- Add a warning about it might raise RecursionError on very
complex expressions due to recursive unparsing aspect of ast.unparse
---

diff --git a/Doc/library/ast.rst b/Doc/library/ast.rst
index 6c6ad01b842c..25cb17811e71 100644
--- a/Doc/library/ast.rst
+++ b/Doc/library/ast.rst
@@ -1553,7 +1553,12 @@ and classes for traversing abstract syntax trees:
 
    .. warning::
       The produced code string will not necessarily be equal to the original
-      code that generated the :class:`ast.AST` object.
+      code that generated the :class:`ast.AST` object (without any compiler
+      optimizations, such as constant tuples/frozensets).
+
+   .. warning::
+      Trying to unparse a highly complex expression would result with
+      :exc:`RecursionError`.
 
    .. versionadded:: 3.9