therubyracer 0.8.0 → 0.8.1.pre1

data/.gitignore

@@ -0,0 +1,14 @@
+.bundle
+Gemfile.lock
+v8.bundle
+v8.so
+*.o
+*.gem
+*.log
+*~
+docs/cpp/html/*
+
+ext/v8/upstream/build
+
+pkg/
+tmp/

data/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "spec/redjs"]
+	path = spec/redjs
+	url = git://github.com/cowboyd/redjs.git

data/.rspec

@@ -0,0 +1 @@
+--colour

data/Changelog.md

@@ -0,0 +1,165 @@
+# Changelog  
+
+## EDGE
+
+* decruft all the crap that had accumulated in the gem
+* Javascript Objects are now always mapped to the same V8::Object when read from the context
+
+## 0.8.0 - 2010/12/02
+
+* every V8 Context gets its own unique access strategy
+* ruby methods and procs embedded in javascript always return the same function per context.
+* ruby classes and subclasses are now all connected via the javascript prototype chain
+* better error reporting on syntax errors
+* upgrade to rspec 2
+* several bug fixes and stability fixes
+
+## 0.7.5 - 1010/08/03
+
+* upgrade to V8 2.3.3
+* property interceptors from ruby via [] and []=
+* indexed property access via [] and []=
+* property
+* several bugfixes
+* stability: eliminate many segfaults
+* don't enumerate property setters such as foo= from javascript
+
+## 0.7.4 - 2010/06/15
+
+* bug fix for rvm ruby installs incorrectly detected as 32bit
+
+## 0.7.3 - 2010/06/15
+
+* don't catch SystemExit and NoMemoryError
+* fix bug bundling gem
+
+## 0.7.2 - 2010/06/14
+
+* embed ruby classes as constructors
+* support for rubinius
+* uniform backtrace() function on JSError mixes the ruby
+* String::NewSymbol() is now scriptable
+* InstanceTemplate(), PrototypeTemplate(), Inherit() methods on v8::FunctionTemplate now scriptable.
+* reuse the standard ruby object access template
+* fix a bunch of compile warnings
+* Store any ruby object in V8 with V8::C::External
+
+## 0.7.1 - 2010/06/03
+
+* Function#call() now uses the global scope for 'this' by default
+* Function#methodcall() added to allow passing in 'this' object
+* Function#new() method to invoke javascript constructor from ruby
+* access javascript properties and call javascript methods from ruby
+* bundled Jasmine DOM-Less browser testing framework.
+
+* added Object::GetHiddenValue() to v8 metal
+* added Handle::IsEmpty() to v8 metal
+* fixed bug where iterating over arrays sometimes failed
+* numerous bug /segfault fixes.
+
+## 0.7.0 - 2010/05/31
+
+* upgraded to V8 2.1.10
+* added low level scripting interface for V8 objects
+* ruby object property/method access is now implemented in ruby
+* auto-convert javascript arrays to rb arrays and vice-versa
+* auto-convert ruby hashes into javascript objects
+* auto-convert javascript Date into ruby Time object and vice versa.
+* better exception handling when passing through multiple language boundaries
+* objects maintain referential integrity when passing objects from ruby to javascript and vice-versa
+* added debug compile option for getting C/C++ backtraces whenever segfaults occur.
+* official support for REE 1.8.7
+* fixed numerous segfaults
+* implemented V8::Value#to_s
+* the global scope is available to every V8::Context as the 'scope' attribute
+* properly convert ruby boolean values into V8 booleans.
+
+## 0.6.3 - 2010/05/07
+
+* FIX: linkage error on OSX /usr/bin/ruby
+
+## 0.6.2 - 2010/05/06
+
+* FIX: linkage error on OSX 10.5
+
+## 0.6.1 - 2010/05/03
+
+* call JavaScript functions from Ruby
+
+## 0.6.0 - 2010/03/31
+
+* ruby 1.9 compatible
+* full featured command line bin/v8 and bin/therubyracer
+* self validating install (v8 --selftest)
+* Only dependency to build gem from source is rubygems.
+
+## 0.5.5 - 2010/03/15
+
+* fix string encoding issue that was breaking RHEL 5.x
+* fix pthread linking issue on RHEL 5.2
+
+## 0.5.4 - 2010/03/09
+
+* add ext directory to gem require paths which was causing problems for non-binary gems
+
+## 0.5.3 - 2010/03/01
+
+* added full back trace to javascript code
+
+## 0.5.2 - 2010/02/26
+
+* added javascript shell (bin/therubyracer)
+* added to_s method for embedded ruby objects
+* added line number and file name to error message.
+
+## 0.5.1 - 2010/02/17
+
+* fix bug in 1.8.6 by creating Object#tap if it does not exist
+
+## 0.5.0 - 2010/02/17
+
+* support for Linux 64 bit
+
+## 0.4.9 - 2010/02/16
+
+* support for Linux 32 bit
+
+## 0.4.8 - 2010/02/08
+
+* expose line number and source name on JavascriptErrors.
+
+## 0.4.5 - 2010/01/18
+
+* case munging so that ruby methods(perl_case) are accessed through javascript in camelCase.
+* access 0-arity ruby methods as javascript properties
+* invoke ruby setters from javascript as properties
+* contexts detect whether they are open or not and open when needed
+
+## 0.4.4 - 2010/01/14
+
+* Ruby objects embedded into javascript are passed back to ruby as themselves and not a wrapped V8 object wrapping a ruby object.
+* Use any ruby object as the scope of eval().
+* quick and dirty V8.eval() method added
+* native objects have a reference to the context that created them.
+* context now has equality check.
+* expose InContext() and GetCurrent() methods.
+* fix a couple of segmentation faults
+
+## 0.4.3 - 2010/10/11
+
+* access properties on Ruby objects with their camel case equivalents
+* reflect JavaScript objects into Ruby and access their properties
+* load JavaScript source from an IO object or by filename
+
+## 0.4.2 - 2010/10/10
+
+* embed Ruby Objects into Javascript and call their methods
+
+## 0.4.1 - 2010/01/09
+
+* embed bare Proc and Method objects into JavaScript and call them
+* catch JavaScript exceptions from Ruby
+
+## 0.4.0 - 2009/12/21
+
+* evaluate JavaScript code from inside Ruby.

data/Gemfile

@@ -0,0 +1 @@
+source :rubygems;gemspec

data/README.md

@@ -0,0 +1,154 @@
+# therubyracer
+
+* http://github.com/cowboyd/therubyracer
+* http://groups.google.com/group/therubyracer
+* irc://irc.freenode.net/therubyracer
+
+## DESCRIPTION:
+
+Embed the V8 Javascript interpreter into Ruby.
+
+
+## FEATURES/PROBLEMS:
+
+* Evaluate Javascript from with in Ruby
+* Embed your Ruby objects into the Javascript world
+* Manipulate JavaScript objects and call JavaScript functions from Ruby
+* API compatible with the The Ruby Rhino (for JRuby: http://github.com/cowboyd/therubyrhino)
+
+## SYNOPSIS:
+
+    gem install therubyracer (stable)
+    gem install therubyracer --pre (bleeding edge)
+
+then in your ruby code
+
+    require 'v8'
+
+evaluate some simple javascript
+
+    cxt = V8::Context.new
+    cxt.eval('7 * 6') #=> 42
+
+embed values into the scope of your context
+
+    cxt['foo'] = "bar"
+    cxt.eval('foo') # => "bar"
+
+embed ruby code into your scope and call it from javascript
+
+    cxt["say"] = lambda {|word, times| word * times}
+    cxt.eval("say('Hello', 3)") #=> HelloHelloHello
+
+embed a ruby object into your scope and access its properties/methods from javascript
+
+    class MyMath
+      def plus(lhs, rhs)
+        lhs + rhs
+      end
+    end
+    
+    cxt['math'] = MyMath.new
+    cxt.eval("math.plus(20,22)") #=> 42
+
+make a ruby object *be* your global javascript scope.
+
+    math = MyMath.new
+    V8::Context.new(:with => math) do |cxt|
+      cxt.eval("plus(20,22)") #=> 42
+    end
+
+you can do the same thing with Object#eval_js 
+
+    math.eval_js("plus(20,22)")
+
+## Different ways of loading javascript source
+
+In addition to just evaluating strings, you can also use streams such as files.
+
+evaluate bytes read from any File/IO object:
+
+    File.open("mysource.js") do |file|
+      cxt.eval(file, "mysource.js")
+    end
+
+or load it by filename
+
+    cxt.load("mysource.js")
+
+
+## Safe by default, dangerous by demand
+
+The Ruby Racer is designed to let you evaluate javascript as safely as possible unless you tell it to do something more
+dangerous. The default context is a hermetically sealed javascript environment with only the standard javascript objects
+and functions. Nothing from the ruby world is accessible at all.
+
+For ruby objects that you explicitly embed into javascript, by default only the _public_ methods _below_ `Object` are
+exposed by default. E.g.
+
+    class A
+      def a
+        "a"
+      end
+
+      def to_s
+        super
+      end
+    end
+    
+    class B < A
+      def b
+        "b"
+      end
+    end
+    
+    
+    V8::Context.new do |cxt|
+      cxt['a'] = A.new
+      cxt['b'] = B.new
+      cxt.eval("a.a") # => 'a'
+      cxt.eval("b.b") # => 'b'
+      cxt.eval("b.a") # => 'a'
+      cxt.eval("b.to_s") # => #<B:0x101776be8> (because A explicitly defined it)
+      cxt.eval("b.object_id") #=> undefined, object_id is on Object
+    end
+
+If needed, you can override the [Ruby Access](https://github.com/cowboyd/therubyracer/blob/master/lib/v8/access.rb)
+to allow whatever behavior you'd like
+
+## REQUIREMENTS:
+
+* python >= 2.5 (required to compile v8)
+* C++ compiler
+
+
+## DEVELOP
+* git clone git://github.com/cowboyd/therubyracer.git
+* cd therubyracer
+* git submodule update --init
+* rake compile
+
+## LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2009,2010,2011 Charles Lowell
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -1,42 +1,14 @@
-require 'rubygems'
-
-UPSTREAM  = "ext/v8/upstream"
-
-manifest = Rake::FileList.new("**/*")
-manifest.exclude "lib/v8/*.bundle", "lib/v8/*.so", "ext/**/test/*", "ext/**/test/*", "ext/**/samples/*", "ext/**/benchmarks/*", "#{UPSTREAM}/build", "tmp", "tmp/**/*", "**/*.gem"
-Gem::Specification.new do |gemspec|
-  $gemspec = gemspec
-  gemspec.name = gemspec.rubyforge_project = "therubyracer"
-  gemspec.version = "0.8.0"
-  gemspec.summary = "Embed the V8 Javascript interpreter into Ruby"
-  gemspec.description = "Call javascript code and manipulate javascript objects from ruby. Call ruby code and manipulate ruby objects from javascript."
-  gemspec.email = "cowboyd@thefrontside.net"
-  gemspec.homepage = "http://github.com/cowboyd/therubyracer"
-  gemspec.authors = ["Charles Lowell", "Bill Robertson"]
-  gemspec.extra_rdoc_files = ["README.rdoc"]
-  gemspec.executables = ["therubyracer", "v8"]
-  gemspec.extensions = ["ext/v8/extconf.rb"]
-  gemspec.require_paths = ["lib", "ext", "contrib"]
-  gemspec.files = manifest.to_a
-end
+require 'bundler'
+require 'bundler/setup'
+require "rake/extensiontask"
+require "rspec/core/rake_task"
+Bundler::GemHelper.install_tasks
 
 task :default => :spec
 
-desc "Build gem"
-task :gem => :gemspec do
-  Gem::Builder.new($gemspec).build
-end
-
-desc "build the gemspec"
-task :gemspec => :clean do
-  File.open("#{$gemspec.name}.gemspec", "w") do |f|
-    f.write($gemspec.to_ruby)
-  end
-end
-
 desc "remove all generated artifacts except built v8 objects"
 task :clean do
-  sh "rm -rf *.gem"
+  sh "rm -rf pkg"
   sh "rm -rf ext/v8/Makefile"
   sh "rm -rf ext/v8/*.bundle ext/v8/*.so"
   sh "rm -rf lib/v8/*.bundle lib/v8/*.so"
@@ -44,16 +16,19 @@ end
 
 desc "remove all built v8 objects"
 task "v8:clean" => "clean" do
-  sh "cd #{UPSTREAM} && make clean"
+  sh "cd ext/v8/upstream && make clean"
 end
 
 desc "build v8 with debugging symbols (much slower)"
 task "v8:debug" do
-  sh "cd #{UPSTREAM} && make debug"
+  sh "cd ext/v8/upstream && make debug"
 end
 
-for file in Dir['tasks/*.rake']
-  load file
+Rake::ExtensionTask.new("v8", eval(File.read("therubyracer.gemspec"))) do |ext|    
+  ext.lib_dir = "lib/v8"
+  ext.source_pattern = "*.{cpp,h}"
 end
 
+RSpec::Core::RakeTask.new(:spec)
+
 

data/ext/v8/upstream/2.3.3/.gitignore

@@ -0,0 +1,26 @@
+*.a
+*.exe
+*.lib
+*.log
+*.map
+*.mk
+*.ncb
+*.pyc
+*.scons*
+*.suo
+*.user
+*.xcodeproj
+*.idb
+*.pdb
+#*#
+*~
+.cpplint-cache
+d8
+d8_g
+shell
+shell_g
+/obj/
+/tools/visual_studio/Debug
+/tools/visual_studio/Release
+/xcodebuild/
+TAGS

data/lib/v8/context.rb

@@ -8,8 +8,9 @@ module V8
       @to = Portal.new(self, @access)
       @native = opts[:with] ? C::Context::New(@to.rubytemplate) : C::Context::New()
       @native.enter do
-        @scope = @to.rb(@native.Global())
-        @native.Global().SetHiddenValue(C::String::New("TheRubyRacer::RubyObject"), C::External::New(opts[:with])) if opts[:with]
+        @global = @native.Global()
+        @scope = @to.rb(@global)
+        @global.SetHiddenValue(C::String::New("TheRubyRacer::RubyObject"), C::External::New(opts[:with])) if opts[:with]
       end
       yield(self) if block_given?
     end

data/lib/v8/error.rb

@@ -107,9 +107,9 @@ module V8
     #in the TryCatch. Is there a better way to detect a syntax error
     def syntax_error?(try)
       ex = try.Exception()
-      if ex && ex.kind_of?(V8::C::Object)
-        type = ex.Get("constructor")
-        type && type.kind_of?(V8::C::Function) && type.GetName().AsciiValue == "SyntaxError"
+      if ex && ex.kind_of?(V8::Object)
+        type = ex["constructor"]
+        type && type.kind_of?(V8::Function) && type.name == "SyntaxError"
       else
         false
       end

data/lib/v8/portal.rb

@@ -186,7 +186,9 @@ module V8
       if external && !external.IsEmpty()
         external.Value()
       else
-        yield.new(value, self)
+        yield.new(value, self).tap do |object|
+          value.SetHiddenValue(C::String::NewSymbol("TheRubyRacer::RubyObject"), C::External::New(object))
+        end
       end
     end
 

data/lib/v8/version.rb

@@ -0,0 +1,3 @@
+module V8
+  VERSION = "0.8.1.pre1"
+end

data/lib/v8.rb

@@ -2,7 +2,7 @@ $:.unshift(File.dirname(__FILE__)) unless
   $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
 
 module V8
-  VERSION = '0.8.0'
+  require 'v8/version'
   require 'v8/v8' #native glue
   require 'v8/portal'
   require 'v8/portal/functions'

data/spec/redjs/jsapi_spec.rb

@@ -84,6 +84,13 @@ describe "Ruby Javascript API" do
       end
     end
 
+    it "always returns the same ruby object for a single javascript object" do
+      obj = @cxt.eval('obj = {}')
+      obj.should be @cxt['obj']
+      @cxt.eval('obj').should be @cxt['obj']
+      @cxt['obj'].should be @cxt['obj']
+    end
+
     it "converts arrays to javascript" do
       @cxt['a'] = [1,2,4]
       @cxt.eval('var sum = 0;for (var i = 0; i < a.length; i++) {sum += a[i]}; sum').should == 7
@@ -230,7 +237,7 @@ describe "Ruby Javascript API" do
 
       it "reports ruby methods that do not exist as undefined" do
         Context.new(:with => Object.new) do |cxt|
-          cxt.eval('this.foobar').should be_nil 
+          cxt.eval('this.foobar').should be_nil
         end
       end