From: Ryan Davis <ryand@...>
Date: 2004-12-03T09:58:43+09:00
Subject: ParseTree 1.2.0 Released

ParseTree version 1.2.0 has been released!

** DESCRIPTION:

ParseTree is a C extension (using RubyInline) that extracts the parse
tree for an entire class or a specific method and returns it as a
s-expression (aka sexp) using ruby's arrays, strings, symbols, and
integers.

As an example:

   def conditional1(arg1)
     if arg1 == 0 then
       return 1
     end
     return 0
   end

becomes:

   [:defn,
     :conditional1,
     [:scope,
      [:block,
       [:args, :arg1],
       [:if,
        [:call, [:lvar, :arg1], :==, [:array, [:lit, 0]]],
        [:return, [:lit, 1]],
        nil],
       [:return, [:lit, 0]]]]]

** FEATURES/PROBLEMS:

+ Uses RubyInline, so it just drops in.
+ Includes SexpProcessor and CompositeSexpProcessor.
	+ Allows you to write very clean filters.
+ Includes show.rb, which lets you quickly snoop code.
+ Includes abc.rb, which lets you get abc metrics on code.
	+ abc metrics = numbers of assignments, branches, and calls.
	+ whitespace independent metric for method complexity.
+ Only works on methods in classes/modules, not arbitrary code.
+ Does not work on the core classes, as they are not ruby (yet).

Changes:

+ 9 minor enhancements
	+ ParseTree now returns symbols for all data except in :str and :lit.
		+ This WILL break existing code! (as if any exists)
	+ ParseTree.parse_tree now takes a list of classes, no optional method.
	+ ParseTree.parse_tree_for_method(klass, method) added.
	+ ParseTree.parse_tree now returns a list of :class/:module nodes.
	+ Added -f to parse_tree_show for uber fast demos.
	+ Added -q to parse_tree_show to NOT use pp so it is mucho faster.
	+ running with $DEBUG will trace the methods and nodes as processed.
	+ Added rdoc to everything.
	+ Gemified
+ 4 bug fixes
	+ Bus error in iter/for nodes where arg list is empty now fixed.
	+ Bus error when handling 'def method(*)' is now fixed.
	+ Unnamed classes and superclasses (ugh) are now handled.
	+ parse_tree_abc now enumerates actual types rather than every token.