RubyGems - opal - Versions diffs - 0.3.21 → 0.3.22 - Mend

opal 0.3.21 → 0.3.22

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (297) hide show

data/.travis.yml +1 -4
data/Gemfile +9 -4
data/README.md +10 -589
data/Rakefile +51 -19
data/config.ru +17 -0
data/core/array.rb +42 -34
data/core/basic_object.rb +4 -4
data/core/browser.js +31 -0
data/core/class.rb +7 -7
data/core/enumerable.rb +65 -69
data/core/erb.rb +30 -0
data/core/error.rb +2 -3
data/core/hash.rb +47 -18
data/core/kernel.rb +15 -16
data/core/load_order +2 -1
data/core/module.rb +19 -37
data/core/numeric.rb +4 -2
data/core/object.rb +4 -0
data/core/proc.rb +6 -3
data/core/racc.rb +215 -0
data/core/regexp.rb +16 -21
data/core/runtime.js +141 -153
data/core/string.rb +41 -19
data/core/strscan.rb +61 -0
data/core/time.rb +1 -5
data/docs/index.md +616 -0
data/docs/post.html +2 -8
data/docs/pre.html +29 -26
data/docs/try.html +52 -0
data/lib/opal.rb +33 -3
data/lib/opal/builder.rb +14 -34
data/lib/opal/erb_parser.rb +19 -0
data/lib/opal/grammar.rb +7 -3
data/lib/opal/grammar.y +3 -0
data/lib/opal/lexer.rb +16 -8
data/lib/opal/parser.rb +156 -119
data/lib/opal/rake_task.rb +2 -2
data/lib/opal/scope.rb +9 -10
data/lib/opal/version.rb +1 -1
data/{test → spec}/core/array/allocate_spec.rb +0 -0
data/{test → spec}/core/array/append_spec.rb +0 -0
data/{test → spec}/core/array/assoc_spec.rb +0 -0
data/{test → spec}/core/array/at_spec.rb +0 -0
data/{test → spec}/core/array/clear_spec.rb +0 -0
data/{test → spec}/core/array/clone_spec.rb +0 -0
data/{test → spec}/core/array/collect_spec.rb +0 -0
data/{test → spec}/core/array/compact_spec.rb +0 -0
data/{test → spec}/core/array/concat_spec.rb +0 -0
data/{test → spec}/core/array/constructor_spec.rb +0 -0
data/{test → spec}/core/array/count_spec.rb +0 -0
data/{test → spec}/core/array/delete_at_spec.rb +0 -0
data/{test → spec}/core/array/delete_if_spec.rb +0 -0
data/{test → spec}/core/array/delete_spec.rb +0 -0
data/{test → spec}/core/array/each_index_spec.rb +0 -0
data/{test → spec}/core/array/each_spec.rb +0 -0
data/{test → spec}/core/array/element_reference_spec.rb +0 -0
data/{test → spec}/core/array/empty_spec.rb +0 -0
data/{test → spec}/core/array/eql_spec.rb +0 -0
data/{test → spec}/core/array/fetch_spec.rb +0 -0
data/{test → spec}/core/array/first_spec.rb +0 -0
data/{test → spec}/core/array/flatten_spec.rb +0 -0
data/{test → spec}/core/array/include_spec.rb +0 -0
data/{test → spec}/core/array/insert_spec.rb +0 -0
data/{test → spec}/core/array/last_spec.rb +0 -0
data/{test → spec}/core/array/length_spec.rb +0 -0
data/{test → spec}/core/array/map_spec.rb +0 -0
data/{test → spec}/core/array/minus_spec.rb +0 -0
data/{test → spec}/core/array/plus_spec.rb +0 -0
data/{test → spec}/core/array/pop_spec.rb +0 -0
data/{test → spec}/core/array/push_spec.rb +0 -0
data/{test → spec}/core/array/rassoc_spec.rb +0 -0
data/{test → spec}/core/array/reject_spec.rb +0 -0
data/{test → spec}/core/array/replace_spec.rb +0 -0
data/{test → spec}/core/array/reverse_each_spec.rb +0 -0
data/{test → spec}/core/array/reverse_spec.rb +0 -0
data/{test → spec}/core/array/size_spec.rb +0 -0
data/{test → spec}/core/array/to_ary_spec.rb +0 -0
data/{test → spec}/core/array/uniq_spec.rb +0 -0
data/{test → spec}/core/array/zip_spec.rb +0 -0
data/{test → spec}/core/class/fixtures/classes.rb +0 -0
data/{test → spec}/core/class/new_spec.rb +3 -0
data/{test → spec}/core/enumerable/all_spec.rb +3 -0
data/{test → spec}/core/enumerable/any_spec.rb +0 -0
data/{test → spec}/core/enumerable/collect_spec.rb +0 -0
data/{test → spec}/core/enumerable/count_spec.rb +0 -0
data/{test → spec}/core/enumerable/detect_spec.rb +0 -0
data/{test → spec}/core/enumerable/drop_spec.rb +0 -0
data/{test → spec}/core/enumerable/drop_while_spec.rb +0 -0
data/{test → spec}/core/enumerable/each_with_index_spec.rb +0 -0
data/{test → spec}/core/enumerable/each_with_object_spec.rb +0 -0
data/{test → spec}/core/enumerable/entries_spec.rb +0 -0
data/{test → spec}/core/enumerable/find_all_spec.rb +0 -0
data/{test → spec}/core/enumerable/find_index_spec.rb +0 -0
data/{test → spec}/core/enumerable/find_spec.rb +0 -0
data/{test → spec}/core/enumerable/first_spec.rb +0 -0
data/{test → spec}/core/enumerable/fixtures/classes.rb +0 -0
data/{test → spec}/core/enumerable/grep_spec.rb +0 -0
data/{test → spec}/core/enumerable/take_spec.rb +0 -0
data/{test → spec}/core/enumerable/to_a_spec.rb +0 -0
data/{test → spec}/core/false/and_spec.rb +0 -0
data/{test → spec}/core/false/inspect_spec.rb +0 -0
data/{test → spec}/core/false/or_spec.rb +0 -0
data/{test → spec}/core/false/to_s_spec.rb +0 -0
data/{test → spec}/core/false/xor_spec.rb +0 -0
data/{test → spec}/core/hash/allocate_spec.rb +0 -0
data/{test → spec}/core/hash/assoc_spec.rb +0 -0
data/{test → spec}/core/hash/clear_spec.rb +0 -0
data/{test → spec}/core/hash/clone_spec.rb +0 -0
data/{test → spec}/core/hash/default_spec.rb +0 -0
data/{test → spec}/core/hash/delete_if_spec.rb +0 -0
data/{test → spec}/core/hash/each_key_spec.rb +0 -0
data/{test → spec}/core/hash/each_pair_spec.rb +0 -0
data/{test → spec}/core/hash/each_spec.rb +0 -0
data/{test → spec}/core/hash/each_value_spec.rb +0 -0
data/{test → spec}/core/hash/element_reference_spec.rb +14 -1
data/{test → spec}/core/hash/element_set_spec.rb +0 -0
data/{test → spec}/core/hash/empty_spec.rb +0 -0
data/{test → spec}/core/hash/fetch_spec.rb +0 -0
data/{test → spec}/core/hash/flatten_spec.rb +0 -0
data/{test → spec}/core/hash/has_key_spec.rb +0 -0
data/{test → spec}/core/hash/has_value_spec.rb +0 -0
data/{test → spec}/core/hash/include_spec.rb +0 -0
data/{test → spec}/core/hash/index_spec.rb +0 -0
data/{test → spec}/core/hash/indexes_spec.rb +0 -0
data/{test → spec}/core/hash/indices_spec.rb +0 -0
data/{test → spec}/core/hash/invert_spec.rb +0 -0
data/{test → spec}/core/hash/keep_if_spec.rb +0 -0
data/{test → spec}/core/hash/key_spec.rb +0 -0
data/{test → spec}/core/hash/keys_spec.rb +0 -0
data/{test → spec}/core/hash/length_spec.rb +0 -0
data/{test → spec}/core/hash/member_spec.rb +0 -0
data/{test → spec}/core/hash/merge_spec.rb +0 -0
data/{test → spec}/core/hash/new_spec.rb +8 -0
data/{test → spec}/core/hash/rassoc_spec.rb +0 -0
data/{test → spec}/core/hash/replace_spec.rb +0 -0
data/{test → spec}/core/hash/select_spec.rb +0 -0
data/{test → spec}/core/hash/shift_spec.rb +0 -0
data/{test → spec}/core/hash/size_spec.rb +0 -0
data/{test → spec}/core/hash/update_spec.rb +0 -0
data/{test → spec}/core/hash/value_spec.rb +0 -0
data/{test → spec}/core/hash/values_at_spec.rb +0 -0
data/{test → spec}/core/hash/values_spec.rb +0 -0
data/{test → spec}/core/kernel/define_singleton_method_spec.rb +0 -0
data/{test → spec}/core/kernel/eql_spec.rb +0 -0
data/{test → spec}/core/kernel/equal_value_spec.rb +0 -0
data/{test → spec}/core/kernel/loop_spec.rb +0 -0
data/{test → spec}/core/kernel/nil_spec.rb +0 -0
data/{test → spec}/core/kernel/proc_spec.rb +4 -0
data/{test → spec}/core/kernel/rand_spec.rb +0 -0
data/{test → spec}/core/kernel/respond_to_spec.rb +0 -0
data/{test → spec}/core/kernel/send_spec.rb +0 -0
data/{test → spec}/core/kernel/tap_spec.rb +0 -0
data/{test → spec}/core/kernel/to_s_spec.rb +0 -0
data/{test → spec}/core/matchdata/to_a_spec.rb +0 -0
data/{test → spec}/core/nil/and_spec.rb +0 -0
data/{test → spec}/core/nil/inspect_spec.rb +0 -0
data/{test → spec}/core/nil/nil_spec.rb +0 -0
data/{test → spec}/core/nil/or_spec.rb +0 -0
data/{test → spec}/core/nil/to_a_spec.rb +0 -0
data/{test → spec}/core/nil/to_f_spec.rb +0 -0
data/{test → spec}/core/nil/to_i_spec.rb +0 -0
data/{test → spec}/core/nil/to_s_spec.rb +0 -0
data/{test → spec}/core/nil/xor_spec.rb +0 -0
data/{test → spec}/core/numeric/equal_value_spec.rb +0 -0
data/spec/core/proc/proc_tricks_spec.rb +7 -0
data/{test → spec}/core/range/begin_spec.rb +0 -0
data/{test → spec}/core/range/case_compare_spec.rb +0 -0
data/{test → spec}/core/range/end_spec.rb +0 -0
data/{test → spec}/core/regexp/match_spec.rb +0 -0
data/{test → spec}/core/string/capitalize_spec.rb +0 -0
data/{test → spec}/core/string/casecmp_spec.rb +0 -0
data/{test → spec}/core/string/chomp_spec.rb +0 -0
data/{test → spec}/core/string/chop_spec.rb +0 -0
data/{test → spec}/core/string/chr_spec.rb +0 -0
data/{test → spec}/core/string/comparison_spec.rb +0 -0
data/{test → spec}/core/string/downcase_spec.rb +0 -0
data/{test → spec}/core/string/element_reference_spec.rb +14 -2
data/{test → spec}/core/string/empty_spec.rb +0 -0
data/{test → spec}/core/string/end_with_spec.rb +0 -0
data/{test → spec}/core/string/fixtures/classes.rb +0 -0
data/{test → spec}/core/string/gsub_spec.rb +0 -0
data/{test → spec}/core/string/include_spec.rb +0 -0
data/{test → spec}/core/string/intern_spec.rb +0 -0
data/{test → spec}/core/string/length_spec.rb +0 -0
data/{test → spec}/core/string/lstrip_spec.rb +0 -0
data/{test → spec}/core/string/match_spec.rb +0 -0
data/{test → spec}/core/string/next_spec.rb +0 -0
data/{test → spec}/core/string/ord_spec.rb +0 -0
data/{test → spec}/core/string/partition_spec.rb +0 -0
data/{test → spec}/core/string/reverse_spec.rb +0 -0
data/{test → spec}/core/string/rstrip_spec.rb +0 -0
data/{test → spec}/core/string/size_spec.rb +0 -0
data/{test → spec}/core/string/slice_spec.rb +4 -1
data/{test → spec}/core/string/split_spec.rb +0 -0
data/{test → spec}/core/string/start_with_spec.rb +0 -0
data/{test → spec}/core/string/strip_spec.rb +0 -0
data/{test → spec}/core/string/sub_spec.rb +0 -0
data/{test → spec}/core/string/succ_spec.rb +0 -0
data/{test → spec}/core/string/sum_spec.rb +0 -0
data/{test → spec}/core/string/swapcase_spec.rb +0 -0
data/{test → spec}/core/string/to_a_spec.rb +0 -0
data/{test → spec}/core/string/to_f_spec.rb +0 -0
data/{test → spec}/core/string/to_i_spec.rb +0 -0
data/{test → spec}/core/string/to_s_spec.rb +0 -0
data/{test → spec}/core/string/to_str_spec.rb +0 -0
data/{test → spec}/core/string/to_sym_spec.rb +0 -0
data/{test → spec}/core/string/upcase_spec.rb +0 -0
data/{test → spec}/core/symbol/to_proc_spec.rb +0 -0
data/{test → spec}/core/time/at_spec.rb +0 -0
data/{test → spec}/core/time/day_spec.rb +0 -0
data/{test → spec}/core/time/friday_spec.rb +0 -0
data/{test → spec}/core/time/hour_spec.rb +0 -0
data/{test → spec}/core/time/min_spec.rb +0 -0
data/{test → spec}/core/time/monday_spec.rb +0 -0
data/{test → spec}/core/time/month_spec.rb +0 -0
data/{test → spec}/core/time/now_spec.rb +0 -0
data/{test → spec}/core/time/saturday_spec.rb +0 -0
data/{test → spec}/core/true/and_spec.rb +0 -0
data/{test → spec}/core/true/inspect_spec.rb +0 -0
data/{test → spec}/core/true/or_spec.rb +0 -0
data/{test → spec}/core/true/to_s_spec.rb +0 -0
data/{test → spec}/core/true/xor_spec.rb +0 -0
data/spec/grammar/lvar_spec.rb +2 -1
data/spec/grammar/str_spec.rb +1 -1
data/spec/grammar/xstr_spec.rb +1 -1
data/{test → spec}/index.html +3 -3
data/{test → spec}/language/alias_spec.rb +0 -0
data/{test → spec}/language/and_spec.rb +0 -0
data/{test → spec}/language/array_spec.rb +0 -0
data/{test → spec}/language/block_spec.rb +0 -0
data/{test → spec}/language/break_spec.rb +0 -0
data/{test → spec}/language/case_spec.rb +0 -0
data/{test → spec}/language/defined_spec.rb +0 -0
data/{test → spec}/language/ensure_spec.rb +2 -2
data/{test → spec}/language/fixtures/next.rb +0 -0
data/{test → spec}/language/fixtures/yield.rb +0 -0
data/{test → spec}/language/hash_spec.rb +0 -0
data/{test → spec}/language/if_spec.rb +0 -0
data/{test → spec}/language/literal_lambda_spec.rb +0 -0
data/{test → spec}/language/loop_spec.rb +0 -0
data/{test → spec}/language/metaclass_spec.rb +0 -0
data/{test → spec}/language/next_spec.rb +2 -0
data/{test → spec}/language/or_spec.rb +0 -0
data/{test → spec}/language/predefined_spec.rb +0 -0
data/{test → spec}/language/regexp_spec.rb +0 -0
data/{test → spec}/language/send_spec.rb +0 -0
data/{test → spec}/language/singleton_class_spec.rb +0 -0
data/{test → spec}/language/super_spec.rb +0 -0
data/{test → spec}/language/symbol_spec.rb +0 -0
data/{test → spec}/language/undef_spec.rb +0 -0
data/{test → spec}/language/unless_spec.rb +0 -0
data/{test → spec}/language/until_spec.rb +0 -0
data/{test → spec}/language/variables_spec.rb +0 -0
data/{test → spec}/language/while_spec.rb +0 -0
data/{test → spec}/language/yield_spec.rb +2 -0
data/{test → spec}/opal/array/subclassing_spec.rb +0 -0
data/{test → spec}/opal/array/to_json_spec.rb +0 -0
data/{test → spec}/opal/boolean/singleton_class_spec.rb +0 -0
data/{test → spec}/opal/boolean/to_json_spec.rb +0 -0
data/{test → spec}/opal/class/bridge_class_spec.rb +0 -0
data/spec/opal/erb/erb_spec.rb +15 -0
data/{test → spec}/opal/exception/subclassing_spec.rb +0 -0
data/{test → spec}/opal/hash/to_json_spec.rb +0 -0
data/spec/opal/hash/to_native_spec.rb +5 -0
data/{test → spec}/opal/json/parse_spec.rb +0 -0
data/{test → spec}/opal/kernel/to_json_spec.rb +0 -0
data/{test → spec}/opal/nil/to_json_spec.rb +0 -0
data/{test → spec}/opal/numeric/to_json_spec.rb +0 -0
data/{test → spec}/opal/runtime/call_spec.rb +0 -0
data/{test → spec}/opal/runtime/class_hierarchy_spec.rb +0 -0
data/{test → spec}/opal/runtime/def_spec.rb +0 -0
data/{test → spec}/opal/runtime/defined_spec.rb +0 -0
data/{test → spec}/opal/runtime/method_missing_spec.rb +3 -3
data/{test → spec}/opal/runtime/super_spec.rb +0 -0
data/{test → spec}/opal/string/subclassing_spec.rb +0 -0
data/{test → spec}/opal/string/to_json_spec.rb +0 -0
data/spec/opal/strscan/check_spec.rb +13 -0
data/spec/opal/strscan/scan_spec.rb +33 -0
data/spec/parser/simple_spec.rb +44 -0
data/spec/spec_helper.rb +7 -7
metadata +487 -497
data/core/dir.rb +0 -89
data/core/file.rb +0 -85
data/spec/browser_spec.rb +0 -28
data/spec/builder/fixtures/build_source/adam.rb +0 -0
data/spec/builder/fixtures/build_source/bar/a.rb +0 -0
data/spec/builder/fixtures/build_source/bar/wow/b.rb +0 -0
data/spec/builder/fixtures/build_source/bar/wow/cow/c.rb +0 -0
data/spec/builder/fixtures/build_source/beynon.rb +0 -0
data/spec/builder/fixtures/build_source/charles.js +0 -0
data/spec/builder/fixtures/build_source/foo/a.rb +0 -0
data/spec/builder/fixtures/build_source/foo/b.rb +0 -0
data/spec/builder/fixtures/build_source/foo/x.js +0 -0
data/spec/builder/fixtures/build_source/foo/y.js +0 -0
data/spec/builder/lib_name_for_spec.rb +0 -19
data/test/index.min.html +0 -12
data/test/spec_helper.rb +0 -4

data/.travis.yml CHANGED Viewed

@@ -5,7 +5,4 @@ rvm:
   - 1.9.3
 before_script:
-  - "export DISPLAY=:99.0"
-  - "sh -e /etc/init.d/xvfb start"
-  - "bundle exec rake build dependencies spec"
+  - "bundle exec rake opal parser"

data/Gemfile CHANGED Viewed

@@ -3,15 +3,20 @@ source :rubygems
 gemspec
 gem "rake"
-gem "racc"
-group :browser do
+# for rebuilding grammar.rb from grammar.y
+group :grammar do
+  gem "racc"
+end
+# running tests on command line
+group :testing do
+  gem "therubyracer", :require => 'v8'
   gem 'opal-spec', :git => 'git://github.com/adambeynon/opal-spec.git'
-  gem 'opal-dom', :git => 'git://github.com/adambeynon/opal-dom.git'
-  gem 'capybara'
 end
 group :docs do
   gem "redcarpet"
   gem "albino"
+  gem "rack"
 end

data/README.md CHANGED Viewed

@@ -1,610 +1,31 @@
 # Opal
-**Opal is a ruby to javascript compiler.** Opal aims to take ruby files
-and generate efficient javascript that maintains rubys features. Opal
-will, by default, generate fast and efficient code in preference to
-keeping all ruby features.
+[![Build Status](https://secure.travis-ci.org/adambeynon/opal.png?branch=master)](http://travis-ci.org/adambeynon/opal)
-Opal comes with an implementation of the ruby corelib, written in ruby,
-that uses a bundled runtime (written in javascript) that tie all the
-features together. Whenever possible Opal bridges to native javascript
-features under the hood. The Opal gem includes the compiler used to
-convert ruby sources into javascript.
+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/adambeynon/opal), and there
 is a Freenode IRC channel at `#opal`.
-## Downloads
-The Opal runtime and corelib are distributed here, and are required to
-run any code generated by opal.
-[Opal version 0.3.21](http://opalrb.org/opal.js) _(13.1kb Minified And Gzipped)_
-## Installation
-Opal should be added to your Gemfile:
-```ruby
-gem "opal"
-```
 ## Usage
-The easiest way to use opal is to create a rake task using the
-`RakeTask` helper class. Assuming you have a single ruby file in
-your Opal app called `app.rb`:
-```ruby
-# app.rb
-puts "Hello world"
-```
-Then create a rake task similar to:
-```ruby
-# Rakefile
-require 'opal/rake_task'
-Opal::RakeTask.new do |t|
-  t.files = ['app.rb']
-end
-```
-### Building the app
-Building the app is as simple as running:
-```
-rake opal:build
-```
-This will build all your listed files into `build/app_name.js`. The
-output name is based on the directory name. This can be overriden by
-setting the `.name` property in the task:
-```ruby
-Opal::RakeTask.new do |t|
-  t.files = ['app.rb']
-  t.name  = 'my_awesome_app'
-end
-```
-### Building opal runtime
-To run the app in the browser, the opal runtime is required. This can
-be built using:
-```
-rake opal:dependencies
-```
-Which will build `opal.js` into `./build`.
-The output directory can also be overriden inside the rake task:
-```ruby
-Opal::RakeTask.new do |t|
-  t.files = ['app.rb']
-  t.build_dir = 'out_dir'
-end
-```
-The output directory will be created if it doesn't exist.
-### Running the app
-The two compiled files need to be added to a html page so that they
-can run in the browser:
-```html
-<!doctype html>
-<html>
-<head>
-  <title>My awesome Opal app</title>
-  <script src="build/opal.js"></script>
-  <script src="build/my_awesome_app.js"></script>
-  <script>
-    // Run opal app
-    Opal.require('app')
-  </script>
-</head>
-<body>
-</body>
-</html>
-```
-If you open the html file, observe the console and you should see
-`"Hello World"` printed to the console.
-It is necessary to run `Opal.require('app')` as all files built for
-opal are registered so that they can be required inside the ruby
-code.
-### Adding dependencies
-The `opal:dependencies` rake task above can be used to build gems which
-are designed to run in the browser. `opal-dom` is a gem that given opal
-access to the DOM in the browser.
-`opal-dom` first needs to be installed as a gem (currently it is only
-available from git):
+See the website, [http://opalrb.org](http://opalrb.org).
-```ruby
-# Gemfile
-gem "opal"
-gem "opal-dom", :git => 'git://github.com/adambeynon/opal-dom.git'
-```
+## Running tests
-Then add it to the dependencies to build:
+Build the runtime, tests and dependencies:
-```ruby
-Opal::RakeTask.new do |t|
-  t.files = ['app.rb']
-  t.dependencies = ['opal-dom']
-end
 ```
-Running `rake opal:dependencies` now will also build
-`build/opal-dom.js`.
-We can now update our application code:
-```ruby
-# app.rb
-require 'opal-dom'
-alert "Hello!"
+rake opal parser
 ```
-And rebuild:
+Run tests using phantom.js runner:
 ```
-rake opal:build
+rake test
 ```
-And add `opal-dom` to the html page:
-```html
-<script src="build/opal.js"></script>
-<script src="build/opal-dom.js"></script>
-<script src="build/app.js"></script>
-```
-Now running the app should cause an alert box to display.
-## Features And Implementation
-Opal is a source-to-source compiler, so there is no VM as such and the
-compiled code aims to be as fast and efficient as possible, mapping
-directly to underlying javascript features and objects where possible.
-### Literals
-**self** is always compiled to `self`. Any context inside the generated
-code is usually a function body; whether it be a method body, a block,
-a class/module body or the file itself.
-**true** and **false** are compiled directly into their native boolean
-equivalents. This makes interaction a lot easier as there is no need
-to convert values to opal specific values. It does mean that there is
-only a `Boolean` ruby class available, not seperate `TrueClass` and
-`FalseClass` classes.
-**nil** is compiled into a `nil` reference, which inside all generated
-files points to a special object which is just an instance of the ruby
-`NilClass` class. This object is available externally to javascript as
-`Opal.nil`.
-```ruby
-nil         # => nil
-true        # => true
-false       # => false
-self        # => self
-```
-#### Strings
-Ruby strings are compiled directly into javascript strings for
-performance as well as readability. This has the side effect that Opal
-does not support mutable strings - i.e. all strings are immutable.
-#### Symbols
-For performance reasons, symbols compile directly into strings. Opal
-supports all the symbol syntaxes, but does not have a real `Symbol`
-class. Symbols and Strings can therefore be used interchangeably.
-```ruby
-"hello world!"    # => "hello world!"
-:foo              # => "foo"
-<<-EOS            # => "\nHello there.\n"
-Hello there.
-EOS
-```
-#### Numbers
-In Opal there is a single class for numbers; `Numeric`. To keep opal
-as performant as possible, ruby numbers are mapped to native numbers.
-This has the side effect that all numbers must be of the same class.
-Most relevant methods from `Integer`, `Float` and `Numeric` are
-implemented on this class.
-```ruby
-42        # => 42
-3.142     # => 3.142
-```
-#### Arrays
-Ruby arrays are compiled directly into javascript arrays. Special
-ruby syntaxes for word arrays etc are also supported.
-```ruby
-[1, 2, 3, 4]        # => [1, 2, 3, 4]
-%w[foo bar baz]     # => ["foo", "bar", "baz"]
-```
-#### Hash
-Inside a generated ruby script, a function `__hash` is available which
-creates a new hash. This is also available in javascript as `Opal.hash`
-and simply returns a new instance of the `Hash` class.
-```ruby
-{ :foo => 100, :baz => 700 }    # => __hash("foo", 100, "baz", 700)
-{ foo: 42, bar: [1, 2, 3] }     # => __hash("foo", 42, "bar", [1, 2, 3])
-```
-#### Range
-Similar to hash, there is a function `__range` available to create
-range instances.
-```ruby
-1..4        # => __range(1, 4, true)
-3...7       # => __range(3, 7, false)
-```
-#### Optimized Math Operators
-In ruby, all math operators are method calls, but compiling this into
-javascript would end up being too slow. For this reason, math
-operators are optimized to test first if the receiver is a number, and
-if so then to just carry out the math call.
-```ruby
-3 + 4
-```
-This ruby code will then be compiled into the following javascript:
-```javascript
-(a = 3, b = 4, typeof(a) === "number" ? a + b : /* method call */)
-```
-This ternary statement falls back on sending a method to the receiver
-so all non-numeric receivers will still have the normal method call
-being sent. This optimization makes math operators a **lot faster**.
-Currently, the optimized method calls are `+`, `-`, `*` and `/`.
-### method_missing
-Method missing is fully supported in Opal. It is implemented as
-efficiently as possible.
-### Logic and conditionals
-As per ruby, Opal treats only `false` and `nil` as falsy, everything
-else is a truthy value including `""`, `0` and `[]`. This differs from
-javascript as these values are also treated as false.
-For this reason, most truthy tests must check if values are `false` or
-`nil`.
-Taking the following test:
-```javascript
-val = 42
-if val
-  return 3.142;
-end
-```
-This would be compiled into:
-```ruby
-val = 42;
-if (val !== false && val !== nil) {
-  return 3.142;
-}
-```
-This makes the generated truthy tests (`if` statements, `and` checks and
-`or` statements) a litle more verbose in the generated code.
-### Instance variables
-Instance variables in Opal work just as expected. When ivars are set or
-retrieved on an object, they are set natively without the `@` prefix.
-This allows real javascript identifiers to be used which is more
-efficient then accessing variables by string name.
-```ruby
-@foo = 200
-@foo  # => 200
-@bar  # => nil
-```
-This gets compiled into:
-```javascript
-this.foo = 200;
-this.foo;   // => 200
-this.bar;   // => nil
-```
-The only point of warning is that when variables are used for the
-first time in ruby, they default to `nil`. In javascript, they default
-to `undefined`/`null`.
-To keep things working in opal, ivars must be preset to `nil` before
-they can be used. In the top scope and other corner cases, this needs
-to be done on a per scope basis, which can add overhead.
-To improve performance, once a class body is compiled, all ivars used
-within methods in that class are preset on the prototype of the class
-to be `nil`. This means that all known ivars are already set to nil,
-and this is done just once during the lifespan of the app.
-```ruby
-class Foo
-  def bar
-    @lol
-  end
-  def woosh
-    @kapow
-  end
-end
-```
-This example gets compiled into something similar to:
-```javascript
-(function() {
-  function Foo(){}
-  // ...
-  Foo.prototype.lol = Foo.prototype.woosh = nil;
-  Foo.prototype.$bar = function() {
-    return this.lol;
-  };
-  // etc ...
-})()
-```
-### Interacting with javascript
-Opal tries to interact as cleanly with javascript and its api as much
-as possible. Ruby arrays, strings, numbers, regexps, blocks and booleans
-are just javascript native equivalents. The only boxed core features are
-hashes and nil.
-As most of the corelib deals with these low level details, opal provides
-a special syntax for inlining javascript code. This is done with
-x-strings or "backticks", as their ruby use has no useful translation
-in the browser.
-```ruby
-`window.title`
-# => "Opal: ruby to javascript compiler"
-%x{
-  console.log("ruby version is:");
-  console.log(#{ OPAL_VERSION });
-}
-# => ruby version is:
-# => 0.3.19
-```
-Even interpolations are supported, as seen here.
-This feature of inlining code is used extensively, for example in
-Array#length:
-```ruby
-class Array
-  def length
-    `this.length`
-  end
-end
-```
-X-Strings also have the ability to automatically return their value,
-as used by this example.
-### Compiled Files
-As described above, a compiled ruby source gets generated into a string
-of javascript code that is wrapped inside an anonymous function. This
-looks similar to the following:
-```javascript
-(function() {
-  var nil = Opal.nil, self = Opal.top;
-  // generated code
-})();
-```
-Inside the function, `nil` is assigned to ensure a local copy is
-available, as well as all the helper methods used within the
-generated file. There is no return value from these functions as they
-are not used anywhere.
-As a complete example, assuming the following code:
-```ruby
-puts "foo"
-```
-This would compile directly into:
-```javascript
-(function() {
-  var nil = Opal.nil, self = Opal.top;
-  self.$puts("foo");
-})();
-```
-Most of the helpers are no longer present as they are not used in this
-example.
-### Using compiled sources
-If you write the generated code as above into a file `app.js` and add
-that to your HTML page, then it is obvious that `"foo"` would be
-written to the browser's console.
-### JSON
-The opal corelib includes JSON support instead of treating it as an
-external lib. The `JSON` module provides the usual parsing methods.
-```ruby
-JSON.parse '{"a": 10, "b": [1, 2, 3], "c": null}'
-# => { "a" => 10, "b" => [1, 2, 3], "c" => nil }
-```
-Opal expects `JSON` to be present in the browser, so older browsers
-may require a shim (json2.js) to work with opal. Most mobile browsers
-and modern desktop browsers include json support natively.
-## Debugging and finding errors
-Because Opal does not aim to be fully compatible with ruby, there are
-some instances where things can break and it may not be entirely
-obvious what went wrong.
-### Undefined methods
-By default, opal aims to be as fast as possible, so `method_missing` is
-not turned on by default. Instead, when calling a method that doesn't
-exist, a native error will be raised.
-```ruby
-self.do_something()
-```
-Might raise an error similar to:
-```
-Error: 'undefined' is not a function (evaluating 'this.$do_something()')
-```
-As described above, all ruby methods will have a `$` prefix which gives
-a good indication that it is a opal method that doesnt exist, and most
-js engines output the missing function name.
-### Undefined constants
-If trying to access a constant that doesn't exist, there is no runtime
-error. Instead, the value of that expression is just `undefined` as
-constants are retrieved from objects that hold all constants in the
-scope. Trying to send a method to an undefined constant will therefore
-just raise an ugly javascript `TypeError`.
-If you are using the constant as a reference, it may not be until much
-later that the error occurs.
-### Using javascript debuggers
-As opal just generates javascript, it is useful to use a native
-debugger to work through javascript code. To use a debugger, simply
-add an x-string similar to the following at the place you wish to
-debug:
-```ruby
-# .. code
-`debugger`
-# .. more code
-```
-The x-strings just pass the debugger statement straight through to the
-javascript output.
-Inside methods and blocks, the current `self` value is always the
-native `this` value. You will not see `self` inside debuggers as it is
-never used to refer to the actual ruby self value.
-All local variables and method/block arguments also keep their ruby
-names except in the rare cases when the name is reserved in javascript.
-In these cases, a `$` suffix is added to the name (e.g. `try` =>
-`try$`).
 ## License
-Opal is released under the MIT license.
-## Change Log
-**0.3.21** _(16 July 2012)_
-* Add `method_missing` support to all objects and classes
-* Add `Opal.build_gem()` method to quickly build installed gem
-* Add `Opal.build_files()` method to build directories of files
-**0.3.20** _(23 June 2012)_
-* Merge JSON into core. JSON module and various #to_json methods are
-  now included as part of corelib
-* Make `Time` class bridge to native `Date` constructor
-* Use named functions as class constuctors to make debugging easier
-* Classes are now real functions with prototypes. Bridged classes are
-  now directly corresponding to the ruby class (e.g. Array === Opal.Array)
-* Set ivars used inside methods in class to `nil` inside class definition
-  to avoid doing it everytime method is called
-* Add debug comments to output for def, class and module stating the file
-  and line number the given code was generated from
-**0.3.19** _(30 May 2012)_
-* Add BasicObject as the root class
-* Add `Opal.define` and `Opal.require` for requiring files
-* Builder uses a `main` option to dictate which file to require on load
-* Completely revamp runtime to reduce helper methods
-* Allow native bridges (Array, String, etc) to be subclassed
-* Make sure `.js` files can be built with `Opal::Builder`
-* Include the current file name when raising parse errors
-**0.3.18** _(20 May 2012)_
-* Fix various core lib bugs
-* Completely remove `require` from corelib
-* Improve Builder to detect dependencies in files
-**0.3.17** _(19 May 2012)_
-* Revamp of Builder and Parser tools
-* Remove opal-repl
-* Added a lot of specs for core lib
-**0.3.16** _(15 January 2012)_
-* Added HEREDOCS support in parser
-* Parser now handles masgn (mass/multi assignments)
-* More useful DependencyBuilder class to build gems dependencies
-* Blocks no longer passed as an argument in method calls
-**0.3.15**
-* Initial Release.
+Opal is released under the MIT license.