runjs 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8dfa257866a324091b0aa01a4e628ad4adce24c9
+  data.tar.gz: 8ffafee810cb03f6da1738c056a9f3c78594986e
+SHA512:
+  metadata.gz: 883f31c273ca2e28d6078eaa972bbbbab42bf47ef92a4822d4fa9f4963c4cd3a9dd7c11eb52593e1c2a9d443a8b7b7c153be96def9b85a44e55eec09caa4db68
+  data.tar.gz: f72abb482bdd5ebe8095c6d18184f0d866bfca7fcdc9ff4ddce358555fa216fcdc80cb28fc012011a8fe8f60ccafcfef4bfb73dbd4097f4a8cd42136c26f941b

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2013 AS Harbitz
+
+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/README.md

@@ -0,0 +1,94 @@
+# RunJS
+
+With RunJS you can run JavaScript code from Ruby.
+
+```ruby
+require 'runjs'
+puts RunJS.run('return "Hello World";')
+```
+
+## Installation
+
+```bash
+$ gem install runjs
+```
+
+RunJS depends on the `json` library. Starting with Ruby version 1.9 this is included, but on Ruby 1.8 you have to install the `json` gem. If this causes any problems, install the `json_pure` gem instead.
+
+```bash
+$ gem install json || gem install json_pure
+```
+
+## JavaScript Runtimes
+
+#### Supported runtimes
+
+* [TheRubyRacer](https://github.com/cowboyd/therubyracer)
+* [JavaScriptCore](http://trac.webkit.org/wiki/JavaScriptCore) included with OS X
+* [V8](http://code.google.com/p/v8/)
+* [Node](http://nodejs.org)
+* [JScript](http://msdn.microsoft.com/en-us/library/9bbdkx3k.aspx) on Windows
+
+RunJS will automatically select the first available runtime from the list above.
+
+#### Deprecated runtimes
+
+* [TheRubyRhino](https://github.com/cowboyd/therubyrhino)
+* [SpiderMonkey](http://www.mozilla.org/js/spidermonkey)
+
+To use TheRubyRhino or SpiderMonkey you have to set the runtime manually.
+
+#### Set the runtime
+
+You can control which runtime RunJS uses in your Ruby code.
+
+```ruby
+RunJS.runtime = RunJS::Node
+```
+
+Or with the RUNJS_RUNTIME environment variable.
+
+```bash
+$ export RUNJS_RUNTIME=Node
+```
+
+<!-- ## API -->
+
+## Examples
+
+```ruby
+require 'runjs'
+
+RunJS.run('return 2 + 2;')                     # => 4
+RunJS.call('Math.sqrt', 25)                    # => 5
+RunJS.apply('Array.prototype.slice', '"cat"')  # => ["c", "a", "t"]
+```
+
+#### Compiling CoffeeScript
+
+```ruby
+require 'runjs'
+require 'open-uri'
+
+url = 'http://jashkenas.github.com/coffee-script/extras/coffee-script.js'
+compiler = open(url).read
+
+coffee = 'alert yes'
+options = { header: true, bare: true }
+RunJS.context(compiler).apply('CoffeeScript.compile', 'CoffeeScript', coffee, options)
+
+# => // Generated by CoffeeScript 1.6.3
+# => alert(true);
+```
+
+<!-- ## RunJS vs. ExecJS -->
+
+## Credits
+
+Thanks to [Sam Stephenson](https://github.com/sstephenson), [Joshua Peek](https://github.com/josh) and the other contributors to [ExecJS](https://github.com/sstephenson/execjs). Although none of the code is directly copied, the API and code structure is almost identical. While coding, the ExecJS code was consulted all the time, and RunJS ended up like a rewrite of ExecJS.
+
+## License
+
+Copyright (c) 2013 AS Harbitz.
+
+RunJS is released under the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,32 @@
+$LOAD_PATH.unshift(File.expand_path('../lib', __FILE__))
+
+require 'runjs'
+require 'rake/testtask'
+
+desc 'Run tests for all the runtimes'
+task :test do
+  RunJS::RUNTIMES.each { |runtime| run_tests(runtime) }
+end
+
+RunJS::RUNTIMES.each do |runtime|
+  desc "Run tests for #{runtime.class_name}"
+  task "test:#{runtime.class_name.downcase}" do
+    run_tests(runtime)
+  end
+end
+
+Rake::TestTask.new 'test:runtime' do |test|
+  test.libs << 'test'
+  test.pattern = 'test/*_test.rb'
+  test.warning = true
+end
+Rake::Task['test:runtime'].clear_comments
+Rake::Task['test:runtime'].comment = 'Run tests for the default runtime'
+
+def run_tests(runtime)
+  ENV['RUNJS_RUNTIME'] = runtime.class_name
+  Rake::Task['test:runtime'].execute
+rescue SignalException
+  raise unless RUBY_PLATFORM == 'java'
+rescue
+end

data/lib/runjs.rb

@@ -0,0 +1,62 @@
+require 'runjs/encoding'
+require 'runjs/error'
+require 'runjs/os'
+require 'runjs/runtime'
+require 'runjs/system_runtime'
+
+require 'runjs/runtimes/java_script_core'
+require 'runjs/runtimes/jscript'
+require 'runjs/runtimes/node'
+require 'runjs/runtimes/spider_monkey'
+require 'runjs/runtimes/the_ruby_racer'
+require 'runjs/runtimes/the_ruby_rhino'
+require 'runjs/runtimes/v8'
+
+module RunJS
+
+  VERSION  = '0.1.0'
+
+  RUNTIMES = [TheRubyRacer, JavaScriptCore, V8, D8, Node, JScript,
+              TheRubyRhino, SpiderMonkey]
+
+  def self.runtime=(runtime)
+    raise RuntimeUnavailable, runtime unless runtime.available?
+    @runtime = runtime
+  end
+
+  def self.runtime
+    @runtime ||= from_environment(ENV['RUNJS_RUNTIME']) ||
+                 RUNTIMES.reject(&:deprecated?).find(&:available?) ||
+                 raise(RuntimeUnavailable)
+  end
+
+  def self.context(js)
+    runtime.new.context(js)
+  end
+
+  def self.run(js)
+    runtime.new.run(js)
+  end
+
+  def self.call(function, *args)
+    runtime.new.call(function, *args)
+  end
+
+  def self.apply(function, this, *args)
+    runtime.new.apply(function, this, *args)
+  end
+
+  def self.eval(js)
+    runtime.new.eval(js)
+  end
+
+private
+
+  def self.from_environment(name)
+    name = (name || '').sub(/^RunJS::/, '')
+    self.runtime = const_get(name) unless name.empty?
+  end
+
+  private_class_method(:from_environment)
+
+end

data/lib/runjs/encoding.rb

@@ -0,0 +1,24 @@
+module RunJS
+
+  module Encoding
+
+    if ''.respond_to?(:encode)
+
+      def encode(text, to, from = nil)
+        text.encode(to, from)
+      end
+
+    else
+
+      require 'iconv'
+
+      def encode(text, to, from = nil)
+        return text unless from
+        Iconv.conv(to, from, text)
+      end
+
+    end
+
+  end
+
+end

data/lib/runjs/error.rb

@@ -0,0 +1,59 @@
+module RunJS
+
+  class Error < StandardError
+  end
+
+  class CompileError < Error
+
+    attr_reader :source
+
+    def initialize(message, source)
+      @source = source
+      super(message)
+    end
+
+  end
+
+  class JavaScriptError < Error
+
+    attr_reader :error
+    attr_reader :source
+
+    def initialize(error, source)
+      @error = error
+      @source = source
+      super(get_message)
+    end
+
+    def [](key)
+      @error[key].nil? ? @error[key.to_s] : @error[key]
+    rescue
+      nil
+    end
+
+  private
+
+    def get_message
+      return '' if @error.respond_to?(:empty?) && @error.empty?
+      message = [self['name'], self['message']].compact
+      message.delete('')
+      message.empty? ? @error.to_s : message.join(': ')
+    end
+
+  end
+
+  class RuntimeUnavailable < Error
+
+    def initialize(runtime = nil)
+      if runtime
+        super('Could not find the runtime: ' + runtime.class_name)
+      else
+        super('Could not find a JavaScript runtime. ' +
+              "The supported runtimes are:\n" +
+              RUNTIMES.reject(&:deprecated?).map(&:class_name).join(', '))
+      end
+    end
+
+  end
+
+end

data/lib/runjs/os.rb

@@ -0,0 +1,80 @@
+require 'tempfile'
+require 'rbconfig'
+require 'shellwords'
+
+module RunJS
+
+  module OS
+
+    def self.which(cmd)
+      cmd += extension(cmd)
+      return cmd if executable?(cmd)
+      ENV['PATH'].split(File::PATH_SEPARATOR).each do |path|
+        path = File.join(path, cmd)
+        return path if executable?(path)
+      end
+      nil
+    end
+
+    def self.write_tempfile(text, &block)
+      file = Tempfile.new(['runjs', '.js'])
+      file.binmode  # Required on Windows when writing UTF-16
+      file.write(text)
+      file.close
+      yield file.path
+    ensure
+      file.close!
+    end
+
+    if RUBY_VERSION < '1.9' || RUBY_PLATFORM == 'java'
+
+      extend Encoding
+
+      def self.popen(cmd, options = {})
+        cmd = shell_escape(cmd) << ' 2>&1'
+        result = IO.popen(cmd) { |io| io.read }
+        encode(result, 'UTF-8', options[:external_encoding])
+      end
+
+    else
+
+      def self.popen(cmd, options = {})
+        cmd = cmd.dup.push({ :err => [:child, :out] })  # Unsupported by JRuby
+        options[:internal_encoding] ||= 'UTF-8'
+        options[:external_encoding] ||= 'UTF-8'
+        IO.popen(cmd, options) { |io| io.read }
+      end
+
+    end
+
+    def self.success?
+      $?.success?
+    end
+
+  private
+
+    def self.extension(cmd)
+      (windows? && File.extname(cmd).empty?) ? '.exe' : ''
+    end
+
+    def self.windows?
+      RbConfig::CONFIG['host_os'] =~ /mswin|mingw/
+    end
+
+    def self.executable?(cmd)
+      File.file?(cmd) && File.executable?(cmd)
+    end
+
+    def self.shell_escape(cmd)
+      if windows?
+        cmd.map { |arg| '"' + arg.gsub('"', '""') + '"' }.join(' ')
+      else
+        Shellwords.join(cmd)
+      end
+    end
+
+    private_class_method(:extension, :windows?, :executable?, :shell_escape)
+
+  end
+
+end

data/lib/runjs/runtime.rb

@@ -0,0 +1,65 @@
+begin
+  require 'json'
+rescue LoadError
+  require 'rubygems'
+  require 'json'
+end
+
+module RunJS
+
+  class Runtime
+
+    def self.deprecated?
+      @deprecated ||= false
+    end
+
+    def self.available?
+      false
+    end
+
+    def self.class_name
+      name.split('::').last
+    end
+
+    def context(js)
+      raise NotImplementedError
+    end
+
+    def run(js)
+      raise NotImplementedError
+    end
+
+    def call(function, *args)
+      apply(function, 'this', *args)
+    end
+
+    def apply(function, this, *args)
+      this = 'null' if this.nil?
+      args = args.to_json
+      run("return #{function}.apply(#{this}, #{args});")
+    end
+
+    def eval(js)
+      js = js.to_json
+      run("return eval(#{js});")
+    end
+
+  private
+
+    include Encoding
+
+    RUNNER = File.read(File.expand_path('../support/runner.js', __FILE__))
+
+    def merge_runner(js)
+      RUNNER % js
+    end
+
+    def parse_json(result, js)
+      result, ok = JSON.parse(result)
+      raise JavaScriptError.new(result, js) unless ok
+      result
+    end
+
+  end
+
+end