superchris-rubyjs 0.8.2

data/README

@@ -0,0 +1,131 @@
+------------------------------------
+RubyJS - Ruby to Javascript Compiler
+------------------------------------
+
+COPYRIGHT
+
+  Copyright (c) 2007, 2008 by Michael Neumann (mneumann@ntecs.de).
+  All rights reserved.
+
+ABOUT
+
+  RubyJS translates Ruby code into Javascript code. NOTE that it executes
+  the Ruby code before it translates it into Javascript. This has the
+  advantage of being able to (mis-)use all of Ruby's meta-programming
+  tricks in the global scope (i.e. for defining classes and methods, NOT
+  within methods!).
+
+REQUIREMENTS
+
+  * Ruby >= 1.8.6
+  * ParseTree >= 2.1.1 
+
+MAPPING
+
+  The mapping from Ruby objects (left) to Javascript values (right) are
+  given below. 
+
+  true          -> true (class Boolean)
+  false         -> false (class Boolean)
+  nil           -> nil (a special variable!)
+  1, 1.2        -> Javascript Number (unboxed)
+  "String"      -> immutable Javascript String (unboxed)
+  /regexp/      -> /regexp/ (unboxed)
+  [array]       -> [array] (unboxed)
+  {hash}        -> Javascript Hash object (unboxed, but indirect)
+  iterator      -> function (unboxed) 
+  1..2          -> custom Range object
+
+BUGS
+
+  --
+  Debug mode sometimes generates code that does not run!  
+
+  --
+  Spidermonkey doesn't run all tests.
+
+TODO
+
+  --
+  Issue a warning whenever a destructive Ruby string method like gsub!
+  is used. The reason behind this warning is that, due to efficience
+  reasons, Ruby strings (which are mutable) are mapped to immutable
+  Javascript strings.
+
+  --
+  Command-line switch that doesn't call methods for some operators.
+  Most important ones are "+", "-" and "/". This is of course an unsafe
+  operation as you could define a method "+" in your own class. For
+  heavy math operations, this of course increases performance a lot!
+
+  --
+  Command-line switch that removes unused methods. This is possible, as
+  we record the names of all (possibly) called methods. This of course
+  disables send() support. This switch has the potential to reduce the
+  size of the generated Javascript significantly (which also reduces
+  memory consumption on the client side). For this to work, we have to
+  generate a call chain, which method name calls which other method
+  names. This works only on method names, as we can't infer the used
+  classes.
+
+  --
+  Command-line switch that disables the generation of name-information
+  used by methods like send(), instance_variables(), methods() or
+  respond_to?(). This makes it hard to decompile the Javascript code
+  back to Ruby or assign meaningful names.
+
+LIMITATIONS
+
+  --
+  Module's are mapped to Classes for now.
+
+  --
+  You can't inherit from core classes like Array, String, Regexp and so
+  on. It's easy to allow by adding one further indirection, e.g. in that
+  on object creation an attribute "m" is assigned, which contains a hash
+  of all methods of that object, and on method call use "obj.m.method".
+  As long as this limitation is no problem, I go the way via prototypes,
+  which should be slightly more efficient.
+
+  --
+  You are not allowed to redefine the classes name method:
+
+    class MyClass
+      def self.name
+        # NOT ALLOWED!!!
+      end
+    end
+
+  The same is true for other methods like ancestors, superclass,
+  instance_methods, methods. But you wouldn't do that anyways in Ruby,
+  so that's no big restriction!
+
+  --
+  Constant assignment inside methods is forbidden. This is due to
+  using static constant lookup. Constant assignment inside the class
+  scope or module scope is not affected, as this is executed by the 
+  Ruby interpreter.
+  Constants are either inlined in the case it is a value type (Fixnum, Float)
+  or a reference is generated (i.e. a variable holding it's value + a name).
+  References are only generated on demand, i.e. only when a constant is
+  accessed. 
+
+  --
+  +break+ inside of loops cannot have arguments in RubyJS:
+
+    # RubyJS
+    while true
+      break 1  # => CompileTime Error
+    end
+
+  This could be accomplished, by introducing a "return loop"
+  variable for each while loop, and setting this variable
+  in "break".
+
+  A loop break cannot occur as expression. This could be accomplished
+  by using a throw instead of break and surrounding the loop by a catch.
+
+  The same applies for +next+!
+
+  -- 
+  Methods can be called regardless of their privacy (private, protected)

data/Rakefile

@@ -0,0 +1,65 @@
+require 'rubygems'
+RUBYJS_BIN = File.join ".", "bin", "rubyjs"
+
+task :gen_tests do
+  ruby "test/gen_browser_test_suite.rb"
+end
+
+task :run_tests do
+  ruby "test/run_tests.rb"
+end
+
+task :default => :gen_tests
+
+rule ".js" => ".rb" do |t|
+  klass = t.source.pathmap("%n").
+    split(/_/).collect { |part| part.capitalize}.join
+  sh "#{RUBYJS_BIN} -O PrettyPrint -d -m #{klass} -o #{t.name} #{t.source}"
+end
+
+rule ".html" => ".js" do |t|
+  File.open(t.name, "w") do |file|
+    file.puts <<EOHTML
+<html>
+  <head>
+    <title></title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+    
+    
+    
+  </head>
+  <body>
+      
+  <script src="#{t.source.pathmap("%f")}"></script>
+  </body>
+</html>    
+EOHTML
+  end
+end
+
+desc "Generate a rubyspec file that github won't complain about"
+task :generate_gemspec do
+  files = Dir['**/*'].reject { |file|
+    file if [/^nbproject/, /^examples/, /~$/, /\.gem$/, /test\/.*.js/, /test\/.*.html/ ].detect { |exp| file =~ exp  }
+  }.map {|entry| "'#{entry}'"}.join(", \n")
+  File.open("rubyjs.gemspec", "w") do |f|
+    f.puts <<EOF
+spec = Gem::Specification.new do |s|
+  s.name = 'rubyjs'
+  s.version = '0.8.2'
+  s.summary = 'RubyJS is a Ruby to Javascript Compiler. This is a fork with some added features.  Orignally by Michael Neumann'
+
+  s.files = [#{files}]
+  s.add_dependency('ParseTree', '>= 2.1.1')
+  s.required_ruby_version = ">= 1.8.6"
+
+  s.require_path = 'src'
+  s.bindir = 'bin'
+  s.executables = ['rubyjs']
+
+  s.author = "Chris Nelson"
+  s.email = "me@christophernelsonconsulting.com"
+end   
+EOF
+  end
+end

data/bin/rubyjs

@@ -0,0 +1,144 @@
+#!/usr/bin/env ruby
+
+require 'optparse'
+require 'ostruct'
+require 'rubygems'
+
+options = OpenStruct.new 
+options.load_path = []
+options.library = []
+options.platform = []
+options.outputs = []
+options.main = nil
+options.code = nil
+options.append = "" 
+options.debug = false
+options.opts = [] 
+
+OPTS = %w(NoArgumentArityChecks NoMethodMissing OptimizeArithOps PrettyPrint)
+
+def show_options
+  puts "Compiler Options:"
+  puts "  --opt NoArgumentArityChecks:: Disable generation of arity checking code"
+  puts "  --opt NoMethodMissing:: Disable method_missing functionality"
+  puts "  --opt OptimizeArithOps:: Enable native +-*/ operators"
+  puts "  --opt PrettyPrint:: Output more readable code"
+end
+
+opts = OptionParser.new do |opts|
+  opts.banner = "Usage: rubyjs [options] [file, [file, ...]]"
+  opts.on("-r", "--require LIBRARY",
+          "Require the LIBRARY before executing your script") do |lib|
+    options.library << lib
+  end
+  opts.on("-I", "--load-path DIRECTORY", "Specifies load path") do |lib|
+    options.load_path << lib
+  end
+  opts.on("-P", "--platform PLATFORM", "Specifies platform") do |plat|
+    options.platform << plat
+  end
+  opts.on("-m", "--main CLASSNAME", "Entry point") do |main|
+    raise "only one entry point allowed" if options.main
+    options.main = main
+  end
+  opts.on("-e", "--eval STRING", "Eval code") do |code|
+    raise "only one code allowed" if options.code
+    options.code = code
+  end
+  opts.on("-a", "--append JSCODE", "Append Javascript code") do |append|
+    options.append << append
+    options.append << "\n"
+  end
+  opts.on("-o", "--output FILE", "Filename to write output to") do |out|
+    options.outputs << out
+  end
+  opts.on("-O", "--opt OPTION", "Set a specific compiler option") do |out|
+    if OPTS.include?(out)
+      options.opts << out
+    else
+      puts "WRONG option"
+      show_options()
+      exit 1
+    end
+  end
+  opts.on("--show-options", "--show-options", "Show all compiler options") do |out|
+    show_options()
+    exit
+  end
+  opts.on("-d", "--debug", "Turn on debug mode") do |out|
+    options.debug = true
+  end
+  opts.on_tail("-h", "--help", "Show this message") do
+    puts opts
+    exit
+  end
+end
+
+args = ARGV.dup
+opts.parse!(args)
+
+# output to STDOUT by default
+if options.outputs.empty?
+  options.outputs << "-"
+end
+
+if args.empty? and !options.code
+  puts opts
+  exit
+end
+
+src_dir = File.expand_path(File.join(File.dirname(__FILE__), "..", "src"))
+options.load_path << src_dir
+options.load_path << File.join(src_dir, "rubyjs", "lib")
+
+$RUBYJS__LOAD_PATH = options.load_path.map {|i| File.expand_path(i)}  
+$RUBYJS__LOAD_PATH << "."
+$RUBYJS__PLATFORM = options.platform
+$RUBYJS = true    # to distinguish between Ruby and RubyJS
+$RUBYJS__DEBUG = options.debug
+$RUBYJS__OPTS = options.opts
+
+# load RubyJS
+$LOAD_PATH.unshift(src_dir)
+require 'rubyjs'
+
+# process requires
+
+eval_into(RubyJS::Environment) do |eval|
+  $RUBYJS__LOAD_PATH.unshift File.join(src_dir, "rubyjs", "lib")
+  require 'core'
+  $RUBYJS__LOAD_PATH.shift
+
+  options.library.each do |lib|
+    require lib 
+  end
+
+  eval.call(options.code) if options.code
+
+  args.each do |file|
+    if file == '-'
+      eval.call(STDIN.read)
+    else
+      eval.call(File.read(file))
+    end
+  end
+end
+
+gen = CodeGenerator.new
+str = "" 
+str << gen.generate()
+if options.main
+  klass, method = options.main.split(".")
+  method ||= "main"
+  str << gen.encode("#<#{klass}>.#<m:#{method}>.apply(#<#{klass}>); ")
+end
+str << options.append
+
+options.outputs.each do |outname| 
+  if outname == "-"
+    STDOUT << str
+    STDOUT.flush
+  else
+    File.open(outname, 'w+') {|f| f << str }
+  end
+end

data/rubyjs.gemspec

@@ -0,0 +1,112 @@
+spec = Gem::Specification.new do |s|
+  s.name = 'rubyjs'
+  s.version = '0.8.2'
+  s.summary = 'RubyJS is a Ruby to Javascript Compiler. This is a fork with some added features.  Orignally by Michael Neumann'
+
+  s.files = ['README', 
+'Rakefile', 
+'bin', 
+'bin/rubyjs', 
+'rubyjs.gemspec', 
+'src', 
+'src/rubyjs.rb', 
+'src/rubyjs', 
+'src/rubyjs/code_generator.rb', 
+'src/rubyjs/compiler.rb', 
+'src/rubyjs/debug_name_generator.rb', 
+'src/rubyjs/encoder.rb', 
+'src/rubyjs/eval_into.rb', 
+'src/rubyjs/lib', 
+'src/rubyjs/lib/core.rb', 
+'src/rubyjs/lib/json.rb', 
+'src/rubyjs/lib/microunit.rb', 
+'src/rubyjs/lib/dom_element.rb', 
+'src/rubyjs/model.rb', 
+'src/rubyjs/name_generator.rb', 
+'src/rwt', 
+'src/rwt/AbsolutePanel.rb', 
+'src/rwt/DOM.Konqueror.rb', 
+'src/rwt/DOM.Opera.rb', 
+'src/rwt/DOM.rb', 
+'src/rwt/Event.Opera.rb', 
+'src/rwt/Event.rb', 
+'src/rwt/HTTPRequest.IE6.rb', 
+'src/rwt/HTTPRequest.rb', 
+'src/rwt/Label.rb', 
+'src/rwt/Panel.rb', 
+'src/rwt/RootPanel.rb', 
+'src/rwt/UIObject.rb', 
+'src/rwt/Widget.rb', 
+'src/rwt/ported-from', 
+'src/rwt/ported-from/AbsolutePanel.java', 
+'src/rwt/ported-from/DOM.java', 
+'src/rwt/ported-from/DOMImpl.java', 
+'src/rwt/ported-from/DOMImplOpera.java', 
+'src/rwt/ported-from/DOMImplStandard.java', 
+'src/rwt/ported-from/HTTPRequest.java', 
+'src/rwt/ported-from/HTTPRequestImpl.java', 
+'src/rwt/ported-from/Label.java', 
+'src/rwt/ported-from/Panel.java', 
+'src/rwt/ported-from/UIObject.java', 
+'src/rwt/ported-from/Widget.java', 
+'test', 
+'test/benchmark', 
+'test/benchmark/bm_vm1_block.rb', 
+'test/benchmark/bm_vm1_const.rb', 
+'test/benchmark/bm_vm1_ensure.rb', 
+'test/benchmark/common.rb', 
+'test/benchmark/params.yaml', 
+'test/common.Browser.rb', 
+'test/common.rb', 
+'test/gen_browser_test_suite.rb', 
+'test/gen_test_suite.rb', 
+'test/run_benchs.rb', 
+'test/run_tests.rb', 
+'test/test_args.rb', 
+'test/test_array.rb', 
+'test/test_case.rb', 
+'test/test_class.rb', 
+'test/test_eql.rb', 
+'test/test_exception.rb', 
+'test/test_expr.rb', 
+'test/test_hash.rb', 
+'test/test_hot_ruby.rb', 
+'test/test_if.rb', 
+'test/test_insertion_sort.rb', 
+'test/test_inspect.rb', 
+'test/test_lebewesen.rb', 
+'test/test_massign.rb', 
+'test/test_new.rb', 
+'test/test_range.rb', 
+'test/test_regexp.rb', 
+'test/test_send.rb', 
+'test/test_simple_output.rb', 
+'test/test_splat.rb', 
+'test/test_string.rb', 
+'test/test_yield.rb', 
+'test/test_test.rb', 
+'utils', 
+'utils/js', 
+'utils/js/Makefile', 
+'utils/js/RunScript.class', 
+'utils/js/RunScript.java', 
+'utils/js/js.jar', 
+'utils/js/run.sh', 
+'utils/jsc', 
+'utils/jsc/Makefile', 
+'utils/jsc/README', 
+'utils/jsc/RunScript.c', 
+'utils/jsc/run.sh', 
+'utils/yuicompressor', 
+'utils/yuicompressor/README', 
+'utils/yuicompressor/yuicompressor-2.2.5.jar']
+  s.add_dependency('ParseTree', '>= 2.1.1')
+  s.required_ruby_version = ">= 1.8.6"
+
+  s.require_path = 'src'
+  s.bindir = 'bin'
+  s.executables = ['rubyjs']
+
+  s.author = "Chris Nelson"
+  s.email = "me@christophernelsonconsulting.com"
+end