Message 202675 - Python tracker

➜

This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author	techtonik
Recipients	docs@python, ezio.melotti, techtonik
Date	2013-11-12.06:52:23
SpamBayes Score	-1.0
Marked as misclassified	Yes
Message-id	<1384239144.67.0.857427270426.issue19557@psf.upfronthosting.co.za>
In-reply-to

Content
http://docs.python.org/2/library/ast.html AST module doc is incomplete. To write node visitor, you need to know possible types of parameters and expected values for every node type. They are different. http://hg.python.org/cpython/file/1ee45eb6aab9/Parser/Python.asdl For example, visit_Assign expects: Assign(targets, value) `targets` can be List, Tuple or Name When there is List, and when there is Tuple? It should be documented.

http://docs.python.org/2/library/ast.html

AST module doc is incomplete. To write node visitor, you need to know possible types of parameters and expected values for every node type. They are different.

http://hg.python.org/cpython/file/1ee45eb6aab9/Parser/Python.asdl

For example, visit_Assign expects:
 Assign(targets, value)
   `targets` can be List, Tuple or Name

When there is List, and when there is Tuple? It should be documented.

History
Date	User	Action	Args
2013-11-12 06:52:24	techtonik	set	recipients: + techtonik, ezio.melotti, docs@python
2013-11-12 06:52:24	techtonik	set	messageid: <1384239144.67.0.857427270426.issue19557@psf.upfronthosting.co.za>
2013-11-12 06:52:24	techtonik	link	issue19557 messages
2013-11-12 06:52:23	techtonik	create