opal-jquery 0.0.5 → 0.0.6

data/Gemfile

@@ -5,4 +5,4 @@ gem 'rake'
 gem 'sprockets'
 
 gem 'opal', '~> 0.3.36'
-gem 'opal-spec', '~> 0.2.8'
+gem 'opal-spec', '~> 0.2.10'

data/README.md

@@ -6,238 +6,24 @@ opal-jquery provides DOM access to opal by wrapping jQuery (or zepto)
 and providing a nice ruby syntax for dealing with jQuery instances.
 opal-jquery is [hosted on github](http://github.com/opal/opal-jquery).
 
-jQuery instances are toll-free bridged to instances of the ruby class
-`JQuery`, so they can be used interchangeably. The `Document` module also
-exists, which provides the simple top level css selector method:
+See the [website for documentation](http://opalrb.org/jquery).
 
-```ruby
-elements = Document['.foo']
-# => [<div class="foo">, ...]
-
-elements.class
-# => JQuery
-
-elements.on(:click) do
-  alert "element was clicked"
-end
-```
-
-### Getting Started
-
-#### Installation
-
-Install opal-jquery from RubyGems:
-
-```
-$ gem install opal-jquery
-```
-
-Or include it in your Gemfile for Bundler:
-
-```ruby
-gem 'opal-jquery'
-```
-
-### Interacting with the DOM
-
-#### Finding elements
-
-opal-jquery provides the `Document` module, which is the best way to
-find elements by CSS selector:
-
-```ruby
-Document['#header']
-```
-
-This method acts just like `$('selector')`, and can use any jQuery
-compatible selector:
-
-```ruby
-Document['#navigation li:last']
-```
-
-The result is just a jQuery instance, which is toll-free bridged to
-instances of the `Element` class in ruby:
-
-```ruby
-Document['.foo'].class
-# => Element
-```
-
-Instances of `Element` also have the `#find` method available for
-finding elements within the scope of each DOM node represented by
-the instance:
-
-```ruby
-el = Document['#header']
-el.find '.foo'
-# => #<Element .... >
-```
-
-#### Running code on document ready
-
-Just like jQuery, opal-jquery requires the document to be ready to
-be able to fully interact with the page. Any top level access should
-use the `ready?` method:
-
-```ruby
-Document.ready? do
-  alert "document is ready to go!"
-end
-```
-
-The `Kernel#alert` method is shown above too.
-
-#### Event handling
-
-The `Element#on` method is used to attach event handlers to elements:
-
-```ruby
-Document['#header'].on :click do
-  puts "The header was clicked!"
-end
-```
-
-Selectors can also be passed as a second argument to handle events
-on certain children:
-
-```ruby
-Document['#header'].on(:click, '.foo') do
-  puts "An element with a 'foo' class was clicked"
-end
-```
-
-An `Event` instance is optionally passed to block handlers as well,
-which is toll-free bridged to jquery events:
-
-```ruby
-Document['#my_link'].on(:click) do |evt|
-  evt.stop_propagation
-  puts "stopped the event!"
-end
-```
-
-#### CSS styles and classnames
-
-The various jQuery methods are available on `Element` instances:
-
-```ruby
-foo = Document['.foo']
-
-foo.add_class 'blue'
-foo.remove_class 'foo'
-foo.toggle_class 'selected'
-```
-
-There are also added convenience methods for opal-jquery:
-
-```ruby
-foo = Document['#header']
-
-foo.class_name
-# => 'red lorry'
-
-foo.class_name = 'yellow house'
-
-foo.class_name
-# => 'yellow house'
-```
-
-`Element#css` also exists for getting/setting css styles:
-
-```ruby
-el = Document['#container']
-el.css 'color', 'blue'
-el.css 'color'
-# => 'blue'
-```
-
-### HTTP/AJAX requests
-
-jQuery's Ajax implementation is also wrapped in the top level HTTP
-class.
-
-```ruby
-HTTP.get("/users/1.json") do |response|
-  puts response.body
-  # => "{\"name\": \"Adam Beynon\"}"
-end
-```
-
-The block passed to this method is used as the handler when the request
-succeeds, as well as when it fails. To determine whether the request
-was successful, use the `ok?` method:
-
-```ruby
-HTTP.get("/users/2.json") do |response|
-  if response.ok?
-    alert "successful!"
-  else
-    alert "request failed :("
-  end
-end
-```
-
-It is also possible to use a different handler for each case:
-
-```ruby
-request = HTTP.get("/users/3.json")
-
-request.callback {
-  puts "Request worked!"
-}
-
-request.errback {
-  puts "Request didn't work :("
-}
-```
-
-The request is actually triggered inside the `HTTP.get` method, but due
-to the async nature of the request, the callback and errback handlers can
-be added anytime before the request returns.
-
-#### Handling responses
-
-Web apps deal with JSON responses quite frequently, so there is a useful
-`#json` helper method to get the JSON content from a request:
-
-```ruby
-HTTP.get("/users.json") do |response|
-  puts response.body
-  puts response.json
-end
+### Running Specs
 
-# => "[{\"name\": \"Adam\"},{\"name\": \"Ben\"}]"
-# => [{"name" => "Adam"}, {"name" => "Ben"}]
-```
+Get the dependencies:
 
-The `#body` method will always return the raw response string.
+    $ bundle install
 
-If an error is encountered, then the `#status_code` method will hold the
-specific error code from the underlying request:
+#### Browser
 
-```ruby
-request = HTTP.get("/users/3.json")
+You can run the specs in any web browser, by running the `config.ru` rack file:
 
-request.callback { puts "it worked!" }
+    $ bundle exec rackup
 
-request.errback { |response|
-  puts "failed with status #{response.status_code}"
-}
-```
+And then visiting `http://localhost:9292` in any web browser.
 
-opal-jquery provides DOM access to opal by wrapping jQuery
-and providing a nice ruby syntax for dealing with jQuery instances.
-opal-jquery is [hosted on github](http://github.com/opal/opal-jquery).
+#### Phantomjs
 
-See the [website for documentation](http://opal.github.com/opal-jquery).
-
-### Running Specs
-
-Get the dependencies:
-
-    $ bundle install
-    
 You will need phantomjs to run the specs outside the browser.  It can
 be downloaded at [http://phantomjs.org/download.html](http://phantomjs.org/download.html)
 
@@ -247,28 +33,7 @@ On osx you can install through homebrew
 
 Run the tests inside a phantom.js runner:
 
-    $ rake
-    
-You can also run the tests in the browser by opening spec/index.html.
-
-### Development Tips
-
-The following rake task are pertinent to adding/changing
-functionality.
-
-* opal - builds the following js files:
-  * opal-jquery  - opal jquery
-  * opal.js      - the opal runtime
-  * opal-spec.js - opal spec framework
-  * specs.js     - the spec
-* opal:test - runs the specs.  It is the default rake task
-
-If you TDD, you may want to run
-
-    $ rake opal opal:test
-    
-Or use a guard script that does similar
-
+    $ bundle exec rake
 
 ###  License
 

data/config.ru

@@ -1,31 +1,10 @@
 require 'bundler'
 Bundler.require
 
-html = <<-HTML
-  <!DOCTYPE html>
-  <html>
-  <head>
-    <title>opal-jquery specs</title>
-  </head>
-    <body>
-      <script src="/assets/autorun.js"></script>
-    </body>
-  </html>
-HTML
+require 'opal/spec/server'
 
-map '/assets' do
-  env = Opal::Environment.new
-  env.append_path 'vendor' # for jquery
-  env.append_path 'spec'
-  run env
-end
+# Run in non-debug mode (faster, all files concatenated into 1 file)
+run Opal::Spec::Server.new(false)
 
-map '/' do
-  run lambda { |env|
-    if env['PATH_INFO'] == '/'
-      [200, {'Content-Type' => 'text/html'}, [html]]
-    else
-      Rack::Directory.new('spec').call(env)
-    end
-  }
-end
+# Run in debug mode - all files loaded seperately, but slower
+# run Opal::Spec::Server.new

data/lib/assets/javascripts/opal-jquery.rb

@@ -0,0 +1 @@
+require 'opal/jquery'

data/lib/assets/javascripts/opal/jquery/document.rb

@@ -29,10 +29,7 @@ module Document
         return nil;
       }
 
-      $(function() {
-        #{ block.call };
-      });
-
+      $(block);
       return nil;
     }
   end

data/lib/assets/javascripts/opal/jquery/event.rb

@@ -10,6 +10,7 @@ class Event < `$.Event`
 
   alias_native :default_prevented?, :isDefaultPrevented
 
+  # Stops propagation and prevents default action.
   def kill
     stop_propagation
     prevent_default

data/lib/assets/javascripts/opal/jquery/http.rb

@@ -5,11 +5,7 @@
 #     end
 #
 class HTTP
-  attr_reader :body
-  attr_reader :error_message
-  attr_reader :method
-  attr_reader :status_code
-  attr_reader :url
+  attr_reader :body, :error_message, :method, :status_code, :url
 
   def self.get(url, opts={}, &block)
     self.new(url, :GET, opts, block).send!

data/lib/opal/jquery/version.rb

@@ -1,5 +1,5 @@
 module Opal
   module JQuery
-    VERSION = '0.0.5'
+    VERSION = '0.0.6'
   end
 end

data/spec/spec_helper.rb

@@ -2,7 +2,7 @@ require 'jquery'
 require 'opal-spec'
 require 'opal-jquery'
 
-module OpalSpec
+module Spec
   class ExampleGroup
 
     # Add some html code to the body tag ready for testing. This will
@@ -24,13 +24,11 @@ module OpalSpec
     def html(html_string='')
       html = '<div id="opal-jquery-test-div">' + html_string + '</div>'
       before do
-        @__html = Document.parse(html)
-        @__html.append_to_body
+        @_spec_html = Document.parse(html)
+        @_spec_html.append_to_body
       end
 
-      after { @__html.remove }
+      after { @_spec_html.remove }
     end
   end
 end
-
-Opal::Spec::Runner.autorun

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: opal-jquery
 version: !ruby/object:Gem::Version
-  version: 0.0.5
+  version: 0.0.6
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-02-08 00:00:00.000000000 Z
+date: 2013-02-16 00:00:00.000000000 Z
 dependencies: []
 description: Opal DOM library for jquery
 email: adam.beynon@gmail.com
@@ -24,7 +24,7 @@ files:
 - README.md
 - Rakefile
 - config.ru
-- lib/assets/javascripts/opal-jquery.js.erb
+- lib/assets/javascripts/opal-jquery.rb
 - lib/assets/javascripts/opal/jquery.rb
 - lib/assets/javascripts/opal/jquery/document.rb
 - lib/assets/javascripts/opal/jquery/element.rb
@@ -36,7 +36,6 @@ files:
 - lib/opal/jquery.rb
 - lib/opal/jquery/version.rb
 - opal-jquery.gemspec
-- spec/autorun.rb
 - spec/data/simple.txt
 - spec/data/user.json
 - spec/document_spec.rb
@@ -57,9 +56,9 @@ files:
 - spec/element_spec.rb
 - spec/event_spec.rb
 - spec/http_spec.rb
+- spec/jquery.js
 - spec/local_storage_spec.rb
 - spec/spec_helper.rb
-- vendor/jquery.js
 homepage: http://opalrb.org
 licenses: []
 post_install_message: 
@@ -85,7 +84,6 @@ signing_key:
 specification_version: 3
 summary: Opal access to jquery
 test_files:
-- spec/autorun.rb
 - spec/data/simple.txt
 - spec/data/user.json
 - spec/document_spec.rb
@@ -106,5 +104,6 @@ test_files:
 - spec/element_spec.rb
 - spec/event_spec.rb
 - spec/http_spec.rb
+- spec/jquery.js
 - spec/local_storage_spec.rb
 - spec/spec_helper.rb

data/lib/assets/javascripts/opal-jquery.js.erb

@@ -1,3 +0,0 @@
-//= require opal/jquery
-
-Opal.jquery_version = <%= Opal::JQuery::VERSION.inspect %>;

data/spec/autorun.rb

@@ -1,3 +0,0 @@
-#= require opal
-#= require opal-spec
-#= require_tree .