[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__. Currently (3.2): ast.__version__ has been removed in issue 12273. Closing this as out of date. -- nosy: +berker.peksag resolution: - out of date stage: needs patch - resolved status: open - closed ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue11762 ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue11762] Ast doc: warning and version number
Changes by Ezio Melotti ezio.melo...@gmail.com: -- keywords: +easy -patch type: - enhancement versions: +Python 3.4 -Python 3.1 ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue11762 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue11762] Ast doc: warning and version number
Éric Araujo mer...@netwok.org 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.” -- ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue11762 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue11762] Ast doc: warning and version number
Changes by Daniel Urban urban.dani...@gmail.com: -- nosy: +durban ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue11762 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue11762] Ast doc: warning and version number
Changes by Ezio Melotti ezio.melo...@gmail.com: -- nosy: +ezio.melotti ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue11762 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue11762] Ast doc: warning and version number
Éric Araujo mer...@netwok.org 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 rep...@bugs.python.org http://bugs.python.org/issue11762 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue11762] Ast doc: warning and version number
Changes by Éric Araujo mer...@netwok.org: -- versions: +Python 3.1 ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue11762 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue11762] Ast doc: warning and version number
Georg Brandl ge...@python.org 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 ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue11762 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue11762] Ast doc: warning and version number
New submission from Terry J. Reedy tjre...@udel.edu: 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.__version__* to work across versions. I omitted Use of this module should not be considered to work across Python VMs or Python releases. as redundant and too legalistic. *ast.__version__* should link to its (new) entry). 2. Add a full entry for __version__. Currently (3.2): The module defines a string constant __version__ which is the decimal Subversion revision number of the file shown below. Proposed replacement (with hidden reference point): ast.__version__ [__version__ in normal entry boldface] String constant with version number of abstract grammar file. 3.1: 67616; 3.2: 82163; 3.3: x -- assignee: docs@python components: Documentation messages: 132951 nosy: docs@python, terry.reedy priority: normal severity: normal stage: needs patch status: open title: Ast doc: warning and version number versions: Python 2.7, Python 3.2, Python 3.3 ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue11762 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue11762] Ast doc: warning and version number
Terry J. Reedy tjre...@udel.edu 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 rep...@bugs.python.org http://bugs.python.org/issue11762 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com