sbader-yui-compressor 0.9.6

data/Rakefile

@@ -0,0 +1,21 @@
+require "rubygems"
+require "rake/gempackagetask"
+require "rake/rdoctask"
+require "rake/testtask"
+
+task :default => :test
+
+Rake::TestTask.new do |t|
+  t.libs += ["lib", "test"]
+  t.test_files = FileList["test/*_test.rb"]
+  t.verbose = true
+end
+
+Rake::RDocTask.new do |t|
+  t.rdoc_files.include("README.rdoc", "lib/**/*.rb")
+end
+
+Rake::GemPackageTask.new(eval(IO.read(File.join(File.dirname(__FILE__), "yui-compressor.gemspec")))) do |pkg|
+  pkg.need_zip = true
+  pkg.need_tar = true
+end

data/lib/yui/compressor.rb

@@ -0,0 +1,216 @@
+require "popen4"
+require "shellwords"
+require "stringio"
+
+module YUI #:nodoc:
+  class Compressor
+    VERSION = "0.9.6"
+
+    class Error < StandardError; end
+    class OptionError   < Error; end
+    class RuntimeError  < Error; end
+
+    attr_reader :options
+
+    def self.default_options #:nodoc:
+      { :charset => "utf-8", :line_break => nil }
+    end
+
+    def self.compressor_type #:nodoc:
+      raise Error, "create a CssCompressor or JavaScriptCompressor instead"
+    end
+
+    def initialize(options = {}) #:nodoc:
+      @options = self.class.default_options.merge(options)
+      @command = [path_to_java, "-jar", path_to_jar_file, *(command_option_for_type + command_options)]
+    end
+
+    def command #:nodoc:
+      @command.map { |word| Shellwords.escape(word) }.join(" ")
+    end
+
+    # Compress a stream or string of code with YUI Compressor. (A stream is
+    # any object that responds to +read+ and +close+ like an IO.) If a block
+    # is given, you can read the compressed code from the block's argument.
+    # Otherwise, +compress+ returns a string of compressed code.
+    #
+    # ==== Example: Compress CSS
+    #   compressor = YUI::CssCompressor.new
+    #   compressor.compress(<<-END_CSS)
+    #     div.error {
+    #       color: red;
+    #     }
+    #     div.warning {
+    #       display: none;
+    #     }
+    #   END_CSS
+    #   # => "div.error{color:red;}div.warning{display:none;}"
+    #
+    # ==== Example: Compress JavaScript
+    #   compressor = YUI::JavaScriptCompressor.new
+    #   compressor.compress('(function () { var foo = {}; foo["bar"] = "baz"; })()')
+    #   # => "(function(){var foo={};foo.bar=\"baz\"})();"
+    #
+    # ==== Example: Compress and gzip a file on disk
+    #   File.open("my.js", "r") do |source|
+    #     Zlib::GzipWriter.open("my.js.gz", "w") do |gzip|
+    #       compressor.compress(source) do |compressed|
+    #         while buffer = compressed.read(4096)
+    #           gzip.write(buffer)
+    #         end
+    #       end
+    #     end
+    #   end
+    #
+    def compress(stream_or_string)
+      streamify(stream_or_string) do |stream|
+        output = true
+        status = POpen4.popen4(command, "b") do |stdout, stderr, stdin, pid|
+          begin
+            stdin.binmode
+            transfer(stream, stdin)
+
+            if block_given?
+              yield stdout
+            else
+              output = stdout.read
+            end
+
+          rescue Exception => e
+            raise RuntimeError, "compression failed"
+          end
+        end
+
+        if status.exitstatus.zero?
+          output
+        else
+          raise RuntimeError, "compression failed"
+        end
+      end
+    end
+
+    private
+      def command_options
+        options.inject([]) do |command_options, (name, argument)|
+          method = begin
+            method(:"command_option_for_#{name}")
+          rescue NameError
+            raise OptionError, "undefined option #{name.inspect}"
+          end
+
+          command_options.concat(method.call(argument))
+        end
+      end
+
+      def path_to_java
+        options.delete(:java) || "java"
+      end
+
+      def path_to_jar_file
+        options.delete(:jar_file) || File.join(File.dirname(__FILE__), *%w".. yuicompressor-2.4.7.jar")
+      end
+
+      def streamify(stream_or_string)
+        if stream_or_string.respond_to?(:read)
+          yield stream_or_string
+        else
+          yield StringIO.new(stream_or_string.to_s)
+        end
+      end
+
+      def transfer(from_stream, to_stream)
+        while buffer = from_stream.read(4096)
+          to_stream.write(buffer)
+        end
+        from_stream.close
+        to_stream.close
+      end
+
+      def command_option_for_type
+        ["--type", self.class.compressor_type.to_s]
+      end
+
+      def command_option_for_charset(charset)
+        ["--charset", charset.to_s]
+      end
+
+      def command_option_for_line_break(line_break)
+        line_break ? ["--line-break", line_break.to_s] : []
+      end
+  end
+
+  class CssCompressor < Compressor
+    def self.compressor_type #:nodoc:
+      "css"
+    end
+
+    # Creates a new YUI::CssCompressor for minifying CSS code.
+    #
+    # Options are:
+    #
+    # <tt>:charset</tt>::    Specifies the character encoding to use. Defaults to
+    #                        <tt>"utf-8"</tt>.
+    # <tt>:line_break</tt>:: By default, CSS will be compressed onto a single
+    #                        line. Use this option to specify the maximum
+    #                        number of characters in each line before a newline
+    #                        is added. If <tt>:line_break</tt> is 0, a newline
+    #                        is added after each CSS rule.
+    #
+    def initialize(options = {})
+      super
+    end
+  end
+
+  class JavaScriptCompressor < Compressor
+    def self.compressor_type #:nodoc:
+      "js"
+    end
+
+    def self.default_options #:nodoc:
+      super.merge(
+        :munge    => false,
+        :optimize => true,
+        :preserve_semicolons => false
+      )
+    end
+
+    # Creates a new YUI::JavaScriptCompressor for minifying JavaScript code.
+    #
+    # Options are:
+    #
+    # <tt>:charset</tt>::    Specifies the character encoding to use. Defaults to
+    #                        <tt>"utf-8"</tt>.
+    # <tt>:line_break</tt>:: By default, JavaScript will be compressed onto a
+    #                        single line. Use this option to specify the
+    #                        maximum number of characters in each line before a
+    #                        newline is added. If <tt>:line_break</tt> is 0, a
+    #                        newline is added after each JavaScript statement.
+    # <tt>:munge</tt>::      Specifies whether YUI Compressor should shorten local
+    #                        variable names when possible. Defaults to +false+.
+    # <tt>:optimize</tt>::   Specifies whether YUI Compressor should optimize
+    #                        JavaScript object property access and object literal
+    #                        declarations to use as few characters as possible.
+    #                        Defaults to +true+.
+    # <tt>:preserve_semicolons</tt>:: Defaults to +false+. If +true+, YUI
+    #                                 Compressor will ensure semicolons exist
+    #                                 after each statement to appease tools like
+    #                                 JSLint.
+    #
+    def initialize(options = {})
+      super
+    end
+
+    private
+      def command_option_for_munge(munge)
+        munge ? [] : ["--nomunge"]
+      end
+
+      def command_option_for_optimize(optimize)
+        optimize ? [] : ["--disable-optimizations"]
+      end
+
+      def command_option_for_preserve_semicolons(preserve_semicolons)
+        preserve_semicolons ? ["--preserve-semi"] : []
+      end
+  end
+end

data/test/compressor_test.rb

@@ -0,0 +1,114 @@
+require "test/unit"
+require "yui/compressor"
+
+module YUI
+  class CompressorTest < Test::Unit::TestCase
+    FIXTURE_CSS = <<-END_CSS
+      div.warning {
+        display: none;
+      }
+
+      div.error {
+        background: red;
+        color: white;
+      }
+
+      @media screen and (max-device-width: 640px) {
+        body { font-size: 90%; }
+      }
+    END_CSS
+
+    FIXTURE_JS = <<-END_JS
+      // here's a comment
+      var Foo = { "a": 1 };
+      Foo["bar"] = (function(baz) {
+        /* here's a
+           multiline comment */
+        if (false) {
+          doSomething();
+        } else {
+          for (var index = 0; index < baz.length; index++) {
+            doSomething(baz[index]);
+          }
+        }
+      })("hello");
+    END_JS
+
+    FIXTURE_ERROR_JS = "var x = {class: 'name'};"
+
+    def test_compressor_should_raise_when_instantiated
+      assert_raises YUI::Compressor::Error do
+        YUI::Compressor.new
+      end
+    end
+
+    def test_css_should_be_compressed
+      @compressor = YUI::CssCompressor.new
+      assert_equal "div.warning{display:none}div.error{background:red;color:white}@media screen and (max-device-width:640px){body{font-size:90%}}", @compressor.compress(FIXTURE_CSS)
+    end
+
+    def test_js_should_be_compressed
+      @compressor = YUI::JavaScriptCompressor.new
+      assert_equal "var Foo={a:1};Foo.bar=(function(baz){if(false){doSomething()}else{for(var index=0;index<baz.length;index++){doSomething(baz[index])}}})(\"hello\");", @compressor.compress(FIXTURE_JS)
+    end
+
+    def test_large_js_should_be_compressed
+      assert_nothing_raised do
+        @compressor = YUI::JavaScriptCompressor.new
+        @compressor.compress(FIXTURE_JS * 200)
+      end
+    end
+
+    def test_compress_should_raise_when_an_unknown_option_is_specified
+      assert_raises YUI::Compressor::OptionError do
+        @compressor = YUI::CssCompressor.new(:foo => "bar")
+        @compressor.compress(FIXTURE_JS)
+      end
+    end
+
+    def test_compress_should_accept_an_io_argument
+      @compressor = YUI::CssCompressor.new
+      assert_equal "div.warning{display:none}div.error{background:red;color:white}@media screen and (max-device-width:640px){body{font-size:90%}}", @compressor.compress(StringIO.new(FIXTURE_CSS))
+    end
+
+    def test_compress_should_accept_a_block_and_yield_an_io
+      @compressor = YUI::CssCompressor.new
+      @compressor.compress(FIXTURE_CSS) do |stream|
+        assert_kind_of IO, stream
+        assert_equal "div.warning{display:none}div.error{background:red;color:white}@media screen and (max-device-width:640px){body{font-size:90%}}", stream.read
+      end
+    end
+
+    def test_line_break_option_should_insert_line_breaks_in_css
+      @compressor = YUI::CssCompressor.new(:line_break => 0)
+      assert_equal "div.warning{display:none}\ndiv.error{background:red;color:white}\n@media screen and (max-device-width:640px){body{font-size:90%}\n}", @compressor.compress(FIXTURE_CSS)
+    end
+
+    def test_line_break_option_should_insert_line_breaks_in_js
+      @compressor = YUI::JavaScriptCompressor.new(:line_break => 0)
+      assert_equal "var Foo={a:1};\nFoo.bar=(function(baz){if(false){doSomething()\n}else{for(var index=0;\nindex<baz.length;\nindex++){doSomething(baz[index])\n}}})(\"hello\");", @compressor.compress(FIXTURE_JS)
+    end
+
+    def test_munge_option_should_munge_local_variable_names
+      @compressor = YUI::JavaScriptCompressor.new(:munge => true)
+      assert_equal "var Foo={a:1};Foo.bar=(function(b){if(false){doSomething()}else{for(var a=0;a<b.length;a++){doSomething(b[a])}}})(\"hello\");", @compressor.compress(FIXTURE_JS)
+    end
+
+    def test_optimize_option_should_not_modify_property_accesses_or_object_literal_keys_when_false
+      @compressor = YUI::JavaScriptCompressor.new(:optimize => false)
+      assert_equal "var Foo={\"a\":1};Foo[\"bar\"]=(function(baz){if(false){doSomething()}else{for(var index=0;index<baz.length;index++){doSomething(baz[index])}}})(\"hello\");", @compressor.compress(FIXTURE_JS)
+    end
+
+    def test_preserve_semicolons_option_should_preserve_semicolons
+      @compressor = YUI::JavaScriptCompressor.new(:preserve_semicolons => true)
+      assert_equal "var Foo={a:1};Foo.bar=(function(baz){if(false){doSomething();}else{for(var index=0;index<baz.length;index++){doSomething(baz[index]);}}})(\"hello\");", @compressor.compress(FIXTURE_JS)
+    end
+
+    def test_compress_should_raise_on_javascript_syntax_error
+      @compressor = YUI::JavaScriptCompressor.new
+      assert_raise YUI::Compressor::RuntimeError do
+        @compressor.compress(FIXTURE_ERROR_JS)
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,60 @@
+--- !ruby/object:Gem::Specification
+name: sbader-yui-compressor
+version: !ruby/object:Gem::Version
+  version: 0.9.6
+  prerelease: 
+platform: ruby
+authors:
+- Sam Stephenson
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-03-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: POpen4
+  requirement: &70096501390620 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.1.4
+  type: :runtime
+  prerelease: false
+  version_requirements: *70096501390620
+description: A Ruby interface to YUI Compressor for minifying JavaScript and CSS assets.
+email: sbader2@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Rakefile
+- lib/yui/compressor.rb
+- lib/yuicompressor-2.4.7.jar
+- test/compressor_test.rb
+homepage: http://github.com/sbader/ruby-yui-compressor/
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: yui
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 3
+summary: JavaScript and CSS minification library
+test_files:
+- test/compressor_test.rb