mirror of
https://github.com/rubyjs/therubyrhino
synced 2023-03-27 23:21:34 -04:00
108 lines
No EOL
3 KiB
Text
108 lines
No EOL
3 KiB
Text
= therubyrhino
|
|
|
|
* http://github.com/cowboyd/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
|
|
1. Ruby Objects goes into Javascript
|
|
1. Our shark's in the Javascript!
|
|
|
|
require 'rhino'
|
|
|
|
# evaluate some simple javascript
|
|
eval_js "7 * 6" #=> 42
|
|
|
|
# evaluate bytes read from any File/IO object:
|
|
File.open("mysource.js") do |file|
|
|
eval_js file, "mysource.js"
|
|
|
|
#or in the context of a controlled scope
|
|
Rhino::Context.open do |context|
|
|
context['foo'] = 'some global variable referenced in mysource.js'
|
|
context.eval(file, "mysource.js")
|
|
end
|
|
|
|
# evaluate a ruby function from javascript
|
|
|
|
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
|
|
|
|
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 javascript 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
|
|
|
|
== REQUIREMENTS:
|
|
|
|
* JRuby >= 1.3.0
|
|
|
|
== INSTALL:
|
|
|
|
* jgem install therubyrhino
|
|
|
|
== LICENSE:
|
|
|
|
(The MIT License)
|
|
|
|
Copyright (c) 2009 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. |