[issue11762] Ast doc: warning and version number

Berker Peksag added the comment: > 1. Add a warning similar to the one for the dis module. The current documentation says: "The abstract syntax itself might change with each Python release; [...]" https://docs.python.org/3.4/library/ast.html > 2. Add a full entry for __version__. Currentl

[issue11762] Ast doc: warning and version number

Changes by Ezio Melotti : -- keywords: +easy -patch type: -> enhancement versions: +Python 3.4 -Python 3.1 ___ Python tracker ___ ___

[issue11762] Ast doc: warning and version number

Éric Araujo added the comment: The Python Insider blog has a nice phrasing: “The AST module exposes a constant, ``ast.__version__``, which provides a means for user code to vary its behaviour depending on the version of the AST it encounters.” -- _

[issue11762] Ast doc: warning and version number

Changes by Daniel Urban : -- nosy: +durban ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.o

[issue11762] Ast doc: warning and version number

Changes by Ezio Melotti : -- nosy: +ezio.melotti ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.py

[issue11762] Ast doc: warning and version number

Changes by Éric Araujo : -- versions: +Python 3.1 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.p

[issue11762] Ast doc: warning and version number

Éric Araujo added the comment: Please improve this rough phrasing: “Check the value of *ast.__version__* to write version-specific code blocks if you need to work across versions.” -- nosy: +eric.araujo ___ Python tracker

[issue11762] Ast doc: warning and version number

Georg Brandl added the comment: Sounds good to me, except for "Use *ast.__version__* to work across versions." which is not quite clear. While talking about version numbers, we should probably also document *what changed* between those versions. -- nosy: +georg.brandl __

[issue11762] Ast doc: warning and version number

Terry J. Reedy added the comment: Modify entry slightly to String constant with version number of the abstract grammar file. 3.1: '67616'; 3.2: '82163'; 3.3: 'x' -- keywords: +patch ___ Python tracker

[issue11762] Ast doc: warning and version number

New submission from Terry J. Reedy : Two related proposals. 1. Add a warning similar to the one for the dis module. As modified: "CPython implementation detail: The ast definition is specific to the CPython interpreter! Ast nodes may be added, removed, or changed between versions. Use *ast.__