jquery-turbolinks 0.1.1 → 0.2.0

data/.gitignore

@@ -1 +1,2 @@
 node_modules
+*.gem

data/README.md

@@ -1,10 +1,12 @@
 # jQuery Turbolinks
 
-Do you like [Turbolinks](https://github.com/rails/turbolinks)? It's easy and fast way to imporove user experience of surfing on your site.
+Do you like [Turbolinks](https://github.com/rails/turbolinks)? It's easy and fast way to improve user experience of surfing on your website.
 
-But if you have large codebase with lots of `$(el).bind(...)` Turbolinks will surprise you. Most part of you JavaScripts stop working in usual way. It's because the nodes on which you bind events no longer exist.
+But if you have a large codebase with lots of `$(el).bind(...)` Turbolinks will surprise you. Most part of your JavaScripts will stop working in usual way. It's because the nodes on which you bind events no longer exist.
 
-I wrote jquery.turbolinks to solve this problem in [my project](http://amplifr.com). It's easy to use: just require it *after* `jquery.js` and `tubrolinks.js`, but before rest scripts.
+I wrote jquery.turbolinks to solve this problem in [my project](http://amplifr.com). It's easy to use: just require it *after* `jquery.js` and `tubrolinks.js`, but before other scripts.
+
+Sponsored by [Evil Martians](http://evilmartians.com/).
 
 ## Usage
 
@@ -18,12 +20,27 @@ JavaScript manifest file:
 //= require jquery.turbolinks
 ```
 
-And now it just works!
+And it just works!
+
+## `$.setReadyEvent`
+
+By default [ready](https://github.com/kossnocorp/jquery.turbolinks/blob/master/src/jquery.turbolinks.coffee#L17:L18) function is binded to [page:load](https://github.com/rails/turbolinks/#events) event.
+
+If you want to change it use `$.setReadyEvent` function:
+
+``` js
+$.setReadyEvent('page:change');
+```
 
 # Changelog
 
 This project uses [Semantic Versioning](http://semver.org/) for release numbering.
 
+## 0.2.0 (October 10, 2012)
+
+* Change event: `page:change` -> `page:load` (kudos to [@davydotcom](https://github.com/davydotcom));
+* added ability to change ready event via `$.setReadyEvent`
+
 ## 0.1.0 (October 3, 2012)
 
 * First, initial release

data/lib/jquery-turbolinks/version.rb

@@ -1,3 +1,3 @@
 module JqueryTurbolinks
-  VERSION = '0.1.1'
+  VERSION = '0.2.0'
 end

data/package.json

@@ -1,8 +1,8 @@
 {
   "name": "jquery.turbolinks",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "author": "Sasha Koss <koss@nocorp.me>",
-  "description": "jQuery plugin for ",
+  "description": "jQuery plugin for drop-in fix binded events problem caused by Turbolinks",
 
   "devDependencies": {
     "coffee-script": "*",
@@ -11,7 +11,8 @@
     "sinon":         "*",
     "sinon-chai":    "*",
     "uglify-js":     "*",
-    "jquery":        "*"
+    "jquery":        "*",
+    "jsdom":         "*"
   },
 
   "license": "MIT",

data/spec/jquery.turbolinks_spec.coffee

@@ -1,24 +1,52 @@
+jsdom = require('jsdom').jsdom
+
+global.document = jsdom()
+global.window   = document.createWindow()
+
 require('../src/jquery.turbolinks.coffee')
 
 chai      = require('chai')
 sinon     = require('sinon')
 sinonChai = require('sinon-chai')
-jQuery    = require('jquery')
+$         = require('jquery')
 
 chai.should()
 chai.use(sinonChai)
 
-describe 'jQuery Turbolinks', ->
+describe '$ Turbolinks', ->
+
+  callback1 = callback2 = null
+
+  beforeEach ->
+     $(callback1 = sinon.spy())
+     $(callback2 = sinon.spy())
 
   it '''
        should trigger callbacks passed to
-       `jQuery()` and `jQuery.ready()` when page:change
+       `$()` and `$.ready()` when page:load
        event fired
      ''', ->
-       jQuery(callback1 = sinon.spy())
-       jQuery(callback2 = sinon.spy())
+       $(document).trigger('page:load')
+
+       callback1.should.have.been.calledOnce
+       callback2.should.have.been.calledOnce
+
+  describe '$.setReadyEvent', ->
+
+    it 'should unbind default (page:load) event', ->
+       $.setReadyEvent('random_event_name')
+
+       $(document).trigger('page:load')
+
+       callback1.should.have.not.been.called
+       callback2.should.have.not.been.called
+
+    it 'should bind ready to passed function', ->
+       $.setReadyEvent('page:change')
 
-       jQuery(document).trigger('page:change')
+       $(document)
+         .trigger('page:load')
+         .trigger('page:change')
 
-       callback1.should.have.been.calledTwice
-       callback2.should.have.been.calledTwice
+       callback1.should.have.been.calledOnce
+       callback2.should.have.been.calledOnce

data/src/jquery.turbolinks.coffee

@@ -1,5 +1,5 @@
 ###
-  jquery.turbolinks.js ~ v0.1.0 ~ https://github.com/kossnocorp/jquery.turbolinks
+  jquery.turbolinks.js ~ v0.2.0 ~ https://github.com/kossnocorp/jquery.turbolinks
 
   jQuery plugin for drop-in fix binded events problem caused by Turbolinks
 
@@ -24,5 +24,11 @@ $(ready)
 $.fn.ready = (callback) ->
   callbacks.push(callback)
 
-# Bind `ready` to Tubolinks page change event
-$(document).on('page:change', ready)
+# Bind ready to passed event
+$.setReadyEvent = (event) ->
+  $(document)
+    .off('.turbolinks')
+    .on(event + '.turbolinks', ready)
+
+# Bind `ready` to Tubolinks page load event
+$.setReadyEvent('page:load')

data/vendor/assets/javascripts/jquery.turbolinks.js

@@ -1,7 +1,7 @@
 // Generated by CoffeeScript 1.3.3
 
 /*
-  jquery.turbolinks.js ~ v0.1.0 ~ https://github.com/kossnocorp/jquery.turbolinks
+  jquery.turbolinks.js ~ v0.2.0 ~ https://github.com/kossnocorp/jquery.turbolinks
 
   jQuery plugin for drop-in fix binded events problem caused by Turbolinks
 
@@ -34,6 +34,10 @@
     return callbacks.push(callback);
   };
 
-  $(document).on('page:change', ready);
+  $.setReadyEvent = function(event) {
+    return $(document).off('.turbolinks').on(event + '.turbolinks', ready);
+  };
+
+  $.setReadyEvent('page:load');
 
 }).call(this);

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jquery-turbolinks
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
   prerelease: 
 platform: ruby
 authors: