abstract-syntax-tree

I wrote some of the code to do this in a branch https://github.com/python-security/pyt/compare/class_based_views, but since I'm working on other things and this feature seems cool and important I'm making this issue 👍

Let me know if you would like any help in implementing.

A lot of the Javadoc comments int the public API are missing documentation for things like parameters and return types (think @param and @return tags). In my opinion, the most glaring omissions of these details are in the metamodel docs, found in the subpackages of spoon.reflect.

For example, at the time of writing

tophat/codewatch#1 (comment)

Our documentation currently contains only a tour, String, Map, and Int. We need to:

• Expand on the current documentation: (Types of Strings, escape characters (Strings), Map key types (Only Strings are supported), etc...).
• And also document the remainder of our core types, such as bool, or double, as well as standard methods(grab, etc...) or libraries (math, io, etc...).