Posted By: Ryan Davis
Date: 2007-08-01 17:25
Summary: ParseTree 2.0.0 Released
Project: ParseTree - ruby parse tree tools

ParseTree version 2.0.0 has been released!

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]]]]]

* Uses RubyInline, so it just drops in.
* Includes SexpProcessor and CompositeSexpProcessor.
* Allows you to write very clean filters.
* Includes UnifiedRuby, allowing you to automatically rewrite ruby quirks.
* ParseTree#parse_tree_for_string lets you parse arbitrary strings of ruby.
* 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.
* Does not work on the core classes, as they are not ruby (yet).

Changes:

* 2 major enhancements:

* Rewrite methods completely rewritten. Rewriters:
* are no longer recursive.
* are no longer required to empty the sexp coming in.
* are depth first, so rewriter gets passed everything already normalized.
* keep rewriting until type doesn't change.
* are magical goodness.
* Added UnifiedRuby module to aid others in writing clean SexpProcessors:
* bmethod/dmethod/fbody unified with defn
* fcall/vcall unified with call
* resbody unified with itself (lots of different forms)

* 5 minor enhancements:

* Add #modules to Module.
* Add Sexp::for shortcut for Sexp.from_array ParseTree.translate(...).
* Add parens for :block nodes as appropriate. May be overzealous.
* Made add_to_parse_tree global for reuse by other C extensions.
* Made test_ruby2ruby MUCH more rigorous with circular testing.

* 6 bug fixes:

* Added $TESTING = true to pt_testcase.rb. OOPS!
* Fixed some circular bugs, mostly by hacking them out, wrt operator precidence.
* Fixed splat arg processing when arg has no name.
* Fixed trinary operator.
* Fixed BMETHOD with no arguments.
* Removed hacky "self." thing for defs at top level PT use.

Latest News
icalendar 1.4.0 Released
    Ryan Ahearn - 2013-05-21 23:17
BinData 1.5.0 - source moved to github
    Dion Mendel - 2013-05-21 11:10
v13.5.0 Released !!
    id 774 - 2013-05-18 12:28
Runt v0.9.0 Released
    Matthew Lipper - 2013-05-17 00:11
kramdown 1.0.2 released
    Thomas Leitner - 2013-05-09 06:58

 

Forums | Admin

Discussion Forums: parsetree-2.0.0-released

Start New Thread Start New Thread

 

Topic Topic Starter Replies Last Post