opal-jquery 0.0.1

data/.gitignore

@@ -0,0 +1,5 @@
+.DS_Store
+*.gem
+Gemfile.lock
+build
+gh-pages

data/.travis.yml

@@ -0,0 +1,8 @@
+language: ruby
+
+rvm:
+  - 1.8.7
+  - 1.9.3
+
+before_script:
+  - "bundle exec rake opal"

data/Gemfile

@@ -0,0 +1,11 @@
+source :rubygems
+
+gem 'rake'
+
+gem 'opal', :git => 'git://github.com/opal/opal.git'
+gem 'opal-spec', :git => 'git://github.com/opal/opal-spec.git'
+
+group :docs do
+  gem 'redcarpet'
+  gem 'albino'
+end

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (C) 2012 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,297 @@
+# opal-jquery
+
+[![Build Status](https://secure.travis-ci.org/opal/opal-jquery.png?branch=master)](http://travis-ci.org/opal/opal-jquery)
+
+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:
+
+```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
+
+# => "[{\"name\": \"Adam\"},{\"name\": \"Ben\"}]"
+# => [{"name" => "Adam"}, {"name" => "Ben"}]
+```
+
+The `#body` method will always return the raw response string.
+
+If an error is encountered, then the `#status_code` method will hold the
+specific error code from the underlying request:
+
+```ruby
+request = HTTP.get("/users/3.json")
+
+request.callback { puts "it worked!" }
+
+request.errback { |response|
+  puts "failed with status #{response.status_code}"
+}
+```
+
+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).
+
+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)
+
+On osx you can install through homebrew
+
+    $ brew update; brew install phantomjs
+
+Build dependencies, opal-jquery and it's specs into `build/`:
+
+    $ rake opal
+
+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
+
+
+###  License
+
+Copyright (C) 2012 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/Rakefile

@@ -0,0 +1,57 @@
+require 'bundler/setup'
+require 'opal/rake_task'
+
+Opal::RakeTask.new do |t|
+  t.name = 'opal-jquery'
+  t.dependencies = ['opal-spec']
+end
+
+task :default => :'opal:test'
+
+namespace :docs do
+  desc "Build docs"
+  task :build do
+    require 'redcarpet'
+    require 'albino'
+
+    klass = Class.new(Redcarpet::Render::HTML) do
+      def block_code(code, language)
+        Albino.new(code, language || :text).colorize
+      end
+    end
+
+    markdown = Redcarpet::Markdown.new(klass, :fenced_code_blocks => true)
+
+    File.open('gh-pages/index.html', 'w+') do |o|
+      puts " * index.html"
+      # remove first 2 lines (header/build status), as pre.html has a docs version
+      src = File.read("README.md").sub(/^(?:[^\n]*\n){4}/, '')
+
+      o.write File.read('docs/pre.html')
+      o.write markdown.render(src)
+      o.write File.read('docs/post.html')
+    end
+  end
+
+  desc "Clone repo"
+  task :clone do
+    if File.exists? 'gh-pages'
+     Dir.chdir('gh-pages') { sh 'git pull origin gh-pages' }
+    else
+      FileUtils.mkdir_p 'gh-pages'
+      Dir.chdir('gh-pages') do
+        sh 'git clone git@github.com:/opal/opal-jquery.git .'
+        sh 'git checkout gh-pages'
+      end
+    end
+  end
+
+  desc "commit and push"
+  task :push do
+    Dir.chdir('gh-pages') do
+      sh "git add ."
+      sh "git commit -a -m \"Documentation update #{Time.new}\""
+      sh "git push origin gh-pages"
+    end
+  end
+end

data/docs/post.html

@@ -0,0 +1,3 @@
+  </div>
+</body>
+</html>

data/docs/pre.html

@@ -0,0 +1,18 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>opal-jquery</title>
+  <link rel="stylesheet" href="css/bootstrap.css" type="text/css">
+  <link rel="stylesheet" href="css/pygment_trac.css" type="text/css">
+  <style>
+    body {
+      padding-top: 42px;
+    }
+  </style>
+</head>
+<body>
+  <a href="https://github.com/opal/opal-jquery"><img style="position: absolute; top: 0; right: 0; border: 0;" src="https://s3.amazonaws.com/github/ribbons/forkme_right_darkblue_121621.png" alt="Fork me on GitHub"></a>
+  <div class="container">
+    <div class="page-header">
+      <h1>opal-jquery <small>jquery wrapper for opal</small></h1>
+    </div>

data/lib/opal-jquery.rb

@@ -0,0 +1,4 @@
+require 'opal-jquery/document'
+require 'opal-jquery/element'
+require 'opal-jquery/kernel'
+require 'opal-jquery/http'

data/lib/opal-jquery/document.rb

@@ -0,0 +1,47 @@
+module Document
+  def self.[](selector)
+    `$(#{selector})`
+  end
+
+  def self.find(selector)
+    self[selector]
+  end
+
+  def self.id(id)
+    %x{
+      var el = document.getElementById(id);
+
+      if (!el) {
+        return nil;
+      }
+
+      return $(el);
+    }
+  end
+
+  def self.parse(str)
+    `$(str)`
+  end
+
+  def self.ready?(&block)
+    %x{
+      if (block === nil) {
+        return nil;
+      }
+
+      $(function() {
+        #{ block.call };
+      });
+
+      return nil;
+    }
+  end
+
+  def self.title
+    `document.title`
+  end
+
+  def self.title=(title)
+    `document.title = title`
+  end
+end