opal-cj 0.7.0.beta1

data/CONTRIBUTING.md

@@ -0,0 +1,41 @@
+# Contributing
+
+This is the issue tracker for Opal. If you have a more general question about
+using opal (or related libraries) then use the
+[google group for opal](http://groups.google.com/forum/#!forum/opalrb), or the
+[#opal](http://webchat.freenode.net/?channels=opal) irc channel on
+FreeNode.
+
+## Contributing
+
+1. Before opening a new issue, search for previous discussions including closed
+ones. Add comments there if a similar issue is found.
+
+2. Please report the version on which the issue is found.
+
+3. Before sending pull requests make sure all tests run and pass (see below).
+
+4. Make sure to use a similar coding style to the rest of the code base. In ruby
+and javascript code we use 2 spaces (no tabs).
+
+## Quick Start
+
+Clone repo:
+
+```
+$ git clone git://github.com/opal/opal.git
+```
+
+Get dependencies:
+
+```
+$ bundle
+```
+
+Run the test suite:
+
+```
+$ bundle exec rake
+```
+
+See the [README](https://github.com/opal/opal/blob/master/README.md#running-tests) for further details.

data/Gemfile

@@ -0,0 +1,27 @@
+source 'https://rubygems.org'
+gemspec
+
+# Stick with older racc until
+# https://github.com/tenderlove/racc/issues/22
+# is solved.
+gem 'racc', '< 1.4.10' if RUBY_ENGINE == 'jruby'
+gem 'json', '< 1.8.1'  if RUBY_VERSION.to_f == 2.1 and RUBY_ENGINE == 'ruby'
+gem 'rubysl', :platform => :rbx
+gem 'thin', platform: :mri
+
+# Uncomment to try with sprockets 3.0:
+#
+#   gem 'sprockets', '~> 3.0.0.beta'
+
+group :repl do
+  gem 'therubyracer', :platform => :mri, :require => 'v8'
+  gem 'therubyrhino', :platform => :jruby
+end
+
+unless ENV['CI']
+  gem 'rb-fsevent'
+  gem 'guard', require: false
+  gem 'terminal-notifier-guard'
+end
+
+gem 'mspec', github: 'opal/mspec'

data/Guardfile

@@ -0,0 +1,77 @@
+require 'guard/plugin'
+
+class ::Guard::Opal < Plugin
+  def mspec *paths
+    command = ['bundle', 'exec', './bin/opal-mspec', *paths.flatten]
+    result = time(:mspec, *paths) { system *command }
+    notify 'MSpec', result
+  end
+
+  def rspec *paths
+    command = ['bundle', 'exec', 'rspec', *paths.flatten]
+    result = time(:rspec, *paths) { system *command }
+    notify 'RSpec', result
+  end
+
+  def notify lib, result
+    if result
+      ::Guard::Notifier.notify(
+        'Success ♥︎', title: "#{lib} results", image: :success, priority: 1
+      )
+    else
+      ::Guard::Notifier.notify(
+        'Failed ♠︎', title: "#{lib} results", image: :failed, priority: 1
+      )
+    end
+  end
+
+  def color *args
+    Guard::UI.send :color, *args
+  end
+
+  def terminal_columns
+    cols = `tput cols 2> /dev/tty`.strip.to_i
+    ($?.success? && cols.nonzero?) ? cols : 80
+  end
+
+  def time *titles
+    columns = terminal_columns
+    puts color("=== running: #{titles.join(' ')} ".ljust(columns,'='), :cyan)
+    s = Time.now
+    result = yield
+    t = (Time.now - s).to_f
+    puts color("=== time: #{t} seconds ".ljust(columns, '='), :cyan)
+    result
+  end
+
+  def run_on_changes(changes)
+    m = changes
+    path = m[0]
+    puts color("Searching specs for #{m[0]}...", :yellow)
+    case path
+    when %r{grammar\.y$}  then system 'rake racc'
+    when %r{^spec/lib}     then rspec path
+    when %r{^spec/corelib} then mspec path
+    when %r{^opal/corelib}
+      name = File.basename(path, '.rb')
+      mspec "spec/corelib/core/#{name}/**/*_spec.rb"
+    when %r{^lib/opal/(.*)\.rb$}
+      name = $1
+      specs = Dir["spec/lib/#{name}_spec.rb"]
+      rspec *specs
+    end
+  end
+
+  def run_all
+    time(:all) { system 'bundle', 'exec', 'rake' }
+  end
+end
+
+guard :opal do
+  ignore %r{^(tmp|tasks|pkg|cdn|build|node_modules|grammar.rb)}
+  watch %r{^spec/.*}
+  watch %r{^lib/.*}
+  watch %r{^bin/.*}
+  watch %r{^opal/.*}
+  watch %r{^stdlib/.*}
+end

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (C) 2013 by Adam Beynon
+
+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,178 @@
+# Opal
+
+[![Build Status](http://img.shields.io/travis/opal/opal/master.svg?style=flat)](http://travis-ci.org/opal/opal)
+[![Gem Version](http://img.shields.io/gem/v/opal.svg?style=flat)](http://badge.fury.io/rb/opal)
+[![Code Climate](http://img.shields.io/codeclimate/github/opal/opal.svg?style=flat)](https://codeclimate.com/github/opal/opal)
+
+Opal is a ruby to javascript source-to-source compiler. It also has an
+implementation of the ruby corelib.
+
+Opal is [hosted on github](http://github.com/opal/opal), and there
+is a Freenode IRC channel at [#opal](http://webchat.freenode.net/?channels=opal),
+ask questions on [stackoverflow (tag #opalrb)](http://stackoverflow.com/questions/ask?tags=opalrb).
+
+[![Stack Overflow](http://img.shields.io/badge/stackoverflow-%23opalrb-orange.svg?style=flat)](http://stackoverflow.com/questions/ask?tags=opalrb)
+[![API doc](http://img.shields.io/badge/doc-api-blue.svg?style=flat)](http://opalrb.org/docs/api)
+[![Gitter chat](http://img.shields.io/badge/gitter-opal%2Fopal-009966.svg?style=flat)](https://gitter.im/opal/opal)
+
+
+
+## Usage
+
+See the website, [http://opalrb.org](http://opalrb.org).
+
+### Compiling ruby code
+
+`Opal.compile` is a simple interface to just compile a string of ruby into a
+string of javascript code.
+
+```ruby
+Opal.compile("puts 'wow'")  # => "(function() { ... })()"
+```
+
+Running this by itself is not enough, you need the opal runtime/corelib.
+
+### Building the corelib
+
+`Opal::Builder` can be used to build the runtime/corelib into a string.
+
+```ruby
+Opal::Builder.build('opal') #=> "(function() { ... })()"
+```
+
+### Running compiled code
+
+You can write the above two strings to file, and run as:
+
+```html
+<!DOCTYPE html>
+<html>
+  <head>
+    <script src="opal.js"></script>
+    <script src="app.js"></script>
+  </head>
+</html>
+```
+
+Just open a browser to this page and view the console.
+
+## Running tests
+
+First, install dependencies:
+
+    $ bundle install
+
+RubySpec related repos must be cloned as a gitsubmodules:
+
+    $ git submodule update --init
+
+The test suite can be run using (requires [phantomjs][]):
+
+    $ rake
+
+This will command will run all RSpec and MSpec examples in sequence.
+
+#### Automated runs
+
+A `Guardfile` with decent mappings between specs and lib/corelib/stdlib files is in place.
+Run `bundle exec guard -i` to have it started.
+
+
+### MSpec
+
+[MSpec][] tests can be run with:
+
+    $ rake mspec
+
+Alternatively, you can just load up a rack instance using `rackup spec/config.ru`, and
+visit `http://localhost:9292/` in any web browser.
+
+
+### Rspec
+
+[RSpec][] tests can be run with
+
+    $ rake rspec
+
+
+## Code Overview
+
+What code is supposed to run where?
+
+* `lib/` code runs inside your ruby env. It compiles ruby to javascript.
+* `opal/` is the runtime/corelib for our implementation (runs in browser)
+* `stdlib/` is our implementation of ruby stdlib. It is optional (for browser).
+
+### lib
+
+The `lib` directory holds the opal parser/compiler used to compile ruby
+into javascript. It is also built ready for the browser into `opal-parser.js`
+to allow compilation in any javascript environment.
+
+### corelib
+
+This directory holds the opal runtime and corelib implemented in ruby and
+javascript.
+
+### stdlib
+
+Holds the stdlib that opal currently supports. This includes Observable,
+StringScanner, Date, etc.
+
+### spec
+
+* **rubyspecs** (file) a whitelist of RubySpec files to be ran
+* **corelib** RubySpec examples (submodule)
+* **stdlib** `rubysl-*` examples (submodules)
+* **filters** The list of MSpec/RubySpec examples that are either bugs or unsupported
+* **opal** opal additions/special behaviour in the runtime/corelib
+* **cli** specs for opal lib (parser, lexer, grammar, compiler etc)
+
+## Browser support
+
+* Internet Explorer 6+
+* Firefox (Current - 1) or Current
+* Chrome (Current - 1) or Current
+* Safari 5.1+
+* Opera 12.1x or (Current - 1) or Current
+
+Any problem above browsers should be considered and reported as a bug.
+
+(Current - 1) or Current denotes that we support the current stable version of
+the browser and the version that preceded it. For example, if the current
+version of a browser is 24.x, we support the 24.x and 23.x versions.
+
+12.1x or (Current - 1) or Current denotes that we support Opera 12.1x as well
+as last 2 versions of Opera. For example, if the current Opera version is 20.x,
+we support Opera 12.1x, 19.x and 20.x but not Opera 15.x through 18.x.
+
+Cross-browser testing sponsored by [BrowserStack](http://browserstack.com).
+
+## License
+
+(The MIT License)
+
+Copyright (C) 2013 by Adam Beynon
+
+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.
+
+
+[phantomjs]: http://phantomjs.org
+[MSpec]: https://github.com/rubyspec/mspec#readme
+[RSpec]: https://github.com/rspec/rspec#readme

data/Rakefile

@@ -0,0 +1,116 @@
+# FIXME: there must be a better way
+Encoding.default_external = 'utf-8'
+
+require 'bundler'
+Bundler.require
+Bundler::GemHelper.install_tasks
+
+import 'tasks/github.rake'
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:rspec) do |t|
+  t.pattern = 'spec/lib/**/*_spec.rb'
+end
+
+require 'mspec/opal/rake_task'
+MSpec::Opal::RakeTask.new(:mspec) do |config|
+  config.pattern = ENV['MSPEC_PATTERN'] if ENV['MSPEC_PATTERN']
+  config.basedir = ENV['MSPEC_BASEDIR'] if ENV['MSPEC_BASEDIR']
+end
+
+task :default => [:rspec, :mspec]
+
+
+require 'opal/version'
+desc <<-DESC
+Build *corelib* and *stdlib* to "build/"
+
+You can restrict the file list with the FILES env var (comma separated)
+and the destination dir with the DIR env var.
+
+Example: rake dist DIR=/tmp/foo FILES='opal.rb,base64.rb'
+Example: rake dist DIR=cdn/opal/#{Opal::VERSION}
+Example: rake dist DIR=cdn/opal/master
+DESC
+task :dist do
+  require 'opal/util'
+
+  Opal::Processor.arity_check_enabled = false
+  Opal::Processor.const_missing_enabled = false
+  Opal::Processor.dynamic_require_severity = :warning
+  env = Opal::Environment.new
+
+  build_dir = ENV['DIR'] || 'build'
+  files     = ENV['FILES'] ? ENV['FILES'].split(',') :
+              Dir['{opal,stdlib}/*.rb'].map { |lib| File.basename(lib, '.rb') }
+
+  Dir.mkdir build_dir unless File.directory? build_dir
+  width = files.map(&:size).max
+
+  files.each do |lib|
+    print "* building #{lib}...".ljust(width+'* building ... '.size)
+    $stdout.flush
+
+    src = env[lib].to_s
+    min = Opal::Util.uglify src
+    gzp = Opal::Util.gzip min
+
+    File.open("#{build_dir}/#{lib}.js", 'w+')        { |f| f << src }
+    File.open("#{build_dir}/#{lib}.min.js", 'w+')    { |f| f << min } if min
+    File.open("#{build_dir}/#{lib}.min.js.gz", 'w+') { |f| f << gzp } if gzp
+
+    print "done. ("
+    print "development: #{('%.2f' % (src.size/1000.0)).rjust(6)}KB"
+    print  ", minified: #{('%.2f' % (min.size/1000.0)).rjust(6)}KB" if min
+    print   ", gzipped: #{('%.2f' % (gzp.size/1000.0)).rjust(6)}KB" if gzp
+    puts  ")."
+  end
+end
+
+desc 'Rebuild grammar.rb for opal parser'
+task :racc do
+  %x(racc -l lib/opal/parser/grammar.y -o lib/opal/parser/grammar.rb)
+end
+
+desc 'Remove any generated file.'
+task :clobber do
+  rm_r './build'
+end
+
+namespace :doc do
+  doc_repo = Pathname(ENV['DOC_REPO'] || 'gh-pages')
+  doc_base = doc_repo.join('doc')
+  current_git_release = -> { `git rev-parse --abbrev-ref HEAD`.chomp }
+  template_option = "--template opal --template-path #{doc_repo.join('yard-templates')}"
+
+  directory doc_repo.to_s do
+    remote = ENV['DOC_REPO_REMOTE'] || '.'
+    sh 'git', 'clone', '-b', 'gh-pages', '--', remote, doc_repo.to_s
+  end
+
+  task :corelib => doc_repo.to_s do
+    git  = current_git_release.call
+    name = 'corelib'
+    glob = 'opal/**/*.rb'
+
+    command = "doxx --template #{doc_repo.join('doxx-templates/opal.jade')} "\
+              "--source opal/corelib --target #{doc_base}/#{git}/#{name} "\
+              "--title \"Opal runtime.js Documentation\" --readme opal/README.md"
+    puts command; system command or $stderr.puts "Please install doxx with: npm install"
+
+    command = "yard doc #{glob} #{template_option} "\
+              "--readme opal/README.md -o #{doc_base}/#{git}/#{name}"
+    puts command; system command
+  end
+
+  task :stdlib => doc_repo do
+    git  = current_git_release.call
+    name = 'stdlib'
+    glob = '{stdlib/**/*,opal/compiler,opal/erb,opal/version}.rb'
+    command = "yard doc #{glob} #{template_option} "\
+              "--readme stdlib/README.md -o gh-pages/doc/#{git}/#{name}"
+    puts command; system command
+  end
+end
+
+task :doc => ['doc:corelib', 'doc:stdlib']