From: Ryan Davis <ryand-ruby@...>
Date: 2007-02-14T07:27:13+09:00
Subject: [ANN] ParseTree 1.6.4 Released

ParseTree version 1.6.4 has been released!

   http://www.zenspider.com/ZSS/Products/ParseTree/

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 parse_tree_show, which lets you quickly snoop code.
	+ echo "1+1" | parse_tree_show -f for quick snippet output.
+ Includes parse_tree_abc, which lets you get abc metrics on code.
	+ abc metrics = numbers of assignments, branches, and calls.
	+ whitespace independent metric for method complexity.
+ Includes parse_tree_deps, which shows you basic class level  
dependencies.
+ Only works on methods in classes/modules, not arbitrary code.
+ Does not work on the core classes, as they are not ruby (yet).

** SYNOPSYS:

   sexp_array = ParseTree.new.parse_tree(klass)

or:

   class MyProcessor < SexpProcessor
     def initialize
       super
       self.strict = false
     end
     def process_lit(exp)
       val = exp.shift
       return val
     end
   end

or:

   % ./parse_tree_show myfile.rb

or:

   % echo "1+1" | ./parse_tree_show -f

or:

   % ./parse_tree_abc myfile.rb

** CHANGES:

+ 2 major enhancements:
	+ rewrite extracted and intended to be run before (or in front of)  
process.
	+ rewrite is now recursive as well, so children rewritings should be  
done independently of their parents. This should make complex  
rewriting layers much cleaner and allow me to eventually collect and  
publish a single "standard" rewriting layer.
+ 1 minor enhancement:
	+ Iters are now {} if short and one line. YAY!
+ 1 bug fix:
	+ Added test cases brought out by ruby2ruby/heckle.

   http://www.zenspider.com/ZSS/Products/ParseTree/