esruby 0.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1d6ffc19124030c749400317f03e62006d7396d6
+  data.tar.gz: 473637c70b6dafa42c40bb5442a6e7950925402e
+SHA512:
+  metadata.gz: 8c769aaaa8fdf0752d520aef45fb6063af9ba1b6f9949fe1b7caa44f39126488150c40d2de02608a97c63cf03a60359cf25c3ee4cc9446640b082c8d7b553029
+  data.tar.gz: 46d2e11b8a653136b00392b59946867c66223b356813dc3ba060771309768dac5305fc17581aa829725b8a5f7d8ac07c483e5e6e8ff17851208d21e39f06b8b7

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2012 - 2015 Xuejie Xiao
+
+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,22 @@
+# ESRuby
+This project brings *mruby* to the browser. It uses *emscripten*
+(https://github.com/kripken/emscripten) to compile the mruby source code into
+JavaScript (ECMAScript) and runs in the browser. It is heavily based off *webruby* (https://github.com/xxuejie/webruby) but has been adjusted to work with the updates to *emscripten* and *mruby*.
+
+# How to Install
+
+*ESRuby* depends on [emsdk](http://kripken.github.io/emscripten-site/docs/getting_started/downloads.html) to provide emscripten and LLVM infrustructure. To try *ESRuby*, follow these steps:
+
+TODO: instructions will not work yet
+
+1. Install emsdk following instructions at [here](http://kripken.github.io/emscripten-site/docs/getting_started/downloads.html)
+2. Install latest incoming version of emscripten sdk(right now webruby still depends on code from incoming branch of emscripten, once this goes into a release version, we will lock the version for better stability)
+3. Activate latest incoming version
+4. Webruby should be able to pick up the correct version of emscripten from emsdk. If not, feel free to create an issue :)
+5. Install gem `gem install esruby`
+6. Create new project with `esruby new <name>`
+7. Build project with `esruby build [config.rb]`
+
+# License
+
+This project is distributed under the MIT License. See LICENSE for further details.

data/bin/esruby

@@ -0,0 +1,34 @@
+#!/usr/bin/env ruby
+# %% -*- ruby -*-
+
+require 'esruby'
+
+
+def show_help_and_exit!
+  puts <<END
+esruby: compile your favourite Ruby source code for the browser!
+
+Usage:
+  esruby clean [config.rb]
+  esruby build [config.rb]
+END
+  exit 0
+end
+
+
+case
+when ARGV[0] == 'clean'
+  config_path = ARGV[1] || 'config.rb'
+  config_path = File.expand_path(config_path)
+  show_help_and_exit! unless File.file?(config_path)
+  require config_path
+  ESRuby.clean
+when ARGV[0] == 'build'
+  config_path = ARGV[1] || 'config.rb'
+  config_path = File.expand_path(config_path)
+  show_help_and_exit! unless File.file?(config_path)
+  require config_path
+  ESRuby.build
+else
+  show_help_and_exit!
+end

data/lib/esruby.rb

@@ -0,0 +1,26 @@
+require 'erubis'
+require 'fileutils'
+require 'forwardable'
+require 'rake'
+
+require_relative "esruby/build.rb"
+require_relative "esruby/build/configuration.rb"
+require_relative "esruby/gem.rb"
+require_relative "esruby/gem/specification.rb"
+
+module ESRuby
+
+  def self.gem_directory
+    "#{File.dirname(__FILE__)}/.."
+  end
+
+  def self.clean
+    build = ESRuby::Build.build
+    FileUtils.rm_rf(build.build_directory)
+  end
+  
+  def self.build
+    ESRuby::Build.build.build
+  end
+  
+end

data/lib/esruby/build.rb

@@ -0,0 +1,140 @@
+module ESRuby
+  class Build
+    extend Forwardable
+    
+    class << self
+      attr_reader :build
+    end
+    
+    def self.new(*args)
+      raise 'can only build one project at a time' if @build
+      new_build = super
+      @build = new_build
+      new_build
+    end
+    
+    def_delegators :@configuration, :root_directory, :ruby_sources, :build_directory,
+      :build_mode, :output, :emsdk_directory, :mruby_directory, :gems
+    
+    def initialize(&block)
+      @configuration = Configuration.new
+      @configuration.instance_eval(&block)
+    end
+    
+    def build
+      FileUtils.mkdir_p(build_directory)
+      load_gems
+      build_mruby_config
+      build_mruby
+      build_app
+    end
+    
+    def gem_directory
+      ESRuby.gem_directory
+    end
+    
+    def load_gems
+      @configuration.gems.each do |gem_path|
+        load("#{gem_path}/esruby_gem")
+      end
+      nil
+    end
+    
+    def prepended_js_sources
+      js_files = []
+      Gem::Specification.specifications.each do |specification|
+        js_files += specification.prepended_js_sources
+      end
+      js_files += @configuration.prepended_js_sources
+      js_files
+    end
+    
+    def appended_js_sources
+      js_files = []
+      Gem::Specification.specifications.each do |specification|
+        js_files += specification.appended_js_sources
+      end
+      js_files += @configuration.appended_js_sources
+      js_files
+    end
+    
+    def emcc
+      "#{emsdk_directory}/emscripten/incoming/emcc"
+    end
+    
+    def emar
+      "#{emsdk_directory}/emscripten/incoming/emar"
+    end
+    
+    def build_mruby_config
+      template = File.read("#{gem_directory}/resources/build_config.eruby")
+      eruby = Erubis::Eruby.new(template)
+      config = {}
+      config[:emcc] = emcc
+      config[:emar] = emar
+      config[:prepended_js_sources] = prepended_js_sources
+      config[:appended_js_sources] = appended_js_sources
+      config[:optimization_argument] = optimization_argument
+      config[:closure_argument] = closure_argument
+      config[:debug_argument] = debug_argument
+      config[:build_directory] = build_directory
+      config[:gems] = gems
+      new_output = eruby.result(config)
+      output_path = "#{build_directory}/build_config.rb"
+      old_output = File.read(output_path) if File.exists?(output_path)
+      File.write(output_path, new_output) if (old_output != new_output) # only write if updated
+      ENV["MRUBY_CONFIG"] = output_path # used by the mruby build process
+    end
+    
+    def optimization_argument
+      case build_mode
+      when 'production'
+        "-O2"
+      when 'development'
+        "-O0"
+      else
+        raise
+      end
+    end
+    
+    def debug_argument
+      case build_mode
+      when 'production'
+        "-g0"
+      when 'development'
+        ""
+      else
+        raise
+      end
+    end
+    
+    def closure_argument
+      #"--closure 0"
+      ""
+    end
+    
+    def build_mruby
+      Dir.chdir(mruby_directory) do
+        RakeFileUtils.sh "rake"
+      end
+    end
+    
+    def build_app
+      mrbc = "#{mruby_directory}/bin/mrbc"
+      js_arguments = prepended_js_sources.map { |path| "--pre-js #{path}" }.join(" ")
+      js_arguments += appended_js_sources.map { |path| "--post-js #{path}" }.join(" ")
+      RakeFileUtils.sh "#{mrbc} -B app -o #{build_directory}/app.c #{ruby_sources.join(" ")}"
+      RakeFileUtils.sh "#{emcc} --bind -I #{mruby_directory}/include #{build_directory}/app.c -o #{build_directory}/app.o #{build_directory}/emscripten/lib/libmruby.a -lm #{js_arguments} #{optimization_argument} #{closure_argument} #{debug_argument}"
+      RakeFileUtils.sh "#{emcc} -std=c++11 --bind -I #{mruby_directory}/include #{gem_directory}/resources/cpp/esruby.cpp -o #{build_directory}/esruby.o #{build_directory}/emscripten/lib/libmruby.a -lm #{js_arguments} #{optimization_argument} #{closure_argument} #{debug_argument}"
+      RakeFileUtils.sh "#{emcc} -std=c++11 --bind -I #{mruby_directory}/include #{gem_directory}/resources/cpp/main.cpp -o #{build_directory}/main.o #{build_directory}/emscripten/lib/libmruby.a -lm #{js_arguments} #{optimization_argument} #{closure_argument} #{debug_argument}"
+      RakeFileUtils.sh "#{emcc} --bind -I #{mruby_directory}/include -o #{build_directory}/output.js #{build_directory}/app.o #{build_directory}/esruby.o #{build_directory}/main.o #{build_directory}/emscripten/lib/libmruby.a -lm #{js_arguments} #{optimization_argument} #{closure_argument} #{debug_argument}"
+      #if build.build_mode == 'production'
+      #  sh "java -jar #{PROJECT_DIRECTORY}/emsdk/emscripten/incoming/third_party/closure-compiler/compiler.jar --js #{build.absolute_build_directory}/output.js --js_output_file #{build.absolute_output}"
+      #else
+        FileUtils.cp("#{build_directory}/output.js", "#{output}")
+      #end
+      #--language_in=ECMASCRIPT6
+    end
+    
+  end
+end

data/lib/esruby/build/configuration.rb

@@ -0,0 +1,77 @@
+module ESRuby
+  class Build
+    class Configuration
+    
+      attr_reader :ruby_sources, :prepended_js_sources, :appended_js_sources,
+        :build_directory, :build_mode, :gems, :emsdk_directory, :mruby_directory,
+        :output
+      
+      def initialize
+        @root_directory = nil
+        @emsdk_directory = 'emsdk'
+        @mruby_directory = "#{ESRuby.gem_directory}/resources/mruby"
+        @output = 'output.js'
+        @ruby_sources = []
+        @prepended_js_sources = []
+        @appended_js_sources = []
+        @gems = []
+      end
+      
+      def root_directory
+        raise "'root_directory' not set" unless @root_directory
+        @root_directory
+      end
+      
+      def root_directory=(new_root_directory)
+        root_directory = File.expand_path(new_root_directory)
+        raise "'root_directory' not found" unless File.directory?(root_directory)
+        @root_directory = root_directory
+      end
+      
+      def add_ruby_source(path)
+        @ruby_sources << File.expand_path(path, root_directory)
+      end
+      
+      def add_prepended_js_source(path)
+        @prepended_js_sources << File.expand_path(path, root_directory)
+      end
+      
+      def add_appended_js_source(path)
+        @appended_js_sources << File.expand_path(path, root_directory)
+      end
+      
+      def build_directory=(new_build_directory)
+        @build_directory = File.expand_path(new_build_directory, root_directory)
+      end
+      
+      def build_mode=(new_build_mode)
+        new_build_mode = new_build_mode.to_s
+        raise 'build mode not valid' unless ['production', 'development'].include?(new_build_mode)
+        @build_mode = new_build_mode
+      end
+      
+      def output=(new_output)
+        @output = File.expand_path(new_output, root_directory)
+      end
+      
+      def emsdk_directory=(new_emsdk_directory)
+        emsdk_directory = File.expand_path(new_emsdk_directory, root_directory)
+        raise "'emsdk_directory' not found" unless File.directory?(emsdk_directory)
+        @emsdk_directory = emsdk_directory
+      end
+      
+      def mruby_directory=(new_mruby_directory)
+        mruby_directory = File.expand_path(new_mruby_directory, root_directory)
+        raise "'mruby_directory' not found" unless File.directory?(mruby_directory)
+        @mruby_directory = mruby_directory
+      end
+      
+      def add_gem(path)
+        path = File.expand_path(path, root_directory)
+        raise "gem #{path} not found" unless File.directory?(path)
+        @gems << path
+      end
+    
+    end
+  end
+end

data/lib/esruby/gem.rb

@@ -0,0 +1,5 @@
+module ESRuby
+  class Gem
+  
+  end
+end

data/lib/esruby/gem/specification.rb

@@ -0,0 +1,35 @@
+module ESRuby
+  class Gem
+    class Specification
+    
+      @specifications = []
+      
+      class << self
+        attr_reader :specifications
+      end
+      
+      def self.new(*arguments)
+        new_specification = super(*arguments)
+        @specifications << new_specification
+        new_specification
+      end
+      
+      attr_reader :prepended_js_sources, :appended_js_sources
+      
+      def initialize(&block)
+        @prepended_js_sources = []
+        @appended_js_sources = []
+        instance_eval(&block)
+      end
+      
+      def add_prepended_js_source(path)
+        @prepended_js_sources << path
+      end
+      
+      def add_appended_js_source(path)
+        @appended_js_sources << path
+      end
+      
+    end
+  end
+end

data/resources/build_config.eruby

@@ -0,0 +1,53 @@
+MRuby::Build.new do |conf|
+
+  conf.build_dir = "<%= build_directory %>/host"
+  
+  toolchain :gcc
+  
+  enable_debug
+  
+  conf.gembox 'default'
+  
+end
+
+
+MRuby::Toolchain.new('emscripten') do |conf|
+
+  toolchain :clang
+  
+  conf.compilers.each do |c|
+    c.defines += %w(MRB_GC_FIXED_ARENA)
+    c.flags << "-Wall"
+    c.flags << "-Wno-warn-absolute-paths"
+    c.flags << "--bind"
+    <% for path in prepended_js_sources %>
+    c.flags << "--pre-js <%= path %>"
+    <% end %>
+    <% for path in appended_js_sources %>
+    c.flags << "--post-js <%= path %>"
+    <% end %>
+    c.flags << "<%= optimization_argument %>"
+    c.flags << "<%= closure_argument %>"
+    c.flags << "<%= debug_argument %>"
+  end
+  
+  conf.cc.command = "<%= emcc %>"
+  conf.cxx.command = "<%= emcc %>"
+  conf.linker.command = "<%= emcc %>"
+  conf.archiver.command = "<%= emar %>"
+
+end
+
+
+MRuby::CrossBuild.new('emscripten') do |conf|
+
+  conf.build_dir = "<%= build_directory %>/emscripten"
+  
+  toolchain :emscripten
+  
+  conf.gembox('default')
+  <% for gem in gems %>
+  conf.gem(<%= gem.inspect %>)
+  <% end %>
+  
+end

data/resources/cpp/esruby.cpp

@@ -0,0 +1,64 @@
+#include "esruby.hpp"
+
+ESRuby::ESRuby()
+{
+  _mrb = mrb_open();
+  if (!_mrb)
+    throw std::runtime_error("error opening new mrb state");
+  _print_level = 1;
+}
+
+ESRuby::~ESRuby()
+{
+  mrb_close(_mrb);
+}
+
+int ESRuby::get_print_level()
+{
+  return _print_level;
+}
+
+void ESRuby::run()
+{
+  mrb_value result = mrb_load_irep(_mrb, app);
+  
+  // print levels:
+  switch(_print_level)
+  {
+    case 0: // do not print anything
+      break;
+    case 1: // print errors only
+      if (_mrb->exc)
+      {
+        mrb_p(_mrb, mrb_obj_value(_mrb->exc));
+        _mrb->exc = 0;
+      }
+      break;
+    case 2: // print errors and results
+      if (_mrb->exc)
+      {
+        mrb_p(_mrb, mrb_obj_value(_mrb->exc));
+        _mrb->exc = 0;
+      }
+      mrb_p(_mrb, result);
+      break;
+  }
+}
+
+void ESRuby::set_print_level(int new_print_level)
+{
+  if (new_print_level >= 0 && new_print_level <= 2)
+    _print_level = new_print_level;
+  else
+    throw std::runtime_error("print level not valid");
+}
+
+EMSCRIPTEN_BINDINGS(esruby)
+{
+  emscripten::class_<ESRuby>("Webruby")
+    .constructor<>()
+    .function("get_print_level", &ESRuby::get_print_level)
+    .function("run", &ESRuby::run)
+    .function("set_print_level", &ESRuby::set_print_level)
+  ;
+}