psyho_juicer 1.0.0

data/History.txt

@@ -0,0 +1,58 @@
+== 1.0.0 / 2010-02-24
+* Make sure @import rules with url is removed when files are merged
+* Dependency resolver supports depending on directories
+* Constant refefined warnings fixed in installer module (Aaron Suggs)
+* Ruby 1.9 compatibility
+* Google Closure Compiler support for `juicer merge` (Pavel Valodzka)
+* Fix bug in `juicer list` for files with no dependencies (Daniel Stockman) 
+* Image embedder to embed images using data uris (Morgan Roderick)
+* YUI Compressor --arguments now works (Daniel Stockman)
+* Download Rhino over HTTP rather than FTP to avoid certain corporate
+  firewall restraints
+* Development improvements:
+  Use Jeweler to package gem
+  Less obtrusive Ruby core extensions (Pavel Valodzka)
+  Switched from Hpricot to Nokogiri
+  New AssetPath interface for resolving URLs in CSS files
+  Refactor web_root -> document_root
+  Tests are considerably sped up
+  Reorganized tests in unit/ directory
+  Use shoulda for tests
+  Use mocha in tests
+  Use FakeFS for certain file operations in tests
+  Bundling binaries needed to run tests
+* Refactored/moved dependency resolver classes. They now live in
+  Juicer::CssDependencyResolver and
+  Juicer::JavaScriptDependencyResolver
+  Dependency resolvers include Enumerable
+
+== 0.2.6 / 2009-07-20
+* New installation paths for YUI Compressor
+  Patch by http://github.com/craveytrain
+
+== 0.2.5 / 2009-05-22
+* Fixed a bug with the stylesheet merger where url( <url> ); (ie URL surrounded
+  by spaces) resolved wrong.
+
+== 0.2.4 / 2009-04-29
+
+* More robust pattern checking for url() references in CSS files
+* Allow skipping verification
+* Bug fix: Skip cache buster if type=none
+* Bug fix: Quote JsLint command parts to allow for spaces in jar file paths
+* Bug fix: cache buster type wasn't carried all the way (ie had no effect)
+
+== 0.2.3 / 2009-03-03
+
+* Cache busters in CSS files should only be appended once to each URL
+* Output to merge target should accept directories as well as files (in case of
+  directories, file name is generated)
+* Tests should not ship with 3rd party libraries
+
+== 0.2.0 / 2009-02-25
+
+* First usable release; merge, verify, install targets
+
+== 0.1.0 / 2008-12-17
+
+* Dug up old project and set it up with Mr Bones

data/Manifest.txt

@@ -0,0 +1,58 @@
+History.txt
+Manifest.txt
+Rakefile
+Readme.rdoc
+bin/juicer
+lib/juicer.rb
+lib/juicer/binary.rb
+lib/juicer/cache_buster.rb
+lib/juicer/chainable.rb
+lib/juicer/cli.rb
+lib/juicer/command/install.rb
+lib/juicer/command/list.rb
+lib/juicer/command/merge.rb
+lib/juicer/command/util.rb
+lib/juicer/command/verify.rb
+lib/juicer/core.rb
+lib/juicer/css_cache_buster.rb
+lib/juicer/install/base.rb
+lib/juicer/install/jslint_installer.rb
+lib/juicer/install/rhino_installer.rb
+lib/juicer/install/yui_compressor_installer.rb
+lib/juicer/jslint.rb
+lib/juicer/merger/base.rb
+lib/juicer/merger/css_dependency_resolver.rb
+lib/juicer/merger/dependency_resolver.rb
+lib/juicer/merger/javascript_dependency_resolver.rb
+lib/juicer/merger/javascript_merger.rb
+lib/juicer/merger/stylesheet_merger.rb
+lib/juicer/minifyer/yui_compressor.rb
+tasks/test/setup.rake
+test/bin/jslint.js
+test/bin/rhino1_7R1.zip
+test/bin/rhino1_7R2-RC1.zip
+test/bin/yuicompressor
+test/bin/yuicompressor-2.3.5.zip
+test/bin/yuicompressor-2.4.2.zip
+test/juicer/command/test_install.rb
+test/juicer/command/test_list.rb
+test/juicer/command/test_merge.rb
+test/juicer/command/test_util.rb
+test/juicer/command/test_verify.rb
+test/juicer/install/test_installer_base.rb
+test/juicer/install/test_jslint_installer.rb
+test/juicer/install/test_rhino_installer.rb
+test/juicer/install/test_yui_compressor_installer.rb
+test/juicer/merger/test_base.rb
+test/juicer/merger/test_css_dependency_resolver.rb
+test/juicer/merger/test_javascript_dependency_resolver.rb
+test/juicer/merger/test_javascript_merger.rb
+test/juicer/merger/test_stylesheet_merger.rb
+test/juicer/minifyer/test_yui_compressor.rb
+test/juicer/test_cache_buster.rb
+test/juicer/test_chainable.rb
+test/juicer/test_core.rb
+test/juicer/test_css_cache_buster.rb
+test/juicer/test_jslint.rb
+test/test_helper.rb
+test/test_juicer.rb

data/Rakefile

@@ -0,0 +1,96 @@
+require 'rubygems'
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "psyho_juicer"
+    gem.summary = "Command line tool for CSS and JavaScript developers"
+    gem.description = "Resolve dependencies, merge and minify CSS and JavaScript files with Juicer - the command line tool for frontend engineers"
+    gem.email = "christian@cjohansen.no"
+    gem.homepage = "http://github.com/cjohansen/juicer"
+    gem.authors = ["Christian Johansen"]
+    gem.rubyforge_project = "juicer"
+    gem.add_development_dependency "shoulda", ">= 2.10.2"
+    gem.add_development_dependency "mocha", ">= 0.9.8"
+    gem.add_development_dependency "fakefs", ">= 0.2.1"
+    gem.add_development_dependency "jeweler", ">= 0.2.1"
+    gem.add_development_dependency "redgreen", ">= 1.2.2" if RUBY_VERSION < "1.9"
+    gem.add_dependency "cmdparse"
+    gem.add_dependency "nokogiri"
+    gem.add_dependency "rubyzip"
+    gem.executables = ["juicer"]
+    gem.post_install_message = <<-MSG
+Juicer does not ship with third party libraries. You probably want to install
+Yui Compressor and JsLint now:
+
+juicer install yui_compressor
+juicer install jslint
+
+Happy juicing!
+    MSG
+    gem.files = FileList["[A-Z]*", "{bin,generators,lib,test}/**/*"]
+  end
+
+  Jeweler::GemcutterTasks.new
+  Jeweler::RubyforgeTasks.new do |rubyforge|
+    rubyforge.doc_task = "rdoc"
+  end
+rescue LoadError => err
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+  puts err.message
+end
+
+Rake::TestTask.new("test:units") do |test|
+  test.libs << 'test'
+  test.pattern = 'test/unit/**/*_test.rb'
+  test.verbose = true
+end
+
+Rake::TestTask.new("test:integration") do |test|
+  test.libs << 'test'
+  test.pattern = 'test/integration/**/*_test.rb'
+  test.verbose = true
+end
+
+task :test => ["check_dependencies:development", "test:units", "test:integration"]
+
+task :default => "test:units"
+
+# lib/tasks/cruise.rake
+desc 'Continuous build target'
+task :cruise do
+  out = ENV['CC_BUILD_ARTIFACTS']
+  mkdir_p out unless File.directory? out if out
+ 
+  Rake::Task["rcov"].invoke
+  mv 'coverage/', "#{out}/" if out
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/*_test.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION')
+    version = File.read('VERSION')
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "jstdutil #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/Readme.rdoc

@@ -0,0 +1,313 @@
+= Juicer
+Official URL: http://github.com/cjohansen/juicer/tree/master
+
+Christian Johansen (http://www.cjohansen.no) and contributors:
+
+* Morgan Roderick (http://roderick.dk)
+* Pavel Valodzka (http://github.com/valodzka)
+* Daniel Stockman (http://evocateur.org/)
+* Aaron Suggs (http://ktheory.com)
+
+== DESCRIPTION:
+
+Juicer is a command line tool that helps you ship frontend code for production.
+
+High level overview; Juicer can
+
+* figure out which files depend on each other and merge them together, reducing
+  the number of http requests per page view, thus improving performance
+* use YUI Compressor or Google Closure Compiler to compress code, thus improving performance
+* verify that your JavaScript is safe to minify/compress by running JsLint on it
+* cycle asset hosts in CSS files
+* add "cache busters" to URLs in CSS files
+* recalculate relative URLs in CSS files, as well as convert them to absolute
+  (or convert absolute URLs to relative URLs)
+* embed images into stylesheets using data-uris
+
+== FEATURES:
+
+=== Merging and minifying
+
+Juicer can read @import statements in CSS files and use them to combine all your
+stylesheets into a single file. This file may be minified using the YUI
+Compressor or Google Closure Compiler. Eventually it will support other minifying tools too.
+
+Juicer can treat your JavaScript files much the same way too, parsing a comment
+switch @depend, as this example shows:
+
+  /**
+   * My script file
+   *
+   * @depend jquery-1.4.1.js
+   */
+  var myNS = {
+      myObject = {}
+  };
+
+Running <tt>juicer merge</tt> on this file will result in a minified file
+<tt>filename.min.js</tt> containing the file jquery-1.4.1.js (located in the
+same directory) and the code above.
+
+You can use @import (CSS files) and @depend (JavaScript) recursively, effectively
+creating a dependency chain for Juicer to climb and merge.
+
+=== Paths
+
+When merging CSS files, you may want to merge CSS files in different directories.
+You may also want the resulting CSS file to end up in another directory as well.
+Juicer automatically recalculates referenced URLs to reflect this change.
+
+Absolute URLs are not changed by default, but if you provide juicer merge
+with <code>--document-root [DIR]</code> and <code>--relative-urls</code> then
+absolute URLs are converted to URLs relative to output directory. You can also
+use <code>--absolute-urls</code> to convert all URLs to absolute ones.
+
+=== Cache busters
+
+Juicer supports so-called cache busters. A cache buster is a pattern in a path
+whose only purpose is to "trick" browsers to redownload a file when it has
+changed in cases where a far future expires header is used.
+
+There are two types of cache busters; soft ones add a parameter to the URL, like
+so: http://assets/images/1.png?cb1234567890, ie the letters "cb" (as in cache
+buster) and then the timestamp of the files mtime.
+
+Unfortunately, the popular web proxy Squid shipped for some time with a default
+configuration which would not treat a URL as a "new" URL if the only thing changed
+was the GET parameters. For this reason Juicer provides hard cache busters.
+
+Hard cache busters result in URLs such as: http://assets/images/1-cb1234567890.png,
+ie URLs that require either renaming of files, or (more conveniently) a web
+server configuration that will forward URLs to the right files anyway.
+
+=== Embed images in stylesheets
+
+Juicer supports embedding images into stylesheets using data uri's.
+
+In order to be as unobtrusive as possible, you must indicate for each image that it 
+can be embedded in the stylesheet by using the embed url suffix.
+
+Example:
+    
+    h1 { background: url(/somepath/someimage.png?embed=true); }
+
+When merging the stylesheets, you must specify which type of embedding you want,
+currently only 'none' and 'data_uri' are supported.
+
+    $ juicer merge my-stylesheet.css -o my-stylesheet.merged.css --embed-images data_uri
+    
+The result will look similar to this:
+
+    h1 { background: url(data:image/png;base64,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); }
+
+Embedding images in stylesheets should be used very carefully, as they will bloat 
+your css files considerably, and you will loose some of the fine grained control 
+over caching of images.
+
+Before using Juicer to embed images into your stylesheets, you should have control 
+over cache expiration of stylesheets.
+
+You should also have gzip enabled, as base64 encoded images take up about 30% more 
+space than serving them normally. With gzip enabled this is reduced to about 5-10% bloat. 
+
+==== Usage scenario: Modern browsers and IE7, IE6 support
+
+As all of the major browsers in their later incarnations support the data uri scheme, 
+it is possible to just create two merged stylesheets, although you can create as many 
+as you want really.
+
+Let's assume you have the following files:
+
+* reset.css
+* layout.css
+* typography.css
+
+    /* layout.css */
+    body { background: url( /images/my-body-background.png?embed=true); }
+
+And let's assume that you want to merge these, and embed the flagged images in 
+layout.css into the stylesheet.
+
+To do this, you would have a master stylesheet that imports the other stylesheets using 
+the @import statemet. It could look like this:
+
+    /* master.css */
+    @import url(reset.css)
+    @import url(layout.css)
+    @import url(typography.css)
+
+Now, in order to create the two versions of the stylesheet, you would simply run 
+Juicer with and without the option to embed images
+
+    $ juicer merge master.css -o master.embedded.css --embed-images data_uri
+    $ juicer merge master.css -o master.normal.css
+    
+In order to only load the relevant stylesheet to supporting browsers, and preventing 
+doubling the effective payload of the background images, you would reference the 
+stylesheets like this:
+
+    <head>
+        ...
+        <!--[if !IE]>-->
+            <link rel="stylesheet" type="text/css" href="master.embedded.css" />
+        <!--<![endif]-->
+        <!--[if gte IE 8]>
+            <link rel="stylesheet" type="text/css" href="master.embedded.css" />
+        <![endif]-->
+        <!--[if lte IE 7]>
+            <link rel="stylesheet" type="text/css" href="master.normal.css" />
+        <![endif]-->
+        ...
+    </head>
+
+The first conditional comemnt allows only non-IE browsers to fetch the 
+<code>master.embedded.css</code> stylesheet.
+
+The second conditional comment allows only IE8+ browsers to fetch the 
+<code>master.embedded.css</code> stylesheet.
+
+The last conditional comment allows only IE7 and lower to fetch the 
+<code>master.normal.css</code> stylesheet.
+    
+Unfortunately, you will need to use three conditional comments, or you will end 
+up with an unsightly "-->" displayed at the top of your pages in IE.
+
+==== Browser support
+Windows Vista, Windows 2003, Windows 7
+Tests needed
+
+Windows XP
+* IE8 - up to 32kb IS supported
+* Firefox 3.5.2 - OK 
+* Opera 9.64 - OK
+* Chrome 3 - OK
+* Safari 4 - OK
+
+OS X 10.6.1
+* Firefox 3.5 - OK
+* Firefox 2.0.20 - OK
+* Safari 4 - OK
+* Opera 10 - OK
+* Opera 9.27 - OK
+* Opera 8.0 - OK
+* Camino 1.6.10 - OK
+
+Debian
+* Opera 10 - OK
+
+Android
+* WebKit - OK
+
+iPhone
+* Safari - OK
+
+The test used is located at http://roderick.dk/experiments/data-uri-limits/
+
+The test used tests loading of styles using the href attribute, it is ASSUMED 
+that loading images from data-uri in css has similar support.
+Soon[tm] there will be a testpage with images as well.
+
+If you have funky browser / OS combinations not listed above, please visit the 
+test and send a screenshot and details about browser and OS to morgan@roderick.dk
+
+
+==== Support for really old user-agents
+If you plan to support user-agents that do understand conditional comments and 
+does not support the data uri scheme, you will have to do some kind of detection 
+of support. These user-agents would be very rare, as our browser testing shows, 
+most modern user agents support data-uris.
+
+* http://weston.ruter.net/2009/05/07/detecting-support-for-data-uris/
+
+Please note that image embedding is NOT a silver bullet, but can help reduce 
+the amount of HTTP connections needed for a page.
+
+
+==== MHTML Support
+
+Due to MHTML being very awkward in it's implementation (having the absolute url 
+including protocol inside the stylesheet itself), it was decided to be of very
+little real value and attempts at supporting it has been dropped.
+
+
+==== Further reading
+
+* http://www.websiteoptimization.com/speed/tweak/inline-images/
+* http://en.wikipedia.org/wiki/Data_URI_scheme
+
+
+== PLANNED FEATURES:
+
+* Support more minifiers, JsMin (Ruby port), Packer and possibly others
+* Add support for CssTidy to compress CSS files
+
+If you have any ideas, feature requests, want to contribute or whatever, fork
+the project on github, or get in touch through christian (at) cjohansen.no.
+
+== SYNOPSIS:
+
+  juicer merge myfile.css
+  -> Produces myfile.min.css which may contain several CSS files, minified
+
+  juicer merge myfile.js
+  -> Produces myfile.min.js, minified and combined
+
+  juicer help
+
+== REQUIREMENTS:
+
+In order to use YUI Compressor, Closure Compiler or JsMin (requires Rhino) you need Java
+installed and the java executable available on your path.
+
+== INSTALL:
+
+  $ gem install juicer
+  $ juicer install yui_compressor
+  $ juicer install closure_compiler
+  $ juicer install jslint
+
+You need Java installed and available on your PATH. During gem installation,
+Juicer will download and install YUI Compressor, Closure Compiler, JsLint and Rhino for you.
+
+  rake check_dependencies:development
+  
+Will tell you about other dependencies that might be missing on your system.
+
+
+== Contributors
+
+* Morgan Roderick (http://roderick.dk)
+  Added support for embedding graphics using data-uri
+  Several small fixes and optimizations
+* Pavel Valodzka (http://github.com/valodzka)
+  Added Google Closure Compiler support
+* Daniel Stockman (http://evocateur.org/)
+  Fixed `juicer list` when running it against files with no dependencies
+* Aaron Suggs (http://ktheory.com)
+  Added support for depending on directories
+  Fixed installers on 1.0 branch
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2008-2010 Christian Johansen
+
+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.