rubyast 0.0.1

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+.idea

data/.travis.yml

@@ -0,0 +1,7 @@
+language: ruby
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+  - jruby-18mode
+  - jruby-19mode

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in rubyast.gemspec
+gemspec

data/README.md

@@ -0,0 +1,48 @@
+# RubyAST
+
+RubyAST is a small library on top of jrubyparser. The library works with ALL VERSIONS OF RUBY. YOU DON'T NEED TO USE JRUBY (but why not, it's awesome!).
+
+## #parse
+
+Parsing a file:
+
+	source = File.read(file_name)
+	ast = RubyAST.parse(file_name, source)
+
+Parsing a string:
+
+	ast = RubyAST.parse("(string)", "x = 1")
+
+You can set a starting line number (by default it's 0):
+
+	ast = RubyAST.parse("(string)", "x = 1", :line_number => 100)
+
+You can set ruby version (by default it's RUBY1_9):
+
+	ast = RubyAST.parse("(string)", "x = 1", :ruby_version => "RUBY1_9")
+
+## #to_source
+
+Just pass AST:
+
+	source = RubyAST.to_source(ast)
+
+If you want to keep quotes and heredocs, pass the original source:
+	
+	original_source = File.read(file_name)
+	ast = RubyAST.parse(file_name, original_source)
+	new_source = RubyAST.to_source(ast, original_source)
+
+
+## AST Nodes
+
+    ast = RubyAST.parse("(string)", "x = 1")
+    new_line_node = ast.body_node
+
+    assignment = new_line_node.next_node
+    fixnum_node = assignment.value_node
+
+    assignment.name.should == "x"
+    fixnum_node.value.should == 1
+
+Check out [jruby-parser](https://github.com/jruby/jruby-parser) for additoinal information about different types of nodes. 

data/Rakefile

@@ -0,0 +1,9 @@
+require 'bundler/gem_tasks'
+require "rspec/core/rake_task"
+
+task :default => [:spec]
+
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.pattern = Dir.glob('spec/**/*_spec.rb')
+  t.rspec_opts = ['--backtrace']
+end

data/lib/rubyast/include_jrubyparser.rb

@@ -0,0 +1,29 @@
+module RubyAST
+  module J
+    jar_path = File.expand_path(File.dirname(__FILE__) + '/../../jar/jrubyparser-0.2.jar')
+
+    if defined?(JRUBY_VERSION)
+      require 'java'
+      require jar_path
+
+      java_import java.io.StringReader
+      java_import java.io.StringWriter
+      java_import org.jrubyparser.parser.ParserConfiguration
+      java_import org.jrubyparser.Parser
+      java_import org.jrubyparser.rewriter.ReWriteVisitor
+      java_import org.jrubyparser.CompatVersion
+
+      ::SyntaxException = org.jrubyparser.lexer.SyntaxException
+    else
+      require 'rjb'
+      Rjb::load(jar_path, [])
+
+      StringReader = Rjb::import('java.io.StringReader')
+      StringWriter = Rjb::import('java.io.StringWriter')
+      ParserConfiguration = Rjb::import('org.jrubyparser.parser.ParserConfiguration')
+      Parser = Rjb::import('org.jrubyparser.Parser')
+      ReWriteVisitor = Rjb::import('org.jrubyparser.rewriter.ReWriteVisitor')
+      CompatVersion = Rjb::import('org.jrubyparser.CompatVersion')
+    end
+  end
+end

data/lib/rubyast/jruby_parser_wrapper.rb

@@ -0,0 +1,24 @@
+module RubyAST
+  class SyntaxException < Exception; end
+
+  module JRubyParserWrapper
+    extend self
+
+    def parse file_name, source, line_number, ruby_version
+      version = J::CompatVersion.getVersionFromString(ruby_version)
+      config = J::ParserConfiguration.new(line_number, version)
+      reader = J::StringReader.new(source)
+
+      J::Parser.new.parse(file_name, reader, config)
+    rescue ::SyntaxException => e
+      raise SyntaxException, e.message
+    end
+
+    def to_source ast, original_source
+      writer = J::StringWriter.new
+      visitor = J::ReWriteVisitor.new(writer, original_source)
+      ast.accept(visitor)
+      writer.toString
+    end
+  end
+end

data/lib/rubyast/version.rb

@@ -0,0 +1,3 @@
+module RubyAST
+  VERSION = "0.0.1"
+end

data/lib/rubyast.rb

@@ -0,0 +1,15 @@
+require File.expand_path(File.dirname(__FILE__) + "/rubyast/version")
+require File.expand_path(File.dirname(__FILE__) + '/rubyast/include_jrubyparser')
+require File.expand_path(File.dirname(__FILE__) + '/rubyast/jruby_parser_wrapper')
+
+module RubyAST
+  def self.parse file_name, source, config = {}
+    line_number = config.fetch(:line_number, 0)
+    ruby_version = config.fetch(:ruby_version, "RUBY1_9")
+    JRubyParserWrapper.parse file_name, source, line_number, ruby_version
+  end
+
+  def self.to_source ast, original_source = ""
+    JRubyParserWrapper.to_source ast, original_source
+  end
+end

data/rubyast.gemspec

@@ -0,0 +1,29 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "rubyast/version"
+
+Gem::Specification.new do |s|
+  s.name        = "rubyast"
+  s.version     = RubyAST::VERSION
+  s.authors     = ["Victor Savkin"]
+  s.email       = ["vic.savkin@gmail.com"]
+  s.homepage    = "http://github.com/vsavkin/rubyast"
+  s.summary     = %q{Allows AST Transformations for Ruby.}
+  s.description = %q{Allows AST Transformations for Ruby: parsers source code,
+transforms AST, generates source code based on AST}
+
+  s.rubyforge_project = "rubyast"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_development_dependency "rspec"
+  s.add_development_dependency "rake"
+  s.add_development_dependency "pry"
+
+  unless defined?(JRUBY_VERSION)
+    s.add_runtime_dependency "rjb"
+  end
+end

data/spec/rubyast/rubyast_spec.rb

@@ -0,0 +1,58 @@
+require File.expand_path(File.dirname(__FILE__) + "/../../lib/rubyast")
+
+module RubyAST
+  describe RubyAST do
+    context "#parse" do
+      let(:filename) { "filename" }
+
+      let(:ast) do
+        RubyAST.parse(filename, "x = 1", :line_number => 100, :ruby_version => "RUBY1_8")
+      end
+
+      it "should return parsed AST" do
+        new_line_node = ast.body_node
+        assignment = new_line_node.next_node
+        fixnum_node = assignment.value_node
+
+        assignment.name.should == "x"
+        fixnum_node.value.should == 1
+      end
+
+      it "should set correct line number" do
+        ast.position.file.should == filename
+        ast.position.start_line.should == 100
+        ast.position.end_line.should == 100
+      end
+
+      it "should default line number to 0" do
+        ast = RubyAST.parse(filename, "x = 1")
+        ast.position.start_line.should == 0
+      end
+
+      it "should default ruby_version to 1.9" do
+        RubyAST.parse(filename, "{x: 1}")
+        lambda { RubyAST.parse(filename, "{x: 1}", :ruby_version => "RUBY1_8") }.should raise_error(SyntaxException)
+      end
+    end
+
+    context "#to_source" do
+      let(:original_source) do
+        %q{x = '1' + "2"}
+      end
+
+      let(:ast) do
+        RubyAST.parse("filename", original_source)
+      end
+
+      it "should generate source from AST" do
+        source = RubyAST.to_source(ast, original_source)
+        source.should == original_source
+      end
+
+      it "will ignore quote types when original source is not passed" do
+        source = RubyAST.to_source(ast)
+        source.should == 'x = "1" + "2"'
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,104 @@
+--- !ruby/object:Gem::Specification
+name: rubyast
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Victor Savkin
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-03-09 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &2165284080 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2165284080
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &2165283080 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2165283080
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: &2165281940 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2165281940
+- !ruby/object:Gem::Dependency
+  name: rjb
+  requirement: &2165281300 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *2165281300
+description: ! 'Allows AST Transformations for Ruby: parsers source code,
+
+  transforms AST, generates source code based on AST'
+email:
+- vic.savkin@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- README.md
+- Rakefile
+- jar/jrubyparser-0.2.jar
+- lib/rubyast.rb
+- lib/rubyast/include_jrubyparser.rb
+- lib/rubyast/jruby_parser_wrapper.rb
+- lib/rubyast/version.rb
+- rubyast.gemspec
+- spec/rubyast/rubyast_spec.rb
+homepage: http://github.com/vsavkin/rubyast
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: rubyast
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Allows AST Transformations for Ruby.
+test_files:
+- spec/rubyast/rubyast_spec.rb