assets_packager 0.0.1

data/.gitignore

@@ -0,0 +1,5 @@
+pkg/*
+*.gem
+.bundle
+Gemfile.lock
+.DS_Store

data/Gemfile

@@ -0,0 +1,3 @@
+source "http://rubygems.org"
+
+gemspec

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Luca Guidi
+
+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,77 @@
+# Assets Packager
+## A bundler for your javascripts and stylesheets.
+
+When you deploy your application it could be convenient to package all your
+stylesheets and javascripts in a single file, let say all.css and all.js, in
+order to decrease the HTTP requests against your server.
+
+You may also find useful to reduce the size of those files, through a process
+which eliminates all unneeded white spaces and comments.
+
+`Assets Packager` helps you to solve these problems.
+
+## Installation
+
+    # Gemfile
+    gem 'assets_packager'
+
+    # lib/tasks/assets.rake
+    require 'assets_packager/tasks'
+
+    # shell
+    $ rake assets:install
+
+If you are in a `Rails` context, you don't need to setup anything else,
+otherwise you can specify your paths:
+
+    AssetsPackager.configure do |config|
+      config.root_path = '/path/to/public/folder'
+      config.file_path = '/path/to/assets.yml'
+    end
+
+## Assets configuration
+Once you use new assets to your application, just add the to the configuration
+file (look at `config/assets.yml`):
+
+    ---
+    css:
+    - application
+    - jquery-ui
+    js:
+    - jquery
+    - jquery-ui
+    - application
+
+Make sure to include library first, you may want to add `jquery.js` before of
+`application.js`.
+
+## Usage
+`Assets Packager` has a lot of useful `Rake` tasks (`rake -T assets`), the most
+important is `assets:package`: it merge and compress all your javascripts and
+stylesheets. Use it as `Capistrano` post deploy hook.
+
+If you're using `Rails`, in order to take advantage of bundled assets,
+you should use `:cache => true` option:
+
+    <%= javascript_include_tag 'jquery', 'jquery-ui', 'application', :cache => true %>
+    <%= stylesheet_link_tag 'application', 'jquery-ui', :cache => true %>
+
+There are some contexts where you can't bundle assets at deploy time (like `Heroku`),
+what you can do is to reference directly to `all.js` or `all.css`:
+
+    <%= javascript_include_tag 'all' %>
+    <%= stylesheet_link_tag 'all' %>
+
+In this way you have to bundle assets on your development machine and put them under
+version control.
+
+## Credits
+`Assets Packager` was strongly inspired by the homonym plugin written by
+[Scott Becker](http://synthesis.sbecker.net/).
+
+Uladzislau Latynski for his jsmin.rb Ruby porting.
+
+Thanks to [Steve Souders](http://stevesouders.com/) for his [High Performance
+Web Sites](http://oreilly.com/catalog/9780596529307) book.
+
+Copyright 2011 Luca Guidi - [www.lucaguidi.com](www.lucaguidi.com) - Released under MIT License

data/Rakefile

@@ -0,0 +1,14 @@
+require 'bundler'
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'rspec/core/rake_task'
+
+task :default => :spec
+
+Bundler::GemHelper.install_tasks
+
+RSpec::Core::RakeTask.new do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rspec_opts = ['-fs --color --backtrace']
+end

data/assets_packager.gemspec

@@ -0,0 +1,34 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "assets_packager/version"
+
+Gem::Specification.new do |s|
+  s.name        = "assets_packager"
+  s.version     = AssetsPackager::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Luca Guidi"]
+  s.email       = ["guidi.luca@gmail.com"]
+  s.homepage    = "http://github.com/jodosha/assets_packager"
+  s.summary     = %q{A packager for your assets}
+  s.description = %q{Compress and merge your JavaScript and CSS files}
+
+  s.rubyforge_project = "assets_packager"
+
+  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"]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, ["~> 2.5.0"])
+    else
+      s.add_dependency(%q<rspec>, ["~> 2.5.0"])
+    end
+  else
+    s.add_dependency(%q<rspec>, ["~> 2.5.0"])
+  end
+end

data/bin/jsmin

@@ -0,0 +1,205 @@
+#!/usr/bin/env ruby
+# jsmin.rb 2007-07-20
+# Author: Uladzislau Latynski
+# This work is a translation from C to Ruby of jsmin.c published by
+# Douglas Crockford.  Permission is hereby granted to use the Ruby
+# version under the same conditions as the jsmin.c on which it is
+# based.
+#
+# /* jsmin.c
+#    2003-04-21
+#
+# Copyright (c) 2002 Douglas Crockford  (www.crockford.com)
+#
+# 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 shall be used for Good, not Evil.
+#
+# 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.
+
+EOF = -1
+$theA = ""
+$theB = ""
+
+# isAlphanum -- return true if the character is a letter, digit, underscore,
+# dollar sign, or non-ASCII character
+def isAlphanum(c)
+   return false if !c || c == EOF
+   return ((c >= 'a' && c <= 'z') || (c >= '0' && c <= '9') ||
+           (c >= 'A' && c <= 'Z') || c == '_' || c == '$' ||
+           c == '\\' || c[0] > 126)
+end
+
+# get -- return the next character from stdin. Watch out for lookahead. If
+# the character is a control character, translate it to a space or linefeed.
+def get()
+  c = $stdin.getc
+  return EOF if(!c)
+  c = c.chr
+  return c if (c >= " " || c == "\n" || c.unpack("c") == EOF)
+  return "\n" if (c == "\r")
+  return " "
+end
+
+# Get the next character without getting it.
+def peek()
+    lookaheadChar = $stdin.getc
+    $stdin.ungetc(lookaheadChar)
+    return lookaheadChar.chr
+end
+
+# mynext -- get the next character, excluding comments.
+# peek() is used to see if a '/' is followed by a '/' or '*'.
+def mynext()
+    c = get
+    if (c == "/")
+        if(peek == "/")
+            while(true)
+                c = get
+                if (c <= "\n")
+                return c
+                end
+            end
+        end
+        if(peek == "*")
+            get
+            while(true)
+                case get
+                when "*"
+                   if (peek == "/")
+                        get
+                        return " "
+                    end
+                when EOF
+                    raise "Unterminated comment"
+                end
+            end
+        end
+    end
+    return c
+end
+
+
+# action -- do something! What you do is determined by the argument: 1
+# Output A. Copy B to A. Get the next B. 2 Copy B to A. Get the next B.
+# (Delete A). 3 Get the next B. (Delete B). action treats a string as a
+# single character. Wow! action recognizes a regular expression if it is
+# preceded by ( or , or =.
+def action(a)
+    if(a==1)
+        $stdout.write $theA
+    end
+    if(a==1 || a==2)
+        $theA = $theB
+        if ($theA == "\'" || $theA == "\"")
+            while (true)
+                $stdout.write $theA
+                $theA = get
+                break if ($theA == $theB)
+                raise "Unterminated string literal" if ($theA <= "\n")
+                if ($theA == "\\")
+                    $stdout.write $theA
+                    $theA = get
+                end
+            end
+        end
+    end
+    if(a==1 || a==2 || a==3)
+        $theB = mynext
+        if ($theB == "/" && ($theA == "(" || $theA == "," || $theA == "=" ||
+                             $theA == ":" || $theA == "[" || $theA == "!" ||
+                             $theA == "&" || $theA == "|" || $theA == "?" ||
+                             $theA == "{" || $theA == "}" || $theA == ";" ||
+                             $theA == "\n"))
+            $stdout.write $theA
+            $stdout.write $theB
+            while (true)
+                $theA = get
+                if ($theA == "/")
+                    break
+                elsif ($theA == "\\")
+                    $stdout.write $theA
+                    $theA = get
+                elsif ($theA <= "\n")
+                    raise "Unterminated RegExp Literal"
+                end
+                $stdout.write $theA
+            end
+            $theB = mynext
+        end
+    end
+end
+
+# jsmin -- Copy the input to the output, deleting the characters which are
+# insignificant to JavaScript. Comments will be removed. Tabs will be
+# replaced with spaces. Carriage returns will be replaced with linefeeds.
+# Most spaces and linefeeds will be removed.
+def jsmin
+    $theA = "\n"
+    action(3)
+    while ($theA != EOF)
+        case $theA
+        when " "
+            if (isAlphanum($theB))
+                action(1)
+            else
+                action(2)
+            end
+        when "\n"
+            case ($theB)
+            when "{","[","(","+","-"
+                action(1)
+            when " "
+                action(3)
+            else
+                if (isAlphanum($theB))
+                    action(1)
+                else
+                    action(2)
+                end
+            end
+        else
+            case ($theB)
+            when " "
+                if (isAlphanum($theA))
+                    action(1)
+                else
+                    action(3)
+                end
+            when "\n"
+                case ($theA)
+                when "}","]",")","+","-","\"","\\", "'", '"'
+                    action(1)
+                else
+                    if (isAlphanum($theA))
+                        action(1)
+                    else
+                        action(3)
+                    end
+                end
+            else
+                action(1)
+            end
+        end
+    end
+end
+
+ARGV.each do |anArg|
+    $stdout.write "// #{anArg}\n"
+end
+
+jsmin

data/lib/assets_packager.rb

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+
+module AssetsPackager
+  autoload :Configuration, 'assets_packager/configuration'
+  autoload :Cleaner,       'assets_packager/cleaner'
+  autoload :Mergers,       'assets_packager/mergers'
+  autoload :Compressors,   'assets_packager/compressors'
+
+  # Configure <tt>AssetsPackager</tt>.
+  #
+  # Example:
+  #   AssetsPackager.configure do |config|
+  #     config.root_path = '/path/to/public/folder'
+  #   end
+  #
+  # Options:
+  # * <tt>root_path</tt>: Specify the directory where your javascript and stylesheet
+  # directories are. i.e. <tt>Rails.public_path</tt>. Default: <tt>Dir.pwd</tt>.
+  # * <tt>file_path</tt>: Specify the path of the <tt>YAML</tt> configuration file.
+  # Default: <tt>root_path + '/assets.yml'</tt>.
+  # * <tt>javascripts_path</tt>: Specify where your javascripts are placed.
+  # Default: <tt>root_path + '/javascripts'</tt>
+  # * <tt>stylesheets_path</tt>: Specify where your stylesheets are placed.
+  # Default: <tt>root_path + '/stylesheets'</tt>
+  #
+  # Notice: If you are in a <tt>Rails</tt> context, everything is already configured.
+  def self.configure
+    yield AssetsPackager::Configuration
+  end
+end

data/lib/assets_packager/cleaner.rb

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+require 'fileutils'
+
+module AssetsPackager
+  module Cleaner
+    extend self
+
+    def clear!
+      clear_configuration!
+      clear_javascripts!
+      clear_stylesheets!
+    end
+
+    def clear_configuration!
+      FileUtils.rm AssetsPackager::Configuration.file_path rescue nil
+    end
+
+    def clear_javascripts!
+      FileUtils.rm AssetsPackager::Mergers::Javascript.file rescue nil
+    end
+
+    def clear_stylesheets!
+      FileUtils.rm AssetsPackager::Mergers::Stylesheet.file rescue nil
+    end
+  end
+end

data/lib/assets_packager/compressors.rb

@@ -0,0 +1,9 @@
+# -*- encoding: utf-8 -*-
+
+module AssetsPackager
+  module Compressors
+    autoload :Base,       'assets_packager/compressors/base'
+    autoload :Javascript, 'assets_packager/compressors/javascript'
+    autoload :Stylesheet, 'assets_packager/compressors/stylesheet'
+  end
+end

data/lib/assets_packager/compressors/base.rb

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+
+module AssetsPackager
+  module Compressors
+    class Base
+      def self.compress!
+        content = _compress_and_load!
+        ::File.open(file, 'w+') { |file| file.write content }
+      end
+
+      def self.file
+        raise "Not implemented"
+      end
+
+      private
+        def self._compress_and_load!
+          raise "Not implemented"
+        end
+    end
+  end
+end