opal-rails 0.8.1 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e89ce2c0e545cbf7fb488dc83ed028e42c33824d
-  data.tar.gz: ed4cfaa99d56aefb0c628c70b0c2eb8ab4576881
+  metadata.gz: ed236f416a615a09d374712bcdc11ddc57c316ee
+  data.tar.gz: b4912b61deeacf0f1ff22f12abb3082c4c9e9a8f
 SHA512:
-  metadata.gz: 5785ad4fc9d033fa4d5566e121ae2becea202d41885563d0a6814542d6fe14f963bfb4a232fbf2bb686f2ebbf47065a6f05cfe49db7a038e0c6767b6280638f9
-  data.tar.gz: 3f6a5408c66a466210830f08a10b3e493b717b59d24e1af6a9af77fd21c3e722ee374c82eb13888b279c8f200375a1482823fd2235d7ca26f6e9cfc643b91f1a
+  metadata.gz: e79a4ca05c7917dacdc1af9a37cfd23b5d394b7e3158b9bcd4bcbf181c63ca678ca39606c1c3cb8a72591d0343a8e50bd529f06f832ddf8420d0fe1511239aa1
+  data.tar.gz: 42f971503e34be50854cfc28cbad4669a7b9e498c669797e677002216e9662f36a4a6932b52c01267915aa5e295291c6214b6895b9db96f14ab981068dc4a04c

data/.gitignore

@@ -2,12 +2,20 @@
 /log/*.log
 /pkg/
 /tmp
-/test_app/db/*.sqlite3
-/test_app/log/*.log
-/test_app/tmp/
-/test_app/.sass-cache
+/test_apps/db/*.sqlite3
+/test_apps/log/*.log
+/test_apps/tmp/
+/test_apps/.sass-cache
 Gemfile.lock
+*.gemfile.lock
 
 # Files generated by `rake opal` but unneded in the gem
 /lib/assets/javascripts/specs.js
 /lib/assets/javascripts/opal-rails.js
+/gemfiles
+
+# old test app dir
+/test_app/db/*.sqlite3
+/test_app/log/*.log
+/test_app/tmp/
+/test_app/.sass-cache

data/.powder

@@ -0,0 +1 @@
+opal-rails

data/.travis.yml

@@ -6,14 +6,18 @@ cache:
   bundler: true
 
 rvm:
-  - 2.2
-  - 2.1
+  - 2.3.0
+  - 2.2.3
+  - 2.1.6
   - 2.0.0
-  - 1.9.3
 
 before_script:
   - "export DISPLAY=:99.0"
   - "sh -e /etc/init.d/xvfb start"
+  - "gem install appraisal"
+  - "appraisal install"
+
+script: "appraisal rake"
 
 notifications:
   irc: "irc.freenode.org#opal"

data/Appraisals

@@ -0,0 +1,11 @@
+appraise "rails-4-1" do
+  gem "rails", "~> 4.1.14"
+end
+
+appraise "rails-4-2" do
+  gem "rails", "~> 4.2.5"
+end
+
+appraise "rails-5" do
+  gem "rails", "~> 5.0.0.beta1"
+end if  Gem::Version.new(RUBY_VERSION) >= Gem::Version.new('2.2.2')

data/CHANGELOG.md

@@ -1,89 +1,152 @@
-# 0.8.1 2015-12-18
+# Change Log
 
-* Restrict the version requirement for `sprockets-rails` to `< 3.0` as v3 bears chages incompatible with `opal-rails`
+All notable changes to this project will be documented in this file.
+This project *tries* to adhere to [Semantic Versioning](http://semver.org/), even before v1.0.
 
-# 0.8.0 2015-07-20
+Changes are grouped as follows:
+- **Added** for new features.
+- **Changed** for changes in existing functionality.
+- **Deprecated** for once-stable features removed in upcoming releases.
+- **Removed** for deprecated features removed in this release.
+- **Fixed** for any bug fixes.
+- **Security** to invite users to upgrade in case of vulnerabilities.
 
-* Opal v0.8
-* Default spec location is now `spec-opal`, this will allow opal specs to be "alphabetically" near other specs.
-* Don't run the sourcemap server unless sprockets is active and sourcemaps enabled and sprockets is in debug mode
-* Align spec compilation done via `rake opal:spec` vs. in the browser at `/opal_spec`
-* Dynamic require severity now defaults to `:ignore`
-* Make `#opal_tag` helper respect provided options + specs
-* Sprockets bootstrap code can be skipped from `javascript_include_tag` passing `skip_opal_loader: true`
-* All specs now need to require "opal" and "opal-rspec" explicitly
+<!--
+Whitespace conventions:
+- 4 spaces before ## titles
+- 2 spaces before ### titles
+- 2 spaces before ### titles
+- 1 spaces before normal text
+ -->
 
 
-# 0.7.0 2015-02-02
 
-* Opal v0.7
-* Added an `opal` Slim filter
-* WebScale!
-* Drop Ruby 1.8.7 support
-* Add a view rails generator `rails g opal:assets` to generate example view classes.
 
-# 0.6.3 2014-03-07
+## [0.9.0] - Unreleased
 
-* Add `opal_tag` helper, similar to `javascript_tag`
-* Allow specs inside subdirectories
-* Updated to Opal v0.6
 
-# 0.6.2 2013-12-13
+### Added
 
-* Added fun
-* Expire Sprockets cache (by means of using different cache keys) when the opal version changes (monkeypatch)
-* Rely on `Opal::Processor` to know if source maps are enabled
+- Support for Opal 0.9
+- Support for Rails 5.0
 
-# 0.6.1 2013-11-05
 
-* Fix the rake task, now uses `opal-rspec` too
+### Removed
 
+- Removed support for Opal 0.8
+- Extracted support for running spec to `opal-rspec-rails`, this is done to make its development independent of `opal-rails` and also to make room for the (yet to be implemented) `opal-minitest-rails`. In addition the extracted gem should address a number of issues like:
+  - faster rake runs
+  - allowing to use any sprockets processor (e.g. `opal-haml` templates were previously not supported)
+  - nicer integration and customizability
+- Drop support for Ruby 1.9.3
 
-# 0.6.0 2013-11-05
 
-* Don't load source maps if they're not enabled via `config.opal.source_map_enabled`
-* Update to Opal v0.5.0
-* Run in-browser specs with `opal-rspec`
 
 
-# 0.5.2 2013-09-05
+## [0.8.1] - 2015-12-18
 
-* Add `opal-activesupport` as a dependency
-* Haml filter now is loaded inside the railtie initializer, avoiding potential Gemfile ordering issues
-* Add the `rake opal:spec` task to run browser specs from the terminal (requires phantomjs)
+- Restrict the version requirement for `sprockets-rails` to `< 3.0` as v3 bears chages incompatible with `opal-rails`
 
 
-# 0.5.1 2013-07-02
+## [0.8.0] - 2015-07-20
 
-* `.js` suffix is now optional for in-browser specs
+- Opal v0.8
+- Default spec location is now `spec-opal`, this will allow opal specs to be "alphabetically" near other specs.
+- Don't run the sourcemap server unless sprockets is active and sourcemaps enabled and sprockets is in debug mode
+- Align spec compilation done via `rake opal:spec` vs. in the browser at `/opal_spec`
+- Dynamic require severity now defaults to `:ignore`
+- Make `#opal_tag` helper respect provided options + specs
+- Sprockets bootstrap code can be skipped from `javascript_include_tag` passing `skip_opal_loader: true`
+- All specs now need to `require "opal"` and `require "opal-rspec"` explicitly
 
 
-# 0.5.0 2013-06-30
+## [0.7.0] - 2015-02-02
 
-* Add support for source-maps
-* `opal` can now be used in the rails app generator: `rails new -j opal`
-* migrate `#to_native` to the new signature: `#to_n`
+- Opal v0.7
+- Added an `opal` Slim filter
+- WebScale!
+- Drop Ruby 1.8.7 support
+- Add a view rails generator `rails g opal:assets` to generate example view classes.
 
 
-# 0.4.0 2013-06-03
+## [0.6.3] - 2014-03-07
 
-* Add `Rails.application.config.opal` which accepts:
+- Add `opal_tag` helper, similar to `javascript_tag`
+- Allow specs inside subdirectories
+- Updated to Opal v0.6
+
+
+## [0.6.2] - 2013-12-13
+
+- Added fun
+- Expire Sprockets cache (by means of using different cache keys) when the opal version changes (monkeypatch)
+- Rely on `Opal::Processor` to know if source maps are enabled
+
+
+## [0.6.1] - 2013-11-05
+
+- Fix the rake task, now uses `opal-rspec` too
+
+
+## [0.6.0] - 2013-11-05
+
+- Don't load source maps if they're not enabled via `config.opal.source_map_enabled`
+- Update to Opal v0.5.0
+- Run in-browser specs with `opal-rspec`
+
+
+## [0.5.2] - 2013-09-05
+
+- Add `opal-activesupport` as a dependency
+- Haml filter now is loaded inside the railtie initializer, avoiding potential Gemfile ordering issues
+- Add the `rake opal:spec` task to run browser specs from the terminal (requires phantomjs)
+
+
+## [0.5.1] - 2013-07-02
+
+- `.js` suffix is now optional for in-browser specs
+
+
+## [0.5.0] - 2013-06-30
+
+- Add support for source-maps
+- `opal` can now be used in the rails app generator: `rails new -j opal`
+- migrate `#to_native` to the new signature: `#to_n`
+
+
+## [0.4.0] - 2013-06-03
+
+- Add `Rails.application.config.opal` which accepts:
     - method_missing: `<Boolean>` (default: `true`)
     - optimized_operators: `<Boolean>` (default: `true`)
     - arity_check: `<Boolean>` (default: `false`)
     - const_missing: `<Boolean>` (default: `true`)
 
-* Add the Changelog
+- Add the Changelog
 
 
-# 0.3.8 2013-05-07
+## [0.3.8] - 2013-05-07
 
-* Add `opal/rails` alongside to `opal-rails` for older bundlers autorequire
+- Add `opal/rails` alongside to `opal-rails` for older bundlers autorequire
 
 
-# 0.3.7 2013-05-04
+## [0.3.7] - 2013-05-04
 
-* Rails 4.0.0 support
-* Add `opal_ujs`, now it's possible to use Opal for new Rails apps: `rails new <app-name> -j opal`
-* Updated README examples
+- Rails 4.0.0 support
+- Add `opal_ujs`, now it's possible to use Opal for new Rails apps: `rails new <app-name> -j opal`
+- Updated README examples
 
+[0.9.0]: https://github.com/opal/opal-rails/compare/v0.8.1...HEAD
+[0.8.1]: https://github.com/opal/opal-rails/compare/v0.8.0...v0.8.1
+[0.8.0]: https://github.com/opal/opal-rails/compare/v0.7.0...v0.8.0
+[0.7.0]: https://github.com/opal/opal-rails/compare/v0.6.3...v0.7.0
+[0.6.3]: https://github.com/opal/opal-rails/compare/v0.6.2...v0.6.3
+[0.6.2]: https://github.com/opal/opal-rails/compare/v0.6.1...v0.6.2
+[0.6.1]: https://github.com/opal/opal-rails/compare/v0.6.0...v0.6.1
+[0.6.0]: https://github.com/opal/opal-rails/compare/v0.5.2...v0.6.0
+[0.5.2]: https://github.com/opal/opal-rails/compare/v0.5.1...v0.5.2
+[0.5.1]: https://github.com/opal/opal-rails/compare/v0.5.0...v0.5.1
+[0.5.0]: https://github.com/opal/opal-rails/compare/v0.4.0...v0.5.0
+[0.4.0]: https://github.com/opal/opal-rails/compare/v0.3.8...v0.4.0
+[0.3.8]: https://github.com/opal/opal-rails/compare/v0.3.7...v0.3.8
+[0.3.7]: https://github.com/opal/opal-rails/compare/v0.3.6...v0.3.7

data/Gemfile

@@ -1,18 +1,2 @@
 source 'https://rubygems.org'
 gemspec
-
-gem 'capybara-webkit'
-
-# gem 'opal',        path: '../opal'
-# gem 'opal-rspec',  path: '../opal-rspec'
-# gem 'opal-jquery', path: '../opal-jquery'
-
-# gem 'opal',        github: 'opal'
-# gem 'opal-rspec',  github: 'opal/opal-rspec'
-# gem 'opal-jquery', github: 'opal/opal-jquery'
-
-if RUBY_VERSION.to_f < 1.9
-  gem 'nokogiri', '< 1.6'
-  gem 'rails',    '< 4.0'
-  gem 'rubyzip',  '< 1'
-end

data/README.md

@@ -32,7 +32,9 @@ Add your configuration in `config/application.rb` with the following contents:
 ```ruby
 module MyApp
   class Application < Rails::Application
-    # These are the available options with their default value:
+    # These are the available options with their default values
+
+    # Compiler options
     config.opal.method_missing      = true
     config.opal.optimized_operators = true
     config.opal.arity_check         = false
@@ -40,22 +42,15 @@ module MyApp
     config.opal.dynamic_require_severity = :ignore
 
     # Enable/disable /opal_specs route
-    config.opal.enable_specs        = true
+    config.opal.enable_specs = true
 
+    # The path to opal specs from Rails.root
     config.opal.spec_location = 'spec-opal'
   end
 end
 ```
 
 
-### Gotchas
-
-<del>After changing the version of the `opal` gem (e.g. via `bundle update opal`) or any configuration flag **you should trash the `#{Rails.root}/tmp/cache/assets` folder**, otherwise you could see a cached source compiled before the change.</del>
-
-Now ships with a patch to sprockets cache key to include processor version that is also in this [pull request](https://github.com/sstephenson/sprockets/pull/508).
-
-
-
 ## Usage
 
 
@@ -64,18 +59,7 @@ Now ships with a patch to sprockets cache key to include processor version that
 You can rename `app/assets/javascripts/application.js` to `application.js.rb`. Even if not necessary, it is recommended to change Sprockets' `//= require` statements to Ruby' `require` methods.
 Sprockets' `//= require` statements won't be known by the opal builder and therefore you can end up adding something twice.
 
-For Opal 0.7 and below, the following example should work:
-
-```ruby
-# app/assets/javascripts/application.js.rb
-
-#= require opal
-#= require opal_ujs
-#= require turbolinks
-#= require_tree .
-```
-
-For Opal 0.8 and above, you should be able to use the following syntax:
+For Opal 0.8 and above, you have to use `application.js.rb` with the following syntax:
 
 ```ruby
 # app/assets/javascripts/application.js.rb
@@ -86,6 +70,16 @@ require 'turbolinks'
 require_tree '.'
 ```
 
+If you want to use `application.js`, you need to `load` the Opal modules(files) manually, e.g.:
+
+```
+// application.js
+//= require opal
+//= require greeter
+//= require_self
+Opal.load('greeter');
+```
+
 As you see in the example above, Opal also gives you a Ruby equivalent of `//= require_tree`.
 
 Opal requires are forwarded to the Asset Pipeline at compile time (similarly to what happens for RubyMotion). You can use either the `.rb` or `.opal` extension:
@@ -160,42 +154,19 @@ Of course you need to require `haml-rails` separately since its presence is not
 ```
 
 
-### Spec!
-
-Add specs into `/spec-opal`:
-
-and then a spec folder with you specs!
-
-```ruby
-# spec-opal/example_spec.js.rb
-
-describe 'a spec' do
-  it 'has successful examples' do
-    'I run'.should =~ /run/
-  end
-end
-```
-
-Then visit `/opal_spec` from your app and **reload at will** or use the command line with `rake opal:spec`.
-
-#### CHANGE from versions pre 0.7.1
+### RSpec support
 
-Specs used to run out of app/assets/javascripts/spec which was problematic because require_tree . would cause opal/sprockets to compile the specs for non spec running.  This could result in bad specs that prevent your application Opal code from compiling, and even if it compiles you'll get exceptions about the test framework methods not being defined.  To address this, specs have been moved out of the app/assets/javascripts to Rails.root/spec-opal.  The name spec-opal was chosen to put it close to the spec directory.  We don't want to put specs in spec directory because we don't want the "backend" rspec to run those.
+_Extracted to [`opal-rspec-rails`](https://github.com/opal/opal-rspec-rails)_
 
-The location of specs is configurable. To restore the old location of app/assets/javascripts/spec add an initializer file like the below.
+Add this line to your `Gemfile`
 
 ```ruby
-# config/initializers/opal.rb
-Rails.application.config.opal.spec_location = "app/assets/javascripts/spec"
-
+gem 'opal-rspec-rails', github: 'opal/opal-rspec-rails'
 ```
 
-Similarly, you can put the opal specs in another location via a similar initializer call.
-
+### Minitest support
 
-
-
-![1 examples, 0 failures](http://f.cl.ly/items/001n0V0g0u0v14160W2G/Schermata%2007-2456110%20alle%201.06.29%20am.png)
+_Upcoming as `opal-minitest-rails`_
 
 
 ### Shared templates
@@ -233,10 +204,21 @@ template.render(self)
 ```
 
 
+### Using Ruby gems from Opal
+
+Just use `Opal.use_gem` in your asset initializer (in `config/initializers`).
+
+Example:
+
+```ruby
+Opal.use_gem 'cannonbol'
+```
+
+
 
 ## License
 
-© 2012-2014 Elia Schito
+© 2012-2015 Elia Schito
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal

data/Rakefile

@@ -12,8 +12,4 @@ Bundler::GemHelper.install_tasks
 require 'rspec/core/rake_task'
 RSpec::Core::RakeTask.new :rspec
 
-
-require File.expand_path('../test_app/config/application', __FILE__)
-TestApp::Application.load_tasks
-
-task :default => [:rspec, 'opal:spec']
+task :default => :rspec