Initial import.

README

@@ -0,0 +1,128 @@
+= AssetPackager
+
+Easily merge, compress, cache, and version your javascript
+and CSS with Ruby on Rails!
+
+== Description
+
+When running in production, instead of sending down a dozen 
+javascript and css files full of formatting and comments, 
+this plugin allows you to merge and compress javascript down 
+into one or more files, thus saving download time for your users.
+
+But when in development, it would be nice to use the formatted,
+commented and logically separated versions for ease of 
+development and debugging.
+
+This plugin makes it easy to do both.
+
+Because not all browsers will dependably cache javascript 
+and css files with query string parameters, we write a timestamp 
+or subversion revision stamp into the merged file names. Therefore 
+files are correctly cached by the browser AND your users always 
+get the latest version when you re-deploy!
+
+== Credit
+
+This Rails Plugin was inspired by Cal Henderson's article 
+"Serving Javascript Fast" on Vitamin:
+http://www.thinkvitamin.com/features/webapps/serving-javascript-fast
+
+It also uses the Ruby Javascript Minifier created by 
+Douglas Crockford.
+http://www.crockford.com/javascript/jsmin.html
+
+== Key Features
+
+* Merges and compresses javascript and css when running in production.
+* Uses uncompressed originals when running in development.
+* Handles caching correctly. (No querystring parameters - filename timestamps)
+* Uses subversion revision numbers instead of timestamps if within a subversion controlled directory.
+* Guarantees new version will get downloaded the next time you deploy.
+
+== Components
+
+* Rake Task for merging and compressing javascript and css files.
+* Helper functions for including these javascript and css files in your RHTML.
+* YAML configuration file for mapping javascript and css files to merged versions.
+* Rake Task for auto-generating the YAML file from your existing javascript files.
+
+== How to Use:
+
+1. Download and install the plugin:
+   ./script/plugin install http://sbecker.net/shared/plugins/asset_packager
+
+2. Run the rake task "asset:packager:create_yml" to generate the /config/asset_packages.yml file the first time. You 
+will need to reorder files under 'base' so dependencies are loaded in correct order. Feel free 
+to rename or create new file packages.
+
+Example with multiple merged files:
+
+---
+javascripts:
+- base:
+  - prototype
+  - effects
+  - controls
+  - dragdrop
+  - application
+- secondary:
+  - foo
+  - bar
+stylesheets:
+- base:
+  - screen
+  - header
+- secondary:
+  - foo
+  - bar
+
+3. Run the rake task "asset:packager:build_all" to generate the compressed, merged versions for each package.
+
+4. Use the helper functions whenever including these files in your application. See below for examples.
+
+5. Potential warning: css compressor function currently removes css comments. This might blow away some css hackery. To disable comment removal, comment out /lib/synthesis/asset_package.rb line 167.
+
+== Javascript Examples
+
+Example call:  
+  <%= javascript_include_merged 'prototype', 'effects', 'controls', 'dragdrop', 'application', 'foo', 'bar' %>
+
+In development, this generates: 
+  <script type="text/javascript" src="/javascripts/prototype.js"></script>
+  <script type="text/javascript" src="/javascripts/effects.js"></script>
+  <script type="text/javascript" src="/javascripts/controls.js"></script>
+  <script type="text/javascript" src="/javascripts/dragdrop.js"></script>
+  <script type="text/javascript" src="/javascripts/application.js"></script>
+  <script type="text/javascript" src="/javascripts/foo.js"></script>
+  <script type="text/javascript" src="/javascripts/bar.js"></script>
+
+In production, this generates: 
+  <script type="text/javascript" src="/javascripts/base_1150571523.js"></script>
+  <script type="text/javascript" src="/javascripts/secondary_1150729166.js"></script>
+
+Now supports symbols and :defaults as well:
+<%= javascript_include_merged :defaults %>
+<%= javascript_include_merged :foo, :bar %>
+
+== Stylesheet Examples
+
+Example call:
+  <%= stylesheet_link_merged 'screen', 'header', 'foo', 'bar' %>
+
+In development, this generates:
+  <link href="/stylesheets/screen.css" media="screen" rel="Stylesheet" type="text/css" />
+  <link href="/stylesheets/header.css" media="screen" rel="Stylesheet" type="text/css" />
+  <link href="/stylesheets/foo.css" media="screen" rel="Stylesheet" type="text/css" />
+  <link href="/stylesheets/bar.css" media="screen" rel="Stylesheet" type="text/css" />
+
+In development this generates:
+
+== License
+Copyright (c) 2006 Scott Becker - http://synthesis.sbecker.net
+
+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.

Rakefile

@@ -0,0 +1,22 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the asset_packager plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the asset_packager plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'AssetPackager'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

about.yml

@@ -0,0 +1,8 @@
+author: Scott Becker
+name: AssetPackager
+summary: Easily merge, compress, cache, and version your javascript and css with Ruby on Rails!
+homepage: http://synthesis.sbecker.net/pages/asset_packager
+plugin: http://sbecker.net/shared/plugins/asset_packager
+license: MIT
+version: 0.2
+rails_version: 1.0+

init.rb

@@ -0,0 +1 @@
+ActionView::Base.send :include, Synthesis::AssetPackageHelper

install.rb

@@ -0,0 +1 @@
+# Install hook code here

lib/jsmin.rb

@@ -0,0 +1,197 @@
+#!/usr/bin/ruby
+# jsmin.rb 2006-03-21
+# 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 == "="))
+            $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
+
+jsmin