🕷 software projects

by ryan davis



sitemap

parsetree

A C extension that extracts ruby ASTs

** Note: ** This project is EOL’ed.

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:

1
2
3
4
5
6
  def conditional1(arg1)
    if arg1 == 0 then
      return 1
    end
    return 0
  end

becomes:

1
2
3
4
5
6
7
8
9
10
  [: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.
  • Uses UnifiedRuby by default, automatically rewriting 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).

Get The Code

If you just want to use parsetree, you can install it via RubyGems:
gem install parsetree
Fork me on GitHub If you want to hack on parsetree, clone it from GitHub:
git clone git://github.com/seattlerb/parsetree

Latest Activity