therubyrhino 2.0.2 → 2.0.3

data/.gitignore

@@ -5,3 +5,4 @@ doc
 .rvmrc
 .bundle
 Gemfile.lock
+spec/deprecations.log

data/.rspec

@@ -0,0 +1 @@
+--color --format documentation

data/Gemfile

@@ -1,4 +1,4 @@
-source :rubygems
+source "https://rubygems.org"
 
 gemspec :name => "therubyrhino"
 
@@ -15,4 +15,7 @@ group :test do
     gem 'therubyrhino_jar', :path => '.'
   end
   gem 'less', '>= 2.2.1', :require => nil
-end
+end
+
+gem 'rake', :require => false, :group => :development
+gem 'jruby-openssl', :group => :development if JRUBY_VERSION < '1.7'

data/{History.txt → History.md}

@@ -1,55 +1,63 @@
-=== 2.0.2 2012-12-05
+## 2.0.3 2014-02-20
+
+* minor fix for time_to_js when scope not set (#27)
+* Jar path now avoids using a glob, which doesn't work inside a jar (#26)
+* use Rhino.warn explicitly otherwise it's a Kernel.warn
+
+## 2.0.2 2012-12-05
 
 * handle Rhino's 64K code generation (method) limit on the fly (#23)
 * correct explicit Ruby equality == and eql? (JRuby 1.7.1 compat)
 * allow to set javascript version programatically - globally also allow
   reading it from system properties by default
-* allow to set optimization level globally also allow reading it from 
-  system properties by default 
-* make sure Ruby function wrapper has (Ruby) #call semantics just like 
+* allow to set optimization level globally also allow reading it from
+  system properties by default
+* make sure Ruby function wrapper has (Ruby) #call semantics just like
   JavaScript functions exposed into the Ruby side
 * function's return value should be converted to Ruby (Ruby #call style)
 
-=== 2.0.1 2012-08-24
+## 2.0.1 2012-08-24
 
 * JSError improvement to preserve nested Ruby error message
 * jar-1.7.4 regression fix e.g when loading less (#25)
 * error.message should be a String value (1.9.3 compat)
 
-=== jar-1.7.4 2012-08-02
+## jar-1.7.4 2012-08-02
 
 * updated to new Mozilla Rhino 1.7R4 release, notes:
   https://developer.mozilla.org/en/New_in_Rhino_1.7R4
 
-=== 2.0.0 2012-08-02
-This release is functionally the same as therubyrhino-1.73.5 as long 
+## 2.0.0 2012-08-02
+
+This release is functionally the same as therubyrhino-1.73.5 as long
 as the therubyrhino_jar-1.7.3 gem dependency is used along with it.
 
 * new versioning scheme - old scheme used for the jar gem
 * moved out the rhino.jar into a separate therubyrhino_jar gem
 
-=== jar-1.7.3 2012-08-02
+## jar-1.7.3 2012-08-02
 
 * therubyrhino_jar gem packaged with Mozilla Rhino 1.7R3
 
 
-=== 1.73.5 2012-07-25
+## 1.73.5 2012-07-25
 
 * #to_s functionName typo fix for org.mozilla.javascript.ScriptStackElement
 * make sure thrown values are correctly raised from inside JS functions
 * a better #inspect for native rhino objects
 * correct JavaScript error handling for Function#apply
 
-=== 1.73.4 2012-05-21
+## 1.73.4 2012-05-21
 
 * allow rhino.jar path overrides with Rhino::JAR_PATH
 * 'correct' JSError#inspect - show thrown value
-* fix JSError#javascript_backtrace to be an array and add it on top of the 
+* fix JSError#javascript_backtrace to be an array and add it on top of the
   (ruby) backtrace
 * make sure JSError#cause always points to native rhino cause (#19)
 * avoid using instance variables with 'native' JS::Context (JRuby 1.7 warnings)
 
-=== 1.73.3 2012-04-23
+## 1.73.3 2012-04-23
+
 RedJS 0.4 compatible
 
 * allow try-catch-ing ScriptError (besides StandardError) in JS
@@ -59,7 +67,8 @@ RedJS 0.4 compatible
 * Ruby StandardError wrapping so they can be try-catched as JS "error" values
 * Rhino::Context.new is expected to yield when block passed
 
-=== 1.73.2 2012-04-11
+## 1.73.2 2012-04-11
+
 RedJS 0.2.1 compatible
 
 * improve JSError#message + add JSError#value to reflect throw JS value
@@ -69,7 +78,8 @@ RedJS 0.2.1 compatible
 * restrictable limits now require Contex.new(:restrictable => true)
 * added Context#timeout_limit (to complete instruction_limit)
 
-=== 1.73.1 2011-11-28
+## 1.73.1 2011-11-28
+
 NOTE: this is a "major" code update from 1.73.0 with some incompatibilities
 although keeping the bits backward compatible as much as possible :
 
@@ -90,51 +100,58 @@ although keeping the bits backward compatible as much as possible :
 * support for setting JS version via Context.version
 * Rhino::J gets deprecated it's now know as Rhino::JS
 
-=== 1.73.0 2011-11-28
+## 1.73.0 2011-11-28
 
 * upgrade to rhino-1.7R3
 * cache objects passed to context - same object passed twice ends up the same
 * properly map ruby Time objects to javascript Date
 * jruby --1.9 improvements
 
-=== 1.72.8 2011-06-26
+## 1.72.8 2011-06-26
+
 * fix passing of options hash to ruby.
 
-=== 1.72.6 2009-11-30
+## 1.72.6 2009-11-30
+
 * 2 major enhancements:
   * evaluate an IO object such as a file or an socket input stream
   * load javascript sources directly into the context with the file system
 
-=== 1.72.5 2009-11-12
+## 1.72.5 2009-11-12
+
 * 2 major enhancements:
   * evaluate javascript with a ruby object as it's scope using Context#open(:with => object)
   * add eval_js() method to Object to evaluate in the context of that object
 
-=== 1.72.4 2009-11-12
+## 1.72.4 2009-11-12
+
 * 3 major enhancements:
   * automatically wrap/unwrap ruby and javascript arrays
   * automatically convert ruby method objects and Proc objects into javascript functions
   * Make functions defined in javascript callable from ruby
 
-=== 1.72.3 2009-11-11
+## 1.72.3 2009-11-11
+
 * 4 major enhancements:
   * greatly simplified interface to context by unifying context and scope
   * remove Context#open_std()
   * remove Context#standard
   * remove Context#init_standard_objects
 
-=== 1.72.2 2009-11-10
+## 1.72.2 2009-11-10
+
 * 1 major enhancement:
   * ability to limit the instruction count for a context
 
-=== 1.72.1 2009-11-09
+## 1.72.1 2009-11-09
+
 * 4 major enhancements:
   * easily manipulate javascript objects from ruby (NativeObject)
   * make NativeObject Enumerable
   * to_h and to_json for NativeObject
   * embed ruby instances and call methods from javascript
 
-=== 1.72.0 2009-09-24
+## 1.72.0 2009-09-24
 
 * 2 major enhancements:
   * evaluate javascript in jruby

data/README.md

@@ -0,0 +1,262 @@
+# therubyrhino
+
+Embed the Mozilla Rhino JavaScript interpreter into Ruby
+
+## REQUIREMENTS:
+
+* JRuby >= 1.6.8
+
+## INSTALL:
+
+`jruby -S gem install therubyrhino`
+
+## FEATURES/PROBLEMS:
+
+* Evaluate JavaScript from with in Ruby
+* Embed your Ruby objects into the JavaScript world
+
+## SYNOPSIS:
+
+1. JavaScript goes into Ruby
+2. Ruby Objects goes into JavaScript
+3. Our shark's in the JavaScript!
+
+```ruby
+require 'rhino'
+```
+
+* evaluate some simple JavaScript using `eval_js`:
+```ruby
+eval_js "7 * 6" #=> 42
+```
+
+* that's quick and dirty, but if you want more control over your environment,
+  use a `Context`:
+```ruby
+Rhino::Context.open do |context|
+  context['foo'] = "bar"
+  context.eval('foo') # => "bar"
+end
+```
+
+* evaluate a Ruby function from JavaScript:
+```ruby
+Rhino::Context.open do |context|
+  context["say"] = lambda {|word, times| word * times}
+  context.eval("say("Hello", 3)") #=> HelloHelloHello
+end
+```
+
+* embed a Ruby object into your JavaScript environment
+```ruby
+class MyMath
+  def plus(a, b)
+    a + b
+  end
+end
+
+Rhino::Context.open do |context|
+  context["math"] = MyMath.new
+  context.eval("math.plus(20, 22)") #=> 42
+end
+```
+
+* make a Ruby object be your JavaScript environment
+```ruby
+math = MyMath.new
+Rhino::Context.open(:with => math) do |context|
+  context.eval("plus(20, 22)") #=> 42
+end
+
+# or the equivalent
+
+math.eval_js("plus(20, 22)")
+```
+
+### Context Configuration
+
+* make your standard objects (Object, String, etc...) immutable:
+```ruby
+Rhino::Context.open(:sealed => true) do |context|
+  context.eval("Object.prototype.toString = function() {}") # this is an error!
+end
+```
+
+* turn on Java integration from JavaScript (probably a bad idea):
+```ruby
+Rhino::Context.open(:java => true) do |context|
+  context.eval("java.lang.System.exit()") # it's dangerous!
+end
+```
+
+* limit the number of instructions that can be executed to prevent rogue code:
+```ruby
+Rhino::Context.open(:restrictable => true) do |context|
+  context.instruction_limit = 100000
+  context.eval("while (true);") # => Rhino::RunawayScriptError
+end
+```
+
+* limit the time a script executes (rogue scripts):
+```ruby
+Rhino::Context.open(:restrictable => true, :java => true) do |context|
+  context.timeout_limit = 1.5 # seconds
+  context.eval %Q{
+    for (var i = 0; i < 100; i++) {
+      java.lang.Thread.sleep(100);
+    }
+  } # => Rhino::ScriptTimeoutError
+end
+```
+
+### 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:
+```ruby
+  File.open("mysource.js") do |file|
+    eval_js file, "mysource.js"
+  end
+```
+
+* or load it by filename:
+```ruby
+  Rhino::Context.open do |context|
+    context.load("mysource.js")
+  end
+```
+
+### Configurable Ruby access
+
+By default accessing Ruby objects from JavaScript is compatible with *therubyracer*:
+https://github.com/cowboyd/therubyracer/wiki/Accessing-Ruby-Objects-From-JavaScript
+
+Thus you end-up calling arbitrary no-arg methods as if they were JavaScript properties,
+since instance accessors (properties) and methods (functions) are indistinguishable:
+```ruby
+Rhino::Context.open do |context|
+  context['Time'] = Time
+  context.eval('Time.now')
+end
+```
+
+However, you can customize this behavior and there's another access implementation
+that attempts to mirror only attributes as properties as close as possible:
+```ruby
+class Foo
+  attr_accessor :bar
+
+  def initialize
+    @bar = "bar"
+  end
+
+  def check_bar
+    bar == "bar"
+  end
+end
+
+Rhino::Ruby::Scriptable.access = :attribute
+Rhino::Context.open do |context|
+  context['Foo'] = Foo
+  context.eval('var foo = new Foo()')
+  context.eval('foo.bar') # get property using reader
+  context.eval('foo.bar = null') # set property using writer
+  context.eval('foo.check_bar()') # called like a function
+end
+```
+
+If you happen to come up with your own access strategy, just set it directly :
+```ruby
+Rhino::Ruby::Scriptable.access = FooApp::BarAccess.instance
+```
+
+## Safe by default
+
+The Ruby Rhino 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 objects and
+functions. Nothing from the Ruby world is accessible.
+
+For Ruby objects that you explicitly embed into JavaScript, only the +public+
+methods "defined in their classes" are exposed by default e.g.
+```ruby
+class A
+  def a; 'a'; end
+end
+
+class B < A
+  def b; 'b'; end
+end
+
+Rhino::Context.open do |context|
+  context['a'] = A.new
+  context['b'] = B.new
+  context.eval("a.a()") # => 'a'
+  context.eval("b.b()") # => 'b'
+  context.eval("b.a()") # => 'TypeError: undefined property 'a' is not a function'
+end
+```
+
+## Context Customizations
+
+Just like the JVM packaged Rhino scripting engine, therubyrhino gem supports
+specifying JavaScript context properies (optimization level and language version)
+using system properties e.g. to force interpreted mode :
+
+  `jruby -J-Drhino.opt.level=-1 -rtherubyrhino -S ...`
+
+You might also set these programatically as a default for all created contexts :
+```ruby
+Rhino::Context.default_optimization_level = 1
+Rhino::Context.default_javascript_version = 1.6
+```
+
+Or using plain old JAVA_OPTS e.g. when setting JavaScript version :
+
+  `-Drhino.js.version=1.7`
+
+## Rhino
+
+Rhino is currently maintained at https://github.com/mozilla/rhino
+Release downloads are available at http://www.mozilla.org/rhino/download.html
+Rhino is licensed under the MPL 1.1/GPL 2.0 license.
+
+### Using a custom Rhino version
+
+Officially supported versions of Rhino's _js.jar_ are packaged separately as
+**therubyrhino_jar** gem. Make sure you're using the latest gem version if you
+feel like missing something available with Rhino. For experimenters the jar can
+be overriden by defining a `Rhino::JAR_PATH` before `require 'rhino'` e.g. :
+```ruby
+module Rhino
+  JAR_PATH = File.expand_path('lib/rhino/build/rhino1_7R5pre/js.jar')
+end
+# ...
+require 'rhino'
+```
+
+## LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2009-2013 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,9 +1,7 @@
 require 'bundler/setup'
 
 require 'rspec/core/rake_task'
-RSpec::Core::RakeTask.new do |spec|
-  spec.rspec_opts = ['--color', "--format documentation"]
-end
+RSpec::Core::RakeTask.new
 
 task :default => :spec
 

data/lib/rhino/context.rb

@@ -245,7 +245,7 @@ module Rhino
       do_open(&block)
     rescue JS::RhinoException => e
       if code_generation_error?(e)
-        warn "[INFO] Rhino byte-code generation failed forcing #{@native} into interpreted mode"
+        Rhino.warn "[INFO] Rhino byte-code generation failed forcing #{@native} into interpreted mode"
         self.optimization_level = -1
         retry
       end

data/lib/rhino/version.rb

@@ -1,3 +1,3 @@
 module Rhino
-  VERSION = "2.0.2"
+  VERSION = "2.0.3"
 end

data/lib/rhino/wormhole.rb

@@ -1,7 +1,7 @@
 
 module Rhino
   module To
-    
+
     def to_ruby(object)
       case object
       when JS::Scriptable::NOT_FOUND, JS::Undefined then nil
@@ -33,13 +33,13 @@ module Rhino
     def args_to_ruby(args)
       args.map { |arg| to_ruby(arg) }
     end
-    
+
     def args_to_javascript(args, scope = nil)
       args.map { |arg| to_javascript(arg, scope) }.to_java
     end
-    
+
     private
-    
+
       def array_to_ruby(js_array)
         js_array.length.times.map { |i| to_ruby( js_array.get(i, js_array) ) }
       end
@@ -60,7 +60,7 @@ module Rhino
       end
 
       def hash_to_javascript(rb_hash, scope = nil)
-        js_object = 
+        js_object =
           if scope && context = JS::Context.getCurrentContext
             context.newObject(scope)
           else
@@ -68,29 +68,27 @@ module Rhino
           end
         # JS::NativeObject implements Map put it's #put does :
         # throw new UnsupportedOperationException(); thus no []=
-        rb_hash.each_pair do |key, val| 
+        rb_hash.each_pair do |key, val|
           js_val = to_javascript(val, scope)
           JS::ScriptableObject.putProperty(js_object, key.to_s, js_val)
         end
         js_object
       end
-    
+
       def time_to_javascript(time, scope = nil)
         millis = time.to_f * 1000
         if scope && context = JS::Context.getCurrentContext
           JS::ScriptRuntime.newObject(context, scope, 'Date', [ millis ].to_java)
         else
           # the pure reflection way - god I love Java's private :
-          js_klass = JS::NativeObject.java_class
-          new = js_klass.getDeclaredConstructor
-          new.setAccessible(true)
+          js_klass = JS::NativeObject.java_class.to_java
+          new = js_klass.getDeclaredConstructor; new.setAccessible(true)
           js_date = new.newInstance
-          date = js_klass.getDeclaredField(:date)
-          date.setAccessible(true)
+          date = js_klass.getDeclaredField(:date); date.setAccessible(true)
           date.setDouble(js_date, millis)
           js_date
         end
       end
-      
+
   end
 end

data/spec/spec_helper.rb

@@ -1,8 +1,11 @@
-require 'bundler/setup'
-
 require 'rhino'
 
-require 'mocha'
+begin
+  require 'mocha/api'
+rescue LoadError
+  require 'mocha'
+end
+
 require 'redjs'
 
 module RedJS
@@ -32,4 +35,5 @@ end
 RSpec.configure do |config|
   config.filter_run_excluding :compat => /(0.5.0)|(0.6.0)/ # RedJS
   config.include Rhino::SpecHelpers
+  config.deprecation_stream = 'spec/deprecations.log'
 end

data/therubyrhino.gemspec

@@ -7,21 +7,20 @@ Gem::Specification.new do |s|
   s.version = Rhino::VERSION
   s.authors = ["Charles Lowell"]
   s.email = %q{cowboyd@thefrontside.net}
-  
+
   s.summary = %q{Embed the Rhino JavaScript interpreter into JRuby}
   s.description = %q{Call javascript code and manipulate javascript objects from ruby. Call ruby code and manipulate ruby objects from javascript.}
   s.homepage = %q{http://github.com/cowboyd/therubyrhino}
   s.rubyforge_project = %q{therubyrhino}
-  s.extra_rdoc_files = ["README.rdoc"]
-  
+  s.extra_rdoc_files = ["README.md"]
+  s.license = "MIT"
+
   s.require_paths = ["lib"]
   s.files = `git ls-files`.split("\n").sort.
     reject { |file| file == 'therubyrhino_jar.gemspec' || file =~ /^jar\// }
 
   s.add_dependency "therubyrhino_jar", '>= 1.7.3'
-  
-  s.add_development_dependency "rake"
-  s.add_development_dependency "rspec", "~> 2.10"
-  s.add_development_dependency "mocha"
-  s.add_development_dependency "jruby-openssl"
+
+  s.add_development_dependency "rspec", "~> 2.14.1"
+  s.add_development_dependency "mocha", "~> 0.13.3"
 end

metadata

@@ -2,7 +2,7 @@
 name: therubyrhino
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 2.0.2
+  version: 2.0.3
 platform: ruby
 authors: 
   - Charles Lowell
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-12-05 00:00:00 Z
+date: 2014-02-20 00:00:00 Z
 dependencies: 
   - !ruby/object:Gem::Dependency 
     name: therubyrhino_jar
@@ -24,49 +24,27 @@ dependencies:
     prerelease: false
     type: :runtime
   - !ruby/object:Gem::Dependency 
-    name: rake
+    name: rspec
     version_requirements: &id002 !ruby/object:Gem::Requirement 
       none: false
       requirements: 
-        - - ">="
+        - - ~>
           - !ruby/object:Gem::Version 
-            version: "0"
+            version: 2.14.1
     requirement: *id002
     prerelease: false
     type: :development
   - !ruby/object:Gem::Dependency 
-    name: rspec
+    name: mocha
     version_requirements: &id003 !ruby/object:Gem::Requirement 
       none: false
       requirements: 
         - - ~>
           - !ruby/object:Gem::Version 
-            version: "2.10"
+            version: 0.13.3
     requirement: *id003
     prerelease: false
     type: :development
-  - !ruby/object:Gem::Dependency 
-    name: mocha
-    version_requirements: &id004 !ruby/object:Gem::Requirement 
-      none: false
-      requirements: 
-        - - ">="
-          - !ruby/object:Gem::Version 
-            version: "0"
-    requirement: *id004
-    prerelease: false
-    type: :development
-  - !ruby/object:Gem::Dependency 
-    name: jruby-openssl
-    version_requirements: &id005 !ruby/object:Gem::Requirement 
-      none: false
-      requirements: 
-        - - ">="
-          - !ruby/object:Gem::Version 
-            version: "0"
-    requirement: *id005
-    prerelease: false
-    type: :development
 description: Call javascript code and manipulate javascript objects from ruby. Call ruby code and manipulate ruby objects from javascript.
 email: cowboyd@thefrontside.net
 executables: []
@@ -74,13 +52,14 @@ executables: []
 extensions: []
 
 extra_rdoc_files: 
-  - README.rdoc
+  - README.md
 files: 
   - .gitignore
+  - .rspec
   - .travis.yml
   - Gemfile
-  - History.txt
-  - README.rdoc
+  - History.md
+  - README.md
   - Rakefile
   - lib/rhino.rb
   - lib/rhino/context.rb
@@ -112,8 +91,8 @@ files:
   - spec/spec_helper.rb
   - therubyrhino.gemspec
 homepage: http://github.com/cowboyd/therubyrhino
-licenses: []
-
+licenses: 
+  - MIT
 post_install_message: 
 rdoc_options: []
 
@@ -140,7 +119,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: therubyrhino
-rubygems_version: 1.8.24
+rubygems_version: 1.8.29
 signing_key: 
 specification_version: 3
 summary: Embed the Rhino JavaScript interpreter into JRuby

data/README.rdoc

@@ -1,246 +0,0 @@
-= therubyrhino
-
-* http://github.com/cowboyd/therubyrhino
-* irc://irc.freenode.net/therubyrhino
-
-== DESCRIPTION:
-
-Embed the Mozilla Rhino JavaScript interpreter into Ruby
-
-== FEATURES/PROBLEMS:
-
-* Evaluate JavaScript from with in Ruby
-* Embed your Ruby objects into the JavaScript world
-
-== SYNOPSIS:
-
-1. JavaScript goes into Ruby
-2. Ruby Objects goes into JavaScript
-3. Our shark's in the JavaScript!
-
-  require 'rhino'
-  
-# evaluate some simple javascript
-  eval_js "7 * 6" #=> 42
-
-# that's quick and dirty, but if you want more control over your
-# environment, use a Context:
-  Rhino::Context.open do |cxt|
-    cxt['foo'] = "bar"
-    cxt.eval('foo') # => "bar"
-  end
-
-# evaluate a ruby function from JS
-  
-  Rhino::Context.open do |context|
-    context["say"] = lambda {|word, times| word * times}
-    context.eval("say("Hello", 3)") #=> HelloHelloHello
-  end
-  
-# embed a ruby object into your JS environment
-
-  class MyMath
-    def plus(lhs, rhs)
-      lhs + rhs
-    end
-  end
-
-  Rhino::Context.open do |context|
-    context["math"] = MyMath.new
-    context.eval("math.plus(20, 22)") #=> 42
-  end
-  
-# make a ruby object *be* your JS environment
-  math = MyMath.new
-  Rhino::Context.open(:with => math) do |context|
-    context.eval("plus(20, 22)") #=> 42
-  end
-  
-  #or the equivalent
-  
-  math.eval_js("plus(20, 22)")
-
-# Configure your embedding setup
-
-  # Make your standard objects (Object, String, etc...) immutable
-  Rhino::Context.open(:sealed => true) do |context|
-    context.eval("Object.prototype.toString = function() {}") # this is an error!
-  end
-  
-  #Turn on Java integration from javascript (probably a bad idea)
-  Rhino::Context.open(:java => true) do |context|
-    context.eval("java.lang.System.exit()") # it's dangerous!
-  end
-
-  #limit the number of instructions that can be executed in order to prevent
-  #rogue scripts
-  Rhino::Context.open(:restrictable => true) do |context|
-    context.instruction_limit = 100000
-    context.eval("while (true);") # => Rhino::RunawayScriptError
-  end
-
-  #limit the time a script executes
-  #rogue scripts
-  Rhino::Context.open(:restrictable => true, :java => true) do |context|
-    context.timeout_limit = 1.5 # seconds
-    context.eval %Q{ 
-        for (var i = 0; i < 100; i++) {
-            java.lang.Thread.sleep(100);
-        }
-    } # => Rhino::ScriptTimeoutError
-  end
-
-==== 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|
-    eval_js file, "mysource.js"
-  end
-
-# or load it by filename
-  Rhino::Context.open do |context|
-    context.load("mysource.js")
-  end
-
-==== Configurable Ruby access
-
-By default accessing Ruby objects from JavaScript is compatible with *therubyracer*:
-https://github.com/cowboyd/therubyracer/wiki/Accessing-Ruby-Objects-From-JavaScript
-
-Thus you end-up calling arbitrary no-arg methods as if they were JavaScript properties, 
-since instance accessors (properties) and methods (functions) are indistinguishable:
-
-  Rhino::Context.open do |context|
-    context['Time'] = Time
-    context.eval('Time.now')
-  end
-
-However, you can customize this behavior and there's another access implementation
-that attempts to mirror only attributes as properties as close as possible:
-
-  class Foo
-    attr_accessor :bar
-    
-    def initialize
-      @bar = "bar"
-    end
-    
-    def check_bar
-      bar == "bar"
-    end
-  end
-  
-  Rhino::Ruby::Scriptable.access = :attribute
-  Rhino::Context.open do |context|
-    context['Foo'] = Foo
-    context.eval('var foo = new Foo()')
-    context.eval('foo.bar') # get property using reader
-    context.eval('foo.bar = null') # set property using writer
-    context.eval('foo.check_bar()') # called like a function
-  end
-
-If you happen to come up with your own access strategy, just set it directly :
-
-  Rhino::Ruby::Scriptable.access = FooApp::BarAccess.instance
-
-=== Safe by default
-
-The Ruby Rhino 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 objects and 
-functions. Nothing from the Ruby world is accessible at all.
-
-For Ruby objects that you explicitly embed into JavaScript, only the +public+ 
-methods "defined in their classes" are exposed by default e.g.
-
-  class A
-    def a
-      "a"
-    end
-  end
-
-  class B < A
-    def b
-      "b"
-    end
-  end
-
-
-  Rhino::Context.open do |cxt|
-    cxt['a'] = A.new
-    cxt['b'] = B.new
-    cxt.eval("a.a()") # => 'a'
-    cxt.eval("b.b()") # => 'b'
-    cxt.eval("b.a()") # => 'TypeError: undefined property 'a' is not a function'
-  end
-  
-==== Using a custom Rhino version
-
-Officially supported versions of Rhino's _js.jar_ are packaged separately as 
-*therubyrhino_jar* gem. Make sure you're using the latest gem version if you 
-feel like missing something available with Rhino. For experimenters the jar can
-be overriden by defining a +Rhino::JAR_PATH+ before +require 'rhino'+ e.g. :
-
-  module Rhino
-    JAR_PATH = File.expand_path('lib/rhino/build/rhino1_7R5pre/js.jar')
-  end
-  # ...
-  require 'rhino'
-
-==== Context customizations
-
-Just like the JVM packaged Rhino scripting engine, therubyrhino gem supports
-specifying JavaScript context properies (optimization level and language version)
-using system properties e.g. to force interpreted mode :
-
-  jruby -J-Drhino.opt.level=-1 -rtherubyrhino -S ...
-
-You might also set these programatically as a default for all created contexts :
-
-  Rhino::Context.default_optimization_level = 1
-  Rhino::Context.default_javascript_version = 1.6
-
-Or using plain old JAVA_OPTS e.g. when setting JavaScript version :
-
-  -Drhino.js.version=1.7
-
-== Rhino
-
-Rhino is currently maintained at https://github.com/mozilla/rhino
-Release downloads are available at http://www.mozilla.org/rhino/download.html
-Rhino is licensed under the MPL 1.1/GPL 2.0 license.
-
-== REQUIREMENTS:
-
-* JRuby >= 1.6
-
-== INSTALL:
-
-* jruby -S gem install therubyrhino
-
-== LICENSE:
-
-(The MIT License)
-
-Copyright (c) 2009-2012 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.