ember-rails-lite 0.8.0

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2012 Keith Pitt, Rob Monie, Joao Carlos, Paul Chavard and ember-rails contributors
+
+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,114 @@
+# ember-rails  [![Build Status](https://secure.travis-ci.org/emberjs/ember-rails.png?branch=master)](http://travis-ci.org/emberjs/ember-rails) [![Dependency Status](https://gemnasium.com/emberjs/ember-rails.png)](https://gemnasium.com/emberjs/ember-rails)
+
+ember-rails allows you to include [Ember.JS](http://emberjs.com/) into your Rails 3.1+ application.
+
+The gem will also pre-compile your handlebars templates when building your asset pipeline. It includes development and production copies of Ember.
+
+You can see an example of how to use the gem [here](https://github.com/keithpitt/ember-rails-example). There is also a great tutorial by [Dan Gebhardt](https://twitter.com/#!/dgeb) called "[Beginning Ember.js on Rails](http://www.cerebris.com/blog/2012/01/24/beginning-ember-js-on-rails-part-1/)" which is a great read if your just starting out with Rails and Ember.js
+
+## Getting started
+
+Add the gem to your application Gemfile:
+
+    gem "ember-rails"
+
+Run `bundle install` and add the following line to `app/assets/javascripts/application.js`:
+
+    //= require ember
+
+Ember-rails will use the production build of Ember.js when Rails is running in
+production mode, and the development build otherwise.
+
+## Architecture
+
+Ember does not require an organized file structure. However, ember-rails allows you 
+to use `rails g ember:bootstrap` to create the following directory structure under `app/assets/javascripts`:
+
+    controllers/
+    helpers/
+    models/
+    routes/
+    templates/
+    views/
+
+Additionally, it will add the following lines to `app/assets/javascripts/application.js`.
+By default, it uses the Rails Application's name and creates an `rails_app_name.js` 
+file to setup application namespace and initial requires:
+
+    //= require ember
+    //= require ember/app
+
+*Example:*
+
+    rails g ember:bootstrap
+      insert  app/assets/javascripts/application.js
+      create  app/assets/javascripts/models
+      create  app/assets/javascripts/models/.gitkeep
+      create  app/assets/javascripts/controllers
+      create  app/assets/javascripts/controllers/.gitkeep
+      create  app/assets/javascripts/views
+      create  app/assets/javascripts/views/.gitkeep
+      create  app/assets/javascripts/helpers
+      create  app/assets/javascripts/helpers/.gitkeep
+      create  app/assets/javascripts/templates
+      create  app/assets/javascripts/templates/.gitkeep
+      create  app/assets/javascripts/app.js
+
+If you want to avoid `.gitkeep` files, use the `skip git` option like
+this: `rails g ember:bootstrap -g`.
+
+Ask Rails to serve HandlebarsJS and pre-compile templates to Ember
+by putting each template in a dedicated ".js.hjs", ".hbs" or ".handlebars" file
+(e.g. `app/assets/javascripts/templates/admin_panel.handlebars`)
+and including the assets in your layout:
+
+    <%= javascript_include_tag "templates/admin_panel" %>
+
+If you want to strip template root from template names, add `templates_root` option to your application configuration block :
+
+    config.handlebars.templates_root = 'templates'
+
+The result will be like this :
+
+    Ember.TEMPLATES['admin_panel'] = "...";
+
+If you want a different path separator in template names add `templates_path_separator` option to your application configuration block :
+
+    config.handlebars.templates_path_separator = '-'
+
+The result will be like this :
+
+    Ember.TEMPLATES['templates-admin_panel'] = "...";
+
+Default behavior for ember-rails is to precompile handlebars templates only in production environment.
+If you don't want this behavior you can turn it off in your application configuration block :
+
+    config.handlebars.precompile = false
+
+Bundle all templates together thanks to Sprockets,
+e.g create `app/assets/javascripts/templates/all.js` with:
+
+    //= require_tree .
+
+Now a single line in the layout loads everything:
+
+    <%= javascript_include_tag "templates/all" %>
+
+If you use Slim or Haml templates, you can use handlebars filter :
+
+    :handlebars
+        {{#view Ember.Button}}OK{{/view}}
+
+It will be translated as :
+
+    <script type="text/x-handlebars">
+        {{#view Ember.Button}}OK{{/view}}
+    </script>
+
+## Note on Patches/Pull Requests
+
+1. Fork the project.
+2. Make your feature addition or bug fix.
+3. Add tests for it. This is important so I don't break it in a future version unintentionally.
+4. Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+5. Send me a pull request. Bonus points for topic branches.

data/lib/ember-rails-lite.rb

@@ -0,0 +1 @@
+require 'ember_rails'

data/lib/ember/filters/haml.rb

@@ -0,0 +1,11 @@
+module Haml
+  module Filters
+    module Handlebars
+      include Base
+      def render_with_options(text, options)
+        type = "type=#{options[:attr_wrapper]}text/x-handlebars#{options[:attr_wrapper]}"
+        "<script #{type}>\n#{text.rstrip}\n</script>"
+      end
+    end
+  end
+end

data/lib/ember/filters/slim.rb

@@ -0,0 +1,5 @@
+module Slim
+  class EmbeddedEngine
+    register :handlebars, TagEngine, :tag => :script, :attributes => { :type => 'text/x-handlebars' }
+  end
+end

data/lib/ember/handlebars/assets/ember-precompiler.js

@@ -0,0 +1,28 @@
+// DOM
+var Element = {};
+Element.firstChild = function () { return Element; };
+Element.innerHTML = function () { return Element; };
+
+var document = { createRange: false, createElement: function() { return Element; } };
+var window = this;
+this.document = document;
+
+// null out console.log and console.warn to avoid unexpected output
+if (window.console) {
+  window.console.warn = function() {};
+  window.console.log = function() {};
+}
+
+//// jQuery
+var jQuery = window.jQuery = function() { return jQuery; };
+jQuery.ready = function() { return jQuery; };
+jQuery.inArray = function() { return jQuery; };
+jQuery.jquery = "1.7.2";
+jQuery.event = {fixHooks: {}};
+
+// Precompiler
+var EmberRails = {
+  precompile: function(string) {
+    return Ember.Handlebars.precompile(string).toString();
+  }
+};

data/lib/ember/handlebars/source.rb

@@ -0,0 +1,54 @@
+require 'execjs'
+
+module Ember
+  module Handlebars
+    class Source
+      class << self
+        def precompiler_path
+          File.expand_path(File.join(__FILE__, '../assets/ember-precompiler.js'))
+        end
+
+        def vendor_path
+          path = ::Rails.root.nil? ? '' : ::Rails.root.join('vendor/assets/javascripts/ember.js')
+
+          if !File.exists?(path)
+            path = File.expand_path(File.join(__FILE__, '../../../../vendor/ember/production/ember.js'))
+          end
+        end
+
+        def path
+          @path ||= ENV['EMBER_SOURCE_PATH'] || vendor_path
+        end
+
+        def contents
+          @contents ||= begin
+            config = ::Rails.application.config.ember
+            handlebars = File.read(config.handlebars_location)
+            ember = File.read(config.ember_location)
+            precompiler = File.read(precompiler_path)
+
+            [precompiler, handlebars, ember].join("\n")
+          end
+        end
+
+        def handlebars_version
+          @handlebars_version ||= contents[/^Handlebars.VERSION = "([^"]*)"/, 1]
+        end
+
+        def ember_version
+          @ember_version ||= contents[/^Ember.VERSION = '([^']*)'/, 1]
+        end
+
+        def context
+          @context ||= ExecJS.compile(contents)
+        end
+      end
+    end
+
+    class << self
+      def compile(template)
+        Source.context.call('EmberRails.precompile', template)
+      end
+    end
+  end
+end

data/lib/ember/handlebars/template.rb

@@ -0,0 +1,60 @@
+require 'sprockets'
+require 'sprockets/engines'
+require 'ember/handlebars/source'
+
+module Ember
+  module Handlebars
+    class Template < Tilt::Template
+      def self.default_mime_type
+        'application/javascript'
+      end
+
+      def prepare; end
+
+      def evaluate(scope, locals, &block)
+        if scope.pathname.to_s =~ /\.raw\.(handlebars|hjs|hbs)/
+          "Ember.TEMPLATES[#{template_path(scope.logical_path).inspect}] = Handlebars.compile(#{indent(data).inspect});\n"
+        else
+          template = mustache_to_handlebars(scope, data)
+
+          if configuration.precompile
+            func = Ember::Handlebars.compile(template)
+            "Ember.TEMPLATES[#{template_path(scope.logical_path).inspect}] = Ember.Handlebars.template(#{func});\n"
+          else
+            "Ember.TEMPLATES[#{template_path(scope.logical_path).inspect}] = Ember.Handlebars.compile(#{indent(template).inspect});\n"
+          end
+        end
+      end
+
+      private
+
+      def mustache_to_handlebars(scope, template)
+        if scope.pathname.to_s =~ /\.mustache\.(handlebars|hjs|hbs)/
+          template.gsub(/\{\{(\w[^\}\}]+)\}\}/){ |x| "{{unbound #{$1}}}" }
+        else
+          template
+        end
+      end
+
+      def template_path(path)
+        root = configuration.templates_root
+
+        unless root.blank?
+          path.gsub!(/^#{Regexp.quote(root)}\/?/, '')
+        end
+
+        path = path.split('/')
+
+        path.join(configuration.templates_path_separator)
+      end
+
+      def configuration
+        ::Rails.configuration.handlebars
+      end
+
+      def indent(string)
+        string.gsub(/$(.)/m, "\\1  ").strip
+      end
+    end
+  end
+end

data/lib/ember/handlebars/version.rb

@@ -0,0 +1,7 @@
+require 'ember/handlebars/source'
+
+module Ember
+  module Handlebars
+    VERSION = "1.0.rc.1"
+  end
+end

data/lib/ember/rails/engine.rb

@@ -0,0 +1,22 @@
+require 'ember/handlebars/template'
+
+module Ember
+  module Rails
+    class Engine < ::Rails::Engine
+      config.handlebars = ActiveSupport::OrderedOptions.new
+
+      config.handlebars.precompile = true
+      config.handlebars.templates_root = "templates"
+      config.handlebars.templates_path_separator = '/'
+
+      initializer "ember_rails.setup", :group => :all do |app|
+        require 'ember/filters/slim' if defined? Slim
+        require 'ember/filters/haml' if defined? Haml
+
+        app.assets.register_engine '.handlebars', Ember::Handlebars::Template
+        app.assets.register_engine '.hbs', Ember::Handlebars::Template
+        app.assets.register_engine '.hjs', Ember::Handlebars::Template
+      end
+    end
+  end
+end

data/lib/ember/rails/version.rb

@@ -0,0 +1,5 @@
+module Ember
+  module Rails
+    VERSION = '0.8.0'
+  end
+end

data/lib/ember/version.rb

@@ -0,0 +1,5 @@
+require 'ember/handlebars/source'
+
+module Ember
+  VERSION = "1.0-pre.2"
+end

data/lib/ember_rails.rb

@@ -0,0 +1,56 @@
+require 'rails'
+require 'ember/rails/version'
+require 'ember/version'
+require 'ember/handlebars/version'
+require 'ember/rails/engine'
+
+module Ember
+  module Rails
+    class Railtie < ::Rails::Railtie
+      config.ember = ActiveSupport::OrderedOptions.new
+
+      generators do |app|
+        app ||= ::Rails.application # Rails 3.0.x does not yield `app`
+
+        app.config.generators.assets = false
+
+        ::Rails::Generators.configure!(app.config.generators)
+        ::Rails::Generators.hidden_namespaces.uniq!
+        require "generators/ember/resource_override"
+      end
+
+      initializer "ember_rails.setup_vendor", :after => "ember_rails.setup", :group => :all do |app|
+        if variant = app.config.ember.variant
+          # Add the gem's vendored ember to the end of the asset search path
+          ember_path = File.expand_path("../../vendor/ember/#{variant}", __FILE__)
+          app.config.assets.paths.push(ember_path.to_s)
+
+          # Allow a local variant override
+          ember_path = app.root.join("vendor/assets/ember/#{variant}")
+          app.config.assets.paths.unshift(ember_path.to_s) if ember_path.exist?
+        else
+          warn "No ember.js variant was specified in your config environment."
+          warn "You can set a specific variant in your application config in "
+          warn "order for sprockets to locate ember's assets:"
+          warn ""
+          warn "    config.ember.variant = :development"
+          warn ""
+          warn "Valid values are :development and :production"
+        end
+      end
+
+      initializer "ember_rails.find_ember", :after => "ember_rails.setup_vendor", :group => :all do |app|
+        config.ember.ember_location ||= location_for(app, "ember.js")
+        config.ember.handlebars_location ||= location_for(app, "handlebars.js")
+      end
+
+      def location_for(app, file)
+        path = app.config.assets.paths.find do |dir|
+          Pathname.new(dir).join(file).exist?
+        end
+
+        File.join(path, file) if path
+      end
+    end
+  end
+end

data/lib/generators/ember/bootstrap_generator.rb

@@ -0,0 +1,56 @@
+require 'generators/ember/generator_helpers'
+
+module Ember
+  module Generators
+    class BootstrapGenerator < ::Rails::Generators::Base
+      include Ember::Generators::GeneratorHelpers
+
+      source_root File.expand_path("../../templates", __FILE__)
+
+      desc "Creates a default Ember.js folder layout in app/assets/javascripts/ember"
+
+      class_option :skip_git, :type => :boolean, :aliases => "-g", :default => false, :desc => "Skip Git keeps"
+
+      def inject_ember
+        application_file = "app/assets/javascripts/application.js"
+
+        inject_into_file(application_file, :before => "//= require_tree") do
+          dependencies = [
+            # this should eventually become handlebars-runtime when we remove
+            # the runtime dependency on compilation
+            "//= require handlebars",
+            "//= require ember",
+            "//= require ember-data",
+            "//= require_self",
+            "//= require #{application_name.underscore}",
+            "#{application_name.camelize} = Ember.Application.create();"
+          ]
+          dependencies.join("\n").concat("\n")
+        end
+      end
+
+      def create_dir_layout
+        %W{models controllers views routes helpers templates}.each do |dir|
+          empty_directory "#{ember_path}/#{dir}"
+          create_file "#{ember_path}/#{dir}/.gitkeep" unless options[:skip_git]
+        end
+      end
+
+      def create_app_file
+        template "app.js", "#{ember_path}/#{application_name.underscore}.js"
+      end
+
+      def create_router_file
+        template "router.js", "#{ember_path}/routes/app_router.js"
+      end
+
+      def create_store_file
+        template "store.js", "#{ember_path}/store.js"
+      end
+
+      def create_app_stubs
+        generate "ember:view", "application"
+      end
+    end
+  end
+end