booster 0.0.1

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+pkg/*
+test/dummy/tmp
+test/dummy/log/*

data/Gemfile

@@ -0,0 +1,7 @@
+source 'http://rubygems.org'
+
+# Gem dependencies specified in booster.gemspec
+gemspec
+
+# jquery-rails is used by the dummy application
+gem 'jquery-rails'

data/Gemfile.lock

@@ -0,0 +1,106 @@
+PATH
+  remote: .
+  specs:
+    booster (0.0.1)
+      execjs
+      tilt
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    actionmailer (3.1.3)
+      actionpack (= 3.1.3)
+      mail (~> 2.3.0)
+    actionpack (3.1.3)
+      activemodel (= 3.1.3)
+      activesupport (= 3.1.3)
+      builder (~> 3.0.0)
+      erubis (~> 2.7.0)
+      i18n (~> 0.6)
+      rack (~> 1.3.5)
+      rack-cache (~> 1.1)
+      rack-mount (~> 0.8.2)
+      rack-test (~> 0.6.1)
+      sprockets (~> 2.0.3)
+    activemodel (3.1.3)
+      activesupport (= 3.1.3)
+      builder (~> 3.0.0)
+      i18n (~> 0.6)
+    activerecord (3.1.3)
+      activemodel (= 3.1.3)
+      activesupport (= 3.1.3)
+      arel (~> 2.2.1)
+      tzinfo (~> 0.3.29)
+    activeresource (3.1.3)
+      activemodel (= 3.1.3)
+      activesupport (= 3.1.3)
+    activesupport (3.1.3)
+      multi_json (~> 1.0)
+    arel (2.2.1)
+    builder (3.0.0)
+    erubis (2.7.0)
+    execjs (1.2.12)
+      multi_json (~> 1.0)
+    hike (1.2.1)
+    i18n (0.6.0)
+    jquery-rails (1.0.19)
+      railties (~> 3.0)
+      thor (~> 0.14)
+    json (1.6.3)
+    libv8 (3.3.10.4)
+    mail (2.3.0)
+      i18n (>= 0.4.0)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    mime-types (1.17.2)
+    multi_json (1.0.4)
+    polyglot (0.3.3)
+    rack (1.3.5)
+    rack-cache (1.1)
+      rack (>= 0.4)
+    rack-mount (0.8.3)
+      rack (>= 1.0.0)
+    rack-ssl (1.3.2)
+      rack
+    rack-test (0.6.1)
+      rack (>= 1.0)
+    rails (3.1.3)
+      actionmailer (= 3.1.3)
+      actionpack (= 3.1.3)
+      activerecord (= 3.1.3)
+      activeresource (= 3.1.3)
+      activesupport (= 3.1.3)
+      bundler (~> 1.0)
+      railties (= 3.1.3)
+    railties (3.1.3)
+      actionpack (= 3.1.3)
+      activesupport (= 3.1.3)
+      rack-ssl (~> 1.3.2)
+      rake (>= 0.8.7)
+      rdoc (~> 3.4)
+      thor (~> 0.14.6)
+    rake (0.9.2.2)
+    rdoc (3.11)
+      json (~> 1.4)
+    sprockets (2.0.3)
+      hike (~> 1.2)
+      rack (~> 1.0)
+      tilt (~> 1.1, != 1.3.0)
+    therubyracer (0.9.9)
+      libv8 (~> 3.3.10)
+    thor (0.14.6)
+    tilt (1.3.3)
+    treetop (1.4.10)
+      polyglot
+      polyglot (>= 0.3.1)
+    tzinfo (0.3.31)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  booster!
+  jquery-rails
+  rails (~> 3.1.0)
+  rake
+  therubyracer

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2011 Redstone Handelsbolag
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,174 @@
+> Note that this project is very new and hardly usable for anything.
+> The documentation is just started and will be up-to-date before
+> the end of 2011.
+
+## What is it?
+
+Booster is a RubyGem with support for writing rich client applications using
+Backbone.js and Handlebars.js. It integrates with the Rails Asset Pipeline
+in a somewhat peculiar way:
+
+* Booster assets have the `.boost` extension and can contain both
+  JavaScript and Handlebars markup __in the same file__. Handlebars templates
+  are compiled to JavaScript functions inline during processing. A TextMate
+  bundle supporting both languages in the same file is included.
+* Each processed asset is wrapped in a CommonJS-like API inspired by
+  [this Gist](https://gist.github.com/1153919) so that each asset
+  essentially becomes a module closure that can be required by other modules.
+* Booster assets support string interpolation as a language addon to JavaScript.
+
+In addition to the Asset Pipeline processor, Booster supplies a set of
+assets of its own that can be used in your applications. This includes
+support functionality on top of Backbone.js and Handlebars.js that you
+can choose to user or extend from rather than the stock Backbone types. This
+is explained in more detail below, and can be opted out.
+
+## Usage
+
+Include the Booster gem in your Gemfile:
+
+**Gemfile:**
+
+    group :assets do
+      gem 'booster'
+    end
+
+Require Booster in your application asset manifest which, in turn, will
+include Underscore.js, Backbone.js, and Handlebars.js (only the runtime part),
+on which Booster depends. You also need to require jQuery (supplied by Rails) before
+requiring Booster (or have it included on page from CDN before including Booster).
+
+**app/assets/javascript/application.js:**
+
+    //= require jquery
+    //= require booster
+
+The `booster` asset is the full package, including additional functionality for Backbone
+and Handlebars which you may not need. If you only need the core Booster functionality
+which includes module support and the Backbone and Handlebars dependencies, require
+the core asset instead:
+
+**app/assets/javascript/application.js:**
+
+    //= require jquery
+    //= require booster-core
+
+## Example
+
+The `app/assets/javascripts/views/user.js.boost` asset below exports
+two Backbone views, `Show` and `Edit`, used for dealing with user models.
+In this example, both views are defined in the same module and the templates used by the
+views are defined in the same file, similar to what is
+[possible in Sinatra](http://www.sinatrarb.com/intro#Inline%20Templates)
+
+**app/assets/javascripts/views/user.js.boost:**
+
+```javascript
+exports.Show = Backbone.View.extend({
+  /* ... */
+
+  render: function() {
+    $(this.el).html(show(this.model));
+  }
+
+  /* ... */
+});
+
+exports.Edit = Backbone.View.extend({
+  /* ... */
+  
+  render: function() {
+    $(this.el).html(edit(this.model));
+  }
+
+  /* ... */
+})
+
+@@ show
+  <h2>{{firstName}} {{lastName}}</h2>
+  <pre>{{address}}</pre>
+  ...
+
+@@ edit
+  <input name="firstName" value="{{firstName}}"/>
+  <textarea name="firstName">{{address}}</textarea>
+```
+
+If templates are included in an asset they are to be placed at the bottom of the
+file. Each template is compiled to a JavaScript function with the same name
+as the `@@ identifier` and can be invoked directly from anywhere in the module as
+can be seen in the `render()` functions above.
+
+To use this module, say from a router, you require it like a regular CommonJS module.
+
+**app/assets/javascripts/routers/user.js.boost:**
+
+```javascript
+var views = require('../models/user');
+
+exports = Backbone.Router.extend({
+  routes: {
+    '/users/:id':      'show',
+    '/users/:id/edit': 'edit'
+  }
+
+  show: function(id) {
+    var view = new views.Show({
+      model: /* load model */
+    });
+    /* add view to layout */
+  },
+
+  edit: function(id) {
+    var view = new views.Edit({
+      model: /* load model */
+    });
+    /* add view to layout */
+  }
+});
+```
+
+## Support Functionality
+
+Booster includes some support functionality that we often use in our own applications. In most cases
+this comes in form of JavaScript mixins that you can use directly on your code as well as Handlebars
+helpers that you can use from your templates.
+
+This support is included by default in the `//= require booster` directive described in __Usage__ above.
+So if you required the full Booster bundle you are set. If you have `//= require`'d `booster-core` which does
+not include the extra support you can add the support on top of core:
+
+**app/assets/javascript/application.js:**
+
+    //= require jquery
+    //= require booster-core
+    //= require booster-support
+
+We might introduce additional Booster assets in the future which can be optionally required in the same way.
+
+### Schema
+
+> To be described
+
+### I18N
+
+> To be described
+
+## Rails 3 Generators
+
+> To be described
+
+We are working on a set of Rails 3 generators that can be used to speed up development. Using these
+generators you can create models, views, and routers, or complete scaffolds using the following
+commands:
+
+    > rails g booster:model Discussion
+    > rails g booster:view Discussion [index [show [edit]]]
+    > rails g booster:router Discussion
+    > rails g booster:scaffold Discussion
+
+This will generate Booster modules for each type of artefact with a skeleton implementation to get
+you going quickly. It will also generate specs based on the Jasmine BDD library. This not only gives
+you a productivity boost but can also help establish a coding style in a project with many developers.
+To customize the templates used when creating the artefacts, just fork Booster on GitHub and
+edit the templates in `lib/generators` and include your updated Gem directly from GitHub in your Gemfile.

data/Rakefile

@@ -0,0 +1,7 @@
+require "bundler/gem_tasks"
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+  t.test_files = FileList['test/**/*_test.rb']
+end

data/booster.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path('../lib', __FILE__)
+require 'booster/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'booster'
+  s.version     = Booster::VERSION.dup
+  s.authors     = ['Redstone Handelsbolag']
+  s.email       = ['support@redstone.eu']
+  s.homepage    = 'http://github.com/gregerolsson/booster'
+  s.summary     = 'Wrapper library for Backbone.js'
+  s.description = 'Integrates with Rails 3.x Asset Pipeline with some Backbone.js support'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ['lib']
+
+  s.add_runtime_dependency     'execjs'
+  s.add_runtime_dependency     'tilt'
+  s.add_development_dependency 'rails', '~> 3.1.0'
+  s.add_development_dependency 'therubyracer'
+  s.add_development_dependency 'rake'
+end

data/booster.tmbundle/Snippets/untitled.tmSnippet

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>content</key>
+	<string>require('$1')</string>
+	<key>name</key>
+	<string>untitled</string>
+	<key>tabTrigger</key>
+	<string>re</string>
+	<key>uuid</key>
+	<string>6F743ED2-C24E-461D-937D-264A643D3724</string>
+</dict>
+</plist>

data/booster.tmbundle/Syntaxes/Booster.tmLanguage

@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>fileTypes</key>
+	<array>
+		<string>boost</string>
+	</array>
+	<key>name</key>
+	<string>Booster</string>
+	<key>patterns</key>
+	<array>
+		<dict>
+			<key>begin</key>
+			<string>(@@\s*([A-Za-z0-9]*))\n</string>
+			<key>beginCaptures</key>
+			<dict>
+				<key>0</key>
+				<dict>
+					<key>name</key>
+					<string>storage</string>
+				</dict>
+			</dict>
+			<key>end</key>
+			<string>(?=@@)</string>
+			<key>name</key>
+			<string>source.js.booster.embedded.mustache</string>
+			<key>patterns</key>
+			<array>
+				<dict>
+					<key>include</key>
+					<string>text.html.mustache</string>
+				</dict>
+			</array>
+		</dict>
+		<dict>
+			<key>include</key>
+			<string>source.js</string>
+		</dict>
+	</array>
+	<key>scopeName</key>
+	<string>source.js.booster</string>
+	<key>uuid</key>
+	<string>A53A6C6F-4F49-41BE-B15C-B1165E1766FC</string>
+</dict>
+</plist>

data/booster.tmbundle/info.plist

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>name</key>
+	<string>Booster</string>
+	<key>uuid</key>
+	<string>5E2B4915-CD6D-4394-8C53-95421BA02D63</string>
+</dict>
+</plist>

data/lib/assets/javascripts/booster-core.js

@@ -0,0 +1,5 @@
+//= require stitch
+//= require underscore
+//= require backbone
+//= require handlebars-vm
+//= require handlebars-helpers

data/lib/assets/javascripts/booster-support.js

@@ -0,0 +1 @@
+//= require_tree ./booster

data/lib/assets/javascripts/booster.js

@@ -0,0 +1,2 @@
+//= require ./booster-core
+//= require ./booster-support

data/lib/assets/javascripts/booster/collection.js.boost

@@ -0,0 +1 @@
+// To be defined

data/lib/assets/javascripts/booster/model.js.boost

@@ -0,0 +1,30 @@
+var schema = require('./support/schema');
+
+/**
+ * Extension of {Backbone.Model} which includes various Booster features
+ * functionality like schema support. An application can choose to extend
+ * its models from this constructor rather than {Backbone.Model} or it
+ * may use the corresponding mixins like this extension does.
+ *
+ * @extends {Backbone.Model}
+ * @constructor
+ */
+
+exports.Model = Backbone.Model.extend({
+  
+});
+
+_.extend(exports.Model.prototype, schema.mixin());
+
+/**
+ * Although empty, it may be a good idea to extend from this type instead
+ * if we introduce functionality in the future which works together with
+ * {exports.Model}.
+ *
+ * @extends {Backbone.Collection}
+ * @constructor
+ */
+
+exports.Collection = Backbone.Collection.extend({
+  
+});