livequery-rails-cis 0.0.1

data/.gitignore

@@ -0,0 +1,8 @@
+pkg/*
+tmp
+spec/support/*/Gemfile.lock
+spec/support/*/public/javascripts
+.ruby-version
+.bundle
+imports/*
+Gemfile.lock

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in livequery-rails-cis.gemspec
+gemspec

data/README.md

@@ -0,0 +1,141 @@
+# LiveQuery::Rails
+
+Live Query utilizes the power of jQuery selectors by binding events or firing callbacks for matched elements auto-magically, even after the page has been loaded and the DOM updated.
+
+Live Query! For Rails!
+
+This gem provides:
+
+* LiveQuery 1.1.1 - [livequery](https://github.com/brandonaaron/livequery)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+For Rails 3.0 apps, add the mozart-rails gem to your Gemfile.
+
+    gem 'livequery-rails-cis'
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself via:
+
+    $ bundle exec rake build
+    $ gem install --local pkg/livequery-rails-cis-0.0.1.gem
+
+
+## Usage
+
+### Rails 3.1 or greater
+
+The LiveQuery files and all dependencies will be added to the asset pipeline and be 
+available for you to use. If they're not already in app/assets/javascripts/application.js, 
+add these lines:
+
+    //= require livequery-rails-cis
+
+LiveQuery has a dependency on the `jQuery-rails` gem.
+
+## Examples
+
+For example you could use the following code to bind a click event to all A tags, even any A tags you might add via AJAX.
+
+    $('a') 
+        .livequery('click', function(event) { 
+            alert('clicked'); 
+            return false; 
+        });
+
+Once you add new A tags to your document, Live Query will bind the click event and there is nothing else that needs to be called or done.
+
+When an element no longer matches a selector the events Live Query bound to it are unbound. The Live Query can be expired which will no longer bind anymore events and unbind all the events it previously bound.
+
+Live Query can even be used with the more powerful jQuery selectors. The following Live Query will match and bind a click event to all A tags that have a rel attribute with the word "friend" in it. If one of the A tags is modified by removing the word "friend" from the rel attribute, the click event will be unbound since it is no longer matched by the Live Query.
+
+    $('a[rel*=friend]') 
+        .livequery('click', function(event) { 
+            doSomething(); 
+        });
+
+Live Query also has the ability to fire a function (callback) when it matches a new element and another function (callback) for when an element is no longer matched. This provides ultimate flexibility and untold use-cases. For example the following code uses a function based Live Query to implement the jQuery hover helper method and remove it when the element is no longer matched.
+
+    $('li') 
+        .livequery(function(){ 
+        // use the helper function hover to bind a mouseover and mouseout event 
+            $(this) 
+                .hover(function() { 
+                    $(this).addClass('hover'); 
+                }, function() { 
+                    $(this).removeClass('hover'); 
+                }); 
+        }, function() { 
+            // unbind the mouseover and mouseout events 
+            $(this) 
+                .unbind('mouseover') 
+                .unbind('mouseout'); 
+        });
+
+## API
+
+### `livequery` Signatures
+
+The `livequery` method has 3 different signatures or ways to call it.
+
+The first, and most typical usage, is to pass an event type and an event handler:
+
+    // eventType: such as click or submit
+    // eventHandler: the function to execute when the event happens
+    $(selector).livequery( eventType, eventHandler );
+
+The second and third signature is to pass one or two functions to `livequery`. Doing this, `livequery` will call the first passed function when an element is newly matched and will call the second passed function when an element is removed or no longer matched. The second function is optional. The `this` or context of the first function will be the newly matched element. For the second function it will be the element that is no longer matched.
+
+    // matchedFn: the function to execute when a new element is matched
+    $(selector).livequery( matchedFn );
+
+    // matchedFn: the function to execute when a new element is matched
+    // unmatchedFn: the function to execute when an element is no longer matched
+    $(selector).livequery( matchedFn, unmatchFn );
+
+### `expire` Signatures
+
+The `expire` method has 5 different signatures or ways to call it.
+
+The first way will stop/expire all live queries associated with the selector.
+
+    $(selector).expire();
+
+The second way will stop/expire all live queries associated with the selector and event type.
+
+    // eventType: such as click or submit
+    $(selctor).expire( eventType );
+
+The third way will stop/expire all live queries associated with the selector, event type, and event handler reference.
+
+    // eventType: such as click or submit
+    // eventHandler: the function to execute when the event happens
+    $(selector).expire( eventType, eventHandler );
+
+The fourth way will stop/expire all live queries associated with the selector and matchedFn.
+
+    // matchedFn: the function to execute when a new element is matched
+    $(selector).expire( matchedFn );
+
+The fifth way will stop/expire all live queries associated with the selector, matchedFn, and unmatchedFn.
+
+    // matchedFn: the function to execute when a new element is matched
+    // unmatchedFn: the function to execute when an element is no longer matched
+    $(selector).expire( matchedFn, unmatchFn );
+
+## For Plugin Developers
+
+If your plugin modifies the DOM without using the built-in DOM Modification methods (append, addClass, etc), you can register your plugin with Live Query like this.
+
+    if (jQuery.livequery) 
+        jQuery.livequery.registerPlugin("pluginMethodName");
+        
+You can register several plugin methods at once by just passing them as additional arguments to the registerPlugin method.
+
+    if (jQuery.livequery) 
+        jQuery.livequery.registerPlugin("method1", "method2", "method3");

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/lib/generators/livequery/install/USAGE

@@ -0,0 +1,8 @@
+Description:
+    Setup jQuerylive assets on your application
+
+Example:
+  rails g livequery:install
+  
+  This will replace the default application assets:
+    /app/assets/javascripts/application.js

data/lib/generators/livequery/install/install_generator.rb

@@ -0,0 +1,37 @@
+require 'rails'
+
+# Supply generator for Rails 3.0.x or if asset pipeline is not enabled
+if ::Rails.version < "3.1" || !::Rails.application.config.assets.enabled || !File.exist?('app/assets/javascripts/application.js') || !File.exist?('app/assets/javascripts/application.js.coffee')
+  module Livequery
+    module Generators
+      class InstallGenerator < ::Rails::Generators::Base
+
+        desc "This generator installs Livequery #{Livequery::Rails::LIVEQUERY_VERSION}"
+        source_root File.expand_path('../../../../../vendor/assets/javascripts', __FILE__)
+
+        def copy_livequery
+          say_status("copying", "livequery (#{Livequery::Rails::LIVEQUERY_VERSION})", :green)
+          copy_file "livequery.js", "public/javascripts/Livequery.js"
+          copy_file "livequery.min.js", "public/javascripts/Livequery.min.js"
+        end
+      end
+    end
+  end
+else
+  module Livequery
+    module Generators
+      class InstallGenerator < ::Rails::Generators::Base
+        desc "This generator add Livequery #{Livequery::Rails::LIVEQUERY_VERSION} to application.js or application.js.coffee"
+        source_root File.expand_path('../../../../../vendor/assets/javascripts', __FILE__)
+        def add_assets
+          insert_into_file "app/assets/javascripts/application#{detect_js_format[0]}", "#{detect_js_format[1]} require livequery\n", :after => "jquery_ujs\n"
+        end
+        
+        def detect_js_format
+          return ['.js.coffee', '#='] if File.exist?('app/assets/javascripts/application.js.coffee')
+          return ['.js', '//='] if File.exist?('app/assets/javascripts/application.js')
+        end
+      end
+    end
+  end
+end

data/lib/livequery-rails-cis.rb

@@ -0,0 +1 @@
+require 'livequery/rails'

data/lib/livequery/assert_select.rb

@@ -0,0 +1,25 @@
+module ActionDispatch
+  module Assertions
+    module SelectorAssertions
+
+      PATTERN_HTML = %Q{"((\\\\\"|[^\"])*)"}
+      PATTERN_UNICODE_ESCAPED_CHAR = /\\u([0-9a-zA-Z]{4})/
+
+      private
+
+      # Unescapes a JS string.
+      def unescape_js(js_string)
+        # js encodes double quotes and line breaks.
+        unescaped= js_string.gsub('\"', '"')
+        unescaped.gsub!('\\\'', "'")
+        unescaped.gsub!(/\\\//, '/')
+        unescaped.gsub!('\n', "\n")
+        unescaped.gsub!('\076', '>')
+        unescaped.gsub!('\074', '<')
+        # js encodes non-ascii characters.
+        unescaped.gsub!(PATTERN_UNICODE_ESCAPED_CHAR) {|u| [$1.hex].pack('U*')}
+        unescaped
+      end
+    end
+  end
+end

data/lib/livequery/rails.rb

@@ -0,0 +1,10 @@
+require 'rails'
+require 'livequery/assert_select' if ::Rails.env.test?
+require 'livequery/rails/engine' if ::Rails.version >= '3.1'
+require 'livequery/rails/railtie'
+require 'livequery/rails/version'
+
+module Livequery
+  module Rails
+  end
+end

data/lib/livequery/rails/engine.rb

@@ -0,0 +1,6 @@
+module Livequery
+  module Rails
+    class Engine < ::Rails::Engine
+    end
+  end
+end

data/lib/livequery/rails/railtie.rb

@@ -0,0 +1,13 @@
+# Used to ensure that Rails 3.0.x, as well as Rails >= 3.1 with asset pipeline disabled
+# get the minified version of the scripts included into the layout in production.
+module Livequery
+  module Rails
+    class Railtie < ::Rails::Railtie
+      config.before_configuration do
+        if config.action_view.javascript_expansions
+          livequery_defaults = ::Rails.env.production? || ::Rails.env.test? ? %w(livequery.min) : %w(livequery)
+        end
+      end
+    end
+  end
+end

data/lib/livequery/rails/version.rb

@@ -0,0 +1,6 @@
+module Livequery
+	module Rails
+		VERSION = "0.0.1"
+		LIVEQUERY_VERSION = "1.1.1"
+	end
+end

data/livequery-rails-cis.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/livequery/rails/version', __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = "livequery-rails-cis"
+  s.date        = '2013-10-04' 
+  s.version     = Livequery::Rails::VERSION
+  s.authors     = ["Anup, CISROR Team"]
+  s.homepage    = "https://github.com/cisror/livequery-rails-cis"
+  s.summary     = %q{Get up and running with Livequery in seconds.}
+  s.description = %q{Live Query utilizes the power of jQuery selectors by binding events or firing callbacks for matched elements auto-magically, even after the page has been loaded and the DOM updated.}
+
+  s.required_rubygems_version = ">= 1.3.6"
+  s.rubyforge_project         = "jquery-rails"
+
+  s.add_dependency "railties", ">= 3.0"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/vendor/assets/javascripts/livequery.js

@@ -0,0 +1,226 @@
+/*! Copyright (c) 2010 Brandon Aaron (http://brandonaaron.net)
+ * Dual licensed under the MIT (MIT_LICENSE.txt)
+ * and GPL Version 2 (GPL_LICENSE.txt) licenses.
+ *
+ * Version: 1.1.1
+ * Requires jQuery 1.3+
+ * Docs: http://docs.jquery.com/Plugins/livequery
+ */
+
+(function($) {
+
+$.extend($.fn, {
+  livequery: function(type, fn, fn2) {
+    var self = this, q;
+
+    // Handle different call patterns
+    if ($.isFunction(type))
+      fn2 = fn, fn = type, type = undefined;
+
+    // See if Live Query already exists
+    $.each( $.livequery.queries, function(i, query) {
+      if ( self.selector == query.selector && self.context == query.context &&
+        type == query.type && (!fn || fn.$lqguid == query.fn.$lqguid) && (!fn2 || fn2.$lqguid == query.fn2.$lqguid) )
+          // Found the query, exit the each loop
+          return (q = query) && false;
+    });
+
+    // Create new Live Query if it wasn't found
+    q = q || new $.livequery(this.selector, this.context, type, fn, fn2);
+
+    // Make sure it is running
+    q.stopped = false;
+
+    // Run it immediately for the first time
+    q.run();
+
+    // Contnue the chain
+    return this;
+  },
+
+  expire: function(type, fn, fn2) {
+    var self = this;
+
+    // Handle different call patterns
+    if ($.isFunction(type))
+      fn2 = fn, fn = type, type = undefined;
+
+    // Find the Live Query based on arguments and stop it
+    $.each( $.livequery.queries, function(i, query) {
+      if ( self.selector == query.selector && self.context == query.context &&
+        (!type || type == query.type) && (!fn || fn.$lqguid == query.fn.$lqguid) && (!fn2 || fn2.$lqguid == query.fn2.$lqguid) && !this.stopped )
+          $.livequery.stop(query.id);
+    });
+
+    // Continue the chain
+    return this;
+  }
+});
+
+$.livequery = function(selector, context, type, fn, fn2) {
+  this.selector = selector;
+  this.context  = context;
+  this.type     = type;
+  this.fn       = fn;
+  this.fn2      = fn2;
+  this.elements = [];
+  this.stopped  = false;
+
+  // The id is the index of the Live Query in $.livequery.queries
+  this.id = $.livequery.queries.push(this)-1;
+
+  // Mark the functions for matching later on
+  fn.$lqguid = fn.$lqguid || $.livequery.guid++;
+  if (fn2) fn2.$lqguid = fn2.$lqguid || $.livequery.guid++;
+
+  // Return the Live Query
+  return this;
+};
+
+$.livequery.prototype = {
+  stop: function() {
+    var query = this;
+
+    if ( this.type )
+      // Unbind all bound events
+      this.elements.unbind(this.type, this.fn);
+    else if (this.fn2)
+      // Call the second function for all matched elements
+      this.elements.each(function(i, el) {
+        query.fn2.apply(el);
+      });
+
+    // Clear out matched elements
+    this.elements = [];
+
+    // Stop the Live Query from running until restarted
+    this.stopped = true;
+  },
+
+  run: function() {
+    // Short-circuit if stopped
+    if ( this.stopped ) return;
+    var query = this;
+
+    var oEls = this.elements,
+      els  = $(this.selector, this.context),
+      nEls = els.not(oEls);
+
+    // Set elements to the latest set of matched elements
+    this.elements = els;
+
+    if (this.type) {
+      // Bind events to newly matched elements
+      nEls.bind(this.type, this.fn);
+
+      // Unbind events to elements no longer matched
+      if (oEls.length > 0)
+        $.each(oEls, function(i, el) {
+          if ( $.inArray(el, els) < 0 )
+            $.event.remove(el, query.type, query.fn);
+        });
+    }
+    else {
+      // Call the first function for newly matched elements
+      nEls.each(function() {
+        query.fn.apply(this);
+      });
+
+      // Call the second function for elements no longer matched
+      if ( this.fn2 && oEls.length > 0 )
+        $.each(oEls, function(i, el) {
+          if ( $.inArray(el, els) < 0 )
+            query.fn2.apply(el);
+        });
+    }
+  }
+};
+
+$.extend($.livequery, {
+  guid: 0,
+  queries: [],
+  queue: [],
+  running: false,
+  timeout: null,
+
+  checkQueue: function() {
+    if ( $.livequery.running && $.livequery.queue.length ) {
+      var length = $.livequery.queue.length;
+      // Run each Live Query currently in the queue
+      while ( length-- )
+        $.livequery.queries[ $.livequery.queue.shift() ].run();
+    }
+  },
+
+  pause: function() {
+    // Don't run anymore Live Queries until restarted
+    $.livequery.running = false;
+  },
+
+  play: function() {
+    // Restart Live Queries
+    $.livequery.running = true;
+    // Request a run of the Live Queries
+    $.livequery.run();
+  },
+
+  registerPlugin: function() {
+    $.each( arguments, function(i,n) {
+      // Short-circuit if the method doesn't exist
+      if (!$.fn[n]) return;
+
+      // Save a reference to the original method
+      var old = $.fn[n];
+
+      // Create a new method
+      $.fn[n] = function() {
+        // Call the original method
+        var r = old.apply(this, arguments);
+
+        // Request a run of the Live Queries
+        $.livequery.run();
+
+        // Return the original methods result
+        return r;
+      }
+    });
+  },
+
+  run: function(id) {
+    if (id != undefined) {
+      // Put the particular Live Query in the queue if it doesn't already exist
+      if ( $.inArray(id, $.livequery.queue) < 0 )
+        $.livequery.queue.push( id );
+    }
+    else
+      // Put each Live Query in the queue if it doesn't already exist
+      $.each( $.livequery.queries, function(id) {
+        if ( $.inArray(id, $.livequery.queue) < 0 )
+          $.livequery.queue.push( id );
+      });
+
+    // Clear timeout if it already exists
+    if ($.livequery.timeout) clearTimeout($.livequery.timeout);
+    // Create a timeout to check the queue and actually run the Live Queries
+    $.livequery.timeout = setTimeout($.livequery.checkQueue, 20);
+  },
+
+  stop: function(id) {
+    if (id != undefined)
+      // Stop are particular Live Query
+      $.livequery.queries[ id ].stop();
+    else
+      // Stop all Live Queries
+      $.each( $.livequery.queries, function(id) {
+        $.livequery.queries[ id ].stop();
+      });
+  }
+});
+
+// Register core DOM manipulation methods
+$.livequery.registerPlugin('append', 'prepend', 'after', 'before', 'wrap', 'attr', 'removeAttr', 'addClass', 'removeClass', 'toggleClass', 'empty', 'remove', 'html');
+
+// Run Live Queries when the Document is ready
+$(function() { $.livequery.play(); });
+
+})(jQuery);

data/vendor/assets/javascripts/livequery.min.js

@@ -0,0 +1,9 @@
+/*! Copyright (c) 2010 Brandon Aaron (http://brandonaaron.net)
+ * Dual licensed under the MIT (MIT_LICENSE.txt)
+ * and GPL Version 2 (GPL_LICENSE.txt) licenses.
+ *
+ * Version: 1.1.1
+ * Requires jQuery 1.3+
+ * Docs: http://docs.jquery.com/Plugins/livequery
+ */
+(function(e){e.extend(e.fn,{livequery:function(t,n,r){var i=this,s;if(e.isFunction(t))r=n,n=t,t=undefined;e.each(e.livequery.queries,function(e,o){if(i.selector==o.selector&&i.context==o.context&&t==o.type&&(!n||n.$lqguid==o.fn.$lqguid)&&(!r||r.$lqguid==o.fn2.$lqguid))return(s=o)&&false});s=s||new e.livequery(this.selector,this.context,t,n,r);s.stopped=false;s.run();return this},expire:function(t,n,r){var i=this;if(e.isFunction(t))r=n,n=t,t=undefined;e.each(e.livequery.queries,function(s,o){if(i.selector==o.selector&&i.context==o.context&&(!t||t==o.type)&&(!n||n.$lqguid==o.fn.$lqguid)&&(!r||r.$lqguid==o.fn2.$lqguid)&&!this.stopped)e.livequery.stop(o.id)});return this}});e.livequery=function(t,n,r,i,s){this.selector=t;this.context=n;this.type=r;this.fn=i;this.fn2=s;this.elements=[];this.stopped=false;this.id=e.livequery.queries.push(this)-1;i.$lqguid=i.$lqguid||e.livequery.guid++;if(s)s.$lqguid=s.$lqguid||e.livequery.guid++;return this};e.livequery.prototype={stop:function(){var e=this;if(this.type)this.elements.unbind(this.type,this.fn);else if(this.fn2)this.elements.each(function(t,n){e.fn2.apply(n)});this.elements=[];this.stopped=true},run:function(){if(this.stopped)return;var t=this;var n=this.elements,r=e(this.selector,this.context),i=r.not(n);this.elements=r;if(this.type){i.bind(this.type,this.fn);if(n.length>0)e.each(n,function(n,i){if(e.inArray(i,r)<0)e.event.remove(i,t.type,t.fn)})}else{i.each(function(){t.fn.apply(this)});if(this.fn2&&n.length>0)e.each(n,function(n,i){if(e.inArray(i,r)<0)t.fn2.apply(i)})}}};e.extend(e.livequery,{guid:0,queries:[],queue:[],running:false,timeout:null,checkQueue:function(){if(e.livequery.running&&e.livequery.queue.length){var t=e.livequery.queue.length;while(t--)e.livequery.queries[e.livequery.queue.shift()].run()}},pause:function(){e.livequery.running=false},play:function(){e.livequery.running=true;e.livequery.run()},registerPlugin:function(){e.each(arguments,function(t,n){if(!e.fn[n])return;var r=e.fn[n];e.fn[n]=function(){var t=r.apply(this,arguments);e.livequery.run();return t}})},run:function(t){if(t!=undefined){if(e.inArray(t,e.livequery.queue)<0)e.livequery.queue.push(t)}else e.each(e.livequery.queries,function(t){if(e.inArray(t,e.livequery.queue)<0)e.livequery.queue.push(t)});if(e.livequery.timeout)clearTimeout(e.livequery.timeout);e.livequery.timeout=setTimeout(e.livequery.checkQueue,20)},stop:function(t){if(t!=undefined)e.livequery.queries[t].stop();else e.each(e.livequery.queries,function(t){e.livequery.queries[t].stop()})}});e.livequery.registerPlugin("append","prepend","after","before","wrap","attr","removeAttr","addClass","removeClass","toggleClass","empty","remove","html");e(function(){e.livequery.play()})})(jQuery)

metadata

@@ -0,0 +1,77 @@
+--- !ruby/object:Gem::Specification
+name: livequery-rails-cis
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Anup, CISROR Team
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-10-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Live Query utilizes the power of jQuery selectors by binding events or
+  firing callbacks for matched elements auto-magically, even after the page has been
+  loaded and the DOM updated.
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README.md
+- Rakefile
+- lib/generators/livequery/install/USAGE
+- lib/generators/livequery/install/install_generator.rb
+- lib/livequery-rails-cis.rb
+- lib/livequery/assert_select.rb
+- lib/livequery/rails.rb
+- lib/livequery/rails/engine.rb
+- lib/livequery/rails/railtie.rb
+- lib/livequery/rails/version.rb
+- livequery-rails-cis.gemspec
+- vendor/assets/javascripts/livequery.js
+- vendor/assets/javascripts/livequery.min.js
+homepage: https://github.com/cisror/livequery-rails-cis
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.3.6
+requirements: []
+rubyforge_project: jquery-rails
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Get up and running with Livequery in seconds.
+test_files: []