R
Ryan Davis
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/
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/