linner 0.4.6 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 22e8e5dc49bf60b631d9932980705923d288eb05
-  data.tar.gz: d528f466a6cf1f464a602b40fd205ea051f40b8c
+  metadata.gz: d8883d113979a23a06f305ffaa96e7c224e3e08d
+  data.tar.gz: eae9dcb29be6f8b59a5696cc11d84504abc7145d
 SHA512:
-  metadata.gz: 7de696f89676b8d83d6848cab9230e72bb4ad369dc2e537beefb5b723f6be54cca8f984c1d5447049a646a80cc27c1566b42f0dfeb3559d258581e3c42a555bc
-  data.tar.gz: 8b9db856716048223a35fbd7117ce861ff7d9d3d66a449f1648316c8ed4f87ae056cee7930398d54709e1cef7774e3fbd0ebdd27d6eb66e8216bcaec2811862c
+  metadata.gz: a9e63c8c9c462d9faa0aecc39885f5e74429ee366d773eccc09c02d99b408628031d3ef4c6dd5429b3f86e90333ebd6b88c88d04bd8ad10b6af4d6e4d1d47cf1
+  data.tar.gz: 1d4fd2a6f5e681f9a0c7b361e5fde514a2efbfa32850b0f877c816aeb552db1baca5238a23afef2a429b63dadea92103640df9da0ac4b5747acf4b7fe9888b84

data/CHANGELOG

@@ -1,3 +1,6 @@
+v 0.5.0
+  - linner command now provides `check` and `install` commands to check and install vendor  dependencies
+
 v 0.4.6
   - compat terminal-notifier with OS X mavericks
 

data/README.md

@@ -13,9 +13,10 @@ Linner is a full-featured HTML5 application assembler.
 * Fast!
 * Supports `Sass`, `Compass` and `Coffee`.
 * Supports OS X Lion and Mountaion Lion Notifications.
-* Supports Modular Javascript, All your code will be wrap by `cmd`.
+* Supports Modular Javascript, All your code will be wrapped by `cmd`.
 * Supports `concat` code by `config file` not `directive processor`.
 * Supports `copy` code from `src` to `dest`.
+* Supports `precompile` Javascript Templates from `src` to `desc`
 * Supports Real-time `concat` by `$ linner watch`.
 * Supports `compress` by `$ linner build`.
 * Supports `LiveReload` with [LiveReload Chrome Extention](https://chrome.google.com/webstore/detail/livereload/jnihajbhpnppcggbcgedagnkighmdlei).

data/docs/commands.md

@@ -4,6 +4,14 @@
 
 Create new brunch project.
 
+## `linner check`
+
+Check linner bundles
+
+## `linner install`
+
+Install linner bundles
+
 ## `linner watch`
 
 Watch linner directory and rebuild if something changed.

data/docs/config.md

@@ -51,6 +51,8 @@ the default configuration defines four groups: `scripts`, `styles`, `images` and
 
 `copy` defines copy strategy of files in Linner. The `Dir.glob` of `value` will be copy to `key` folder.
 
+`precompile` defines precompile strategy of javascript templates for Linner. The `Dir.glob` of `value` will be concat to `key`
+
 `order` defines the order of this group files, and It's very useful when you `concat` your files. for example:
 
 ```yaml
@@ -102,3 +104,25 @@ Default:
 ```yaml
 notification: true
 ```
+
+## `bundles`
+
+`bundles` defines application's library dependencies, the dependencies will be copied to `vendor` folder.
+
+For example:
+
+```yaml
+bundles:
+  "jquery.js":
+    version: "1.10.2"
+    url: "http://code.jquery.com/jquery-1.10.2.js"
+  "underscore.js":
+    version: "1.5.2"
+    url: https://raw.github.com/jashkenas/underscore/1.5.2/underscore.js
+  "backbone.js":
+    version: "1.1.0"
+    url: "https://raw.github.com/jashkenas/backbone/1.1.0/backbone.js"
+  "handlebars.js":
+    version: "1.0.0"
+    url: "https://raw.github.com/wycats/handlebars.js/1.0.0/dist/handlebars.js"
+```

data/lib/linner.rb

@@ -5,6 +5,7 @@ require "linner/command"
 require "linner/asset"
 require "linner/cache"
 require "linner/helper"
+require "linner/bundler"
 require "linner/reactor"
 require "linner/wrapper"
 require "linner/template"
@@ -65,6 +66,9 @@ module Linner
   end
 
   def perform(*asset)
+    env.groups.each do |config|
+      precompile(config) if config["precompile"]
+    end
     env.groups.each do |config|
       copy(config) if config["copy"]
       concat(config) if config["concat"]
@@ -72,7 +76,7 @@ module Linner
     revision if compile? and env.revision
   end
 
-private
+  private
   def concat(config)
     config["concat"].each_with_index do |pair, index|
       dest, pattern, order = pair.first, pair.last, config["order"]||[]
@@ -94,6 +98,14 @@ private
     end
   end
 
+  def precompile(config)
+    config["precompile"].each do |dest, pattern|
+      matches = Dir.glob(pattern).sort_by(&:downcase)
+      next if matches.select { |p| cache.miss? p }.empty?
+      write_template(dest, matches)
+    end
+  end
+
   def revision
     dump_manifest
     [env.revision].flatten.each do |rev|
@@ -103,11 +115,17 @@ private
     end
   end
 
-  private
+  def write_template(dest, child_assets)
+    asset = Asset.new(File.join env.public_folder, dest)
+    content = child_assets.inject("") {|s, m| s << cache[m].content}
+    asset.content = Wrapper::Template.definition(content)
+    asset.compress if compile?
+    asset.write
+  end
 
   def write_asset(dest, child_assets)
     asset = Asset.new(File.join env.public_folder, dest)
-    definition = (asset.path == env.definition ? Wrapper.definition : "")
+    definition = (asset.path == env.definition ? Wrapper::Module.definition : "")
     asset.content = child_assets.inject(definition) {|s, m| s << cache[m].content}
     asset.compress if compile?
     asset.write

data/lib/linner/asset.rb

@@ -49,7 +49,11 @@ module Linner
     end
 
     def wrap(source)
-      Wrapper.wrap(logical_path.chomp(File.extname logical_path), source)
+      if javascript?
+        Wrapper::Module.wrap(logical_path.chomp(File.extname logical_path), source)
+      else
+        Wrapper::Template.wrap(logical_path.chomp(File.extname logical_path), source)
+      end
     end
 
     def javascript?
@@ -60,8 +64,12 @@ module Linner
       Tilt[path] and Tilt[path].default_mime_type == "text/css"
     end
 
+    def template?
+      Tilt[path] and Tilt[path].default_mime_type == "text/template"
+    end
+
     def wrappable?
-      !!(self.javascript? and !Linner.env.modules_ignored.include?(@path))
+      !!(self.javascript? and !Linner.env.modules_ignored.include?(@path) or self.template?)
     end
 
     def write

data/lib/linner/bundler.rb

@@ -0,0 +1,66 @@
+require "digest"
+require "fileutils"
+require "open-uri"
+
+module Linner
+  class Bundler
+    VENDOR = Pathname(".").expand_path.join "vendor"
+    REPOSITORY = File.expand_path "~/.linner/bundles"
+
+    Bundle = Struct.new(:name, :version, :url) do
+      def path
+        File.join(REPOSITORY, name, version, File.basename(url))
+      end
+    end
+
+    def initialize(bundles)
+      @bundles = []
+      bundles.each do |name, props|
+        @bundles << Bundle.new(name, props["version"], props["url"])
+      end
+    end
+
+    def check
+      return [false, "Bundles didn't exsit!"] unless File.exists? REPOSITORY
+      @bundles.each do |bundle|
+        unless File.exists?(bundle.path) and File.exists?(File.join(VENDOR, bundle.name))
+          return [false, "Bundle #{bundle.name} v#{bundle.version} didn't match!"]
+        end
+      end
+      return [true, "Perfect bundled, ready to go!"]
+    end
+
+    def install
+      unless File.exists? REPOSITORY
+        FileUtils.mkdir_p(REPOSITORY)
+      end
+      @bundles.each do |bundle|
+        if bundle.version != "master"
+          next if File.exists?(bundle.path) and File.exists?(File.join(VENDOR, bundle.name))
+        end
+        puts "Installing #{bundle.name} #{bundle.version}..."
+        install_to_repository bundle.url, bundle.path
+        link_to_vendor bundle.path, File.join(VENDOR, bundle.name)
+      end
+    end
+
+    def perform
+      check and install
+    end
+
+    private
+    def install_to_repository(url, path)
+      FileUtils.mkdir_p File.dirname(path)
+      File.open(path, "w") do |dist|
+        open(url, "r:UTF-8") {|file| dist.write file.read}
+      end
+    end
+
+    def link_to_vendor(path, dist)
+      if !File.exist?(dist) or Digest::MD5.file(path).hexdigest != Digest::MD5.file(dist).hexdigest
+        FileUtils.mkdir_p File.dirname(dist)
+        FileUtils.cp path, dist
+      end
+    end
+  end
+end

data/lib/linner/command.rb

@@ -15,18 +15,37 @@ module Linner
       puts Linner::VERSION
     end
 
+    desc "check", "check dependencies"
+    def check
+      message = Linner::Bundler.new(env.bundles).check
+      puts (message.first ? "🍵 :" : "👻 :") + message.last
+    end
+
+    desc "install", "install dependencies"
+    def install
+      begin
+        Linner::Bundler.new(env.bundles).perform
+      rescue
+        puts "👻 : Install failed!"
+        puts $!
+        return
+      end
+      puts "🍵 : Perfect installed all bundles!"
+    end
+
     desc "build", "build assets"
     def build
       Linner.compile = true
       clean
-      Notifier.profile { Linner.perform }
+      perform
     end
 
     desc "watch", "watch assets"
     def watch
       trap(:INT) { exit! }
       clean
-      perform_proc.call
+      Linner::Bundler.new(env.bundles).perform
+      perform
       watch_for_perform
       watch_for_reload
       sleep
@@ -48,20 +67,20 @@ module Linner
       Linner.env
     end
 
-    def perform_proc
-      @proc ||= Proc.new do
-        begin
-          Notifier.profile{ Linner.perform }
-        rescue
-          Notifier.error $!
+    def perform
+      begin
+        Notifier.profile do
+          Linner.perform
         end
+      rescue
+        Notifier.error $!
       end
     end
 
     def watch_for_perform
       Listen.to env.watched_paths do |modified, added, removed|
         Linner.cache.expire_by(modified + added + removed)
-        perform_proc.call
+        perform
       end
     end
 

data/lib/linner/compressor.rb

@@ -5,7 +5,7 @@ module Linner
   class Compressor
 
     def self.compress(asset)
-      if asset.javascript?
+      if asset.javascript? or asset.template?
         Uglifier.compile asset.content, comments: "none"
       elsif asset.stylesheet?
         CSSminify.new.compress asset.content

data/lib/linner/environment.rb

@@ -31,6 +31,10 @@ module Linner
       end
     end
 
+    def bundles
+      @env["bundles"] || []
+    end
+
     def modules_ignored
       Dir.glob(@env["modules"]["ignored"])
     end

data/lib/linner/template.rb

@@ -1,6 +1,7 @@
 require "tilt"
 require "sass"
 require "compass"
+require "handlebars.rb"
 require "coffee_script"
 
 module Tilt
@@ -30,8 +31,19 @@ module Tilt
     end
   end
 
+  class HandlebarsTemplate < Template
+    self.default_mime_type = 'text/template'
+
+    def prepare; end
+
+    def evaluate(scope, locals, &block)
+      @output ||= Handlebars.precompile(data)
+    end
+  end
+
   register CSSTemplate, "css"
   register JavascriptTemplate, "js"
+  register HandlebarsTemplate, "hbs", "handlebars"
 
   register CompassSassTemplate, "sass"
   prefer CompassSassTemplate

data/lib/linner/templates/app/scripts/app.coffee

@@ -1,2 +1,3 @@
 module.exports = ->
+  $("body").append Handlebars.templates["welcome"]()
   console.info "log from app!"

data/lib/linner/templates/app/templates/welcome.hbs

@@ -0,0 +1 @@
+<p>Hello world! This is Linner Boilerplate.</p>

data/lib/linner/templates/app/views/index.html

@@ -13,10 +13,9 @@
             <p class="browsehappy">You are using an <strong>outdated</strong> browser. Please <a href="http://browsehappy.com/">upgrade your browser</a> to improve your experience.</p>
         <![endif]-->
 
-        <p>Hello world! This is Linner Boilerplate.</p>
-
         <script src="/scripts/vendor.js"></script>
         <script src="/scripts/app.js"></script>
+        <script src="/scripts/templates.js"></script>
         <script>require("app")()</script>
     </body>
 </html>

data/lib/linner/templates/config.yml

@@ -17,10 +17,23 @@ groups:
       "/images/": "app/images/**/*.{png,gif}"
   views:
     copy:
-      "/": "app/views/**/*.{html,hbs}"
+      "/": "app/views/**/*.html"
+  templates:
+    paths:
+      - "app/templates"
+    precompile:
+      "/scripts/templates.js": "app/templates/**/*.hbs"
 modules:
   wrapper: "cmd"
   ignored: "vendor/**/*"
   definition: "/scripts/app.js"
 revision: "index.html"
 notification: true
+bundles:
+  "jquery.js":
+    version: "1.10.2"
+    url: "http://code.jquery.com/jquery-1.10.2.js"
+  "handlebars.js":
+    version: "1.0.0"
+    url: "https://raw.github.com/wycats/handlebars.js/1.0.0/dist/handlebars.runtime.js"
+

data/lib/linner/templates/public/.gitkeep

@@ -0,0 +1 @@
+.gitkeep

data/lib/linner/templates/vendor/.gitkeep

@@ -0,0 +1 @@
+.gitkeep

data/lib/linner/version.rb

@@ -1,3 +1,3 @@
 module Linner
-  VERSION = "0.4.6"
+  VERSION = "0.5.0"
 end

data/lib/linner/wrapper.rb

@@ -1,17 +1,32 @@
 module Linner
-  class Wrapper
-    WRAPPER =
-      'this.require.define({"%s":' +
-        'function(exports, require, module){' +
-        '%s' +
-        ";}});\n"
+  module Wrapper
+    class Module
+      def self.wrap(name, content)
+        <<-WRAPPER
+this.require.define({"#{name}":function(exports, require, module){#{content};}});
+        WRAPPER
+      end
 
-    def self.wrap(name, content)
-      WRAPPER % [name, content]
+      def self.definition
+        File.read(File.join File.dirname(__FILE__), "../../vendor", "require_definition.js")
+      end
     end
 
-    def self.definition
-      File.read(File.join File.dirname(__FILE__), "../../vendor", "require_definition.js")
+    class Template
+      def self.wrap(name, content)
+        <<-WRAPPER
+templates["#{name}"] = template(#{content});
+        WRAPPER
+      end
+
+      def self.definition(content)
+        <<-DEFINITION
+(function() {
+  var template = Handlebars.template, templates = Handlebars.templates = Handlebars.templates || {};
+  #{content}
+})();
+        DEFINITION
+      end
     end
   end
 end