opal 0.5.5 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8c3c4aae83ea36c7e4785f86f3ec1af7f0faa999
-  data.tar.gz: a8373ec3672064f31eed60d47ca924d551e1371f
+  metadata.gz: 9f894d4150a0535a93f352701ed5b9d204b74409
+  data.tar.gz: 1551213eccd9d9177e3868722429c56624a40b5b
 SHA512:
-  metadata.gz: 3fd251517ad89ef9153543b94fcfbfe05d8362461644cb92b0f423e77cbccc3d1477816bb395e8d837ce0d753c377bc65d612c17469b26889497d1f0d793219d
-  data.tar.gz: cab981292ad0da4f0462f1933421e8bc49927783aa57c8520c3b779ef1d470e78b0f938c376f6987b5093177c7cd0c199f6197386f3e02d0f10609e6b4cbed60
+  metadata.gz: a14ce6ec8c51a5a64d29c0b10865daaf426c17703f978fc99f2aad2d0bb9b2562f9de495cb1d0cf2f40281305ebe3f3cd4eb4442e68b3a92bbf9d6c5b5eb3d52
+  data.tar.gz: b697aeeca8bfee4fcc2f70bbc6fd52df6bf140938983b114e905f3d08c01ba080756e21e331301d9713b735db090f9b5b670dee7c56d64d2f7655b55c7f238d3

data/.travis.yml

@@ -1,17 +1,48 @@
 language: ruby
 
-rvm:
-  - 1.8.7
-  - 1.9.3
-  - 2.0.0
-  - rbx-20mode
+cache: bundler
+
+matrix:
+  fast_finish: true
+
+  include:
+    - rvm: 2.1.0
+      env: RUN=default
+
+    - rvm: 1.8.7
+      env: RUN=rspec
+
+    - rvm: 1.9.3
+      env: RUN=rspec
+
+    - rvm: 2.0.0
+      env: RUN=rspec
+
+    - rvm: rbx
+      env: RUN=rspec
+
+    - rvm: jruby
+      env: RUN=rspec
+
+  allow_failures:
+    - rvm: 1.8.7
+    - rvm: 1.9.3
+    - rvm: 2.0.0
+    - rvm: rbx
+    - rvm: jruby
 
 before_install:
   - git submodule update --init
 
+  # Fix waiting for rubygems v2.2.1 to be released and active on travis
+  # https://github.com/rubygems/rubygems/commit/f8e0f1d5f67cfc4e1966cc1e2db367aebf8a09e4
+  - gem update bundler
+  - bundle --version
+  - gem update --system 2.1.11
+  - gem --version
+
+script:
+  - "bundle exec rake $RUN"
+
 notifications:
   irc: "irc.freenode.org#opal"
-
-matrix:
-  allow_failures:
-    - rvm: rbx-20mode

data/CHANGELOG.md

@@ -0,0 +1,349 @@
+## edge
+
+*   Fix parsing of escapes in single-strings ('foo\n'). Only ' and \
+    characters now get escaped in single quoted strings. Also, more escape
+    sequences in double-quoted strings are now supported: `\a`, `\v`, `\f`,
+    `\e`, `\s`, octal (`\314`), hex (`\xff`) and unicode (`\u1234`).
+
+*   Sourcemaps revamp. Lexer now tracks column and line info for ever token to
+    produce much more accurate sourcemaps. All method calls are now located on
+    the correct source line, and multi-line xstrings are now split to generate
+    a map line-to-line for long inline javascript parts.
+
+*   Merged sprockets support from `opal-sprockets` directly into Opal. For the
+    next release, the exernal `opal-sprockets` gem is no longer needed. This
+    commit adds `Opal::Processor`, `Opal::Server` and `Opal::Environment`.
+
+*   Introduce pre-processed if directives to hide code from Opal. Two special
+    constant checks now take place in the compiler. Either `RUBY_ENGINE` or
+    `RUBY_PLATFORM` when `== "opal"`. Both if and unless statements can pick
+    up these logic checks:
+
+        if RUBY_ENGINE == "opal"
+          # this code compiles
+        else
+          # this code never compiles
+        end
+
+    Unless:
+
+        unless RUBY_ENGINE == "opal"
+          # this code never compiles
+        end
+
+    This is particularly useful for avoiding `require()` statements being
+    picked up, which are included at compile time.
+
+*   Add special `debugger` method to compiler. Compiles down to javascript
+    `debugger` keyword to start in-browser debug console.
+
+*   Add missing string escapes to `read_escape` in lexer. Now most ruby escape
+    sequences are properly detected and handled in string parsing.
+
+*   Disable escapes inside x-strings. This means no more double escaping all
+    characters in x-strings and backticks. (`\n` => `\n`).
+
+*   Add `time.rb` to stdlib and moved `Time.parse()` and `Time.iso8601()`
+    methods there.
+
+*   `!` is now treated as a unary method call on the object. Opal now parsed
+    `!` as a def method name, and implements the method on `BasicObject`,
+    `NilClass` and `Boolean`.
+
+*   Fixed bug where true/false as object literals from javascript were not
+    correctly being detected as truthy/falsy respectively. This is due to the
+    javascript "feature" where `new Boolean(false) !== false`.
+
+*   Moved `native.rb` to stdlib. Native support must now be explicitly required
+    into Opal. `Native` is also now a module, instead of a top level class.
+    Also added `Native::Object#respond_to?`.
+
+*   Remove all core `#as_json()` methods from `json.rb`. Added them externally
+    to `opal-activesupport`.
+
+*   `Kernel#respond_to?` now calls `#respond_to_missing?` for compliance.
+
+*   Fix various `String` methods and add relevant rubyspecs for them. `#chars`,
+    `#to_f`, `#clone`, `#split`.
+
+*   Fix `Array` method compliance: `#first`, `#fetch`, `#insert`, `#delete_at`,
+    `#last, `#splice`, `.try_convert`.
+
+*   Fix compliance of `Kernel#extend` and ensure it calls `#extended()` hook.
+
+*   Fix bug where sometimes the wrong regexp flags would be generated in the
+    output javascript.
+
+*   Support parsing `__END__` constructs in ruby code, inside the lexer. The
+    content is gathered up by use of the parser. The special constant `DATA`
+    is then available inside the ruby code to read the content.
+
+*   Support single character strings (using ? prefix) with escaped characters.
+
+*   Fix lexer to detect dereferencing on local variables even when whitespace
+    is present (`a = 0; a [0]` parses as a deference on a).
+
+*   Fix various `Struct` methods. Fixed `#each` and `#each_pair` to return
+    self. Add `Struct.[]` as synonym for `Struct.new`.
+
+*   Implemented some `Enumerable` methods: `#collect_concat`, `#flat_map`,
+    `#reject`, `#reverse_each`, `#partition` and `#zip`.
+
+*   Support any Tilt template for `index_path` in `Opal::Server`. All index
+    files are now run through `Tilt` (now supports haml etc).
+
+*   Fix code generation of `op_asgn_1` calls (foo[val] += 10).
+
+*   Add `base64` to stdlib.
+
+*   Add promises implementation to stdlib.
+
+*   Add `Math` module to corelib.
+
+*   Use `//#` instead of `//@` deprecated syntax for sourceMappingURL.
+
+*   Implicitly require `erb` from stdlib when including erb templates.
+
+*   Fix `Regexp.escape` to also escape '(' character.
+
+*   Support '<' and '>' as matching pairs in string boundrys `%q<hi>`.
+
+*   `Opal::Server` no longer searches for an index file if not specified.
+
+*   Move `Math` and `Encoding` to stdlib. Can be required using
+    `require 'math'`, etc.
+
+*   Fix some stdlib `Date` methods.
+
+*   Fix `Regexp.escape` to properly escape \n, \t, \r, \f characters.
+
+*   Add `Regexp.quote` as an alias of `escape`.
+
+## 0.5.5 2013-11-25
+
+*   Fix regression: add `%i[foo bar]` style words back to lexer
+
+*   Move corelib from `opal/core` to `opal/corelib`. This stops files in
+    `core/` clashing with user files.
+
+## 0.5.4 2013-11-20
+
+*   Reverted `RUBY_VERSION` to `1.9.3`. Opal `0.6.0` will be the first release
+    for `2.0.0`.
+
+## 0.5.3 2013-11-12
+
+*   Opal now targets ruby 2.0.0
+
+*   Named function inside class body now generates with `$` prefix, e.g.
+    `$MyClass`. This makes it easier to wrap/bridge native functions.
+
+*   Support Array subclasses
+
+*   Various fixes to `String`, `Kernel` and other core classes
+
+*   Fix `Method#call` to use correct receiver
+
+*   Fix `Module#define_method` to call `#to_proc` on explicit argument
+
+*   Fix `super()` dispatches on class methods
+
+*   Support `yield()` calls from inside a block (inside a method)
+
+*   Cleanup string parsing inside lexer
+
+*   Cleanup parser/lexer to use `t` and `k` prefixes for all tokens
+
+## 0.5.2 2013-11-11
+
+*   Include native into corelib for 0.5.x
+
+## 0.5.1 2013-11-10
+
+*   Move all corelib under `core/` directory to prevent filename clashes with
+    `require`
+
+*   Move `native.rb` into stdlib - must now be explicitly required
+
+*   Implement `BasicObject#__id__`
+
+*   Cleanup and fix various `Enumerable` methods
+
+## 0.5.0 2013-11-03
+
+*   WIP: https://gist.github.com/elia/7747460
+
+## 0.4.2 2013-07-03
+
+*   Added `Kernel#rand`. (fntzr)
+
+*   Restored the `bin/opal` executable in gemspec.
+
+*   Now `.valueOf()` is used in `#to_n` of Boolean, Numeric, Regexp and String
+    to return the naked JavaScript value instead of a wrapping object.
+
+*   Parser now wraps or-ops in paranthesis to stop variable order from
+    leaking out when minified by uglify. We now have code in this
+    format: `(((tmp = lhs) !== false || !==nil) ? tmp : rhs)`.
+
+## 0.4.1 2013-06-16
+
+*   Move sprockets logic out to external opal-sprockets gem. That now
+    handles the compiling and loading of opal files in sprockets.
+
+## 0.4.0 2013-06-15
+
+*   Added fragments to parser. All parser methods now generate one or
+    more Fragments which store the original sexp. This allows us to
+    enumerate over them after parsing to map generated lines back to
+    original line numbers.
+
+*   Reverted `null` for `nil`. Too buggy at this time.
+
+*   Add Opal::SprocketsParser as Parser subclass for handling parsing
+    for sprockets environment. This subclass handles require statements
+    and stores them for sprockets to use.
+
+*   Add :irb option to parser to keep top level lvars stored inside
+    opal runtime so that an irb session can be persisted and maintain
+    access to local variables.
+
+*   Add Opal::Environment#use_gem() helper to add a gem to opals load
+    path.
+
+*   Stop pre-setting ivars to `nil`. This is no longer needed as `nil`
+    is now `null` or `undefined`.
+
+*   Use `null` as `nil` in opal. This allows us to send methods to
+    `null` and `undefined`, and both act as `nil`. This makes opal a
+    much better javascript citizen. **REVERTED**
+
+*   Add Enumerable#none? with specs.
+
+*   Add Opal.block_send() runtime helper for sending methods to an
+    object which uses a block.
+
+*   Remove \_klass variable for denoting ruby classes, and use
+    constructor instead. constructor is a javascript property used for
+    the same purpose, and this makes opal fit in as a better js citizen.
+
+*   Add Class.bridge\_class method to bridge a native constructor into an
+    opal class which will set it up with all methods from Object, as
+    well as giving it a scope and name.
+
+*   Added native #[]= and #to_h methods, for setting properties and
+    converting to a hash respectivaly.
+
+*   Fix bug where '::' was parsed as :colon2 instead of :colon3 when in
+    an args scope. Fixes #213
+
+*   Remove lots of properties added to opal classes. This makes normal
+    js constructors a lot closer to opal classes, making is easier to
+    treat js classes as opal classes.
+
+*   Merge Hash.from_native into Hash.new
+
+## 0.3.44 2013-05-31
+
+*   Cleanup runtime, and remove various flags and functions from opal
+    objects and classes (moving them to runtime methods).
+
+*   Remove some activesupport methods into external lib.
+
+*   Add/fix lots of String methods, with specs.
+
+*   Add more methods to MatchData class.
+
+*   Implement $' and $` variables.
+
+*   Opal can now call methods on all native objects, via method missing
+    dispatcher.
+
+*   Add Opal::Environment as custom sprockets subclass which adds all
+    opal load paths automatically.
+
+## 0.3.43 2013-05-02
+
+*   Stop inlining respond_to? inside the parser. This now fully respects
+    an object overriding respond_to?.
+
+*   Expose `Opal.eval()` function when parser is loaded for parsing
+    and running strings of ruby code.
+
+*   Add erb to corelib (as well as compiler to gem lib). ERB files with
+    .opalerb extension will automatically be compiled into Template
+    constant.
+
+*   Added some examples into examples/ dir.
+
+*   Add Opal.send() javascript function for sending methods to ruby
+    objects.
+
+*   Native class for wrapping and interacting with native objects and
+    function calls.
+
+*   Add local_storage to stdlib as a basic wrapper around localStorage.
+
+*   Make method_missing more performant by reusing same dispatch function
+    instead of reallocating one for each run.
+
+*   Fix Kernel#format to work in firefox. String.prototype.replace() had
+    different semantics for empty matching groups which was breaking
+    Kernel#format.
+
+## 0.3.42 2013-03-21
+
+*   Fix/add lots of language specs.
+
+*   Seperate sprockets support out to opal-sprockets gem.
+
+*   Support %r[foo] style regexps.
+
+*   Use mspec to run specs on corelib and runtime. Rubyspecs are now
+    used, where possible to be as compliant as possible.
+
+## 0.3.41 2013-02-26
+
+*   Remove bin/opal - no longer required for building sources.
+
+*   Depreceate Opal::Environment. The Opal::Server class provides a better
+    method of using the opal load paths. Opal.paths still stores a list of
+    load paths for generic sprockets based apps to use.
+
+## 0.3.40 2013-02-23
+
+*   Add Opal::Server as an easy to configure rack server for testing and
+    running Opal based apps.
+
+*   Added optional arity check mode for parser. When turned on, every method
+    will have code which checks the argument arity. Off by default.
+
+*   Exception subclasses now relfect their name in webkit/firefox debuggers
+    to show both their class name and message.
+
+*   Add Class#const_set. Trying to access undefined constants by a literal
+    constant will now also raise a NameError.
+
+## 0.3.39 2013-02-20
+
+*   Fix bug where methods defined on a parent class after subclass was defined
+    would not given subclass access to method. Subclasses are now also tracked
+    by superclass, by a private '_inherited' property.
+
+*   Fix bug where classes defined by `Class.new` did not have a constant scope.
+
+*   Move Date out of opal.rb loading, as it is part of stdlib not corelib.
+
+*   Fix for defining methods inside metaclass, or singleton_class scopes.
+
+## 0.3.38 2013-02-13
+
+*   Add Native module used for wrapping objects to forward calls as native
+    calls.
+
+*   Support method_missing for all objects. Feature can be enabled/disabled on
+    Opal::Processor.
+
+*   Hash can now use any ruby object as a key.
+
+*   Move to Sprockets based building via `Opal::Processor`.

data/Gemfile

@@ -3,15 +3,14 @@ gemspec
 
 # Stick with older racc until
 # https://github.com/tenderlove/racc/issues/32
-# is solved.
-gem 'racc', '< 1.4.10' if RUBY_VERSION.to_f < 1.9
-
-platform :rbx do
-  gem 'rubysl'
-  gem 'rubysl-openssl'
-end
+# and
+# https://github.com/tenderlove/racc/issues/22
+# are solved.
+gem 'racc', '< 1.4.10' if RUBY_VERSION.to_f <  1.9 or  RUBY_ENGINE == 'jruby'
+gem 'json', '< 1.8.1'  if RUBY_VERSION.to_f == 2.1 and RUBY_ENGINE == 'ruby'
+gem 'rubysl', :platform => :rbx
 
 group :repl do
-  gem 'therubyracer', :require => 'v8', :platform => :mri
+  gem 'therubyracer', :platform => :mri, :require => 'v8'
   gem 'therubyrhino', :platform => :jruby
 end

data/README.md

@@ -8,7 +8,10 @@ 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). There is also a [google group for opal](http://groups.google.com/forum/#!forum/opalrb).
+is a Freenode IRC channel at [#opal](http://webchat.freenode.net/?channels=opal), 
+ask questions on [stackoverflow#opalrb](http://stackoverflow.com/questions/ask?tags=opalrb).
+
+
 
 ## Usage
 
@@ -92,9 +95,28 @@ StringScanner, Date, etc.
 
 ### spec
 
-* **rubyspec** contains rubyspecs that apply to opal (core + language)
 * **opal** opal additions/special behaviour in the runtime/corelib
-* **parser** specs for opal lib (parser, lexer, grammar etc)
+* **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