63 |
69 |
70 |
71 |
72 |
--------------------------------------------------------------------------------
/lib/min/plugins/sammy.oauth2-0.7.6.min.js:
--------------------------------------------------------------------------------
1 | // -- Sammy.js -- /plugins/sammy.oauth2.js
2 | // http://sammyjs.org
3 | // Version: 0.7.6
4 | // Built: 2014-08-26 10:45:33 +0300
5 | (function(factory){if(typeof define==="function"&&define.amd){define(["jquery","sammy"],factory)}else{(window.Sammy=window.Sammy||{}).OAuth2=factory(window.jQuery,window.Sammy)}})(function($,Sammy){Sammy.OAuth2=function(app){app.use("JSON");this.authorize="/oauth/authorize";this.helper("requireOAuth",function(cb){if(this.app.getAccessToken()){if(cb){cb.apply(this)}}else{this.redirect(this.app.authorize+"?state="+escape(this.path));return false}});this.helper("loseAccessToken",function(){this.app.loseAccessToken()});this.requireOAuth=function(options){this.before(options||{},function(context){return context.requireOAuth()})};this.getAccessToken=function(){return this.session("oauth.token")};this.setAccessToken=function(token){this.session("oauth.token",token);this.trigger("oauth.connected")};this.loseAccessToken=function(){this.session("oauth.token",null);this.trigger("oauth.disconnected")};$(document).ajaxSend(function(evt,xhr){var token=app.getAccessToken();if(token){xhr.setRequestHeader("Authorization","OAuth "+token)}});function parseParams(path){var hash=path.match(/#(.*)$/)[1];var pairs=hash.split("&"),params={};var i,len=pairs.length;for(i=0;i-
64 |
- reset! 65 |
- People! 66 |
- Computers! 67 |
Hello!
54 | // 55 | // Hey, AQ! Welcome to HAML! 56 | // 57 | // Note: You dont have to include the haml.js file on top of the plugin as the plugin 58 | // includes the full source. 59 | // 60 | Sammy.Haml = function(app, method_alias) { 61 | var haml_cache = {}; 62 | // *Helper* Uses haml-js to parse a template and interpolate and work with the passed data 63 | // 64 | // ### Arguments 65 | // 66 | // * `template` A String template. 67 | // * `data` An Object containing the replacement values for the template. 68 | // data is extended with the EventContext allowing you to call its methods within the template. 69 | // 70 | var haml = function(template, data, name) { 71 | // use name for caching 72 | if (typeof name == 'undefined') { name = template; } 73 | var fn = haml_cache[name]; 74 | if (!fn) { 75 | fn = haml_cache[name] = Haml(template); 76 | } 77 | return fn($.extend({}, this, data)); 78 | }; 79 | 80 | // set the default method name/extension 81 | if (!method_alias) { method_alias = 'haml'; } 82 | app.helper(method_alias, haml); 83 | 84 | }; 85 | 86 | return Sammy.Haml; 87 | 88 | })); 89 | -------------------------------------------------------------------------------- /lib/plugins/sammy.data_location_proxy.js: -------------------------------------------------------------------------------- 1 | (function (factory) { 2 | if (typeof define === 'function' && define.amd) { 3 | define(['jquery', 'sammy'], factory); 4 | } else { 5 | (window.Sammy = window.Sammy || {}).DataLocationProxy = factory(window.jQuery, window.Sammy); 6 | } 7 | }(function ($, Sammy) { 8 | 9 | // The DataLocationProxy is an optional location proxy prototype. As opposed to 10 | // the `HashLocationProxy` it gets its location from a jQuery.data attribute 11 | // tied to the application's element. You can set the name of the attribute by 12 | // passing a string as the second argument to the constructor. The default attribute 13 | // name is 'sammy-location'. To read more about location proxies, check out the 14 | // documentation for `Sammy.HashLocationProxy` 15 | // 16 | // An optional `href_attribute` can be passed, which specifies a DOM element 17 | // attribute that holds "links" to different locations in the app. When the 18 | // proxy is bound, clicks to element that have this attribute activate a 19 | // `setLocation()` using the contents of the `href_attribute`. 20 | // 21 | // ### Example 22 | // 23 | // var app = $.sammy(function() { 24 | // // set up the location proxy 25 | // this.setLocationProxy(new Sammy.DataLocationProxy(this, 'location', 'rel')); 26 | // 27 | // this.get('about', function() { 28 | // this.partial('about.html'); 29 | // }); 30 | // 31 | // }); 32 | // 33 | // In this scenario, if an element existed within the template: 34 | // 35 | // About Us 36 | // 37 | // Clicking on that link would not go to /about, but would set the apps location 38 | // to 'about' and trigger the route. 39 | Sammy.DataLocationProxy = function(app, data_name, href_attribute) { 40 | this.app = app; 41 | this.data_name = data_name || 'sammy-location'; 42 | this.href_attribute = href_attribute; 43 | }; 44 | 45 | $.extend(Sammy.DataLocationProxy.prototype , { 46 | bind: function() { 47 | var proxy = this; 48 | this.app.$element().bind('setData', function(e, key, value) { 49 | if (key == proxy.data_name) { 50 | // jQuery unfortunately fires the event before it sets the value 51 | // work around it, by setting the value ourselves 52 | proxy.app.$element().each(function() { 53 | $.data(this, proxy.data_name, value); 54 | }); 55 | proxy.app.trigger('location-changed'); 56 | } 57 | }); 58 | if (this.href_attribute) { 59 | this.app.$element().delegate('[' + this.href_attribute + ']', 'click', function(e) { 60 | e.preventDefault(); 61 | proxy.setLocation($(this).attr(proxy.href_attribute)); 62 | }); 63 | } 64 | }, 65 | 66 | unbind: function() { 67 | if (this.href_attribute) { 68 | this.app.$element().undelegate('[' + this.href_attribute + ']', 'click'); 69 | } 70 | this.app.$element().unbind('setData'); 71 | }, 72 | 73 | getLocation: function() { 74 | return this.app.$element().data(this.data_name) || ''; 75 | }, 76 | 77 | setLocation: function(new_location) { 78 | return this.app.$element().data(this.data_name, new_location); 79 | } 80 | }); 81 | 82 | return Sammy.DataLocationProxy; 83 | 84 | })); 85 | -------------------------------------------------------------------------------- /examples/backend/public/javascripts/app.js: -------------------------------------------------------------------------------- 1 | ;(function($) { 2 | var app = $.sammy('#main', function() { 3 | this.debug = true; 4 | this.use(Sammy.Cache); 5 | this.use(Sammy.Template, 'erb'); 6 | 7 | var db = null, 8 | db_loaded = false; 9 | 10 | this.before(function() { 11 | if (!db_loaded) { 12 | this.redirect('#/connecting'); 13 | return false; 14 | } 15 | }); 16 | 17 | // display tasks 18 | this.get('#/', function(context) { 19 | this.partial('/templates/index.html.erb', function(html) { 20 | $('#main').html(html); 21 | $.each(db.collection('tasks').all(), function(i, task) { 22 | context.log('task', task.json()); 23 | context.partial('/templates/task.html.erb', {task: task}, function(task_html) { 24 | $(task_html).data('task', task).prependTo('#tasks'); 25 | }); 26 | }); 27 | }); 28 | }); 29 | 30 | this.get('#/tasks/:id', function() { 31 | this.task = db.collection('tasks').get(this.params['id']).json(); 32 | this.partial('/templates/task_details.html.erb') 33 | }); 34 | 35 | this.post('#/tasks', function(context) { 36 | var task = { 37 | entry: this.params['entry'], 38 | completed: false, 39 | created_at: Date() 40 | }; 41 | db.collection('tasks').create(task, { 42 | success: function(task) { 43 | context.partial('/templates/task.html.erb', {task: task}, function(task_html) { 44 | $('#tasks').prepend(task_html); 45 | }); 46 | // clear the form 47 | $('.entry').val(''); 48 | }, 49 | error: function() { 50 | context.trigger('error', {message: 'Sorry, could not save your task.'}) 51 | } 52 | }); 53 | }); 54 | 55 | this.get('#/connecting', function() { 56 | $('#main').html('... Loading ...'); 57 | }); 58 | 59 | this.bind('task-toggle', function(e, data) { 60 | this.log('data', data) 61 | var $task = data.$task; 62 | this.task = db.collection('tasks').get($task.attr('id')); 63 | this.task.attr('completed', function() { return (this == true ? false : true); }); 64 | this.task.update({}, { 65 | success: function() { 66 | $task.toggleClass('completed'); 67 | } 68 | }); 69 | }); 70 | 71 | this.bind('run', function() { 72 | var context = this; 73 | db = $.cloudkit; 74 | db.boot({ 75 | success: function() { 76 | db_loaded = true; 77 | context.trigger('db-loaded'); 78 | }, 79 | failure: function() { 80 | db_loaded = false; 81 | context.trigger('error', {message: 'Could not connect to CloudKit.'}) 82 | } 83 | }); 84 | 85 | $('li.task :checkbox').live('click', function() { 86 | var $task = $(this).parents('.task'); 87 | context.trigger('task-toggle', {$task: $task}); 88 | }); 89 | }); 90 | 91 | this.bind('db-loaded', function() { 92 | this.redirect('#/') 93 | }); 94 | 95 | this.bind('error', function(e, data) { 96 | $('#error').text(data.message).show(); 97 | }); 98 | 99 | 100 | }); 101 | 102 | $(function() { 103 | app.run('#/'); 104 | }) 105 | })(jQuery); 106 | -------------------------------------------------------------------------------- /vendor/qunit/qunit.css: -------------------------------------------------------------------------------- 1 | 2 | ol#qunit-tests { 3 | font-family:"Helvetica Neue Light", "HelveticaNeue-Light", "Helvetica Neue", Calibri, Helvetica, Arial; 4 | margin:0; 5 | padding:0; 6 | list-style-position:inside; 7 | 8 | font-size: smaller; 9 | } 10 | ol#qunit-tests li{ 11 | padding:0.4em 0.5em 0.4em 2.5em; 12 | border-bottom:1px solid #fff; 13 | font-size:small; 14 | list-style-position:inside; 15 | } 16 | ol#qunit-tests li ol{ 17 | box-shadow: inset 0px 2px 13px #999; 18 | -moz-box-shadow: inset 0px 2px 13px #999; 19 | -webkit-box-shadow: inset 0px 2px 13px #999; 20 | margin-top:0.5em; 21 | margin-left:0; 22 | padding:0.5em; 23 | background-color:#fff; 24 | border-radius:15px; 25 | -moz-border-radius: 15px; 26 | -webkit-border-radius: 15px; 27 | } 28 | ol#qunit-tests li li{ 29 | border-bottom:none; 30 | margin:0.5em; 31 | background-color:#fff; 32 | list-style-position: inside; 33 | padding:0.4em 0.5em 0.4em 0.5em; 34 | } 35 | 36 | ol#qunit-tests li li.pass{ 37 | border-left:26px solid #C6E746; 38 | background-color:#fff; 39 | color:#5E740B; 40 | } 41 | ol#qunit-tests li li.fail{ 42 | border-left:26px solid #EE5757; 43 | background-color:#fff; 44 | color:#710909; 45 | } 46 | ol#qunit-tests li.pass{ 47 | background-color:#D2E0E6; 48 | color:#528CE0; 49 | } 50 | ol#qunit-tests li.fail{ 51 | background-color:#EE5757; 52 | color:#000; 53 | } 54 | ol#qunit-tests li strong { 55 | cursor:pointer; 56 | } 57 | h1#qunit-header{ 58 | background-color:#0d3349; 59 | margin:0; 60 | padding:0.5em 0 0.5em 1em; 61 | color:#fff; 62 | font-family:"Helvetica Neue Light", "HelveticaNeue-Light", "Helvetica Neue", Calibri, Helvetica, Arial; 63 | border-top-right-radius:15px; 64 | border-top-left-radius:15px; 65 | -moz-border-radius-topright:15px; 66 | -moz-border-radius-topleft:15px; 67 | -webkit-border-top-right-radius:15px; 68 | -webkit-border-top-left-radius:15px; 69 | text-shadow: rgba(0, 0, 0, 0.5) 4px 4px 1px; 70 | } 71 | h2#qunit-banner{ 72 | font-family:"Helvetica Neue Light", "HelveticaNeue-Light", "Helvetica Neue", Calibri, Helvetica, Arial; 73 | height:5px; 74 | margin:0; 75 | padding:0; 76 | } 77 | h2#qunit-banner.qunit-pass{ 78 | background-color:#C6E746; 79 | } 80 | h2#qunit-banner.qunit-fail, #qunit-testrunner-toolbar { 81 | background-color:#EE5757; 82 | } 83 | #qunit-testrunner-toolbar { 84 | font-family:"Helvetica Neue Light", "HelveticaNeue-Light", "Helvetica Neue", Calibri, Helvetica, Arial; 85 | padding:0; 86 | /*width:80%;*/ 87 | padding:0em 0 0.5em 2em; 88 | font-size: small; 89 | } 90 | h2#qunit-userAgent { 91 | font-family:"Helvetica Neue Light", "HelveticaNeue-Light", "Helvetica Neue", Calibri, Helvetica, Arial; 92 | background-color:#2b81af; 93 | margin:0; 94 | padding:0; 95 | color:#fff; 96 | font-size: small; 97 | padding:0.5em 0 0.5em 2.5em; 98 | text-shadow: rgba(0, 0, 0, 0.5) 2px 2px 1px; 99 | } 100 | p#qunit-testresult{ 101 | font-family:"Helvetica Neue Light", "HelveticaNeue-Light", "Helvetica Neue", Calibri, Helvetica, Arial; 102 | margin:0; 103 | font-size: small; 104 | color:#2b81af; 105 | border-bottom-right-radius:15px; 106 | border-bottom-left-radius:15px; 107 | -moz-border-radius-bottomright:15px; 108 | -moz-border-radius-bottomleft:15px; 109 | -webkit-border-bottom-right-radius:15px; 110 | -webkit-border-bottom-left-radius:15px; 111 | background-color:#D2E0E6; 112 | padding:0.5em 0.5em 0.5em 2.5em; 113 | } 114 | strong b.fail{ 115 | color:#710909; 116 | } 117 | strong b.pass{ 118 | color:#5E740B; 119 | } 120 | -------------------------------------------------------------------------------- /lib/plugins/sammy.flash.js: -------------------------------------------------------------------------------- 1 | (function (factory) { 2 | if (typeof define === 'function' && define.amd) { 3 | define(['jquery', 'sammy'], factory); 4 | } else { 5 | (window.Sammy = window.Sammy || {}).Flash = factory(window.jQuery, window.Sammy); 6 | } 7 | }(function ($, Sammy) { 8 | 9 | Sammy.FlashHash = function() { 10 | this.now = {}; 11 | }; 12 | 13 | $.extend(Sammy.FlashHash.prototype , { 14 | // @return [String] this Flash, rendered as an- .
15 | toHTML: function() {
16 | var result = this._renderUL();
17 | this.clear();
18 | return result;
19 | },
20 |
21 | clear: function() {
22 | this._clearHash(this);
23 | this._clearHash(this.now);
24 | },
25 |
26 | // Callback on redirect.
27 | // @api private
28 | _onRedirect: function() {
29 | this._clearHash(this.now);
30 | },
31 |
32 | // clear out all flash keys
33 | // @api private
34 | _clearHash: function(hash) {
35 | var key;
36 | for (key in hash) {
37 | if (key !== 'now' && hash.hasOwnProperty(key)) {
38 | delete hash[key];
39 | }
40 | }
41 | },
42 |
43 | _renderUL: function() {
44 | return '
- ' + hash[key] + ' '; 56 | } 57 | } 58 | Sammy.log('rendered flash: ' + result); 59 | return result; 60 | } 61 | }); 62 | 63 | // Sammy.Flash is a plugin for storing and sending status messages to the client. It's API and use 64 | // is similar to Ruby on Rails' `flash` explained here: 65 | // [http://apidock.com/rails/ActionController/Flash](http://apidock.com/rails/ActionController/Flash) 66 | Sammy.Flash = function(app) { 67 | app.flash = new Sammy.FlashHash(); 68 | 69 | // *Helper* flash(key, value) get or set a flash message that will 70 | // be erased on the next render (but not on redirect). 71 | // 72 | // @param [String] key, the Flash key 73 | // @param [String] value, the new value; optional 74 | // @return [Sammy.FlashHash, String, null] if a key was given, the value for that key; else, the Flash 75 | app.helper('flash', function(key, value) { 76 | if (arguments.length === 0) { 77 | return this.app.flash; 78 | } else if (arguments.length === 2) { 79 | this.app.flash[key] = value; 80 | } 81 | return this.app.flash[key]; 82 | }); 83 | 84 | // *Helper* flashNow(key, value) get or set a flash message that 85 | // will be erased on the next render or redirect. 86 | // 87 | // @param [String] key, the Flash key 88 | // @param [String] value, the new value; optional 89 | // @return [String, null] the value for the given key 90 | app.helper('flashNow', function(key, value) { 91 | if (arguments.length === 0) { 92 | return this.app.flash.now; 93 | }else if (arguments.length === 2) { 94 | this.app.flash.now[key] = value; 95 | } 96 | return this.app.flash.now[key]; 97 | }); 98 | 99 | app.bind('redirect', function() { 100 | this.app.flash._onRedirect(); 101 | }); 102 | }; 103 | 104 | return Sammy.Flash; 105 | 106 | })); 107 | -------------------------------------------------------------------------------- /lib/plugins/sammy.googleanalytics.js: -------------------------------------------------------------------------------- 1 | (function (factory) { 2 | if (typeof define === 'function' && define.amd) { 3 | define(['jquery', 'sammy'], factory); 4 | } else { 5 | (window.Sammy = window.Sammy || {}).GoogleAnalytics = factory(window.jQuery, window.Sammy); 6 | } 7 | }(function ($, Sammy) { 8 | 9 | // A simple plugin that pings Google Analytics tracker 10 | // every time a route is triggered. Originally by Brit Gardner (britg), 11 | // with updates from Aaron Quint (quirkey). 12 | // 13 | // ### Arguments 14 | // 15 | // +tracker+:: the Google Analytics pageTracker object. Defaults to 16 | // the default object defined by the GA snippet, or pass your own if you 17 | // have a custom install. If using analytics.js pass a string with the 18 | // name of your tracker. 19 | // 20 | // ### Example 21 | // 22 | // Install Google Analytics to your site as you normally would. 23 | // 24 | // If using ga.js be sure that the 'pageTracker' global variable exists. 25 | // If using analytics.js there is nothing to do (but you probably want 26 | // to remove the ga('send','pageview') line) 27 | // 28 | // Then, simply add the plugin to your Sammy App and it will automatically 29 | // track all of your routes in Google Analytics. 30 | // They will appear as page views to the route's path. 31 | // 32 | // $.sammy(function() { 33 | // this.use('GoogleAnalytics'); 34 | // 35 | // ... 36 | // }); 37 | // 38 | // If you have routes that you do not want to track, simply call `noTrack` 39 | // within the route. 40 | // 41 | // $.sammy(function() { 42 | // this.use('GoogleAnalytics') 43 | // 44 | // this.get('#/dont/track/me', function() { 45 | // this.noTrack(); // This route will not be tracked 46 | // }); 47 | // }); 48 | // 49 | Sammy.GoogleAnalytics = function(app, tracker) { 50 | var _tracker = tracker || window.pageTracker, 51 | trackerName = 'send', 52 | shouldTrack = true; 53 | 54 | if (typeof tracker == 'string' || tracker instanceof String){ 55 | trackerName = tracker + '.send'; 56 | } 57 | 58 | function disableTracking() { 59 | shouldTrack = false; 60 | } 61 | 62 | function enableTracking() { 63 | shouldTrack = true; 64 | } 65 | 66 | function trackPageview(path) { 67 | if (typeof ga == 'function') { 68 | ga(trackerName, 'pageview', { 'page': path }); 69 | } else if (typeof _gaq != 'undefined') { 70 | _gaq.push(['_trackPageview', path]); 71 | } else if (typeof _tracker != 'undefined') { 72 | _tracker._trackPageview(path); 73 | } 74 | } 75 | 76 | this.helpers({ 77 | // Disable tracking for the current route. Put at the begining of the 78 | // route's callback 79 | noTrack: function() { 80 | disableTracking(); 81 | }, 82 | // send a page view to the tracker with `path` 83 | track: function(path) { 84 | if((typeof _tracker != 'undefined' || typeof _gaq != 'undefined' || typeof ga == 'function') && shouldTrack) { 85 | this.log('tracking google analytics', path); 86 | trackPageview(path); 87 | } 88 | } 89 | }); 90 | 91 | this.bind('event-context-after', function() { 92 | var path = this.app.last_location[1]; 93 | if (path) { 94 | this.track(path); 95 | enableTracking(); 96 | } 97 | }); 98 | }; 99 | 100 | return Sammy.GoogleAnalytics; 101 | 102 | })); 103 | -------------------------------------------------------------------------------- /lib/min/plugins/sammy.json-0.7.6.min.js: -------------------------------------------------------------------------------- 1 | // -- Sammy.js -- /plugins/sammy.json.js 2 | // http://sammyjs.org 3 | // Version: 0.7.6 4 | // Built: 2014-08-26 10:45:32 +0300 5 | (function(factory){if(typeof define==="function"&&define.amd){define(["jquery","sammy"],factory)}else{(window.Sammy=window.Sammy||{}).JSON=factory(window.jQuery,window.Sammy)}})(function($,Sammy){if(!window.JSON){window.JSON={}}(function(){function f(n){return n<10?"0"+n:n}if(typeof Date.prototype.toJSON!=="function"){Date.prototype.toJSON=function(key){return this.getUTCFullYear()+"-"+f(this.getUTCMonth()+1)+"-"+f(this.getUTCDate())+"T"+f(this.getUTCHours())+":"+f(this.getUTCMinutes())+":"+f(this.getUTCSeconds())+"Z"};String.prototype.toJSON=Number.prototype.toJSON=Boolean.prototype.toJSON=function(key){return this.valueOf()}}var cx=/[\u0000\u00ad\u0600-\u0604\u070f\u17b4\u17b5\u200c-\u200f\u2028-\u202f\u2060-\u206f\ufeff\ufff0-\uffff]/g,escapable=/[\\\"\x00-\x1f\x7f-\x9f\u00ad\u0600-\u0604\u070f\u17b4\u17b5\u200c-\u200f\u2028-\u202f\u2060-\u206f\ufeff\ufff0-\uffff]/g,gap,indent,meta={"\b":"\\b"," ":"\\t","\n":"\\n","\f":"\\f","\r":"\\r",'"':'\\"',"\\":"\\\\"},rep;function quote(string){escapable.lastIndex=0;return escapable.test(string)?'"'+string.replace(escapable,function(a){var c=meta[a];return typeof c==="string"?c:"\\u"+("0000"+a.charCodeAt(0).toString(16)).slice(-4)})+'"':'"'+string+'"'}function str(key,holder){var i,k,v,length,mind=gap,partial,value=holder[key];if(value&&typeof value==="object"&&typeof value.toJSON==="function"){value=value.toJSON(key)}if(typeof rep==="function"){value=rep.call(holder,key,value)}switch(typeof value){case"string":return quote(value);case"number":return isFinite(value)?String(value):"null";case"boolean":case"null":return String(value);case"object":if(!value){return"null"}gap+=indent;partial=[];if(Object.prototype.toString.apply(value)==="[object Array]"){length=value.length;for(i=0;i
- ' +
45 | this._renderLIs(this) +
46 | this._renderLIs(this.now) +
47 | '
61 | // 
64 | // <% } %>
65 | //
66 | //
67 | // Given that is a publicly accesible file, you would render it like:
68 | //
69 | // $.sammy(function() {
70 | // // include the plugin
71 | // this.use(Sammy.Template);
72 | //
73 | // this.get('#/', function() {
74 | // // the template is rendered in the current context.
75 | // this.user = {name: 'Aaron Quint'};
76 | // // partial calls template() because of the file extension
77 | // this.partial('user.template');
78 | // })
79 | // });
80 | //
81 | // You can also pass a second argument to use() that will alias the template
82 | // method and therefore allow you to use a different extension for template files
83 | // in partial()
84 | //
85 | // // alias to 'tpl'
86 | // this.use(Sammy.Template, 'tpl');
87 | //
88 | // // now .tpl files will be run through srender
89 | // this.get('#/', function() {
90 | // this.partial('myfile.tpl');
91 | // });
92 | //
93 | Sammy.Template = function(app, method_alias) {
94 |
95 | // *Helper:* Uses simple templating to parse ERB like templates.
96 | //
97 | // === Arguments
98 | //
99 | // +template+:: A String template. '<% %>' tags are evaluated as Javascript and replaced with the elements in data.
100 | // +data+:: An Object containing the replacement values for the template.
101 | // data is extended with the EventContext allowing you to call its methods within the template.
102 | // +name+:: An optional String name to cache the template.
103 | //
104 | var template = function(template, data, name) {
105 | // use name for caching
106 | if (typeof name == 'undefined') name = template;
107 | return srender(name, template, $.extend({}, this, data));
108 | };
109 |
110 | // set the default method name/extension
111 | if (!method_alias) method_alias = 'template';
112 | // create the helper at the method alias
113 | app.helper(method_alias, template);
114 |
115 | };
116 |
117 | })(jQuery);
118 |
--------------------------------------------------------------------------------
/vendor/qunit-spec.js:
--------------------------------------------------------------------------------
1 | (function() {
2 |
3 | QUnit.Spec = function(name) {
4 | this.before = false;
5 | this.after = false;
6 | QUnit.module(name);
7 | };
8 |
9 | function extend(a, b) {
10 | for ( var prop in b ) {
11 | a[prop] = b[prop];
12 | }
13 | return a;
14 | }
15 |
16 | // RSpec style describe
17 | // takes an arbitrary number of arguments that are contactenated as strings
18 | // the last argument is the configuration object
19 | // which can have before: after: callbacks
20 | function describe() {
21 | var args = Array.prototype.slice.call(arguments),
22 | // configuration function
23 | config = (args.length > 0 && args[args.length - 1]['before']) ? args.pop() : {},
24 | spec = new QUnit.Spec(args.join(' '));
25 | spec['before'] = config['before'] || config['setup'];
26 | spec['after'] = config['after'] || config['teardown'];
27 | return spec;
28 | }
29 |
30 | extend(QUnit.Spec.prototype, {
31 |
32 | // RSpec style test definition
33 | it: function(name, callback, nowait) {
34 | var spec = this;
35 | var spec_context = {};
36 | QUnit.test(name, function() {
37 | if (spec.before) spec.before.apply(spec_context);
38 | callback.apply(spec_context, [this, spec]);
39 | if (spec.after) spec.after.apply(spec_context);
40 | });
41 | return spec;
42 | },
43 |
44 | // Shoulda style test definition
45 | should: function(name, callback, nowait) {
46 | name = 'should ' + name;
47 | return this.it.apply(this, [name, callback, nowait]);
48 | },
49 |
50 | pending: function(name, callback, nowait) {
51 | name = 'DEFERRED: ' + name + '';
52 | return this.it.apply(this, [name, function () { QUnit.ok(true) }, nowait]);
53 | },
54 |
55 | should_eventually: function(name, callback, nowait) {
56 | return this.pending(name, callback, nowait);
57 | }
58 |
59 | });
60 |
61 |
62 | extend(QUnit, {
63 | // aliases for describe
64 | describe: describe,
65 | context: describe,
66 |
67 | // asserts that the method is defined (like respond_to?)
68 | defined: function(object, method) {
69 | return QUnit.ok(QUnit.is('Function', object[method]), method + ' is not defined on ' + object);
70 | },
71 |
72 | // asserts that the object is of a certain type
73 | isType: function(object, type) {
74 | return ok(QUnit.is(type, object), "expected " + object + " to be a " + type);
75 | },
76 |
77 | // assert a string matches a regex
78 | matches: function(matcher, string, message) {
79 | return QUnit.ok(!!matcher.test(string), message || "expected: " + string + "match(" + matcher.toString() + ")");
80 | },
81 |
82 | // assert that a matching error is raised
83 | // expected can be a regex, a string, or an object
84 | raised: function(expected_error, callback) {
85 | var error = null;
86 | try {
87 | callback.apply(this);
88 | } catch(e) {
89 | error = e;
90 | }
91 | error_message = error && error.message ? error.message.toString() : error.toString();
92 | message = "expected error: " + expected_error.toString() + ", actual error:" + error_message;
93 | if (expected_error.constructor == RegExp) {
94 | return QUnit.matches(expected_error, error_message, message);
95 | } else if (expected_error.constructor == String) {
96 | return QUnit.equal(expected_error, error_message, message);
97 | } else {
98 | return QUnit.deepEqual(expected_error, error, message);
99 | }
100 | },
101 |
102 | notRaised: function(callback) {
103 | var error = '';
104 | try {
105 | callback.apply(this);
106 | } catch(e) {
107 | error = e;
108 | }
109 | message = "expected: no errors, actual error: " + error.toString();
110 | QUnit.equal('', error, message);
111 | },
112 |
113 | soon: function(callback, context, secs, many_expects) {
114 | if (typeof context == 'undefined') context = this;
115 | if (typeof secs == 'undefined') secs = 1;
116 | if (typeof many_expects == 'undefined') many_expects = 1;
117 | QUnit.expect(many_expects);
118 | QUnit.stop();
119 | setTimeout(function() {
120 | callback.apply(context);
121 | QUnit.start();
122 | }, secs * 500);
123 | },
124 |
125 | flunk: function() {
126 | QUnit.ok(false, 'FLUNK');
127 | },
128 |
129 | sameHTML: function(actual, expected) {
130 | var strippedHTML = function(element) {
131 | return $(element)
132 | .wrap('')
133 | .parent()
134 | .html()
135 | .toString()
136 | .replace(/(>)(\s+)(<)/g, "><");
137 | };
138 |
139 | actual = strippedHTML(actual);
140 | expected = strippedHTML(expected);
141 | equal(actual, expected, "HTML is equal");
142 | }
143 |
144 | });
145 |
146 |
147 | })();
148 |
--------------------------------------------------------------------------------
/lib/plugins/sammy.mustache.js:
--------------------------------------------------------------------------------
1 | (function (factory) {
2 | if (typeof define === 'function' && define.amd) {
3 | define(['jquery', 'sammy', 'mustache'], factory);
4 | } else {
5 | (window.Sammy = window.Sammy || {}).Mustache = factory(window.jQuery, window.Sammy, window.Mustache);
6 | }
7 | }(function ($, Sammy, Mustache) {
8 |
9 | // Sammy.Mustache provides a quick way of using mustache style templates in your app.
10 | // The plugin wraps the awesome mustache.js lib created and maintained by Jan Lehnardt
11 | // at http://github.com/janl/mustache.js
12 | //
13 | // Note: As of Sammy 0.7 the Mustache lib is not included in the templates source. Please download
14 | // mustache.js and include it before Sammy.Mustache.
15 | //
16 | // Mustache is a clever templating system that relys on double brackets {{}} for interpolation.
17 | // For full details on syntax check out the original Ruby implementation created by Chris Wanstrath at
18 | // http://github.com/defunkt/mustache
19 | //
20 | // By default using Sammy.Mustache in your app adds the mustache() method to the EventContext
21 | // prototype. However, just like Sammy.Template you can change the default name of the method
22 | // by passing a second argument (e.g. you could use the ms() as the method alias so that all the template
23 | // files could be in the form file.ms instead of file.mustache)
24 | //
25 | // ### Example #1
26 | //
27 | // The template (mytemplate.ms):
28 | //
29 | // <%= user.name %>
62 | // <% if (user.photo_url) { %>
63 | // {{title}}
30 | //
31 | // Hey, {{name}}! Welcome to Mustache!
32 | //
33 | // The app:
34 | //
35 | // var app = $.sammy(function() {
36 | // // include the plugin and alias mustache() to ms()
37 | // this.use('Mustache', 'ms');
38 | //
39 | // this.get('#/hello/:name', function() {
40 | // // set local vars
41 | // this.title = 'Hello!'
42 | // this.name = this.params.name;
43 | // // render the template and pass it through mustache
44 | // this.partial('mytemplate.ms');
45 | // });
46 | // });
47 | //
48 | // $(function() {
49 | // app.run()
50 | // });
51 | //
52 | // If I go to #/hello/AQ in the browser, Sammy will render this to the body:
53 | //
54 | // Hello!
55 | //
56 | // Hey, AQ! Welcome to Mustache!
57 | //
58 | //
59 | // ### Example #2 - Mustache partials
60 | //
61 | // The template (mytemplate.ms)
62 | //
63 | // Hey, {{name}}! {{>hello_friend}}
64 | //
65 | //
66 | // The partial (mypartial.ms)
67 | //
68 | // Say hello to your friend {{friend}}!
69 | //
70 | // The app:
71 | //
72 | // var app = $.sammy(function() {
73 | // // include the plugin and alias mustache() to ms()
74 | // this.use('Mustache', 'ms');
75 | //
76 | // this.get('#/hello/:name/to/:friend', function(context) {
77 | // // fetch mustache-partial first
78 | // this.load('mypartial.ms')
79 | // .then(function(partial) {
80 | // // set local vars
81 | // context.partials = {hello_friend: partial};
82 | // context.name = context.params.name;
83 | // context.friend = context.params.friend;
84 | //
85 | // // render the template and pass it through mustache
86 | // context.partial('mytemplate.ms');
87 | // });
88 | // });
89 | // });
90 | //
91 | // $(function() {
92 | // app.run()
93 | // });
94 | //
95 | // If I go to #/hello/AQ/to/dP in the browser, Sammy will render this to the body:
96 | //
97 | // Hey, AQ! Say hello to your friend dP!
98 | //
99 | // Note: You need to include the mustache.js file before this plugin.
100 | //
101 | Sammy.Mustache = function(app, method_alias) {
102 |
103 | // *Helper* Uses Mustache.js to parse a template and interpolate and work with the passed data
104 | //
105 | // ### Arguments
106 | //
107 | // * `template` A String template. {{}} Tags are evaluated and interpolated by Mustache.js
108 | // * `data` An Object containing the replacement values for the template.
109 | // data is extended with the EventContext allowing you to call its methods within the template.
110 | // * `partials` An Object containing one or more partials (String templates
111 | // that are called from the main template).
112 | //
113 | var mustache = function(template, data, partials) {
114 | data = $.extend({}, this, data);
115 | partials = $.extend({}, data.partials, partials);
116 | return Mustache.to_html(template, data, partials);
117 | };
118 |
119 | // set the default method name/extension
120 | if (!method_alias) { method_alias = 'mustache'; }
121 | app.helper(method_alias, mustache);
122 | };
123 |
124 | return Sammy.Mustache;
125 |
126 | }));
127 |
--------------------------------------------------------------------------------
/lib/plugins/sammy.hogan.js:
--------------------------------------------------------------------------------
1 | (function (factory) {
2 | if (typeof define === 'function' && define.amd) {
3 | define(['jquery', 'sammy', 'hogan'], factory);
4 | } else {
5 | (window.Sammy = window.Sammy || {}).Hogan = factory(window.jQuery, window.Sammy, window.Hogan);
6 | }
7 | }(function ($, Sammy) {
8 |
9 | // Sammy.Hogan provides a quick way of using hogan.js style templates in your app.
10 | // The plugin wraps the awesome hogan.js lib created and maintained by Twitter
11 | // at http://twitter.github.com/hogan.js/
12 | //
13 | // Note: As of Sammy 0.7 the Hogan.js lib is not included in the templates source. Please download
14 | // hogan.js and include it before Sammy.Hogan.
15 | //
16 | // Hogan.js is a clever templating system that relys on double brackets {{}} for interpolation.
17 | // For full details on syntax check out the documentation at
18 | // http://twitter.github.com/hogan.js/
19 | //
20 | // By default using Sammy.Hogan in your app adds the hogan() method to the EventContext
21 | // prototype. However, just like Sammy.Hogan you can change the default name of the method
22 | // by passing a second argument (e.g. you could use the hg() as the method alias so that all the template
23 | // files could be in the form file.hg instead of file.hogan)
24 | //
25 | // ### Example #1
26 | //
27 | // The template (mytemplate.hg):
28 | //
29 | // {{title}}
30 | //
31 | // Hey, {{name}}! Welcome to Mustache!
32 | //
33 | // The app:
34 | //
35 | // var app = $.sammy(function() {
36 | // // include the plugin and alias hogan() to hg()
37 | // this.use('Hogan', 'hg');
38 | //
39 | // this.get('#/hello/:name', function() {
40 | // // set local vars
41 | // this.title = 'Hello!'
42 | // this.name = this.params.name;
43 | // // render the template and pass it through hogan
44 | // this.partial('mytemplate.hg');
45 | // });
46 | // });
47 | //
48 | // $(function() {
49 | // app.run()
50 | // });
51 | //
52 | // If I go to #/hello/AQ in the browser, Sammy will render this to the body:
53 | //
54 | // Hello!
55 | //
56 | // Hey, AQ! Welcome to Mustache!
57 | //
58 | //
59 | // ### Example #2 - Hogan partials
60 | //
61 | // The template (mytemplate.hg)
62 | //
63 | // Hey, {{name}}! {{>hello_friend}}
64 | //
65 | //
66 | // The partial (mypartial.hg)
67 | //
68 | // Say hello to your friend {{friend}}!
69 | //
70 | // The app:
71 | //
72 | // var app = $.sammy(function() {
73 | // // include the plugin and alias hogan() to hg()
74 | // this.use('Hogan', 'hg');
75 | //
76 | // this.get('#/hello/:name/to/:friend', function(context) {
77 | // // fetch hogan-partial first
78 | // this.load('mypartial.hg')
79 | // .then(function(partial) {
80 | // // set local vars
81 | // context.partials = {hello_friend: partial};
82 | // context.name = context.params.name;
83 | // context.friend = context.params.friend;
84 | //
85 | // // render the template and pass it through hogan
86 | // context.partial('mytemplate.hg');
87 | // });
88 | // });
89 | // });
90 | //
91 | // $(function() {
92 | // app.run()
93 | // });
94 | //
95 | // If I go to #/hello/AQ/to/dP in the browser, Sammy will render this to the body:
96 | //
97 | // Hey, AQ! Say hello to your friend dP!
98 | //
99 | // Note: You dont have to include the hogan.js file on top of the plugin as the plugin
100 | // includes the full source.
101 | //
102 | Sammy.Hogan = function(app, method_alias) {
103 | var cached_templates = {};
104 |
105 | // *Helper* Uses Hogan.js to parse a template and interpolate and work with the passed data
106 | //
107 | // ### Arguments
108 | //
109 | // * `template` A String template. {{}} Tags are evaluated and interpolated by Hogan.js
110 | // * `data` An Object containing the replacement values for the template.
111 | // data is extended with the EventContext allowing you to call its methods within the template.
112 | // * `partials` An Object containing one or more partials (String templates
113 | // that are called from the main template).
114 | //
115 | var hogan = function(template, data, partials) {
116 | var compiled_template = cached_templates[compiled_template];
117 | if (!compiled_template){
118 | compiled_template = Hogan.compile(template);
119 | }
120 | data = $.extend({}, this, data);
121 | partials = $.extend({}, data.partials, partials);
122 | return compiled_template.render(data, partials);
123 | };
124 |
125 | // set the default method name/extension
126 | if (!method_alias) { method_alias = 'hogan'; }
127 | app.helper(method_alias, hogan);
128 | };
129 |
130 | return Sammy.Hogan;
131 |
132 | }));
133 |
--------------------------------------------------------------------------------
/lib/plugins/sammy.meld.js:
--------------------------------------------------------------------------------
1 | (function (factory) {
2 | if (typeof define === 'function' && define.amd) {
3 | define(['jquery', 'sammy'], factory);
4 | } else {
5 | (window.Sammy = window.Sammy || {}).Meld = factory(window.jQuery, window.Sammy);
6 | }
7 | }(function ($, Sammy) {
8 |
9 | // `Sammy.Meld` is a simple templating engine that uses the power of jQuery's
10 | // DOM manipulation to easily meld JSON data and HTML templates very quickly.
11 | //
12 | // The template can either be a string (i.e. loaded from a remote template)
13 | // or a DOM Element/jQuery object. This allows you to have templates be DOM
14 | // elements as the initial document load.
15 | //
16 | // ### Example
17 | //
18 | // The simplest case is a nested `` whose class name is tied to a
19 | // property of a JS object.
20 | //
21 | // Template:
22 | //
23 | //
24 | //
25 | //
26 | //
29 | //
30 | //
31 | // Data:
32 | //
33 | // {
34 | // "post": {
35 | // "title": "My Post",
36 | // "entry": "My Entry",
37 | // "author": {
38 | // "name": "@aq"
39 | // }
40 | // }
41 | // }
42 | //
43 | // Result:
44 | //
45 | //
46 | // My Post
47 | // My Entry
48 | //
51 | //
52 | //
53 | // Templates can be much more complex, and more deeply nested.
54 | // More examples can be found in `test/fixtures/meld/`
55 | //
56 | // If you don't think the lookup by classes is semantic for you, you can easily
57 | // switch the method of lookup by defining a selector function in the options
58 | //
59 | // For example:
60 | //
61 | // meld($('.post'), post_data, {
62 | // selector: function(k) {
63 | // return '[data-key=' + k + ']';
64 | // }
65 | // });
66 | //
67 | // Would look for template nodes like ``
68 | //
69 | Sammy.Meld = function(app, method_alias) {
70 | var default_options = {
71 | selector: function(k) { return '.' + k; },
72 | remove_false: true
73 | };
74 |
75 | var meld = function(template, data, options) {
76 | var $template = $(template);
77 |
78 | options = $.extend(default_options, options || {});
79 |
80 | if (typeof data === 'string') {
81 | $template.html(data);
82 | } else {
83 | $.each(data, function(key, value) {
84 | var selector = options.selector(key),
85 | $sub = $template.filter(selector),
86 | $container,
87 | $item,
88 | is_list = false,
89 | subindex = $template.index($sub);
90 |
91 | if ($sub.length === 0) { $sub = $template.find(selector); }
92 | if ($sub.length > 0) {
93 | if ($.isArray(value)) {
94 | $container = $('');
95 | if ($sub.is('ol, ul')) {
96 | is_list = true;
97 | $item = $sub.children('li:first');
98 | if ($item.length == 0) { $item = $(''); }
99 | } else if ($sub.children().length == 1) {
100 | is_list = true;
101 | $item = $sub.children(':first').clone();
102 | } else {
103 | $item = $sub.clone();
104 | }
105 | for (var i = 0; i < value.length; i++) {
106 | $container.append(meld($item.clone(), value[i], options));
107 | }
108 | if (is_list) {
109 | $sub.html($container.html());
110 | } else if ($sub[0] == $template[0]) {
111 | $template = $($container.html());
112 | } else if (subindex >= 0) {
113 | var args = [subindex, 1];
114 | args = args.concat($container.children().get());
115 | $template.splice.apply($template, args);
116 | }
117 | } else if (options.remove_false && value === false) {
118 | $template.splice(subindex, 1);
119 | } else if (typeof value === 'object') {
120 | if ($sub.is(':empty')) {
121 | $sub.attr(value, true);
122 | } else {
123 | $sub.html(meld($sub.html(), value, options));
124 | }
125 | } else {
126 | $sub.html(value.toString());
127 | }
128 | } else {
129 | $template.attr(key, value, true);
130 | }
131 | });
132 | }
133 | var dom = $template;
134 | return dom;
135 | };
136 |
137 | // set the default method name/extension
138 | if (!method_alias) method_alias = 'meld';
139 | // create the helper at the method alias
140 | app.helper(method_alias, meld);
141 |
142 | };
143 |
144 | return Sammy.Meld;
145 |
146 | }));
147 |
--------------------------------------------------------------------------------
/lib/plugins/sammy.handlebars.js:
--------------------------------------------------------------------------------
1 | (function (factory) {
2 | if (typeof define === 'function' && define.amd) {
3 | define(['jquery', 'sammy', 'handlebars'], factory);
4 | } else {
5 | (window.Sammy = window.Sammy || {}).Handlebars = factory(window.jQuery, window.Sammy);
6 | }
7 | }(function ($, Sammy, Handlebars) {
8 | // version 1.0.0 has no support for AMD but upwards does, this way we support both.
9 | Handlebars = Handlebars || window.Handlebars;
10 |
11 | // Sammy.Handlebars provides a quick way of using Handlebars templates in your app.
12 | //
13 | // Note: As of Sammy 0.7 Handlebars itself is not included in the source. Please download and
14 | // include handlebars.js before Sammy.Handlebars.
15 | //
16 | // Handlebars.js is an extension to the Mustache templating language created by Chris Wanstrath. Handlebars.js
17 | // and Mustache are both logicless templating languages that keep the view and the code separated like
18 | // we all know they should be.
19 | //
20 | // By default using Sammy.Handlbars in your app adds the handlebars() method to the EventContext
21 | // prototype. However, just like Sammy.Template you can change the default name of the method
22 | // by passing a second argument (e.g. you could use the hbr() as the method alias so that all the template
23 | // files could be in the form file.hbr instead of file.handlebars)
24 | //
25 | // ### Example #1
26 | //
27 | // The template (mytemplate.hb):
28 | //
29 | // {{title}}
30 | //
31 | // Hey, {{name}}! Welcome to Handlebars!
32 | //
33 | // The app:
34 | //
35 | // var app = $.sammy(function() {
36 | // // include the plugin and alias handlebars() to hb()
37 | // this.use('Handlebars', 'hb');
38 | //
39 | // this.get('#/hello/:name', function() {
40 | // // set local vars
41 | // this.title = 'Hello!'
42 | // this.name = this.params.name;
43 | // // render the template and pass it through handlebars
44 | // this.partial('mytemplate.hb');
45 | // });
46 | // });
47 | //
48 | // $(function() {
49 | // app.run()
50 | // });
51 | //
52 | // If I go to #/hello/AQ in the browser, Sammy will render this to the body:
53 | //
54 | // Hello!
55 | //
56 | // Hey, AQ! Welcome to Handlebars!
57 | //
58 | //
59 | // ### Example #2 - Handlebars partials
60 | //
61 | // The template (mytemplate.hb)
62 | //
63 | // Hey, {{name}}! {{>hello_friend}}
64 | //
65 | //
66 | // The partial (mypartial.hb)
67 | //
68 | // Say hello to your friend {{friend}}!
69 | //
70 | // The app:
71 | //
72 | // var app = $.sammy(function() {
73 | // // include the plugin and alias handlebars() to hb()
74 | // this.use('Handlebars', 'hb');
75 | //
76 | // this.get('#/hello/:name/to/:friend', function(context) {
77 | // // fetch handlebars-partial first
78 | // this.load('mypartial.hb')
79 | // .then(function(partial) {
80 | // // set local vars
81 | // context.partials = {hello_friend: partial};
82 | // context.name = context.params.name;
83 | // context.friend = context.params.friend;
84 | //
85 | // // render the template and pass it through handlebars
86 | // context.partial('mytemplate.hb');
87 | // });
88 | // });
89 | // });
90 | //
91 | // $(function() {
92 | // app.run()
93 | // });
94 | //
95 | // If I go to #/hello/AQ/to/dP in the browser, Sammy will render this to the body:
96 | //
97 | // Hey, AQ! Say hello to your friend dP!
98 | //
99 | // Note: You dont have to include the handlebars.js file on top of the plugin as the plugin
100 | // includes the full source.
101 | //
102 | Sammy.Handlebars = function(app, method_alias) {
103 | var handlebars_cache = {};
104 | // *Helper* Uses handlebars.js to parse a template and interpolate and work with the passed data
105 | //
106 | // ### Arguments
107 | //
108 | // * `template` A String template.
109 | // * `data` An Object containing the replacement values for the template.
110 | // data is extended with the EventContext allowing you to call its methods within the template.
111 | //
112 | var handlebars = function(template, data, partials, name) {
113 | // use name for caching
114 | if (typeof name == 'undefined') { name = template; }
115 | var fn = handlebars_cache[name];
116 | if (!fn) {
117 | fn = handlebars_cache[name] = Handlebars.compile(template);
118 | }
119 |
120 | data = $.extend({}, this, data);
121 | partials = $.extend({}, data.partials, partials);
122 |
123 | return fn(data, {"partials":partials});
124 | };
125 |
126 | // set the default method name/extension
127 | if (!method_alias) { method_alias = 'handlebars'; }
128 | app.helper(method_alias, handlebars);
129 | };
130 |
131 | return Sammy.Handlebars;
132 |
133 | }));
134 |
--------------------------------------------------------------------------------
/test/meld_spec.js:
--------------------------------------------------------------------------------
1 | describe('Meld', function() {
2 | var context;
3 |
4 | beforeEach(function() {
5 | var app = new Sammy.Application(function() {
6 | this.raise_errors = false;
7 | this.element_selector = '#main';
8 | this.use(Sammy.Meld);
9 | this.get('#/', function() {});
10 | });
11 |
12 | context = new app.context_prototype(app, 'get', '#/test/:test', {test: 'hooray'});
13 | });
14 |
15 | it('does simple interpolation', function() {
16 | var template = "";
17 | data = {'title': 'TEST'},
18 | expected = "TEST";
19 |
20 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
21 | });
22 |
23 | it('interpolates one level deep', function() {
24 | var template = "";
25 | data = {'post': {'title': 'TEST'}},
26 | expected = "TEST";
27 |
28 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
29 | });
30 |
31 | it('interpolates multiple keys', function() {
32 | var template = "";
33 | data = {'post': 'my post', 'title': 'TEST'},
34 | expected = "my postTEST";
35 |
36 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
37 | });
38 |
39 | it('interpolates multiple nested keys', function() {
40 | var template = "";
41 | data = {'post': {'title': 'TEST', 'author': 'AQ'}},
42 | expected = "TEST";
43 |
44 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
45 | });
46 |
47 | it('multiplies an array of tags', function() {
48 | var template = "";
49 | data = {'post': {'tags': ['one', 'two']}},
50 | expected = "";
51 |
52 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
53 | });
54 |
55 | it('multiplies an array of objects', function() {
56 | var template = "";
57 | data = {'post': {'authors': [{'name': 'AQ', 'twitter': 'aq'}, {'name':'Mike', 'twitter':'mrb_bk'}]}},
58 | expected = "";
59 |
60 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
61 | });
62 |
63 | it('multiplies an array on a list item', function() {
64 | var template = "";
65 | data = {'post': {'tags': ['one', 'two']}},
66 | expected = "";
67 |
68 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
69 | });
70 |
71 | it('multiplies an array on a list item using the example list item', function() {
72 | var template = "";
73 | data = {'post': {'tags': ['one', 'two']}},
74 | expected = "";
75 |
76 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
77 | });
78 |
79 | it('replaces attributes of elements as a fallback to class lookup', function() {
80 | var template = "",
81 | data = {'post': {'name': {'href': 'http://www.google.com', 'text': 'Link'}}},
82 | expected = "";
83 |
84 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
85 | });
86 |
87 | it('removes nodes if value is false', function() {
88 | var template = "Active",
89 | data = {'post': {'name': "My Name", 'active': false}},
90 | expected = "My Name
";
91 |
92 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
93 | });
94 |
95 | it('allows the setting of a selector function', function() {
96 | var template = "",
97 | data = {'post': {'name': "My Name"}},
98 | expected = "My Name
";
99 |
100 | expect(context.meld(template, data, {selector: function(k) {
101 | return "[rel='"+ k + "']";
102 | }})).to.have.sameHTMLAs(expected);
103 | });
104 |
105 | it('renders templates correctly', function(done) {
106 | var templates = 3;
107 |
108 | var getAndAssertTemplate = function(i) {
109 | var template, json, result;
110 | $.get('fixtures/meld/' + i + '.meld', function(t) {
111 | template = t;
112 | $.getJSON('fixtures/meld/' + i + '.json', function(j) {
113 | json = j;
114 | $.get('fixtures/meld/' + i + '.html', function(r) {
115 | expect(context.meld(template, json)).to.have.sameHTMLAs(r);
116 | if (i == templates) {
117 | done();
118 | } else {
119 | getAndAssertTemplate(i + 1);
120 | }
121 | });
122 | });
123 | });
124 | }
125 |
126 | getAndAssertTemplate(1);
127 | });
128 | });
129 |
--------------------------------------------------------------------------------
/lib/plugins/sammy.template.js:
--------------------------------------------------------------------------------
1 | (function (factory) {
2 | if (typeof define === 'function' && define.amd) {
3 | define(['jquery', 'sammy'], factory);
4 | } else {
5 | (window.Sammy = window.Sammy || {}).Template = factory(window.jQuery, window.Sammy);
6 | }
7 | }(function ($, Sammy) {
8 |
9 | // Simple JavaScript Templating
10 | // John Resig - http://ejohn.org/ - MIT Licensed
11 | // adapted from: http://ejohn.org/blog/javascript-micro-templating/
12 | // originally $.srender by Greg Borenstein http://ideasfordozens.com in Feb 2009
13 | // modified for Sammy by Aaron Quint for caching templates by name
14 | var srender_cache = {};
15 | var srender = function(name, template, data, options) {
16 | var fn, escaped_string;
17 | // target is an optional element; if provided, the result will be inserted into it
18 | // otherwise the result will simply be returned to the caller
19 | if (srender_cache[name]) {
20 | fn = srender_cache[name];
21 | } else {
22 | if (typeof template == 'undefined') {
23 | // was a cache check, return false
24 | return false;
25 | }
26 | // If options escape_html is false, dont escape the contents by default
27 | if (options && options.escape_html === false) {
28 | escaped_string = "\",$1,\"";
29 | } else {
30 | escaped_string = "\",h($1),\"";
31 | }
32 | // Generate a reusable function that will serve as a template
33 | // generator (and which will be cached).
34 | fn = srender_cache[name] = new Function("obj",
35 | "var ___$$$___=[],print=function(){___$$$___.push.apply(___$$$___,arguments);};" +
36 |
37 | // Introduce the data as local variables using with(){}
38 | "with(obj){___$$$___.push(\"" +
39 |
40 | // Convert the template into pure JavaScript
41 | String(template)
42 | .replace(/[\r\t\n]/g, " ")
43 | .replace(/\"/g, '\\"')
44 | .split("<%").join("\t")
45 | .replace(/((^|%>)[^\t]*)/g, "$1\r")
46 | .replace(/\t=(.*?)%>/g, escaped_string)
47 | .replace(/\t!(.*?)%>/g, "\",$1,\"")
48 | .split("\t").join("\");")
49 | .split("%>").join("___$$$___.push(\"")
50 | .split("\r").join("")
51 | + "\");}return ___$$$___.join('');");
52 | }
53 |
54 | if (typeof data != 'undefined') {
55 | return fn(data);
56 | } else {
57 | return fn;
58 | }
59 | };
60 |
61 | // `Sammy.Template` is a simple plugin that provides a way to create
62 | // and render client side templates. The rendering code is based on John Resig's
63 | // quick templates and Greg Borenstien's srender plugin.
64 | // This is also a great template/boilerplate for Sammy plugins.
65 | //
66 | // Templates use `<% %>` tags to denote embedded javascript.
67 | //
68 | // ### Examples
69 | //
70 | // Here is an example template (user.template):
71 | //
72 | // // user.template
73 | //
74 | // <%= user.name %>
75 | // <% if (user.photo_url) { %>
76 | //
77 | // <% } %>
78 | //
79 | //
80 | // Given that is a publicly accesible file, you would render it like:
81 | //
82 | // // app.js
83 | // $.sammy(function() {
84 | // // include the plugin
85 | // this.use('Template');
86 | //
87 | // this.get('#/', function() {
88 | // // the template is rendered in the current context.
89 | // this.user = {name: 'Aaron Quint'};
90 | // // partial calls template() because of the file extension
91 | // this.partial('user.template');
92 | // })
93 | // });
94 | //
95 | // You can also pass a second argument to use() that will alias the template
96 | // method and therefore allow you to use a different extension for template files
97 | // in partial()
98 | //
99 | // // alias to 'tpl'
100 | // this.use(Sammy.Template, 'tpl');
101 | //
102 | // // now .tpl files will be run through srender
103 | // this.get('#/', function() {
104 | // this.partial('myfile.tpl');
105 | // });
106 | //
107 | // By default, the data passed into the tempalate is passed automatically passed through
108 | // Sammy's `escapeHTML` method in order to prevent possible XSS attacks. This is
109 | // a problem though if you're using something like `Sammy.Form` which renders HTML
110 | // within the templates. You can get around this in two ways. One, you can use the
111 | // `<%! %>` instead of `<%= %>`. Two, you can pass the `escape_html = false` option
112 | // when interpolating, i.e:
113 | //
114 | // this.get('#/', function() {
115 | // this.template('myform.tpl', {form: "
"}, {escape_html: false});
116 | // });
117 | //
118 | Sammy.Template = function(app, method_alias) {
119 |
120 | // *Helper:* Uses simple templating to parse ERB like templates.
121 | //
122 | // ### Arguments
123 | //
124 | // * `template` A String template. '<% %>' tags are evaluated as Javascript and replaced with the elements in data.
125 | // * `data` An Object containing the replacement values for the template.
126 | // data is extended with the EventContext allowing you to call its methods within the template.
127 | // * `name` An optional String name to cache the template.
128 | //
129 | var template = function(template, data, name, options) {
130 | // use name for caching
131 | if (typeof name == 'undefined') { name = template; }
132 | if (typeof options == 'undefined' && typeof name == 'object') {
133 | options = name; name = template;
134 | }
135 | return srender(name, template, $.extend({}, this, data), options);
136 | };
137 |
138 | // set the default method name/extension
139 | if (!method_alias) { method_alias = 'template'; }
140 | // create the helper at the method alias
141 | app.helper(method_alias, template);
142 |
143 | };
144 |
145 | return Sammy.Template;
146 |
147 | }));
148 |
--------------------------------------------------------------------------------
/lib/plugins/sammy.oauth2.js:
--------------------------------------------------------------------------------
1 | (function (factory) {
2 | if (typeof define === 'function' && define.amd) {
3 | define(['jquery', 'sammy'], factory);
4 | } else {
5 | (window.Sammy = window.Sammy || {}).OAuth2 = factory(window.jQuery, window.Sammy);
6 | }
7 | }(function ($, Sammy) {
8 |
9 | // Sammy.OAuth2 is a plugin for using OAuth 2.0 to authenticate users and
10 | // access your application's API. Requires Sammy.Session.
11 | //
12 | // Triggers the following events:
13 | //
14 | // * `oauth.connected` - Access token set and ready to use. Triggered when new
15 | // access token acquired, of when application starts and already has access
16 | // token.
17 | // * `oauth.disconnected` - Access token reset. Triggered by
18 | // loseAccessToken().
19 | // * `oauth.denied` - Authorization attempt rejected.
20 | //
21 | // ### Example
22 | //
23 | // this.use('Storage');
24 | // this.use('OAuth2');
25 | // this.oauthorize = "/oauth/authorize";
26 | //
27 | // // The quick & easy way
28 | // this.requireOAuth();
29 | // // Specific path
30 | // this.requireOAuth("/private");
31 | // // Filter you can apply to specific URLs
32 | // this.before(function(context) { return context.requireOAuth(); })
33 | // // Apply to specific request
34 | // this.get("/private", function(context) {
35 | // this.requireOAuth(function() {
36 | // // Do something
37 | // });
38 | // });
39 | //
40 | // // Sign in/sign out.
41 | // this.bind("oauth.connected", function() { $("#signin").hide() });
42 | // this.bind("oauth.disconnected", function() { $("#signin").show() });
43 | //
44 | // // Handle access denied and other errors
45 | // this.bind("oauth.denied", function(evt, error) {
46 | // this.partial("admin/views/no_access.tmpl", { error: error.message });
47 | // });
48 | //
49 | // // Sign out.
50 | // this.get("#/signout", function(context) {
51 | // context.loseAccessToken();
52 | // context.redirect("#/");
53 | // });
54 | //
55 | Sammy.OAuth2 = function(app) {
56 | app.use('JSON');
57 | this.authorize = "/oauth/authorize";
58 |
59 | // Use this on request that require OAuth token. You can use this in a
60 | // filter: it will redirect and return false if the access token is missing.
61 | // You can use it in a route, it will redirect to get the access token, or
62 | // call the callback function if it has an access token.
63 | this.helper("requireOAuth", function(cb) {
64 | if (this.app.getAccessToken()) {
65 | if (cb) {
66 | cb.apply(this);
67 | }
68 | } else {
69 | this.redirect(this.app.authorize + "?state=" + escape(this.path));
70 | return false;
71 | }
72 | });
73 |
74 | // Use this to sign out.
75 | this.helper("loseAccessToken", function() {
76 | this.app.loseAccessToken();
77 | });
78 |
79 | // Use this in your application to require an OAuth access token on all, or
80 | // the specified paths. It sets up a before filter on the specified paths.
81 | this.requireOAuth = function(options) {
82 | this.before(options || {}, function(context) {
83 | return context.requireOAuth();
84 | });
85 | }
86 |
87 | // Returns the access token. Uses Sammy.Session to store the token.
88 | this.getAccessToken = function() {
89 | return this.session("oauth.token");
90 | }
91 | // Stores the access token in the session.
92 | this.setAccessToken = function(token) {
93 | this.session("oauth.token", token);
94 | this.trigger("oauth.connected");
95 | }
96 | // Lose access token: use this to sign out.
97 | this.loseAccessToken = function() {
98 | this.session("oauth.token", null);
99 | this.trigger("oauth.disconnected");
100 | }
101 |
102 | // Add OAuth 2.0 access token to all XHR requests.
103 | $(document).ajaxSend(function(evt, xhr) {
104 | var token = app.getAccessToken();
105 | if (token) {
106 | xhr.setRequestHeader("Authorization", "OAuth " + token);
107 | }
108 | });
109 |
110 | // Converts query string parameters in fragment identifier to object.
111 | function parseParams(path) {
112 | var hash = path.match(/#(.*)$/)[1];
113 | var pairs = hash.split("&"), params = {};
114 | var i, len = pairs.length;
115 |
116 | for (i = 0; i < len; i += 1) {
117 | var splat = pairs[i].split("=");
118 | params[splat[0]] = splat[1].replace(/\+/g, " ");
119 | }
120 | return params;
121 | }
122 |
123 | var start_url;
124 | // Capture the application's start URL, we'll need that later on for
125 | // redirection.
126 | this.bind("run", function(evt, params) {
127 | start_url = params.start_url || "#";
128 | if (this.app.getAccessToken()) {
129 | this.trigger("oauth.connected");
130 | }
131 | });
132 |
133 | // Intercept OAuth authorization response with access token, stores it and
134 | // redirects to original URL, or application root.
135 | this.before(/#(access_token=|[^\\].*\&access_token=)/, function(context) {
136 | var params = parseParams(context.path);
137 | this.app.setAccessToken(params.access_token);
138 | // When the filter redirected the original request, it passed the original
139 | // request's URL in the state parameter, which we get back after
140 | // authorization.
141 | context.redirect(params.state.length === 0 ? this.app.start_url : unescape(params.state));
142 | return false;
143 | }).get(/#(access_token=|[^\\].*\&access_token=)/, function(context) { });
144 |
145 | // Intercept OAuth authorization response with error (typically access
146 | // denied).
147 | this.before(/#(error=|[^\\].*\&error=)/, function(context) {
148 | var params = parseParams(context.path);
149 | var message = params.error_description || "Access denined";
150 | context.trigger("oauth.denied", { code: params.error, message: message });
151 | return false;
152 | }).get(/#(error=|[^\\].*\&error=)/, function(context) { });
153 |
154 | }
155 |
156 | return Sammy.OAuth2;
157 |
158 | }));
159 |
--------------------------------------------------------------------------------
/test/flash_spec.js:
--------------------------------------------------------------------------------
1 | describe('Flash', function() {
2 | var app, nowApp, context, output,
3 | createAppsWithFlash, unloadAppsWithFlash;
4 |
5 | createAppsWithFlash = function() {
6 | app = Sammy(function() {
7 | this.use(Sammy.Flash);
8 | this.element_selector = '#main';
9 |
10 | this.get('#/', function() {
11 | this.flash('welcome info', 'Welcome!');
12 | });
13 | this.post('#/test', function() {
14 | this.flash('info', "Successfully POSTed nested params");
15 | this.redirect('#/');
16 | });
17 | });
18 |
19 | nowApp = Sammy(function() {
20 | this.use(Sammy.Flash);
21 | this.element_selector = '#main2';
22 |
23 | this.get('#/', function() {
24 | this.flashNow('info', '您好');
25 | });
26 | this.post('#/test', function() {
27 | this.flashNow('warn', 'Uh-oh?');
28 | this.redirect('#/doNothing');
29 | });
30 | this.get('#/doNothing', function() {});
31 | });
32 | };
33 |
34 | unloadApps = function() {
35 | app.unload();
36 | nowApp.unload();
37 | window.location.href = '#/';
38 | };
39 |
40 | describe('app.flash', function() {
41 | beforeEach(createAppsWithFlash);
42 | afterEach(unloadApps);
43 |
44 | it('exists', function() {
45 | expect(app.flash).to.be.an(Object);
46 | });
47 |
48 | it('retains entries after a non-redirect', function() {
49 | app.run('#/');
50 | expect(app.flash['welcome info']).to.eql('Welcome!');
51 | });
52 |
53 | it('retains entries after a redirect', function() {
54 | $('#main').html('');
57 |
58 | app.run('#/');
59 | $('#test_form').submit();
60 | expect(app.flash['info']).to.eql("Successfully POSTed nested params");
61 | });
62 |
63 | it('loses all entries after being rendered', function() {
64 | app.run('#/');
65 | app.flash.toHTML();
66 | expect(app.flash['welcome info']).to.be(undefined);
67 | });
68 |
69 | it('retains entries after a redirect in another app', function() {
70 | $('#main2').html('');
73 |
74 | app.run('#/');
75 | nowApp.run('#/');
76 | $('#test_form').submit();
77 | expect(app.flash['welcome info']).to.eql('Welcome!');
78 | });
79 | });
80 |
81 | describe('app.flash.now', function() {
82 | beforeEach(createAppsWithFlash);
83 | afterEach(unloadApps);
84 |
85 | it('exists', function() {
86 | expect(nowApp.flash).to.be.an(Object);
87 | });
88 |
89 | it('retains entries after a non-redirect', function() {
90 | nowApp.run('#/');
91 | window.location.hash = '#/';
92 | expect(nowApp.flash.now.info).to.eql('您好');
93 | });
94 |
95 | it('loses all entries after a redirect', function() {
96 | $('#main').html('');
97 | $('#main2').html('');
100 |
101 | nowApp.run('#/');
102 | $('#test_form').submit();
103 | expect(nowApp.flash.now.warn).to.be(undefined);
104 | });
105 |
106 | it('loses all entries after being rendered', function() {
107 | nowApp.run('#/');
108 | nowApp.flash.toHTML();
109 | expect(nowApp.flash.now.info).to.be(undefined);
110 | });
111 |
112 | it('retains entries after a redirect in another app', function() {
113 | $('#main2').html('');
114 | $('#main').html('');
117 |
118 | app.run('#/');
119 | nowApp.run('#/');
120 | $('#test_form').submit();
121 | expect(nowApp.flash.now.info).to.eql('您好');
122 | });
123 | });
124 |
125 | describe('#flash()', function() {
126 | beforeEach(function() {
127 | createAppsWithFlash();
128 | context = new app.context_prototype(app, 'get', '#/', {});
129 | });
130 |
131 | it('returns the Flash object when passed no arguments', function() {
132 | expect(context.flash()).to.eql(app.flash);
133 | });
134 |
135 | it('returns the value of the given key when passed one argument', function() {
136 | app.flash.foo = 'bar';
137 | expect(context.flash('foo')).to.eql('bar');
138 | });
139 |
140 | it('sets a flash value when passed two arguments', function() {
141 | context.flash('foo2', 'bar2');
142 | expect(context.flash('foo2')).to.eql('bar2');
143 | });
144 | });
145 |
146 | describe('#flashNow()', function() {
147 | beforeEach(function() {
148 | createAppsWithFlash();
149 | context = new app.context_prototype(app, 'get', '#/', {});
150 | });
151 |
152 | it('returns the Flash-Now object when passed no arguments', function() {
153 | expect(context.flashNow()).to.eql(app.flash.now);
154 | });
155 |
156 | it('returns the value of the given key when passed one argument', function() {
157 | app.flash.now.foo = 'bar';
158 | expect(context.flashNow('foo')).to.eql('bar');
159 | });
160 |
161 | it('sets a flash value when passed two arguments', function() {
162 | context.flashNow('foo2', 'bar2');
163 | expect(context.flashNow('foo2')).to.eql('bar2');
164 | });
165 | });
166 |
167 | describe('#app.flash.toHTML()', function() {
168 | beforeEach(function() {
169 | createAppsWithFlash();
170 | app.flash.clear();
171 | nowApp.flash.clear();
172 |
173 | app.flash.error = 'Boom!';
174 | app.flash.warn = 'Beep!';
175 | app.flash.now.info = 'Info!';
176 | nowApp.flash.debug = 'Debug!';
177 |
178 | output = $('')
179 | .append(app.flash.toHTML())
180 | .appendTo($('body'));
181 | });
182 |
183 | afterEach(function() {
184 | output.remove();
185 | });
186 |
187 | it('renders a ul.flash', function() {
188 | expect($('ul.flash', this.output)).to.have.length(1);
189 | });
190 |
191 | it('includes entries from both flash and flash.now, with keys as classes', function() {
192 | expect($('ul.flash li.error', this.output).text()).to.eql('Boom!');
193 | expect($('ul.flash li.warn', this.output).text()).to.eql('Beep!');
194 | expect($('ul.flash li.info', this.output).text()).to.eql('Info!');
195 | });
196 |
197 | it("does not include entries from another app's flash", function() {
198 | expect($('.debug', output)).to.have.length(0);
199 | });
200 | });
201 | });
202 |
--------------------------------------------------------------------------------
Hello!
55 | // 56 | // Hey, AQ! Welcome to Mustache! 57 | // 58 | // 59 | // ### Example #2 - Mustache partials 60 | // 61 | // The template (mytemplate.ms) 62 | // 63 | // Hey, {{name}}! {{>hello_friend}} 64 | // 65 | // 66 | // The partial (mypartial.ms) 67 | // 68 | // Say hello to your friend {{friend}}! 69 | // 70 | // The app: 71 | // 72 | // var app = $.sammy(function() { 73 | // // include the plugin and alias mustache() to ms() 74 | // this.use('Mustache', 'ms'); 75 | // 76 | // this.get('#/hello/:name/to/:friend', function(context) { 77 | // // fetch mustache-partial first 78 | // this.load('mypartial.ms') 79 | // .then(function(partial) { 80 | // // set local vars 81 | // context.partials = {hello_friend: partial}; 82 | // context.name = context.params.name; 83 | // context.friend = context.params.friend; 84 | // 85 | // // render the template and pass it through mustache 86 | // context.partial('mytemplate.ms'); 87 | // }); 88 | // }); 89 | // }); 90 | // 91 | // $(function() { 92 | // app.run() 93 | // }); 94 | // 95 | // If I go to #/hello/AQ/to/dP in the browser, Sammy will render this to the body: 96 | // 97 | // Hey, AQ! Say hello to your friend dP! 98 | // 99 | // Note: You need to include the mustache.js file before this plugin. 100 | // 101 | Sammy.Mustache = function(app, method_alias) { 102 | 103 | // *Helper* Uses Mustache.js to parse a template and interpolate and work with the passed data 104 | // 105 | // ### Arguments 106 | // 107 | // * `template` A String template. {{}} Tags are evaluated and interpolated by Mustache.js 108 | // * `data` An Object containing the replacement values for the template. 109 | // data is extended with the EventContext allowing you to call its methods within the template. 110 | // * `partials` An Object containing one or more partials (String templates 111 | // that are called from the main template). 112 | // 113 | var mustache = function(template, data, partials) { 114 | data = $.extend({}, this, data); 115 | partials = $.extend({}, data.partials, partials); 116 | return Mustache.to_html(template, data, partials); 117 | }; 118 | 119 | // set the default method name/extension 120 | if (!method_alias) { method_alias = 'mustache'; } 121 | app.helper(method_alias, mustache); 122 | }; 123 | 124 | return Sammy.Mustache; 125 | 126 | })); 127 | -------------------------------------------------------------------------------- /lib/plugins/sammy.hogan.js: -------------------------------------------------------------------------------- 1 | (function (factory) { 2 | if (typeof define === 'function' && define.amd) { 3 | define(['jquery', 'sammy', 'hogan'], factory); 4 | } else { 5 | (window.Sammy = window.Sammy || {}).Hogan = factory(window.jQuery, window.Sammy, window.Hogan); 6 | } 7 | }(function ($, Sammy) { 8 | 9 | // Sammy.Hogan provides a quick way of using hogan.js style templates in your app. 10 | // The plugin wraps the awesome hogan.js lib created and maintained by Twitter 11 | // at http://twitter.github.com/hogan.js/ 12 | // 13 | // Note: As of Sammy 0.7 the Hogan.js lib is not included in the templates source. Please download 14 | // hogan.js and include it before Sammy.Hogan. 15 | // 16 | // Hogan.js is a clever templating system that relys on double brackets {{}} for interpolation. 17 | // For full details on syntax check out the documentation at 18 | // http://twitter.github.com/hogan.js/ 19 | // 20 | // By default using Sammy.Hogan in your app adds the hogan() method to the EventContext 21 | // prototype. However, just like Sammy.Hogan you can change the default name of the method 22 | // by passing a second argument (e.g. you could use the hg() as the method alias so that all the template 23 | // files could be in the form file.hg instead of file.hogan) 24 | // 25 | // ### Example #1 26 | // 27 | // The template (mytemplate.hg): 28 | // 29 | //{{title}}
30 | //
31 | // Hey, {{name}}! Welcome to Mustache!
32 | //
33 | // The app:
34 | //
35 | // var app = $.sammy(function() {
36 | // // include the plugin and alias hogan() to hg()
37 | // this.use('Hogan', 'hg');
38 | //
39 | // this.get('#/hello/:name', function() {
40 | // // set local vars
41 | // this.title = 'Hello!'
42 | // this.name = this.params.name;
43 | // // render the template and pass it through hogan
44 | // this.partial('mytemplate.hg');
45 | // });
46 | // });
47 | //
48 | // $(function() {
49 | // app.run()
50 | // });
51 | //
52 | // If I go to #/hello/AQ in the browser, Sammy will render this to the body:
53 | //
54 | // Hello!
55 | //
56 | // Hey, AQ! Welcome to Mustache!
57 | //
58 | //
59 | // ### Example #2 - Hogan partials
60 | //
61 | // The template (mytemplate.hg)
62 | //
63 | // Hey, {{name}}! {{>hello_friend}}
64 | //
65 | //
66 | // The partial (mypartial.hg)
67 | //
68 | // Say hello to your friend {{friend}}!
69 | //
70 | // The app:
71 | //
72 | // var app = $.sammy(function() {
73 | // // include the plugin and alias hogan() to hg()
74 | // this.use('Hogan', 'hg');
75 | //
76 | // this.get('#/hello/:name/to/:friend', function(context) {
77 | // // fetch hogan-partial first
78 | // this.load('mypartial.hg')
79 | // .then(function(partial) {
80 | // // set local vars
81 | // context.partials = {hello_friend: partial};
82 | // context.name = context.params.name;
83 | // context.friend = context.params.friend;
84 | //
85 | // // render the template and pass it through hogan
86 | // context.partial('mytemplate.hg');
87 | // });
88 | // });
89 | // });
90 | //
91 | // $(function() {
92 | // app.run()
93 | // });
94 | //
95 | // If I go to #/hello/AQ/to/dP in the browser, Sammy will render this to the body:
96 | //
97 | // Hey, AQ! Say hello to your friend dP!
98 | //
99 | // Note: You dont have to include the hogan.js file on top of the plugin as the plugin
100 | // includes the full source.
101 | //
102 | Sammy.Hogan = function(app, method_alias) {
103 | var cached_templates = {};
104 |
105 | // *Helper* Uses Hogan.js to parse a template and interpolate and work with the passed data
106 | //
107 | // ### Arguments
108 | //
109 | // * `template` A String template. {{}} Tags are evaluated and interpolated by Hogan.js
110 | // * `data` An Object containing the replacement values for the template.
111 | // data is extended with the EventContext allowing you to call its methods within the template.
112 | // * `partials` An Object containing one or more partials (String templates
113 | // that are called from the main template).
114 | //
115 | var hogan = function(template, data, partials) {
116 | var compiled_template = cached_templates[compiled_template];
117 | if (!compiled_template){
118 | compiled_template = Hogan.compile(template);
119 | }
120 | data = $.extend({}, this, data);
121 | partials = $.extend({}, data.partials, partials);
122 | return compiled_template.render(data, partials);
123 | };
124 |
125 | // set the default method name/extension
126 | if (!method_alias) { method_alias = 'hogan'; }
127 | app.helper(method_alias, hogan);
128 | };
129 |
130 | return Sammy.Hogan;
131 |
132 | }));
133 |
--------------------------------------------------------------------------------
/lib/plugins/sammy.meld.js:
--------------------------------------------------------------------------------
1 | (function (factory) {
2 | if (typeof define === 'function' && define.amd) {
3 | define(['jquery', 'sammy'], factory);
4 | } else {
5 | (window.Sammy = window.Sammy || {}).Meld = factory(window.jQuery, window.Sammy);
6 | }
7 | }(function ($, Sammy) {
8 |
9 | // `Sammy.Meld` is a simple templating engine that uses the power of jQuery's
10 | // DOM manipulation to easily meld JSON data and HTML templates very quickly.
11 | //
12 | // The template can either be a string (i.e. loaded from a remote template)
13 | // or a DOM Element/jQuery object. This allows you to have templates be DOM
14 | // elements as the initial document load.
15 | //
16 | // ### Example
17 | //
18 | // The simplest case is a nested `` whose class name is tied to a
19 | // property of a JS object.
20 | //
21 | // Template:
22 | //
23 | //
24 | //
25 | //
26 | //
29 | //
30 | //
31 | // Data:
32 | //
33 | // {
34 | // "post": {
35 | // "title": "My Post",
36 | // "entry": "My Entry",
37 | // "author": {
38 | // "name": "@aq"
39 | // }
40 | // }
41 | // }
42 | //
43 | // Result:
44 | //
45 | //
46 | // My Post
47 | // My Entry
48 | //
51 | //
52 | //
53 | // Templates can be much more complex, and more deeply nested.
54 | // More examples can be found in `test/fixtures/meld/`
55 | //
56 | // If you don't think the lookup by classes is semantic for you, you can easily
57 | // switch the method of lookup by defining a selector function in the options
58 | //
59 | // For example:
60 | //
61 | // meld($('.post'), post_data, {
62 | // selector: function(k) {
63 | // return '[data-key=' + k + ']';
64 | // }
65 | // });
66 | //
67 | // Would look for template nodes like ``
68 | //
69 | Sammy.Meld = function(app, method_alias) {
70 | var default_options = {
71 | selector: function(k) { return '.' + k; },
72 | remove_false: true
73 | };
74 |
75 | var meld = function(template, data, options) {
76 | var $template = $(template);
77 |
78 | options = $.extend(default_options, options || {});
79 |
80 | if (typeof data === 'string') {
81 | $template.html(data);
82 | } else {
83 | $.each(data, function(key, value) {
84 | var selector = options.selector(key),
85 | $sub = $template.filter(selector),
86 | $container,
87 | $item,
88 | is_list = false,
89 | subindex = $template.index($sub);
90 |
91 | if ($sub.length === 0) { $sub = $template.find(selector); }
92 | if ($sub.length > 0) {
93 | if ($.isArray(value)) {
94 | $container = $('');
95 | if ($sub.is('ol, ul')) {
96 | is_list = true;
97 | $item = $sub.children('li:first');
98 | if ($item.length == 0) { $item = $(''); }
99 | } else if ($sub.children().length == 1) {
100 | is_list = true;
101 | $item = $sub.children(':first').clone();
102 | } else {
103 | $item = $sub.clone();
104 | }
105 | for (var i = 0; i < value.length; i++) {
106 | $container.append(meld($item.clone(), value[i], options));
107 | }
108 | if (is_list) {
109 | $sub.html($container.html());
110 | } else if ($sub[0] == $template[0]) {
111 | $template = $($container.html());
112 | } else if (subindex >= 0) {
113 | var args = [subindex, 1];
114 | args = args.concat($container.children().get());
115 | $template.splice.apply($template, args);
116 | }
117 | } else if (options.remove_false && value === false) {
118 | $template.splice(subindex, 1);
119 | } else if (typeof value === 'object') {
120 | if ($sub.is(':empty')) {
121 | $sub.attr(value, true);
122 | } else {
123 | $sub.html(meld($sub.html(), value, options));
124 | }
125 | } else {
126 | $sub.html(value.toString());
127 | }
128 | } else {
129 | $template.attr(key, value, true);
130 | }
131 | });
132 | }
133 | var dom = $template;
134 | return dom;
135 | };
136 |
137 | // set the default method name/extension
138 | if (!method_alias) method_alias = 'meld';
139 | // create the helper at the method alias
140 | app.helper(method_alias, meld);
141 |
142 | };
143 |
144 | return Sammy.Meld;
145 |
146 | }));
147 |
--------------------------------------------------------------------------------
/lib/plugins/sammy.handlebars.js:
--------------------------------------------------------------------------------
1 | (function (factory) {
2 | if (typeof define === 'function' && define.amd) {
3 | define(['jquery', 'sammy', 'handlebars'], factory);
4 | } else {
5 | (window.Sammy = window.Sammy || {}).Handlebars = factory(window.jQuery, window.Sammy);
6 | }
7 | }(function ($, Sammy, Handlebars) {
8 | // version 1.0.0 has no support for AMD but upwards does, this way we support both.
9 | Handlebars = Handlebars || window.Handlebars;
10 |
11 | // Sammy.Handlebars provides a quick way of using Handlebars templates in your app.
12 | //
13 | // Note: As of Sammy 0.7 Handlebars itself is not included in the source. Please download and
14 | // include handlebars.js before Sammy.Handlebars.
15 | //
16 | // Handlebars.js is an extension to the Mustache templating language created by Chris Wanstrath. Handlebars.js
17 | // and Mustache are both logicless templating languages that keep the view and the code separated like
18 | // we all know they should be.
19 | //
20 | // By default using Sammy.Handlbars in your app adds the handlebars() method to the EventContext
21 | // prototype. However, just like Sammy.Template you can change the default name of the method
22 | // by passing a second argument (e.g. you could use the hbr() as the method alias so that all the template
23 | // files could be in the form file.hbr instead of file.handlebars)
24 | //
25 | // ### Example #1
26 | //
27 | // The template (mytemplate.hb):
28 | //
29 | // {{title}}
30 | //
31 | // Hey, {{name}}! Welcome to Handlebars!
32 | //
33 | // The app:
34 | //
35 | // var app = $.sammy(function() {
36 | // // include the plugin and alias handlebars() to hb()
37 | // this.use('Handlebars', 'hb');
38 | //
39 | // this.get('#/hello/:name', function() {
40 | // // set local vars
41 | // this.title = 'Hello!'
42 | // this.name = this.params.name;
43 | // // render the template and pass it through handlebars
44 | // this.partial('mytemplate.hb');
45 | // });
46 | // });
47 | //
48 | // $(function() {
49 | // app.run()
50 | // });
51 | //
52 | // If I go to #/hello/AQ in the browser, Sammy will render this to the body:
53 | //
54 | // Hello!
55 | //
56 | // Hey, AQ! Welcome to Handlebars!
57 | //
58 | //
59 | // ### Example #2 - Handlebars partials
60 | //
61 | // The template (mytemplate.hb)
62 | //
63 | // Hey, {{name}}! {{>hello_friend}}
64 | //
65 | //
66 | // The partial (mypartial.hb)
67 | //
68 | // Say hello to your friend {{friend}}!
69 | //
70 | // The app:
71 | //
72 | // var app = $.sammy(function() {
73 | // // include the plugin and alias handlebars() to hb()
74 | // this.use('Handlebars', 'hb');
75 | //
76 | // this.get('#/hello/:name/to/:friend', function(context) {
77 | // // fetch handlebars-partial first
78 | // this.load('mypartial.hb')
79 | // .then(function(partial) {
80 | // // set local vars
81 | // context.partials = {hello_friend: partial};
82 | // context.name = context.params.name;
83 | // context.friend = context.params.friend;
84 | //
85 | // // render the template and pass it through handlebars
86 | // context.partial('mytemplate.hb');
87 | // });
88 | // });
89 | // });
90 | //
91 | // $(function() {
92 | // app.run()
93 | // });
94 | //
95 | // If I go to #/hello/AQ/to/dP in the browser, Sammy will render this to the body:
96 | //
97 | // Hey, AQ! Say hello to your friend dP!
98 | //
99 | // Note: You dont have to include the handlebars.js file on top of the plugin as the plugin
100 | // includes the full source.
101 | //
102 | Sammy.Handlebars = function(app, method_alias) {
103 | var handlebars_cache = {};
104 | // *Helper* Uses handlebars.js to parse a template and interpolate and work with the passed data
105 | //
106 | // ### Arguments
107 | //
108 | // * `template` A String template.
109 | // * `data` An Object containing the replacement values for the template.
110 | // data is extended with the EventContext allowing you to call its methods within the template.
111 | //
112 | var handlebars = function(template, data, partials, name) {
113 | // use name for caching
114 | if (typeof name == 'undefined') { name = template; }
115 | var fn = handlebars_cache[name];
116 | if (!fn) {
117 | fn = handlebars_cache[name] = Handlebars.compile(template);
118 | }
119 |
120 | data = $.extend({}, this, data);
121 | partials = $.extend({}, data.partials, partials);
122 |
123 | return fn(data, {"partials":partials});
124 | };
125 |
126 | // set the default method name/extension
127 | if (!method_alias) { method_alias = 'handlebars'; }
128 | app.helper(method_alias, handlebars);
129 | };
130 |
131 | return Sammy.Handlebars;
132 |
133 | }));
134 |
--------------------------------------------------------------------------------
/test/meld_spec.js:
--------------------------------------------------------------------------------
1 | describe('Meld', function() {
2 | var context;
3 |
4 | beforeEach(function() {
5 | var app = new Sammy.Application(function() {
6 | this.raise_errors = false;
7 | this.element_selector = '#main';
8 | this.use(Sammy.Meld);
9 | this.get('#/', function() {});
10 | });
11 |
12 | context = new app.context_prototype(app, 'get', '#/test/:test', {test: 'hooray'});
13 | });
14 |
15 | it('does simple interpolation', function() {
16 | var template = "";
17 | data = {'title': 'TEST'},
18 | expected = "TEST";
19 |
20 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
21 | });
22 |
23 | it('interpolates one level deep', function() {
24 | var template = "";
25 | data = {'post': {'title': 'TEST'}},
26 | expected = "TEST";
27 |
28 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
29 | });
30 |
31 | it('interpolates multiple keys', function() {
32 | var template = "";
33 | data = {'post': 'my post', 'title': 'TEST'},
34 | expected = "my postTEST";
35 |
36 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
37 | });
38 |
39 | it('interpolates multiple nested keys', function() {
40 | var template = "";
41 | data = {'post': {'title': 'TEST', 'author': 'AQ'}},
42 | expected = "TEST";
43 |
44 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
45 | });
46 |
47 | it('multiplies an array of tags', function() {
48 | var template = "";
49 | data = {'post': {'tags': ['one', 'two']}},
50 | expected = "";
51 |
52 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
53 | });
54 |
55 | it('multiplies an array of objects', function() {
56 | var template = "";
57 | data = {'post': {'authors': [{'name': 'AQ', 'twitter': 'aq'}, {'name':'Mike', 'twitter':'mrb_bk'}]}},
58 | expected = "";
59 |
60 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
61 | });
62 |
63 | it('multiplies an array on a list item', function() {
64 | var template = "";
65 | data = {'post': {'tags': ['one', 'two']}},
66 | expected = "";
67 |
68 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
69 | });
70 |
71 | it('multiplies an array on a list item using the example list item', function() {
72 | var template = "";
73 | data = {'post': {'tags': ['one', 'two']}},
74 | expected = "";
75 |
76 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
77 | });
78 |
79 | it('replaces attributes of elements as a fallback to class lookup', function() {
80 | var template = "",
81 | data = {'post': {'name': {'href': 'http://www.google.com', 'text': 'Link'}}},
82 | expected = "";
83 |
84 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
85 | });
86 |
87 | it('removes nodes if value is false', function() {
88 | var template = "Active",
89 | data = {'post': {'name': "My Name", 'active': false}},
90 | expected = "My Name
";
91 |
92 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
93 | });
94 |
95 | it('allows the setting of a selector function', function() {
96 | var template = "",
97 | data = {'post': {'name': "My Name"}},
98 | expected = "My Name
";
99 |
100 | expect(context.meld(template, data, {selector: function(k) {
101 | return "[rel='"+ k + "']";
102 | }})).to.have.sameHTMLAs(expected);
103 | });
104 |
105 | it('renders templates correctly', function(done) {
106 | var templates = 3;
107 |
108 | var getAndAssertTemplate = function(i) {
109 | var template, json, result;
110 | $.get('fixtures/meld/' + i + '.meld', function(t) {
111 | template = t;
112 | $.getJSON('fixtures/meld/' + i + '.json', function(j) {
113 | json = j;
114 | $.get('fixtures/meld/' + i + '.html', function(r) {
115 | expect(context.meld(template, json)).to.have.sameHTMLAs(r);
116 | if (i == templates) {
117 | done();
118 | } else {
119 | getAndAssertTemplate(i + 1);
120 | }
121 | });
122 | });
123 | });
124 | }
125 |
126 | getAndAssertTemplate(1);
127 | });
128 | });
129 |
--------------------------------------------------------------------------------
/lib/plugins/sammy.template.js:
--------------------------------------------------------------------------------
1 | (function (factory) {
2 | if (typeof define === 'function' && define.amd) {
3 | define(['jquery', 'sammy'], factory);
4 | } else {
5 | (window.Sammy = window.Sammy || {}).Template = factory(window.jQuery, window.Sammy);
6 | }
7 | }(function ($, Sammy) {
8 |
9 | // Simple JavaScript Templating
10 | // John Resig - http://ejohn.org/ - MIT Licensed
11 | // adapted from: http://ejohn.org/blog/javascript-micro-templating/
12 | // originally $.srender by Greg Borenstein http://ideasfordozens.com in Feb 2009
13 | // modified for Sammy by Aaron Quint for caching templates by name
14 | var srender_cache = {};
15 | var srender = function(name, template, data, options) {
16 | var fn, escaped_string;
17 | // target is an optional element; if provided, the result will be inserted into it
18 | // otherwise the result will simply be returned to the caller
19 | if (srender_cache[name]) {
20 | fn = srender_cache[name];
21 | } else {
22 | if (typeof template == 'undefined') {
23 | // was a cache check, return false
24 | return false;
25 | }
26 | // If options escape_html is false, dont escape the contents by default
27 | if (options && options.escape_html === false) {
28 | escaped_string = "\",$1,\"";
29 | } else {
30 | escaped_string = "\",h($1),\"";
31 | }
32 | // Generate a reusable function that will serve as a template
33 | // generator (and which will be cached).
34 | fn = srender_cache[name] = new Function("obj",
35 | "var ___$$$___=[],print=function(){___$$$___.push.apply(___$$$___,arguments);};" +
36 |
37 | // Introduce the data as local variables using with(){}
38 | "with(obj){___$$$___.push(\"" +
39 |
40 | // Convert the template into pure JavaScript
41 | String(template)
42 | .replace(/[\r\t\n]/g, " ")
43 | .replace(/\"/g, '\\"')
44 | .split("<%").join("\t")
45 | .replace(/((^|%>)[^\t]*)/g, "$1\r")
46 | .replace(/\t=(.*?)%>/g, escaped_string)
47 | .replace(/\t!(.*?)%>/g, "\",$1,\"")
48 | .split("\t").join("\");")
49 | .split("%>").join("___$$$___.push(\"")
50 | .split("\r").join("")
51 | + "\");}return ___$$$___.join('');");
52 | }
53 |
54 | if (typeof data != 'undefined') {
55 | return fn(data);
56 | } else {
57 | return fn;
58 | }
59 | };
60 |
61 | // `Sammy.Template` is a simple plugin that provides a way to create
62 | // and render client side templates. The rendering code is based on John Resig's
63 | // quick templates and Greg Borenstien's srender plugin.
64 | // This is also a great template/boilerplate for Sammy plugins.
65 | //
66 | // Templates use `<% %>` tags to denote embedded javascript.
67 | //
68 | // ### Examples
69 | //
70 | // Here is an example template (user.template):
71 | //
72 | // // user.template
73 | //
74 | // <%= user.name %>
75 | // <% if (user.photo_url) { %>
76 | //
77 | // <% } %>
78 | //
79 | //
80 | // Given that is a publicly accesible file, you would render it like:
81 | //
82 | // // app.js
83 | // $.sammy(function() {
84 | // // include the plugin
85 | // this.use('Template');
86 | //
87 | // this.get('#/', function() {
88 | // // the template is rendered in the current context.
89 | // this.user = {name: 'Aaron Quint'};
90 | // // partial calls template() because of the file extension
91 | // this.partial('user.template');
92 | // })
93 | // });
94 | //
95 | // You can also pass a second argument to use() that will alias the template
96 | // method and therefore allow you to use a different extension for template files
97 | // in partial()
98 | //
99 | // // alias to 'tpl'
100 | // this.use(Sammy.Template, 'tpl');
101 | //
102 | // // now .tpl files will be run through srender
103 | // this.get('#/', function() {
104 | // this.partial('myfile.tpl');
105 | // });
106 | //
107 | // By default, the data passed into the tempalate is passed automatically passed through
108 | // Sammy's `escapeHTML` method in order to prevent possible XSS attacks. This is
109 | // a problem though if you're using something like `Sammy.Form` which renders HTML
110 | // within the templates. You can get around this in two ways. One, you can use the
111 | // `<%! %>` instead of `<%= %>`. Two, you can pass the `escape_html = false` option
112 | // when interpolating, i.e:
113 | //
114 | // this.get('#/', function() {
115 | // this.template('myform.tpl', {form: "
"}, {escape_html: false});
116 | // });
117 | //
118 | Sammy.Template = function(app, method_alias) {
119 |
120 | // *Helper:* Uses simple templating to parse ERB like templates.
121 | //
122 | // ### Arguments
123 | //
124 | // * `template` A String template. '<% %>' tags are evaluated as Javascript and replaced with the elements in data.
125 | // * `data` An Object containing the replacement values for the template.
126 | // data is extended with the EventContext allowing you to call its methods within the template.
127 | // * `name` An optional String name to cache the template.
128 | //
129 | var template = function(template, data, name, options) {
130 | // use name for caching
131 | if (typeof name == 'undefined') { name = template; }
132 | if (typeof options == 'undefined' && typeof name == 'object') {
133 | options = name; name = template;
134 | }
135 | return srender(name, template, $.extend({}, this, data), options);
136 | };
137 |
138 | // set the default method name/extension
139 | if (!method_alias) { method_alias = 'template'; }
140 | // create the helper at the method alias
141 | app.helper(method_alias, template);
142 |
143 | };
144 |
145 | return Sammy.Template;
146 |
147 | }));
148 |
--------------------------------------------------------------------------------
/lib/plugins/sammy.oauth2.js:
--------------------------------------------------------------------------------
1 | (function (factory) {
2 | if (typeof define === 'function' && define.amd) {
3 | define(['jquery', 'sammy'], factory);
4 | } else {
5 | (window.Sammy = window.Sammy || {}).OAuth2 = factory(window.jQuery, window.Sammy);
6 | }
7 | }(function ($, Sammy) {
8 |
9 | // Sammy.OAuth2 is a plugin for using OAuth 2.0 to authenticate users and
10 | // access your application's API. Requires Sammy.Session.
11 | //
12 | // Triggers the following events:
13 | //
14 | // * `oauth.connected` - Access token set and ready to use. Triggered when new
15 | // access token acquired, of when application starts and already has access
16 | // token.
17 | // * `oauth.disconnected` - Access token reset. Triggered by
18 | // loseAccessToken().
19 | // * `oauth.denied` - Authorization attempt rejected.
20 | //
21 | // ### Example
22 | //
23 | // this.use('Storage');
24 | // this.use('OAuth2');
25 | // this.oauthorize = "/oauth/authorize";
26 | //
27 | // // The quick & easy way
28 | // this.requireOAuth();
29 | // // Specific path
30 | // this.requireOAuth("/private");
31 | // // Filter you can apply to specific URLs
32 | // this.before(function(context) { return context.requireOAuth(); })
33 | // // Apply to specific request
34 | // this.get("/private", function(context) {
35 | // this.requireOAuth(function() {
36 | // // Do something
37 | // });
38 | // });
39 | //
40 | // // Sign in/sign out.
41 | // this.bind("oauth.connected", function() { $("#signin").hide() });
42 | // this.bind("oauth.disconnected", function() { $("#signin").show() });
43 | //
44 | // // Handle access denied and other errors
45 | // this.bind("oauth.denied", function(evt, error) {
46 | // this.partial("admin/views/no_access.tmpl", { error: error.message });
47 | // });
48 | //
49 | // // Sign out.
50 | // this.get("#/signout", function(context) {
51 | // context.loseAccessToken();
52 | // context.redirect("#/");
53 | // });
54 | //
55 | Sammy.OAuth2 = function(app) {
56 | app.use('JSON');
57 | this.authorize = "/oauth/authorize";
58 |
59 | // Use this on request that require OAuth token. You can use this in a
60 | // filter: it will redirect and return false if the access token is missing.
61 | // You can use it in a route, it will redirect to get the access token, or
62 | // call the callback function if it has an access token.
63 | this.helper("requireOAuth", function(cb) {
64 | if (this.app.getAccessToken()) {
65 | if (cb) {
66 | cb.apply(this);
67 | }
68 | } else {
69 | this.redirect(this.app.authorize + "?state=" + escape(this.path));
70 | return false;
71 | }
72 | });
73 |
74 | // Use this to sign out.
75 | this.helper("loseAccessToken", function() {
76 | this.app.loseAccessToken();
77 | });
78 |
79 | // Use this in your application to require an OAuth access token on all, or
80 | // the specified paths. It sets up a before filter on the specified paths.
81 | this.requireOAuth = function(options) {
82 | this.before(options || {}, function(context) {
83 | return context.requireOAuth();
84 | });
85 | }
86 |
87 | // Returns the access token. Uses Sammy.Session to store the token.
88 | this.getAccessToken = function() {
89 | return this.session("oauth.token");
90 | }
91 | // Stores the access token in the session.
92 | this.setAccessToken = function(token) {
93 | this.session("oauth.token", token);
94 | this.trigger("oauth.connected");
95 | }
96 | // Lose access token: use this to sign out.
97 | this.loseAccessToken = function() {
98 | this.session("oauth.token", null);
99 | this.trigger("oauth.disconnected");
100 | }
101 |
102 | // Add OAuth 2.0 access token to all XHR requests.
103 | $(document).ajaxSend(function(evt, xhr) {
104 | var token = app.getAccessToken();
105 | if (token) {
106 | xhr.setRequestHeader("Authorization", "OAuth " + token);
107 | }
108 | });
109 |
110 | // Converts query string parameters in fragment identifier to object.
111 | function parseParams(path) {
112 | var hash = path.match(/#(.*)$/)[1];
113 | var pairs = hash.split("&"), params = {};
114 | var i, len = pairs.length;
115 |
116 | for (i = 0; i < len; i += 1) {
117 | var splat = pairs[i].split("=");
118 | params[splat[0]] = splat[1].replace(/\+/g, " ");
119 | }
120 | return params;
121 | }
122 |
123 | var start_url;
124 | // Capture the application's start URL, we'll need that later on for
125 | // redirection.
126 | this.bind("run", function(evt, params) {
127 | start_url = params.start_url || "#";
128 | if (this.app.getAccessToken()) {
129 | this.trigger("oauth.connected");
130 | }
131 | });
132 |
133 | // Intercept OAuth authorization response with access token, stores it and
134 | // redirects to original URL, or application root.
135 | this.before(/#(access_token=|[^\\].*\&access_token=)/, function(context) {
136 | var params = parseParams(context.path);
137 | this.app.setAccessToken(params.access_token);
138 | // When the filter redirected the original request, it passed the original
139 | // request's URL in the state parameter, which we get back after
140 | // authorization.
141 | context.redirect(params.state.length === 0 ? this.app.start_url : unescape(params.state));
142 | return false;
143 | }).get(/#(access_token=|[^\\].*\&access_token=)/, function(context) { });
144 |
145 | // Intercept OAuth authorization response with error (typically access
146 | // denied).
147 | this.before(/#(error=|[^\\].*\&error=)/, function(context) {
148 | var params = parseParams(context.path);
149 | var message = params.error_description || "Access denined";
150 | context.trigger("oauth.denied", { code: params.error, message: message });
151 | return false;
152 | }).get(/#(error=|[^\\].*\&error=)/, function(context) { });
153 |
154 | }
155 |
156 | return Sammy.OAuth2;
157 |
158 | }));
159 |
--------------------------------------------------------------------------------
/test/flash_spec.js:
--------------------------------------------------------------------------------
1 | describe('Flash', function() {
2 | var app, nowApp, context, output,
3 | createAppsWithFlash, unloadAppsWithFlash;
4 |
5 | createAppsWithFlash = function() {
6 | app = Sammy(function() {
7 | this.use(Sammy.Flash);
8 | this.element_selector = '#main';
9 |
10 | this.get('#/', function() {
11 | this.flash('welcome info', 'Welcome!');
12 | });
13 | this.post('#/test', function() {
14 | this.flash('info', "Successfully POSTed nested params");
15 | this.redirect('#/');
16 | });
17 | });
18 |
19 | nowApp = Sammy(function() {
20 | this.use(Sammy.Flash);
21 | this.element_selector = '#main2';
22 |
23 | this.get('#/', function() {
24 | this.flashNow('info', '您好');
25 | });
26 | this.post('#/test', function() {
27 | this.flashNow('warn', 'Uh-oh?');
28 | this.redirect('#/doNothing');
29 | });
30 | this.get('#/doNothing', function() {});
31 | });
32 | };
33 |
34 | unloadApps = function() {
35 | app.unload();
36 | nowApp.unload();
37 | window.location.href = '#/';
38 | };
39 |
40 | describe('app.flash', function() {
41 | beforeEach(createAppsWithFlash);
42 | afterEach(unloadApps);
43 |
44 | it('exists', function() {
45 | expect(app.flash).to.be.an(Object);
46 | });
47 |
48 | it('retains entries after a non-redirect', function() {
49 | app.run('#/');
50 | expect(app.flash['welcome info']).to.eql('Welcome!');
51 | });
52 |
53 | it('retains entries after a redirect', function() {
54 | $('#main').html('');
57 |
58 | app.run('#/');
59 | $('#test_form').submit();
60 | expect(app.flash['info']).to.eql("Successfully POSTed nested params");
61 | });
62 |
63 | it('loses all entries after being rendered', function() {
64 | app.run('#/');
65 | app.flash.toHTML();
66 | expect(app.flash['welcome info']).to.be(undefined);
67 | });
68 |
69 | it('retains entries after a redirect in another app', function() {
70 | $('#main2').html('');
73 |
74 | app.run('#/');
75 | nowApp.run('#/');
76 | $('#test_form').submit();
77 | expect(app.flash['welcome info']).to.eql('Welcome!');
78 | });
79 | });
80 |
81 | describe('app.flash.now', function() {
82 | beforeEach(createAppsWithFlash);
83 | afterEach(unloadApps);
84 |
85 | it('exists', function() {
86 | expect(nowApp.flash).to.be.an(Object);
87 | });
88 |
89 | it('retains entries after a non-redirect', function() {
90 | nowApp.run('#/');
91 | window.location.hash = '#/';
92 | expect(nowApp.flash.now.info).to.eql('您好');
93 | });
94 |
95 | it('loses all entries after a redirect', function() {
96 | $('#main').html('');
97 | $('#main2').html('');
100 |
101 | nowApp.run('#/');
102 | $('#test_form').submit();
103 | expect(nowApp.flash.now.warn).to.be(undefined);
104 | });
105 |
106 | it('loses all entries after being rendered', function() {
107 | nowApp.run('#/');
108 | nowApp.flash.toHTML();
109 | expect(nowApp.flash.now.info).to.be(undefined);
110 | });
111 |
112 | it('retains entries after a redirect in another app', function() {
113 | $('#main2').html('');
114 | $('#main').html('');
117 |
118 | app.run('#/');
119 | nowApp.run('#/');
120 | $('#test_form').submit();
121 | expect(nowApp.flash.now.info).to.eql('您好');
122 | });
123 | });
124 |
125 | describe('#flash()', function() {
126 | beforeEach(function() {
127 | createAppsWithFlash();
128 | context = new app.context_prototype(app, 'get', '#/', {});
129 | });
130 |
131 | it('returns the Flash object when passed no arguments', function() {
132 | expect(context.flash()).to.eql(app.flash);
133 | });
134 |
135 | it('returns the value of the given key when passed one argument', function() {
136 | app.flash.foo = 'bar';
137 | expect(context.flash('foo')).to.eql('bar');
138 | });
139 |
140 | it('sets a flash value when passed two arguments', function() {
141 | context.flash('foo2', 'bar2');
142 | expect(context.flash('foo2')).to.eql('bar2');
143 | });
144 | });
145 |
146 | describe('#flashNow()', function() {
147 | beforeEach(function() {
148 | createAppsWithFlash();
149 | context = new app.context_prototype(app, 'get', '#/', {});
150 | });
151 |
152 | it('returns the Flash-Now object when passed no arguments', function() {
153 | expect(context.flashNow()).to.eql(app.flash.now);
154 | });
155 |
156 | it('returns the value of the given key when passed one argument', function() {
157 | app.flash.now.foo = 'bar';
158 | expect(context.flashNow('foo')).to.eql('bar');
159 | });
160 |
161 | it('sets a flash value when passed two arguments', function() {
162 | context.flashNow('foo2', 'bar2');
163 | expect(context.flashNow('foo2')).to.eql('bar2');
164 | });
165 | });
166 |
167 | describe('#app.flash.toHTML()', function() {
168 | beforeEach(function() {
169 | createAppsWithFlash();
170 | app.flash.clear();
171 | nowApp.flash.clear();
172 |
173 | app.flash.error = 'Boom!';
174 | app.flash.warn = 'Beep!';
175 | app.flash.now.info = 'Info!';
176 | nowApp.flash.debug = 'Debug!';
177 |
178 | output = $('')
179 | .append(app.flash.toHTML())
180 | .appendTo($('body'));
181 | });
182 |
183 | afterEach(function() {
184 | output.remove();
185 | });
186 |
187 | it('renders a ul.flash', function() {
188 | expect($('ul.flash', this.output)).to.have.length(1);
189 | });
190 |
191 | it('includes entries from both flash and flash.now, with keys as classes', function() {
192 | expect($('ul.flash li.error', this.output).text()).to.eql('Boom!');
193 | expect($('ul.flash li.warn', this.output).text()).to.eql('Beep!');
194 | expect($('ul.flash li.info', this.output).text()).to.eql('Info!');
195 | });
196 |
197 | it("does not include entries from another app's flash", function() {
198 | expect($('.debug', output)).to.have.length(0);
199 | });
200 | });
201 | });
202 |
--------------------------------------------------------------------------------
Hello!
55 | // 56 | // Hey, AQ! Welcome to Mustache! 57 | // 58 | // 59 | // ### Example #2 - Hogan partials 60 | // 61 | // The template (mytemplate.hg) 62 | // 63 | // Hey, {{name}}! {{>hello_friend}} 64 | // 65 | // 66 | // The partial (mypartial.hg) 67 | // 68 | // Say hello to your friend {{friend}}! 69 | // 70 | // The app: 71 | // 72 | // var app = $.sammy(function() { 73 | // // include the plugin and alias hogan() to hg() 74 | // this.use('Hogan', 'hg'); 75 | // 76 | // this.get('#/hello/:name/to/:friend', function(context) { 77 | // // fetch hogan-partial first 78 | // this.load('mypartial.hg') 79 | // .then(function(partial) { 80 | // // set local vars 81 | // context.partials = {hello_friend: partial}; 82 | // context.name = context.params.name; 83 | // context.friend = context.params.friend; 84 | // 85 | // // render the template and pass it through hogan 86 | // context.partial('mytemplate.hg'); 87 | // }); 88 | // }); 89 | // }); 90 | // 91 | // $(function() { 92 | // app.run() 93 | // }); 94 | // 95 | // If I go to #/hello/AQ/to/dP in the browser, Sammy will render this to the body: 96 | // 97 | // Hey, AQ! Say hello to your friend dP! 98 | // 99 | // Note: You dont have to include the hogan.js file on top of the plugin as the plugin 100 | // includes the full source. 101 | // 102 | Sammy.Hogan = function(app, method_alias) { 103 | var cached_templates = {}; 104 | 105 | // *Helper* Uses Hogan.js to parse a template and interpolate and work with the passed data 106 | // 107 | // ### Arguments 108 | // 109 | // * `template` A String template. {{}} Tags are evaluated and interpolated by Hogan.js 110 | // * `data` An Object containing the replacement values for the template. 111 | // data is extended with the EventContext allowing you to call its methods within the template. 112 | // * `partials` An Object containing one or more partials (String templates 113 | // that are called from the main template). 114 | // 115 | var hogan = function(template, data, partials) { 116 | var compiled_template = cached_templates[compiled_template]; 117 | if (!compiled_template){ 118 | compiled_template = Hogan.compile(template); 119 | } 120 | data = $.extend({}, this, data); 121 | partials = $.extend({}, data.partials, partials); 122 | return compiled_template.render(data, partials); 123 | }; 124 | 125 | // set the default method name/extension 126 | if (!method_alias) { method_alias = 'hogan'; } 127 | app.helper(method_alias, hogan); 128 | }; 129 | 130 | return Sammy.Hogan; 131 | 132 | })); 133 | -------------------------------------------------------------------------------- /lib/plugins/sammy.meld.js: -------------------------------------------------------------------------------- 1 | (function (factory) { 2 | if (typeof define === 'function' && define.amd) { 3 | define(['jquery', 'sammy'], factory); 4 | } else { 5 | (window.Sammy = window.Sammy || {}).Meld = factory(window.jQuery, window.Sammy); 6 | } 7 | }(function ($, Sammy) { 8 | 9 | // `Sammy.Meld` is a simple templating engine that uses the power of jQuery's 10 | // DOM manipulation to easily meld JSON data and HTML templates very quickly. 11 | // 12 | // The template can either be a string (i.e. loaded from a remote template) 13 | // or a DOM Element/jQuery object. This allows you to have templates be DOM 14 | // elements as the initial document load. 15 | // 16 | // ### Example 17 | // 18 | // The simplest case is a nested `` whose class name is tied to a
19 | // property of a JS object.
20 | //
21 | // Template:
22 | //
23 | //
24 | //
25 | //
26 | //
29 | //
30 | //
31 | // Data:
32 | //
33 | // {
34 | // "post": {
35 | // "title": "My Post",
36 | // "entry": "My Entry",
37 | // "author": {
38 | // "name": "@aq"
39 | // }
40 | // }
41 | // }
42 | //
43 | // Result:
44 | //
45 | //
46 | //
52 | //
53 | // Templates can be much more complex, and more deeply nested.
54 | // More examples can be found in `test/fixtures/meld/`
55 | //
56 | // If you don't think the lookup by classes is semantic for you, you can easily
57 | // switch the method of lookup by defining a selector function in the options
58 | //
59 | // For example:
60 | //
61 | // meld($('.post'), post_data, {
62 | // selector: function(k) {
63 | // return '[data-key=' + k + ']';
64 | // }
65 | // });
66 | //
67 | // Would look for template nodes like `My Post
47 | // My Entry
48 | //
51 | // `
68 | //
69 | Sammy.Meld = function(app, method_alias) {
70 | var default_options = {
71 | selector: function(k) { return '.' + k; },
72 | remove_false: true
73 | };
74 |
75 | var meld = function(template, data, options) {
76 | var $template = $(template);
77 |
78 | options = $.extend(default_options, options || {});
79 |
80 | if (typeof data === 'string') {
81 | $template.html(data);
82 | } else {
83 | $.each(data, function(key, value) {
84 | var selector = options.selector(key),
85 | $sub = $template.filter(selector),
86 | $container,
87 | $item,
88 | is_list = false,
89 | subindex = $template.index($sub);
90 |
91 | if ($sub.length === 0) { $sub = $template.find(selector); }
92 | if ($sub.length > 0) {
93 | if ($.isArray(value)) {
94 | $container = $('');
95 | if ($sub.is('ol, ul')) {
96 | is_list = true;
97 | $item = $sub.children('li:first');
98 | if ($item.length == 0) { $item = $(''); }
99 | } else if ($sub.children().length == 1) {
100 | is_list = true;
101 | $item = $sub.children(':first').clone();
102 | } else {
103 | $item = $sub.clone();
104 | }
105 | for (var i = 0; i < value.length; i++) {
106 | $container.append(meld($item.clone(), value[i], options));
107 | }
108 | if (is_list) {
109 | $sub.html($container.html());
110 | } else if ($sub[0] == $template[0]) {
111 | $template = $($container.html());
112 | } else if (subindex >= 0) {
113 | var args = [subindex, 1];
114 | args = args.concat($container.children().get());
115 | $template.splice.apply($template, args);
116 | }
117 | } else if (options.remove_false && value === false) {
118 | $template.splice(subindex, 1);
119 | } else if (typeof value === 'object') {
120 | if ($sub.is(':empty')) {
121 | $sub.attr(value, true);
122 | } else {
123 | $sub.html(meld($sub.html(), value, options));
124 | }
125 | } else {
126 | $sub.html(value.toString());
127 | }
128 | } else {
129 | $template.attr(key, value, true);
130 | }
131 | });
132 | }
133 | var dom = $template;
134 | return dom;
135 | };
136 |
137 | // set the default method name/extension
138 | if (!method_alias) method_alias = 'meld';
139 | // create the helper at the method alias
140 | app.helper(method_alias, meld);
141 |
142 | };
143 |
144 | return Sammy.Meld;
145 |
146 | }));
147 |
--------------------------------------------------------------------------------
/lib/plugins/sammy.handlebars.js:
--------------------------------------------------------------------------------
1 | (function (factory) {
2 | if (typeof define === 'function' && define.amd) {
3 | define(['jquery', 'sammy', 'handlebars'], factory);
4 | } else {
5 | (window.Sammy = window.Sammy || {}).Handlebars = factory(window.jQuery, window.Sammy);
6 | }
7 | }(function ($, Sammy, Handlebars) {
8 | // version 1.0.0 has no support for AMD but upwards does, this way we support both.
9 | Handlebars = Handlebars || window.Handlebars;
10 |
11 | // Sammy.Handlebars provides a quick way of using Handlebars templates in your app.
12 | //
13 | // Note: As of Sammy 0.7 Handlebars itself is not included in the source. Please download and
14 | // include handlebars.js before Sammy.Handlebars.
15 | //
16 | // Handlebars.js is an extension to the Mustache templating language created by Chris Wanstrath. Handlebars.js
17 | // and Mustache are both logicless templating languages that keep the view and the code separated like
18 | // we all know they should be.
19 | //
20 | // By default using Sammy.Handlbars in your app adds the handlebars() method to the EventContext
21 | // prototype. However, just like Sammy.Template you can change the default name of the method
22 | // by passing a second argument (e.g. you could use the hbr() as the method alias so that all the template
23 | // files could be in the form file.hbr instead of file.handlebars)
24 | //
25 | // ### Example #1
26 | //
27 | // The template (mytemplate.hb):
28 | //
29 | // {{title}}
"}, {escape_html: false});
116 | // });
117 | //
118 | Sammy.Template = function(app, method_alias) {
119 |
120 | // *Helper:* Uses simple templating to parse ERB like templates.
121 | //
122 | // ### Arguments
123 | //
124 | // * `template` A String template. '<% %>' tags are evaluated as Javascript and replaced with the elements in data.
125 | // * `data` An Object containing the replacement values for the template.
126 | // data is extended with the EventContext allowing you to call its methods within the template.
127 | // * `name` An optional String name to cache the template.
128 | //
129 | var template = function(template, data, name, options) {
130 | // use name for caching
131 | if (typeof name == 'undefined') { name = template; }
132 | if (typeof options == 'undefined' && typeof name == 'object') {
133 | options = name; name = template;
134 | }
135 | return srender(name, template, $.extend({}, this, data), options);
136 | };
137 |
138 | // set the default method name/extension
139 | if (!method_alias) { method_alias = 'template'; }
140 | // create the helper at the method alias
141 | app.helper(method_alias, template);
142 |
143 | };
144 |
145 | return Sammy.Template;
146 |
147 | }));
148 |
--------------------------------------------------------------------------------
/lib/plugins/sammy.oauth2.js:
--------------------------------------------------------------------------------
1 | (function (factory) {
2 | if (typeof define === 'function' && define.amd) {
3 | define(['jquery', 'sammy'], factory);
4 | } else {
5 | (window.Sammy = window.Sammy || {}).OAuth2 = factory(window.jQuery, window.Sammy);
6 | }
7 | }(function ($, Sammy) {
8 |
9 | // Sammy.OAuth2 is a plugin for using OAuth 2.0 to authenticate users and
10 | // access your application's API. Requires Sammy.Session.
11 | //
12 | // Triggers the following events:
13 | //
14 | // * `oauth.connected` - Access token set and ready to use. Triggered when new
15 | // access token acquired, of when application starts and already has access
16 | // token.
17 | // * `oauth.disconnected` - Access token reset. Triggered by
18 | // loseAccessToken().
19 | // * `oauth.denied` - Authorization attempt rejected.
20 | //
21 | // ### Example
22 | //
23 | // this.use('Storage');
24 | // this.use('OAuth2');
25 | // this.oauthorize = "/oauth/authorize";
26 | //
27 | // // The quick & easy way
28 | // this.requireOAuth();
29 | // // Specific path
30 | // this.requireOAuth("/private");
31 | // // Filter you can apply to specific URLs
32 | // this.before(function(context) { return context.requireOAuth(); })
33 | // // Apply to specific request
34 | // this.get("/private", function(context) {
35 | // this.requireOAuth(function() {
36 | // // Do something
37 | // });
38 | // });
39 | //
40 | // // Sign in/sign out.
41 | // this.bind("oauth.connected", function() { $("#signin").hide() });
42 | // this.bind("oauth.disconnected", function() { $("#signin").show() });
43 | //
44 | // // Handle access denied and other errors
45 | // this.bind("oauth.denied", function(evt, error) {
46 | // this.partial("admin/views/no_access.tmpl", { error: error.message });
47 | // });
48 | //
49 | // // Sign out.
50 | // this.get("#/signout", function(context) {
51 | // context.loseAccessToken();
52 | // context.redirect("#/");
53 | // });
54 | //
55 | Sammy.OAuth2 = function(app) {
56 | app.use('JSON');
57 | this.authorize = "/oauth/authorize";
58 |
59 | // Use this on request that require OAuth token. You can use this in a
60 | // filter: it will redirect and return false if the access token is missing.
61 | // You can use it in a route, it will redirect to get the access token, or
62 | // call the callback function if it has an access token.
63 | this.helper("requireOAuth", function(cb) {
64 | if (this.app.getAccessToken()) {
65 | if (cb) {
66 | cb.apply(this);
67 | }
68 | } else {
69 | this.redirect(this.app.authorize + "?state=" + escape(this.path));
70 | return false;
71 | }
72 | });
73 |
74 | // Use this to sign out.
75 | this.helper("loseAccessToken", function() {
76 | this.app.loseAccessToken();
77 | });
78 |
79 | // Use this in your application to require an OAuth access token on all, or
80 | // the specified paths. It sets up a before filter on the specified paths.
81 | this.requireOAuth = function(options) {
82 | this.before(options || {}, function(context) {
83 | return context.requireOAuth();
84 | });
85 | }
86 |
87 | // Returns the access token. Uses Sammy.Session to store the token.
88 | this.getAccessToken = function() {
89 | return this.session("oauth.token");
90 | }
91 | // Stores the access token in the session.
92 | this.setAccessToken = function(token) {
93 | this.session("oauth.token", token);
94 | this.trigger("oauth.connected");
95 | }
96 | // Lose access token: use this to sign out.
97 | this.loseAccessToken = function() {
98 | this.session("oauth.token", null);
99 | this.trigger("oauth.disconnected");
100 | }
101 |
102 | // Add OAuth 2.0 access token to all XHR requests.
103 | $(document).ajaxSend(function(evt, xhr) {
104 | var token = app.getAccessToken();
105 | if (token) {
106 | xhr.setRequestHeader("Authorization", "OAuth " + token);
107 | }
108 | });
109 |
110 | // Converts query string parameters in fragment identifier to object.
111 | function parseParams(path) {
112 | var hash = path.match(/#(.*)$/)[1];
113 | var pairs = hash.split("&"), params = {};
114 | var i, len = pairs.length;
115 |
116 | for (i = 0; i < len; i += 1) {
117 | var splat = pairs[i].split("=");
118 | params[splat[0]] = splat[1].replace(/\+/g, " ");
119 | }
120 | return params;
121 | }
122 |
123 | var start_url;
124 | // Capture the application's start URL, we'll need that later on for
125 | // redirection.
126 | this.bind("run", function(evt, params) {
127 | start_url = params.start_url || "#";
128 | if (this.app.getAccessToken()) {
129 | this.trigger("oauth.connected");
130 | }
131 | });
132 |
133 | // Intercept OAuth authorization response with access token, stores it and
134 | // redirects to original URL, or application root.
135 | this.before(/#(access_token=|[^\\].*\&access_token=)/, function(context) {
136 | var params = parseParams(context.path);
137 | this.app.setAccessToken(params.access_token);
138 | // When the filter redirected the original request, it passed the original
139 | // request's URL in the state parameter, which we get back after
140 | // authorization.
141 | context.redirect(params.state.length === 0 ? this.app.start_url : unescape(params.state));
142 | return false;
143 | }).get(/#(access_token=|[^\\].*\&access_token=)/, function(context) { });
144 |
145 | // Intercept OAuth authorization response with error (typically access
146 | // denied).
147 | this.before(/#(error=|[^\\].*\&error=)/, function(context) {
148 | var params = parseParams(context.path);
149 | var message = params.error_description || "Access denined";
150 | context.trigger("oauth.denied", { code: params.error, message: message });
151 | return false;
152 | }).get(/#(error=|[^\\].*\&error=)/, function(context) { });
153 |
154 | }
155 |
156 | return Sammy.OAuth2;
157 |
158 | }));
159 |
--------------------------------------------------------------------------------
/test/flash_spec.js:
--------------------------------------------------------------------------------
1 | describe('Flash', function() {
2 | var app, nowApp, context, output,
3 | createAppsWithFlash, unloadAppsWithFlash;
4 |
5 | createAppsWithFlash = function() {
6 | app = Sammy(function() {
7 | this.use(Sammy.Flash);
8 | this.element_selector = '#main';
9 |
10 | this.get('#/', function() {
11 | this.flash('welcome info', 'Welcome!');
12 | });
13 | this.post('#/test', function() {
14 | this.flash('info', "Successfully POSTed nested params");
15 | this.redirect('#/');
16 | });
17 | });
18 |
19 | nowApp = Sammy(function() {
20 | this.use(Sammy.Flash);
21 | this.element_selector = '#main2';
22 |
23 | this.get('#/', function() {
24 | this.flashNow('info', '您好');
25 | });
26 | this.post('#/test', function() {
27 | this.flashNow('warn', 'Uh-oh?');
28 | this.redirect('#/doNothing');
29 | });
30 | this.get('#/doNothing', function() {});
31 | });
32 | };
33 |
34 | unloadApps = function() {
35 | app.unload();
36 | nowApp.unload();
37 | window.location.href = '#/';
38 | };
39 |
40 | describe('app.flash', function() {
41 | beforeEach(createAppsWithFlash);
42 | afterEach(unloadApps);
43 |
44 | it('exists', function() {
45 | expect(app.flash).to.be.an(Object);
46 | });
47 |
48 | it('retains entries after a non-redirect', function() {
49 | app.run('#/');
50 | expect(app.flash['welcome info']).to.eql('Welcome!');
51 | });
52 |
53 | it('retains entries after a redirect', function() {
54 | $('#main').html('');
57 |
58 | app.run('#/');
59 | $('#test_form').submit();
60 | expect(app.flash['info']).to.eql("Successfully POSTed nested params");
61 | });
62 |
63 | it('loses all entries after being rendered', function() {
64 | app.run('#/');
65 | app.flash.toHTML();
66 | expect(app.flash['welcome info']).to.be(undefined);
67 | });
68 |
69 | it('retains entries after a redirect in another app', function() {
70 | $('#main2').html('');
73 |
74 | app.run('#/');
75 | nowApp.run('#/');
76 | $('#test_form').submit();
77 | expect(app.flash['welcome info']).to.eql('Welcome!');
78 | });
79 | });
80 |
81 | describe('app.flash.now', function() {
82 | beforeEach(createAppsWithFlash);
83 | afterEach(unloadApps);
84 |
85 | it('exists', function() {
86 | expect(nowApp.flash).to.be.an(Object);
87 | });
88 |
89 | it('retains entries after a non-redirect', function() {
90 | nowApp.run('#/');
91 | window.location.hash = '#/';
92 | expect(nowApp.flash.now.info).to.eql('您好');
93 | });
94 |
95 | it('loses all entries after a redirect', function() {
96 | $('#main').html('');
97 | $('#main2').html('');
100 |
101 | nowApp.run('#/');
102 | $('#test_form').submit();
103 | expect(nowApp.flash.now.warn).to.be(undefined);
104 | });
105 |
106 | it('loses all entries after being rendered', function() {
107 | nowApp.run('#/');
108 | nowApp.flash.toHTML();
109 | expect(nowApp.flash.now.info).to.be(undefined);
110 | });
111 |
112 | it('retains entries after a redirect in another app', function() {
113 | $('#main2').html('');
114 | $('#main').html('');
117 |
118 | app.run('#/');
119 | nowApp.run('#/');
120 | $('#test_form').submit();
121 | expect(nowApp.flash.now.info).to.eql('您好');
122 | });
123 | });
124 |
125 | describe('#flash()', function() {
126 | beforeEach(function() {
127 | createAppsWithFlash();
128 | context = new app.context_prototype(app, 'get', '#/', {});
129 | });
130 |
131 | it('returns the Flash object when passed no arguments', function() {
132 | expect(context.flash()).to.eql(app.flash);
133 | });
134 |
135 | it('returns the value of the given key when passed one argument', function() {
136 | app.flash.foo = 'bar';
137 | expect(context.flash('foo')).to.eql('bar');
138 | });
139 |
140 | it('sets a flash value when passed two arguments', function() {
141 | context.flash('foo2', 'bar2');
142 | expect(context.flash('foo2')).to.eql('bar2');
143 | });
144 | });
145 |
146 | describe('#flashNow()', function() {
147 | beforeEach(function() {
148 | createAppsWithFlash();
149 | context = new app.context_prototype(app, 'get', '#/', {});
150 | });
151 |
152 | it('returns the Flash-Now object when passed no arguments', function() {
153 | expect(context.flashNow()).to.eql(app.flash.now);
154 | });
155 |
156 | it('returns the value of the given key when passed one argument', function() {
157 | app.flash.now.foo = 'bar';
158 | expect(context.flashNow('foo')).to.eql('bar');
159 | });
160 |
161 | it('sets a flash value when passed two arguments', function() {
162 | context.flashNow('foo2', 'bar2');
163 | expect(context.flashNow('foo2')).to.eql('bar2');
164 | });
165 | });
166 |
167 | describe('#app.flash.toHTML()', function() {
168 | beforeEach(function() {
169 | createAppsWithFlash();
170 | app.flash.clear();
171 | nowApp.flash.clear();
172 |
173 | app.flash.error = 'Boom!';
174 | app.flash.warn = 'Beep!';
175 | app.flash.now.info = 'Info!';
176 | nowApp.flash.debug = 'Debug!';
177 |
178 | output = $('')
179 | .append(app.flash.toHTML())
180 | .appendTo($('body'));
181 | });
182 |
183 | afterEach(function() {
184 | output.remove();
185 | });
186 |
187 | it('renders a ul.flash', function() {
188 | expect($('ul.flash', this.output)).to.have.length(1);
189 | });
190 |
191 | it('includes entries from both flash and flash.now, with keys as classes', function() {
192 | expect($('ul.flash li.error', this.output).text()).to.eql('Boom!');
193 | expect($('ul.flash li.warn', this.output).text()).to.eql('Beep!');
194 | expect($('ul.flash li.info', this.output).text()).to.eql('Info!');
195 | });
196 |
197 | it("does not include entries from another app's flash", function() {
198 | expect($('.debug', output)).to.have.length(0);
199 | });
200 | });
201 | });
202 |
--------------------------------------------------------------------------------
{{title}}
30 | //
31 | // Hey, {{name}}! Welcome to Handlebars!
32 | //
33 | // The app:
34 | //
35 | // var app = $.sammy(function() {
36 | // // include the plugin and alias handlebars() to hb()
37 | // this.use('Handlebars', 'hb');
38 | //
39 | // this.get('#/hello/:name', function() {
40 | // // set local vars
41 | // this.title = 'Hello!'
42 | // this.name = this.params.name;
43 | // // render the template and pass it through handlebars
44 | // this.partial('mytemplate.hb');
45 | // });
46 | // });
47 | //
48 | // $(function() {
49 | // app.run()
50 | // });
51 | //
52 | // If I go to #/hello/AQ in the browser, Sammy will render this to the body:
53 | //
54 | // Hello!
55 | //
56 | // Hey, AQ! Welcome to Handlebars!
57 | //
58 | //
59 | // ### Example #2 - Handlebars partials
60 | //
61 | // The template (mytemplate.hb)
62 | //
63 | // Hey, {{name}}! {{>hello_friend}}
64 | //
65 | //
66 | // The partial (mypartial.hb)
67 | //
68 | // Say hello to your friend {{friend}}!
69 | //
70 | // The app:
71 | //
72 | // var app = $.sammy(function() {
73 | // // include the plugin and alias handlebars() to hb()
74 | // this.use('Handlebars', 'hb');
75 | //
76 | // this.get('#/hello/:name/to/:friend', function(context) {
77 | // // fetch handlebars-partial first
78 | // this.load('mypartial.hb')
79 | // .then(function(partial) {
80 | // // set local vars
81 | // context.partials = {hello_friend: partial};
82 | // context.name = context.params.name;
83 | // context.friend = context.params.friend;
84 | //
85 | // // render the template and pass it through handlebars
86 | // context.partial('mytemplate.hb');
87 | // });
88 | // });
89 | // });
90 | //
91 | // $(function() {
92 | // app.run()
93 | // });
94 | //
95 | // If I go to #/hello/AQ/to/dP in the browser, Sammy will render this to the body:
96 | //
97 | // Hey, AQ! Say hello to your friend dP!
98 | //
99 | // Note: You dont have to include the handlebars.js file on top of the plugin as the plugin
100 | // includes the full source.
101 | //
102 | Sammy.Handlebars = function(app, method_alias) {
103 | var handlebars_cache = {};
104 | // *Helper* Uses handlebars.js to parse a template and interpolate and work with the passed data
105 | //
106 | // ### Arguments
107 | //
108 | // * `template` A String template.
109 | // * `data` An Object containing the replacement values for the template.
110 | // data is extended with the EventContext allowing you to call its methods within the template.
111 | //
112 | var handlebars = function(template, data, partials, name) {
113 | // use name for caching
114 | if (typeof name == 'undefined') { name = template; }
115 | var fn = handlebars_cache[name];
116 | if (!fn) {
117 | fn = handlebars_cache[name] = Handlebars.compile(template);
118 | }
119 |
120 | data = $.extend({}, this, data);
121 | partials = $.extend({}, data.partials, partials);
122 |
123 | return fn(data, {"partials":partials});
124 | };
125 |
126 | // set the default method name/extension
127 | if (!method_alias) { method_alias = 'handlebars'; }
128 | app.helper(method_alias, handlebars);
129 | };
130 |
131 | return Sammy.Handlebars;
132 |
133 | }));
134 |
--------------------------------------------------------------------------------
/test/meld_spec.js:
--------------------------------------------------------------------------------
1 | describe('Meld', function() {
2 | var context;
3 |
4 | beforeEach(function() {
5 | var app = new Sammy.Application(function() {
6 | this.raise_errors = false;
7 | this.element_selector = '#main';
8 | this.use(Sammy.Meld);
9 | this.get('#/', function() {});
10 | });
11 |
12 | context = new app.context_prototype(app, 'get', '#/test/:test', {test: 'hooray'});
13 | });
14 |
15 | it('does simple interpolation', function() {
16 | var template = "";
17 | data = {'title': 'TEST'},
18 | expected = "TEST";
19 |
20 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
21 | });
22 |
23 | it('interpolates one level deep', function() {
24 | var template = "";
25 | data = {'post': {'title': 'TEST'}},
26 | expected = "TEST";
27 |
28 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
29 | });
30 |
31 | it('interpolates multiple keys', function() {
32 | var template = "";
33 | data = {'post': 'my post', 'title': 'TEST'},
34 | expected = "my postTEST";
35 |
36 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
37 | });
38 |
39 | it('interpolates multiple nested keys', function() {
40 | var template = "";
41 | data = {'post': {'title': 'TEST', 'author': 'AQ'}},
42 | expected = "TEST";
43 |
44 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
45 | });
46 |
47 | it('multiplies an array of tags', function() {
48 | var template = "";
49 | data = {'post': {'tags': ['one', 'two']}},
50 | expected = "";
51 |
52 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
53 | });
54 |
55 | it('multiplies an array of objects', function() {
56 | var template = "";
57 | data = {'post': {'authors': [{'name': 'AQ', 'twitter': 'aq'}, {'name':'Mike', 'twitter':'mrb_bk'}]}},
58 | expected = "";
59 |
60 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
61 | });
62 |
63 | it('multiplies an array on a list item', function() {
64 | var template = "";
65 | data = {'post': {'tags': ['one', 'two']}},
66 | expected = "";
67 |
68 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
69 | });
70 |
71 | it('multiplies an array on a list item using the example list item', function() {
72 | var template = "";
73 | data = {'post': {'tags': ['one', 'two']}},
74 | expected = "";
75 |
76 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
77 | });
78 |
79 | it('replaces attributes of elements as a fallback to class lookup', function() {
80 | var template = "",
81 | data = {'post': {'name': {'href': 'http://www.google.com', 'text': 'Link'}}},
82 | expected = "";
83 |
84 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
85 | });
86 |
87 | it('removes nodes if value is false', function() {
88 | var template = "Active",
89 | data = {'post': {'name': "My Name", 'active': false}},
90 | expected = "My Name
";
91 |
92 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
93 | });
94 |
95 | it('allows the setting of a selector function', function() {
96 | var template = "",
97 | data = {'post': {'name': "My Name"}},
98 | expected = "My Name
";
99 |
100 | expect(context.meld(template, data, {selector: function(k) {
101 | return "[rel='"+ k + "']";
102 | }})).to.have.sameHTMLAs(expected);
103 | });
104 |
105 | it('renders templates correctly', function(done) {
106 | var templates = 3;
107 |
108 | var getAndAssertTemplate = function(i) {
109 | var template, json, result;
110 | $.get('fixtures/meld/' + i + '.meld', function(t) {
111 | template = t;
112 | $.getJSON('fixtures/meld/' + i + '.json', function(j) {
113 | json = j;
114 | $.get('fixtures/meld/' + i + '.html', function(r) {
115 | expect(context.meld(template, json)).to.have.sameHTMLAs(r);
116 | if (i == templates) {
117 | done();
118 | } else {
119 | getAndAssertTemplate(i + 1);
120 | }
121 | });
122 | });
123 | });
124 | }
125 |
126 | getAndAssertTemplate(1);
127 | });
128 | });
129 |
--------------------------------------------------------------------------------
/lib/plugins/sammy.template.js:
--------------------------------------------------------------------------------
1 | (function (factory) {
2 | if (typeof define === 'function' && define.amd) {
3 | define(['jquery', 'sammy'], factory);
4 | } else {
5 | (window.Sammy = window.Sammy || {}).Template = factory(window.jQuery, window.Sammy);
6 | }
7 | }(function ($, Sammy) {
8 |
9 | // Simple JavaScript Templating
10 | // John Resig - http://ejohn.org/ - MIT Licensed
11 | // adapted from: http://ejohn.org/blog/javascript-micro-templating/
12 | // originally $.srender by Greg Borenstein http://ideasfordozens.com in Feb 2009
13 | // modified for Sammy by Aaron Quint for caching templates by name
14 | var srender_cache = {};
15 | var srender = function(name, template, data, options) {
16 | var fn, escaped_string;
17 | // target is an optional element; if provided, the result will be inserted into it
18 | // otherwise the result will simply be returned to the caller
19 | if (srender_cache[name]) {
20 | fn = srender_cache[name];
21 | } else {
22 | if (typeof template == 'undefined') {
23 | // was a cache check, return false
24 | return false;
25 | }
26 | // If options escape_html is false, dont escape the contents by default
27 | if (options && options.escape_html === false) {
28 | escaped_string = "\",$1,\"";
29 | } else {
30 | escaped_string = "\",h($1),\"";
31 | }
32 | // Generate a reusable function that will serve as a template
33 | // generator (and which will be cached).
34 | fn = srender_cache[name] = new Function("obj",
35 | "var ___$$$___=[],print=function(){___$$$___.push.apply(___$$$___,arguments);};" +
36 |
37 | // Introduce the data as local variables using with(){}
38 | "with(obj){___$$$___.push(\"" +
39 |
40 | // Convert the template into pure JavaScript
41 | String(template)
42 | .replace(/[\r\t\n]/g, " ")
43 | .replace(/\"/g, '\\"')
44 | .split("<%").join("\t")
45 | .replace(/((^|%>)[^\t]*)/g, "$1\r")
46 | .replace(/\t=(.*?)%>/g, escaped_string)
47 | .replace(/\t!(.*?)%>/g, "\",$1,\"")
48 | .split("\t").join("\");")
49 | .split("%>").join("___$$$___.push(\"")
50 | .split("\r").join("")
51 | + "\");}return ___$$$___.join('');");
52 | }
53 |
54 | if (typeof data != 'undefined') {
55 | return fn(data);
56 | } else {
57 | return fn;
58 | }
59 | };
60 |
61 | // `Sammy.Template` is a simple plugin that provides a way to create
62 | // and render client side templates. The rendering code is based on John Resig's
63 | // quick templates and Greg Borenstien's srender plugin.
64 | // This is also a great template/boilerplate for Sammy plugins.
65 | //
66 | // Templates use `<% %>` tags to denote embedded javascript.
67 | //
68 | // ### Examples
69 | //
70 | // Here is an example template (user.template):
71 | //
72 | // // user.template
73 | //
74 | // <%= user.name %>
75 | // <% if (user.photo_url) { %>
76 | //
77 | // <% } %>
78 | //
79 | //
80 | // Given that is a publicly accesible file, you would render it like:
81 | //
82 | // // app.js
83 | // $.sammy(function() {
84 | // // include the plugin
85 | // this.use('Template');
86 | //
87 | // this.get('#/', function() {
88 | // // the template is rendered in the current context.
89 | // this.user = {name: 'Aaron Quint'};
90 | // // partial calls template() because of the file extension
91 | // this.partial('user.template');
92 | // })
93 | // });
94 | //
95 | // You can also pass a second argument to use() that will alias the template
96 | // method and therefore allow you to use a different extension for template files
97 | // in partial()
98 | //
99 | // // alias to 'tpl'
100 | // this.use(Sammy.Template, 'tpl');
101 | //
102 | // // now .tpl files will be run through srender
103 | // this.get('#/', function() {
104 | // this.partial('myfile.tpl');
105 | // });
106 | //
107 | // By default, the data passed into the tempalate is passed automatically passed through
108 | // Sammy's `escapeHTML` method in order to prevent possible XSS attacks. This is
109 | // a problem though if you're using something like `Sammy.Form` which renders HTML
110 | // within the templates. You can get around this in two ways. One, you can use the
111 | // `<%! %>` instead of `<%= %>`. Two, you can pass the `escape_html = false` option
112 | // when interpolating, i.e:
113 | //
114 | // this.get('#/', function() {
115 | // this.template('myform.tpl', {form: "
"}, {escape_html: false});
116 | // });
117 | //
118 | Sammy.Template = function(app, method_alias) {
119 |
120 | // *Helper:* Uses simple templating to parse ERB like templates.
121 | //
122 | // ### Arguments
123 | //
124 | // * `template` A String template. '<% %>' tags are evaluated as Javascript and replaced with the elements in data.
125 | // * `data` An Object containing the replacement values for the template.
126 | // data is extended with the EventContext allowing you to call its methods within the template.
127 | // * `name` An optional String name to cache the template.
128 | //
129 | var template = function(template, data, name, options) {
130 | // use name for caching
131 | if (typeof name == 'undefined') { name = template; }
132 | if (typeof options == 'undefined' && typeof name == 'object') {
133 | options = name; name = template;
134 | }
135 | return srender(name, template, $.extend({}, this, data), options);
136 | };
137 |
138 | // set the default method name/extension
139 | if (!method_alias) { method_alias = 'template'; }
140 | // create the helper at the method alias
141 | app.helper(method_alias, template);
142 |
143 | };
144 |
145 | return Sammy.Template;
146 |
147 | }));
148 |
--------------------------------------------------------------------------------
/lib/plugins/sammy.oauth2.js:
--------------------------------------------------------------------------------
1 | (function (factory) {
2 | if (typeof define === 'function' && define.amd) {
3 | define(['jquery', 'sammy'], factory);
4 | } else {
5 | (window.Sammy = window.Sammy || {}).OAuth2 = factory(window.jQuery, window.Sammy);
6 | }
7 | }(function ($, Sammy) {
8 |
9 | // Sammy.OAuth2 is a plugin for using OAuth 2.0 to authenticate users and
10 | // access your application's API. Requires Sammy.Session.
11 | //
12 | // Triggers the following events:
13 | //
14 | // * `oauth.connected` - Access token set and ready to use. Triggered when new
15 | // access token acquired, of when application starts and already has access
16 | // token.
17 | // * `oauth.disconnected` - Access token reset. Triggered by
18 | // loseAccessToken().
19 | // * `oauth.denied` - Authorization attempt rejected.
20 | //
21 | // ### Example
22 | //
23 | // this.use('Storage');
24 | // this.use('OAuth2');
25 | // this.oauthorize = "/oauth/authorize";
26 | //
27 | // // The quick & easy way
28 | // this.requireOAuth();
29 | // // Specific path
30 | // this.requireOAuth("/private");
31 | // // Filter you can apply to specific URLs
32 | // this.before(function(context) { return context.requireOAuth(); })
33 | // // Apply to specific request
34 | // this.get("/private", function(context) {
35 | // this.requireOAuth(function() {
36 | // // Do something
37 | // });
38 | // });
39 | //
40 | // // Sign in/sign out.
41 | // this.bind("oauth.connected", function() { $("#signin").hide() });
42 | // this.bind("oauth.disconnected", function() { $("#signin").show() });
43 | //
44 | // // Handle access denied and other errors
45 | // this.bind("oauth.denied", function(evt, error) {
46 | // this.partial("admin/views/no_access.tmpl", { error: error.message });
47 | // });
48 | //
49 | // // Sign out.
50 | // this.get("#/signout", function(context) {
51 | // context.loseAccessToken();
52 | // context.redirect("#/");
53 | // });
54 | //
55 | Sammy.OAuth2 = function(app) {
56 | app.use('JSON');
57 | this.authorize = "/oauth/authorize";
58 |
59 | // Use this on request that require OAuth token. You can use this in a
60 | // filter: it will redirect and return false if the access token is missing.
61 | // You can use it in a route, it will redirect to get the access token, or
62 | // call the callback function if it has an access token.
63 | this.helper("requireOAuth", function(cb) {
64 | if (this.app.getAccessToken()) {
65 | if (cb) {
66 | cb.apply(this);
67 | }
68 | } else {
69 | this.redirect(this.app.authorize + "?state=" + escape(this.path));
70 | return false;
71 | }
72 | });
73 |
74 | // Use this to sign out.
75 | this.helper("loseAccessToken", function() {
76 | this.app.loseAccessToken();
77 | });
78 |
79 | // Use this in your application to require an OAuth access token on all, or
80 | // the specified paths. It sets up a before filter on the specified paths.
81 | this.requireOAuth = function(options) {
82 | this.before(options || {}, function(context) {
83 | return context.requireOAuth();
84 | });
85 | }
86 |
87 | // Returns the access token. Uses Sammy.Session to store the token.
88 | this.getAccessToken = function() {
89 | return this.session("oauth.token");
90 | }
91 | // Stores the access token in the session.
92 | this.setAccessToken = function(token) {
93 | this.session("oauth.token", token);
94 | this.trigger("oauth.connected");
95 | }
96 | // Lose access token: use this to sign out.
97 | this.loseAccessToken = function() {
98 | this.session("oauth.token", null);
99 | this.trigger("oauth.disconnected");
100 | }
101 |
102 | // Add OAuth 2.0 access token to all XHR requests.
103 | $(document).ajaxSend(function(evt, xhr) {
104 | var token = app.getAccessToken();
105 | if (token) {
106 | xhr.setRequestHeader("Authorization", "OAuth " + token);
107 | }
108 | });
109 |
110 | // Converts query string parameters in fragment identifier to object.
111 | function parseParams(path) {
112 | var hash = path.match(/#(.*)$/)[1];
113 | var pairs = hash.split("&"), params = {};
114 | var i, len = pairs.length;
115 |
116 | for (i = 0; i < len; i += 1) {
117 | var splat = pairs[i].split("=");
118 | params[splat[0]] = splat[1].replace(/\+/g, " ");
119 | }
120 | return params;
121 | }
122 |
123 | var start_url;
124 | // Capture the application's start URL, we'll need that later on for
125 | // redirection.
126 | this.bind("run", function(evt, params) {
127 | start_url = params.start_url || "#";
128 | if (this.app.getAccessToken()) {
129 | this.trigger("oauth.connected");
130 | }
131 | });
132 |
133 | // Intercept OAuth authorization response with access token, stores it and
134 | // redirects to original URL, or application root.
135 | this.before(/#(access_token=|[^\\].*\&access_token=)/, function(context) {
136 | var params = parseParams(context.path);
137 | this.app.setAccessToken(params.access_token);
138 | // When the filter redirected the original request, it passed the original
139 | // request's URL in the state parameter, which we get back after
140 | // authorization.
141 | context.redirect(params.state.length === 0 ? this.app.start_url : unescape(params.state));
142 | return false;
143 | }).get(/#(access_token=|[^\\].*\&access_token=)/, function(context) { });
144 |
145 | // Intercept OAuth authorization response with error (typically access
146 | // denied).
147 | this.before(/#(error=|[^\\].*\&error=)/, function(context) {
148 | var params = parseParams(context.path);
149 | var message = params.error_description || "Access denined";
150 | context.trigger("oauth.denied", { code: params.error, message: message });
151 | return false;
152 | }).get(/#(error=|[^\\].*\&error=)/, function(context) { });
153 |
154 | }
155 |
156 | return Sammy.OAuth2;
157 |
158 | }));
159 |
--------------------------------------------------------------------------------
/test/flash_spec.js:
--------------------------------------------------------------------------------
1 | describe('Flash', function() {
2 | var app, nowApp, context, output,
3 | createAppsWithFlash, unloadAppsWithFlash;
4 |
5 | createAppsWithFlash = function() {
6 | app = Sammy(function() {
7 | this.use(Sammy.Flash);
8 | this.element_selector = '#main';
9 |
10 | this.get('#/', function() {
11 | this.flash('welcome info', 'Welcome!');
12 | });
13 | this.post('#/test', function() {
14 | this.flash('info', "Successfully POSTed nested params");
15 | this.redirect('#/');
16 | });
17 | });
18 |
19 | nowApp = Sammy(function() {
20 | this.use(Sammy.Flash);
21 | this.element_selector = '#main2';
22 |
23 | this.get('#/', function() {
24 | this.flashNow('info', '您好');
25 | });
26 | this.post('#/test', function() {
27 | this.flashNow('warn', 'Uh-oh?');
28 | this.redirect('#/doNothing');
29 | });
30 | this.get('#/doNothing', function() {});
31 | });
32 | };
33 |
34 | unloadApps = function() {
35 | app.unload();
36 | nowApp.unload();
37 | window.location.href = '#/';
38 | };
39 |
40 | describe('app.flash', function() {
41 | beforeEach(createAppsWithFlash);
42 | afterEach(unloadApps);
43 |
44 | it('exists', function() {
45 | expect(app.flash).to.be.an(Object);
46 | });
47 |
48 | it('retains entries after a non-redirect', function() {
49 | app.run('#/');
50 | expect(app.flash['welcome info']).to.eql('Welcome!');
51 | });
52 |
53 | it('retains entries after a redirect', function() {
54 | $('#main').html('');
57 |
58 | app.run('#/');
59 | $('#test_form').submit();
60 | expect(app.flash['info']).to.eql("Successfully POSTed nested params");
61 | });
62 |
63 | it('loses all entries after being rendered', function() {
64 | app.run('#/');
65 | app.flash.toHTML();
66 | expect(app.flash['welcome info']).to.be(undefined);
67 | });
68 |
69 | it('retains entries after a redirect in another app', function() {
70 | $('#main2').html('');
73 |
74 | app.run('#/');
75 | nowApp.run('#/');
76 | $('#test_form').submit();
77 | expect(app.flash['welcome info']).to.eql('Welcome!');
78 | });
79 | });
80 |
81 | describe('app.flash.now', function() {
82 | beforeEach(createAppsWithFlash);
83 | afterEach(unloadApps);
84 |
85 | it('exists', function() {
86 | expect(nowApp.flash).to.be.an(Object);
87 | });
88 |
89 | it('retains entries after a non-redirect', function() {
90 | nowApp.run('#/');
91 | window.location.hash = '#/';
92 | expect(nowApp.flash.now.info).to.eql('您好');
93 | });
94 |
95 | it('loses all entries after a redirect', function() {
96 | $('#main').html('');
97 | $('#main2').html('');
100 |
101 | nowApp.run('#/');
102 | $('#test_form').submit();
103 | expect(nowApp.flash.now.warn).to.be(undefined);
104 | });
105 |
106 | it('loses all entries after being rendered', function() {
107 | nowApp.run('#/');
108 | nowApp.flash.toHTML();
109 | expect(nowApp.flash.now.info).to.be(undefined);
110 | });
111 |
112 | it('retains entries after a redirect in another app', function() {
113 | $('#main2').html('');
114 | $('#main').html('');
117 |
118 | app.run('#/');
119 | nowApp.run('#/');
120 | $('#test_form').submit();
121 | expect(nowApp.flash.now.info).to.eql('您好');
122 | });
123 | });
124 |
125 | describe('#flash()', function() {
126 | beforeEach(function() {
127 | createAppsWithFlash();
128 | context = new app.context_prototype(app, 'get', '#/', {});
129 | });
130 |
131 | it('returns the Flash object when passed no arguments', function() {
132 | expect(context.flash()).to.eql(app.flash);
133 | });
134 |
135 | it('returns the value of the given key when passed one argument', function() {
136 | app.flash.foo = 'bar';
137 | expect(context.flash('foo')).to.eql('bar');
138 | });
139 |
140 | it('sets a flash value when passed two arguments', function() {
141 | context.flash('foo2', 'bar2');
142 | expect(context.flash('foo2')).to.eql('bar2');
143 | });
144 | });
145 |
146 | describe('#flashNow()', function() {
147 | beforeEach(function() {
148 | createAppsWithFlash();
149 | context = new app.context_prototype(app, 'get', '#/', {});
150 | });
151 |
152 | it('returns the Flash-Now object when passed no arguments', function() {
153 | expect(context.flashNow()).to.eql(app.flash.now);
154 | });
155 |
156 | it('returns the value of the given key when passed one argument', function() {
157 | app.flash.now.foo = 'bar';
158 | expect(context.flashNow('foo')).to.eql('bar');
159 | });
160 |
161 | it('sets a flash value when passed two arguments', function() {
162 | context.flashNow('foo2', 'bar2');
163 | expect(context.flashNow('foo2')).to.eql('bar2');
164 | });
165 | });
166 |
167 | describe('#app.flash.toHTML()', function() {
168 | beforeEach(function() {
169 | createAppsWithFlash();
170 | app.flash.clear();
171 | nowApp.flash.clear();
172 |
173 | app.flash.error = 'Boom!';
174 | app.flash.warn = 'Beep!';
175 | app.flash.now.info = 'Info!';
176 | nowApp.flash.debug = 'Debug!';
177 |
178 | output = $('')
179 | .append(app.flash.toHTML())
180 | .appendTo($('body'));
181 | });
182 |
183 | afterEach(function() {
184 | output.remove();
185 | });
186 |
187 | it('renders a ul.flash', function() {
188 | expect($('ul.flash', this.output)).to.have.length(1);
189 | });
190 |
191 | it('includes entries from both flash and flash.now, with keys as classes', function() {
192 | expect($('ul.flash li.error', this.output).text()).to.eql('Boom!');
193 | expect($('ul.flash li.warn', this.output).text()).to.eql('Beep!');
194 | expect($('ul.flash li.info', this.output).text()).to.eql('Info!');
195 | });
196 |
197 | it("does not include entries from another app's flash", function() {
198 | expect($('.debug', output)).to.have.length(0);
199 | });
200 | });
201 | });
202 |
--------------------------------------------------------------------------------
Hello!
55 | // 56 | // Hey, AQ! Welcome to Handlebars! 57 | // 58 | // 59 | // ### Example #2 - Handlebars partials 60 | // 61 | // The template (mytemplate.hb) 62 | // 63 | // Hey, {{name}}! {{>hello_friend}} 64 | // 65 | // 66 | // The partial (mypartial.hb) 67 | // 68 | // Say hello to your friend {{friend}}! 69 | // 70 | // The app: 71 | // 72 | // var app = $.sammy(function() { 73 | // // include the plugin and alias handlebars() to hb() 74 | // this.use('Handlebars', 'hb'); 75 | // 76 | // this.get('#/hello/:name/to/:friend', function(context) { 77 | // // fetch handlebars-partial first 78 | // this.load('mypartial.hb') 79 | // .then(function(partial) { 80 | // // set local vars 81 | // context.partials = {hello_friend: partial}; 82 | // context.name = context.params.name; 83 | // context.friend = context.params.friend; 84 | // 85 | // // render the template and pass it through handlebars 86 | // context.partial('mytemplate.hb'); 87 | // }); 88 | // }); 89 | // }); 90 | // 91 | // $(function() { 92 | // app.run() 93 | // }); 94 | // 95 | // If I go to #/hello/AQ/to/dP in the browser, Sammy will render this to the body: 96 | // 97 | // Hey, AQ! Say hello to your friend dP! 98 | // 99 | // Note: You dont have to include the handlebars.js file on top of the plugin as the plugin 100 | // includes the full source. 101 | // 102 | Sammy.Handlebars = function(app, method_alias) { 103 | var handlebars_cache = {}; 104 | // *Helper* Uses handlebars.js to parse a template and interpolate and work with the passed data 105 | // 106 | // ### Arguments 107 | // 108 | // * `template` A String template. 109 | // * `data` An Object containing the replacement values for the template. 110 | // data is extended with the EventContext allowing you to call its methods within the template. 111 | // 112 | var handlebars = function(template, data, partials, name) { 113 | // use name for caching 114 | if (typeof name == 'undefined') { name = template; } 115 | var fn = handlebars_cache[name]; 116 | if (!fn) { 117 | fn = handlebars_cache[name] = Handlebars.compile(template); 118 | } 119 | 120 | data = $.extend({}, this, data); 121 | partials = $.extend({}, data.partials, partials); 122 | 123 | return fn(data, {"partials":partials}); 124 | }; 125 | 126 | // set the default method name/extension 127 | if (!method_alias) { method_alias = 'handlebars'; } 128 | app.helper(method_alias, handlebars); 129 | }; 130 | 131 | return Sammy.Handlebars; 132 | 133 | })); 134 | -------------------------------------------------------------------------------- /test/meld_spec.js: -------------------------------------------------------------------------------- 1 | describe('Meld', function() { 2 | var context; 3 | 4 | beforeEach(function() { 5 | var app = new Sammy.Application(function() { 6 | this.raise_errors = false; 7 | this.element_selector = '#main'; 8 | this.use(Sammy.Meld); 9 | this.get('#/', function() {}); 10 | }); 11 | 12 | context = new app.context_prototype(app, 'get', '#/test/:test', {test: 'hooray'}); 13 | }); 14 | 15 | it('does simple interpolation', function() { 16 | var template = ""; 17 | data = {'title': 'TEST'}, 18 | expected = "TEST
";
19 |
20 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
21 | });
22 |
23 | it('interpolates one level deep', function() {
24 | var template = "";
25 | data = {'post': {'title': 'TEST'}},
26 | expected = "
TEST
my post
TEST
";
35 |
36 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
37 | });
38 |
39 | it('interpolates multiple nested keys', function() {
40 | var template = "";
41 | data = {'post': {'title': 'TEST', 'author': 'AQ'}},
42 | expected = "
TEST
";
49 | data = {'post': {'tags': ['one', 'two']}},
50 | expected = "
";
51 |
52 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
53 | });
54 |
55 | it('multiplies an array of objects', function() {
56 | var template = "
";
57 | data = {'post': {'authors': [{'name': 'AQ', 'twitter': 'aq'}, {'name':'Mike', 'twitter':'mrb_bk'}]}},
58 | expected = "
";
59 |
60 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
61 | });
62 |
63 | it('multiplies an array on a list item', function() {
64 | var template = "
";
65 | data = {'post': {'tags': ['one', 'two']}},
66 | expected = "
";
67 |
68 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
69 | });
70 |
71 | it('multiplies an array on a list item using the example list item', function() {
72 | var template = "
";
73 | data = {'post': {'tags': ['one', 'two']}},
74 | expected = "
";
75 |
76 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
77 | });
78 |
79 | it('replaces attributes of elements as a fallback to class lookup', function() {
80 | var template = "",
81 | data = {'post': {'name': {'href': 'http://www.google.com', 'text': 'Link'}}},
82 | expected = "";
83 |
84 | expect(context.meld(template, data)).to.have.sameHTMLAs(expected);
85 | });
86 |
87 | it('removes nodes if value is false', function() {
88 | var template = "
Active
",
89 | data = {'post': {'name': "My Name", 'active': false}},
90 | expected = "My Name
",
97 | data = {'post': {'name': "My Name"}},
98 | expected = "
My Name
74 | //
77 | // <% } %>
78 | //
79 | //
80 | // Given that is a publicly accesible file, you would render it like:
81 | //
82 | // // app.js
83 | // $.sammy(function() {
84 | // // include the plugin
85 | // this.use('Template');
86 | //
87 | // this.get('#/', function() {
88 | // // the template is rendered in the current context.
89 | // this.user = {name: 'Aaron Quint'};
90 | // // partial calls template() because of the file extension
91 | // this.partial('user.template');
92 | // })
93 | // });
94 | //
95 | // You can also pass a second argument to use() that will alias the template
96 | // method and therefore allow you to use a different extension for template files
97 | // in partial()
98 | //
99 | // // alias to 'tpl'
100 | // this.use(Sammy.Template, 'tpl');
101 | //
102 | // // now .tpl files will be run through srender
103 | // this.get('#/', function() {
104 | // this.partial('myfile.tpl');
105 | // });
106 | //
107 | // By default, the data passed into the tempalate is passed automatically passed through
108 | // Sammy's `escapeHTML` method in order to prevent possible XSS attacks. This is
109 | // a problem though if you're using something like `Sammy.Form` which renders HTML
110 | // within the templates. You can get around this in two ways. One, you can use the
111 | // `<%! %>` instead of `<%= %>`. Two, you can pass the `escape_html = false` option
112 | // when interpolating, i.e:
113 | //
114 | // this.get('#/', function() {
115 | // this.template('myform.tpl', {form: "<%= user.name %>
75 | // <% if (user.photo_url) { %>
76 | //