reduce 0.2.0

data/.gitignore

@@ -0,0 +1,2 @@
+pkg
+spec/files/*.min

data/README.markdown

@@ -0,0 +1,32 @@
+Lossless reduction for js, css, jpg, png, gif 
+
+Install
+=======
+    install ruby + rubygems
+    sudo gem install reduce
+
+Usage
+=====
+    reduce -o public/image.gif
+    reduce public/javascripts/application.js > public/javascripts/application.min.js
+
+Options
+=======
+    -o, --overwrite                  overwrite file
+    -v, --version                    Show Version
+    -h, --help                       Show this.
+
+Ruby
+====
+    reduced_data = Reduce.reduce('files/bla.js')
+
+How does it work?
+=================
+ - uses web-based lossless image reduction service [Smush.it](http://smush.it) / [PunyPng](http://www.gracepointafterfive.com/punypng) through [smusher](http://github.com/grosser/smusher)
+ - uses YUI compressor to minify css/js
+
+Author
+======
+Michael Grosser  
+grosser.michael@gmail.com  
+Hereby placed under public domain, do what you want, just do not hold me accountable...  

data/Rakefile

@@ -0,0 +1,20 @@
+task :default => :spec
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new {|t| t.spec_opts = ['--color']}
+
+begin
+  require 'jeweler'
+  project_name = 'reduce'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "reduce"
+    gem.summary = "Reduce your assets: minify javascript + stylesheets, optimize images lossless"
+    gem.email = "grosser.michael@gmail.com"
+    gem.homepage = "http://github.com/grosser/#{project_name}"
+    gem.authors = ["Michael Grosser"]
+    gem.add_dependency ['smusher']
+  end
+
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler, or one of its dependencies, is not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
+end

data/VERSION

@@ -0,0 +1 @@
+0.2.0

data/bin/reduce

@@ -0,0 +1,33 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+require 'optparse'
+require 'reduce'
+
+options = {}
+OptionParser.new do |opts|
+  opts.banner = <<BANNER
+Lossless optimize js, css, jpg, png, gif
+
+Usage:
+    reduce -o public/image.gif
+    reduce public/javascripts/application.js > public/javascripts/application.min.js
+
+Options are:
+BANNER
+  opts.on("-o", "--overwrite", "overwrite file") { options[:overwrite]=true }
+  opts.on('-v', '--version', 'Show Version'){ puts Reduce::VERSION; exit}
+  opts.on("-h", "--help", "Show this.") { puts opts; exit }
+end.parse!
+
+file = ARGV.first
+if file.to_s.empty? or not File.exist?(file)
+  puts "Usage instructions: reduce --help"
+  exit
+else
+  data = Reduce.reduce(file)
+  if options[:overwrite]
+    File.open(file, 'w'){|f| f.print data}
+  else
+    print data
+  end
+end

data/lib/reduce.rb

@@ -0,0 +1,35 @@
+require 'smusher'
+raise "please install a newer version of smusher" if Smusher::VERSION < '0.4.0'
+
+module Reduce
+  extend self
+
+  VERSION = File.read( File.join(File.dirname(__FILE__),'..','VERSION') ).strip
+
+  def reduce(file)
+    extension = File.extname(file).downcase.sub('.','')
+    case extension
+    when 'js','css'
+      compressor = File.join(File.dirname(__FILE__),'..','vendor','yuicompressor*.jar')
+      `java -jar #{compressor} --type #{extension} #{file}`
+    when 'jpg', 'jpeg', 'png', 'gif'
+      reduce_image file
+    else
+      raise "reduce does not know how to handle a .#{extension} file (#{file})"
+    end
+  end
+
+  private
+
+  def reduce_image(input)
+    output = input+'.temp'
+    FileUtils.cp(input, output)
+
+    service = (input.downcase =~ /\.gif$/ ? 'PunyPng' : 'SmushIt')
+    Smusher.optimize_image(output, :quiet=>true, :service => service)
+
+    data = File.read(output)
+    FileUtils.rm(output)
+    data
+  end
+end

data/reduce.gemspec

@@ -0,0 +1,59 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{reduce}
+  s.version = "0.2.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Michael Grosser"]
+  s.date = %q{2009-11-22}
+  s.default_executable = %q{reduce}
+  s.email = %q{grosser.michael@gmail.com}
+  s.executables = ["reduce"]
+  s.extra_rdoc_files = [
+    "README.markdown"
+  ]
+  s.files = [
+    ".gitignore",
+     "README.markdown",
+     "Rakefile",
+     "VERSION",
+     "bin/reduce",
+     "lib/reduce.rb",
+     "reduce.gemspec",
+     "spec/files/facebox.css",
+     "spec/files/facebox.js",
+     "spec/files/paintcan.png",
+     "spec/files/test.gif",
+     "spec/reduce_spec.rb",
+     "spec/spec_helper.rb",
+     "vendor/README",
+     "vendor/yuicompressor-2.4.2.jar"
+  ]
+  s.homepage = %q{http://github.com/grosser/reduce}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Reduce your assets: minify javascript + stylesheets, optimize images lossless}
+  s.test_files = [
+    "spec/spec_helper.rb",
+     "spec/reduce_spec.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<smusher>, [">= 0"])
+    else
+      s.add_dependency(%q<smusher>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<smusher>, [">= 0"])
+  end
+end
+

data/spec/files/facebox.css

@@ -0,0 +1,99 @@
+#facebox .b {
+  background:url(/images/facebox/b.png);
+}
+
+#facebox .tl {
+  background:url(/images/facebox/tl.png);
+}
+
+#facebox .tr {
+  background:url(/images/facebox/tr.png);
+}
+
+#facebox .bl {
+  background:url(/images/facebox/bl.png);
+}
+
+#facebox .br {
+  background:url(/images/facebox/br.png);
+}
+
+#facebox {
+  position: absolute;
+  top: 0;
+  left: 0;
+  z-index: 100;
+  text-align: left;
+}
+
+#facebox .popup {
+  position: relative;
+}
+
+#facebox table {
+  border-collapse: collapse;
+}
+
+#facebox td {
+  border-bottom: 0;
+  padding: 0;
+}
+
+#facebox .body {
+  padding: 10px;
+  background: #fff;
+  width: 370px;
+}
+
+#facebox .loading {
+  text-align: center;
+}
+
+#facebox .image {
+  text-align: center;
+}
+
+#facebox img {
+  border: 0;
+  margin: 0;
+}
+
+#facebox .footer {
+  border-top: 1px solid #DDDDDD;
+  padding-top: 5px;
+  margin-top: 10px;
+  text-align: right;
+}
+
+#facebox .footer img {
+  vertical-align: middle;
+}
+
+#facebox .tl, #facebox .tr, #facebox .bl, #facebox .br {
+  height: 10px;
+  width: 10px;
+  overflow: hidden;
+  padding: 0;
+}
+
+#facebox_overlay {
+  position: fixed;
+  top: 0px;
+  left: 0px;
+  height:100%;
+  width:100%;
+}
+
+.facebox_hide {
+  z-index:-100;
+}
+
+.facebox_overlayBG {
+  background-color: #000;
+  z-index: 99;
+}
+
+* html #facebox_overlay { /* ie6 hack */
+  position: absolute;
+  height: expression(document.body.scrollHeight > document.body.offsetHeight ? document.body.scrollHeight : document.body.offsetHeight + 'px');
+}

data/spec/files/facebox.js

@@ -0,0 +1,336 @@
+/*
+ * Facebox (for jQuery)
+ * version: 1.2 (05/05/2008)
+ * @requires jQuery v1.2 or later
+ *
+ * Examples at http://famspam.com/facebox/
+ *
+ * Licensed under the MIT:
+ *   http://www.opensource.org/licenses/mit-license.php
+ *
+ * Copyright 2007, 2008 Chris Wanstrath [ chris@ozmm.org ]
+ *
+ * Usage:
+ *  
+ *  jQuery(document).ready(function() {
+ *    jQuery('a[rel*=facebox]').facebox() 
+ *  })
+ *
+ *  <a href="#terms" rel="facebox">Terms</a>
+ *    Loads the #terms div in the box
+ *
+ *  <a href="terms.html" rel="facebox">Terms</a>
+ *    Loads the terms.html page in the box
+ *
+ *  <a href="terms.png" rel="facebox">Terms</a>
+ *    Loads the terms.png image in the box
+ *
+ *
+ *  You can also use it programmatically:
+ * 
+ *    jQuery.facebox('some html')
+ *    jQuery.facebox('some html', 'my-groovy-style')
+ *
+ *  The above will open a facebox with "some html" as the content.
+ *    
+ *    jQuery.facebox(function($) { 
+ *      $.get('blah.html', function(data) { $.facebox(data) })
+ *    })
+ *
+ *  The above will show a loading screen before the passed function is called,
+ *  allowing for a better ajaxy experience.
+ *
+ *  The facebox function can also display an ajax page, an image, or the contents of a div:
+ *  
+ *    jQuery.facebox({ ajax: 'remote.html' })
+ *    jQuery.facebox({ ajax: 'remote.html' }, 'my-groovy-style')
+ *    jQuery.facebox({ image: 'stairs.jpg' })
+ *    jQuery.facebox({ image: 'stairs.jpg' }, 'my-groovy-style')
+ *    jQuery.facebox({ div: '#box' })
+ *    jQuery.facebox({ div: '#box' }, 'my-groovy-style')
+ *
+ *  Want to close the facebox?  Trigger the 'close.facebox' document event:
+ *
+ *    jQuery(document).trigger('close.facebox')
+ *
+ *  Facebox also has a bunch of other hooks:
+ *
+ *    loading.facebox
+ *    beforeReveal.facebox
+ *    reveal.facebox (aliased as 'afterReveal.facebox')
+ *    init.facebox
+ *
+ *  Simply bind a function to any of these hooks:
+ *
+ *   $(document).bind('reveal.facebox', function() { ...stuff to do after the facebox and contents are revealed... })
+ *
+ */
+(function($) {
+  $.facebox = function(data, klass) {
+    $.facebox.loading()
+
+    if (data.ajax) fillFaceboxFromAjax(data.ajax, klass)
+    else if (data.image) fillFaceboxFromImage(data.image, klass)
+    else if (data.div) fillFaceboxFromHref(data.div, klass)
+    else if ($.isFunction(data)) data.call($)
+    else $.facebox.reveal(data, klass)
+  }
+
+  /*
+   * Public, $.facebox methods
+   */
+
+  $.extend($.facebox, {
+    //possible option: noAutoload --- will build facebox only when it is needed
+    settings: {
+      opacity      : 0,
+      overlay      : true,
+      imagePath    : '/images/facebox/',
+      loadingImage : 'loading.gif',
+      closeImage   : 'closelabel.gif',
+      imageTypes   : [ 'png', 'jpg', 'jpeg', 'gif' ]
+    },
+
+    html : function(){
+      return '\
+<div id="facebox" style="display:none;"> \
+  <div class="popup"> \
+    <table> \
+      <tbody> \
+        <tr> \
+          <td class="tl"/><td class="b"/><td class="tr"/> \
+        </tr> \
+        <tr> \
+          <td class="b"/> \
+          <td class="body"> \
+            <div class="content"> \
+            </div> \
+            <div class="footer"> \
+              <a href="#" class="close"> \
+                <img src="'+$.facebox.settings.imagePath+$.facebox.settings.closeImage+'" title="close" class="close_image" /> \
+              </a> \
+            </div> \
+          </td> \
+          <td class="b"/> \
+        </tr> \
+        <tr> \
+          <td class="bl"/><td class="b"/><td class="br"/> \
+        </tr> \
+      </tbody> \
+    </table> \
+  </div> \
+</div>'
+    },
+
+    loading: function() {
+      init()
+      var $f = $('#facebox')
+      if ($f.find('.loading').length == 1) return true
+      showOverlay()
+
+      $f.find('.content').empty()
+      $f.find('.body').children().hide().end().
+        append('<div class="loading"><img src="'+$.facebox.settings.imagePath+$.facebox.settings.loadingImage+'"/></div>')
+
+      $f.css({
+        top:	getPageScroll()[1] + (getPageHeight() / 10),
+        left:	$(window).width() / 2 - 205 
+      }).show()
+
+      $(document).bind('keydown.facebox', function(e) {
+        if (e.keyCode == 27) $.facebox.close()
+        return true
+      })
+      $(document).trigger('loading.facebox')
+    },
+
+    reveal: function(data, klass) {
+      $(document).trigger('beforeReveal.facebox')
+      var $f = $('#facebox')
+      if (klass) $('#facebox .content').addClass(klass)
+      $f.find('.content').append(data)
+      $f.find('.loading').remove()
+      $f.find('.body').children().fadeIn('normal')
+      $f.css('left', $(window).width() / 2 - ($('#facebox table').width() / 2))
+      $(document).trigger('reveal.facebox').trigger('afterReveal.facebox')
+    },
+
+    close: function() {
+      $(document).trigger('close.facebox')
+      return false
+    }
+  })
+
+  /*
+   * Public, $.fn methods
+   */
+
+  $.fn.facebox = function(settings) {
+    merge_settings(settings)
+    if(!settings.noAutoload)init()
+
+    return this.bind('click.facebox',function(){
+      $.facebox.loading()
+
+      // support for rel="facebox.inline_popup" syntax, to add a class
+      // also supports deprecated "facebox[.inline_popup]" syntax
+      var klass = this.rel.match(/facebox\[?\.(\w+)\]?/)
+      if (klass) klass = klass[1]
+
+      fillFaceboxFromHref(this.href, klass)
+      return false
+    })
+  }
+
+  /*
+   * Private methods
+   */
+
+  function merge_settings(settings){
+    $.extend($.facebox.settings, settings)
+  }
+
+  // called one time to setup facebox on this page
+  function init() {
+    if ($.facebox.settings.inited) return
+    else $.facebox.settings.inited = true
+
+    $(document).trigger('init.facebox')
+    makeCompatible()
+
+    var imageTypes = $.facebox.settings.imageTypes.join('|')
+    $.facebox.settings.imageTypesRegexp = new RegExp('\.(' + imageTypes + ')$', 'i')
+
+    $('body').append($.facebox.html())
+    if(! $.facebox.settings.noAutoload)preloadImages()
+    $('#facebox .close').click($.facebox.close)
+  }
+
+  function preloadImages(){
+    var preload = [ new Image(), new Image() ]
+    var path = $.facebox.settings.imagePath
+    preload[0].src = path + $.facebox.settings.closeImage
+    preload[1].src = path + $.facebox.settings.loadingImage
+
+    $('#facebox').find('.b:first, .bl, .br, .tl, .tr').each(function() {
+      preload.push(new Image())
+      preload.slice(-1).src = $(this).css('background-image').replace(/url\((.+)\)/, '$1')
+    })
+  }
+
+  // getPageScroll() by quirksmode.com
+  function getPageScroll() {
+    var xScroll, yScroll;
+    if (self.pageYOffset) {
+      yScroll = self.pageYOffset;
+      xScroll = self.pageXOffset;
+    } else if (document.documentElement && document.documentElement.scrollTop) {	 // Explorer 6 Strict
+      yScroll = document.documentElement.scrollTop;
+      xScroll = document.documentElement.scrollLeft;
+    } else if (document.body) {// all other Explorers
+      yScroll = document.body.scrollTop;
+      xScroll = document.body.scrollLeft;	
+    }
+    return new Array(xScroll,yScroll) 
+  }
+
+  // Adapted from getPageSize() by quirksmode.com
+  function getPageHeight() {
+    var windowHeight
+    if (self.innerHeight) {	// all except Explorer
+      windowHeight = self.innerHeight;
+    } else if (document.documentElement && document.documentElement.clientHeight) { // Explorer 6 Strict Mode
+      windowHeight = document.documentElement.clientHeight;
+    } else if (document.body) { // other Explorers
+      windowHeight = document.body.clientHeight;
+    }	
+    return windowHeight
+  }
+
+  // Backwards compatibility
+  function makeCompatible() {
+    var $s = $.facebox.settings
+
+    $s.loadingImage = $s.loading_image || $s.loadingImage
+    $s.closeImage = $s.close_image || $s.closeImage
+    $s.imageTypes = $s.image_types || $s.imageTypes
+    $s.faceboxHtml = $s.facebox_html || $s.faceboxHtml
+  }
+
+  // Figures out what you want to display and displays it
+  // formats are:
+  //     div: #id
+  //   image: blah.extension
+  //    ajax: anything else
+  function fillFaceboxFromHref(href, klass) {
+    // div
+    if (href.match(/#/)) {
+      var url    = window.location.href.split('#')[0]
+      var target = href.replace(url,'')
+      $.facebox.reveal($(target).show().replaceWith("<div id='facebox_moved'></div>"), klass)
+
+    // image
+    } else if (href.match($.facebox.settings.imageTypesRegexp)) {
+      fillFaceboxFromImage(href, klass)
+    // ajax
+    } else {
+      fillFaceboxFromAjax(href, klass)
+    }
+  }
+
+  function fillFaceboxFromImage(href, klass) {
+    var image = new Image()
+    image.onload = function() {
+      $.facebox.reveal('<div class="image"><img src="' + image.src + '" /></div>', klass)
+    }
+    image.src = href
+  }
+
+  function fillFaceboxFromAjax(href, klass) {
+    $.get(href, function(data) { $.facebox.reveal(data, klass) })
+  }
+
+  function skipOverlay() {
+    return $.facebox.settings.overlay == false || $.facebox.settings.opacity === null 
+  }
+
+  function showOverlay() {
+    if (skipOverlay()) return
+
+    if ($('#facebox_overlay').length == 0) 
+      $("body").append('<div id="facebox_overlay" class="facebox_hide"></div>')
+
+    $('#facebox_overlay').hide().addClass("facebox_overlayBG")
+      .css('opacity', $.facebox.settings.opacity)
+      .click(function() { $(document).trigger('close.facebox') })
+      .fadeIn(200)
+    return false
+  }
+
+  function hideOverlay() {
+    if (skipOverlay()) return
+
+    $('#facebox_overlay').fadeOut(200, function(){
+      $("#facebox_overlay").removeClass("facebox_overlayBG").
+        addClass("facebox_hide").
+        remove()
+    })
+    
+    return false
+  }
+
+  /*
+   * Bindings
+   */
+
+  $(document).bind('close.facebox', function() {
+    $(document).unbind('keydown.facebox')
+    $('#facebox').fadeOut(function() {
+      if ($('#facebox_moved').length == 0) $('#facebox .content').removeClass().addClass('content')
+      else $('#facebox_moved').replaceWith($('#facebox .content').children().hide())
+      hideOverlay()
+      $('#facebox .loading').remove()
+    })
+  })
+
+})(jQuery);

data/spec/reduce_spec.rb

@@ -0,0 +1,33 @@
+require File.expand_path("spec_helper", File.dirname(__FILE__))
+files = File.join(File.dirname(__FILE__),'files')
+
+def cleanup(files)
+  Dir[files+'/*.min.*', files+'/*.temp'].each{|f| FileUtils.rm(f)}
+end
+
+describe Reduce do
+  after(:all){ cleanup(files) }
+
+  cleanup(files)
+  Dir[files+'/*.*'].each do |file|
+    extension = File.extname(file)
+    it "reduces #{File.extname(file)} and returns the content" do
+      data = Reduce.reduce(file)
+      data.length.should < File.size(file)
+    end
+  end
+
+  it "uses PunyPng for gifs" do
+    Smusher.should_receive(:optimize_image).with(anything, hash_including(:service => 'PunyPng'))
+    Reduce.reduce(File.join(files, 'test.gif'))
+  end
+
+  it "uses SmushIt for other images" do
+    Smusher.should_receive(:optimize_image).with(anything, hash_including(:service => 'SmushIt'))
+    Reduce.reduce(File.join(files, 'paintcan.png'))
+  end
+
+  it "has a VERSION" do
+    Reduce::VERSION.should =~ /^\d+\.\d+\.\d+$/
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,23 @@
+# ---- requirements
+require 'rubygems'
+
+$LOAD_PATH << File.expand_path("../lib", File.dirname(__FILE__))
+require 'reduce'
+
+# ---- bugfix
+#`exit?': undefined method `run?' for Test::Unit:Module (NoMethodError)
+#can be solved with require test/unit but this will result in extra test-output
+module Test
+  module Unit
+    def self.run?
+      true
+    end
+  end
+end
+
+# ---- Helpers
+def pending_it(text,&block)
+  it text do
+    pending(&block)
+  end
+end

data/vendor/README

@@ -0,0 +1,135 @@
+==============================================================================
+YUI Compressor
+==============================================================================
+
+NAME
+
+  YUI Compressor - The Yahoo! JavaScript and CSS Compressor
+
+SYNOPSIS
+
+  Usage: java -jar yuicompressor-x.y.z.jar [options] [input file]
+
+  Global Options
+    -h, --help                Displays this information
+    --type <js|css>           Specifies the type of the input file
+    --charset <charset>       Read the input file using <charset>
+    --line-break <column>     Insert a line break after the specified column number
+    -v, --verbose             Display informational messages and warnings
+    -o <file>                 Place the output into <file>. Defaults to stdout.
+
+  JavaScript Options
+    --nomunge                 Minify only, do not obfuscate
+    --preserve-semi           Preserve all semicolons
+    --disable-optimizations   Disable all micro optimizations
+
+DESCRIPTION
+
+  The YUI Compressor is a JavaScript compressor which, in addition to removing
+  comments and white-spaces, obfuscates local variables using the smallest
+  possible variable name. This obfuscation is safe, even when using constructs
+  such as 'eval' or 'with' (although the compression is not optimal is those
+  cases) Compared to jsmin, the average savings is around 20%.
+
+  The YUI Compressor is also able to safely compress CSS files. The decision
+  on which compressor is being used is made on the file extension (js or css)
+
+GLOBAL OPTIONS
+
+  -h, --help
+      Prints help on how to use the YUI Compressor
+
+  --line-break
+      Some source control tools don't like files containing lines longer than,
+      say 8000 characters. The linebreak option is used in that case to split
+      long lines after a specific column. It can also be used to make the code
+      more readable, easier to debug (especially with the MS Script Debugger)
+      Specify 0 to get a line break after each semi-colon in JavaScript, and
+      after each rule in CSS.
+
+  --type js|css
+      The type of compressor (JavaScript or CSS) is chosen based on the
+      extension of the input file name (.js or .css) This option is required
+      if no input file has been specified. Otherwise, this option is only
+      required if the input file extension is neither 'js' nor 'css'.
+
+  --charset character-set
+      If a supported character set is specified, the YUI Compressor will use it
+      to read the input file. Otherwise, it will assume that the platform's
+      default character set is being used. The output file is encoded using
+      the same character set.
+
+  -o outfile
+      Place output in file outfile. If not specified, the YUI Compressor will
+      default to the standard output, which you can redirect to a file.
+
+  -v, --verbose
+      Display informational messages and warnings.
+
+JAVASCRIPT ONLY OPTIONS
+
+  --nomunge
+      Minify only. Do not obfuscate local symbols.
+
+  --preserve-semi
+      Preserve unnecessary semicolons (such as right before a '}') This option
+      is useful when compressed code has to be run through JSLint (which is the
+      case of YUI for example)
+
+  --disable-optimizations
+      Disable all the built-in micro optimizations.
+
+NOTES
+
+  + If no input file is specified, it defaults to stdin.
+
+  + The YUI Compressor requires Java version >= 1.4.
+
+  + It is possible to prevent a local variable, nested function or function
+    argument from being obfuscated by using "hints". A hint is a string that
+    is located at the very beginning of a function body like so:
+
+    function fn (arg1, arg2, arg3) {
+        "arg2:nomunge, localVar:nomunge, nestedFn:nomunge";
+
+        ...
+        var localVar;
+        ...
+
+        function nestedFn () {
+            ....
+        }
+
+        ...
+    }
+
+    The hint itself disappears from the compressed file.
+
+  + C-style comments starting with /*! are preserved. This is useful with
+    comments containing copyright/license information. For example:
+
+    /*!
+     * TERMS OF USE - EASING EQUATIONS
+     * Open source under the BSD License.
+     * Copyright 2001 Robert Penner All rights reserved.
+     */
+
+    becomes:
+
+    /*
+     * TERMS OF USE - EASING EQUATIONS
+     * Open source under the BSD License.
+     * Copyright 2001 Robert Penner All rights reserved.
+     */
+
+AUTHOR
+
+  The YUI Compressor was written and is maintained by:
+      Julien Lecomte <jlecomte@yahoo-inc.com>
+  The CSS portion is a port of Isaac Schlueter's cssmin utility.
+
+COPYRIGHT
+
+  Copyright (c) 2007, Yahoo! Inc. All rights reserved.
+  Code licensed under the BSD License:
+      http://developer.yahoo.net/yui/license.txt

metadata

@@ -0,0 +1,79 @@
+--- !ruby/object:Gem::Specification 
+name: reduce
+version: !ruby/object:Gem::Version 
+  version: 0.2.0
+platform: ruby
+authors: 
+- Michael Grosser
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-11-22 00:00:00 +01:00
+default_executable: reduce
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: smusher
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: 
+email: grosser.michael@gmail.com
+executables: 
+- reduce
+extensions: []
+
+extra_rdoc_files: 
+- README.markdown
+files: 
+- .gitignore
+- README.markdown
+- Rakefile
+- VERSION
+- bin/reduce
+- lib/reduce.rb
+- reduce.gemspec
+- spec/files/facebox.css
+- spec/files/facebox.js
+- spec/files/paintcan.png
+- spec/files/test.gif
+- spec/reduce_spec.rb
+- spec/spec_helper.rb
+- vendor/README
+- vendor/yuicompressor-2.4.2.jar
+has_rdoc: true
+homepage: http://github.com/grosser/reduce
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: "Reduce your assets: minify javascript + stylesheets, optimize images lossless"
+test_files: 
+- spec/spec_helper.rb
+- spec/reduce_spec.rb