Class: YUI::Compressor

Inherits:
Object
  • Object
show all
Defined in:
lib/yui/compressor.rb

Direct Known Subclasses

CssCompressor, JavaScriptCompressor

Defined Under Namespace

Classes: Error, OptionError, RuntimeError

Constant Summary collapse

VERSION =
"0.9.6"

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(options = {}) ⇒ Compressor

:nodoc:



23
24
25
26
# File 'lib/yui/compressor.rb', line 23

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

Instance Attribute Details

#optionsObject (readonly)

Returns the value of attribute options.



13
14
15
# File 'lib/yui/compressor.rb', line 13

def options
  @options
end

Class Method Details

.compressor_typeObject

:nodoc:

Raises:



19
20
21
# File 'lib/yui/compressor.rb', line 19

def self.compressor_type #:nodoc:
  raise Error, "create a CssCompressor or JavaScriptCompressor instead"
end

.default_optionsObject

:nodoc:



15
16
17
# File 'lib/yui/compressor.rb', line 15

def self.default_options #:nodoc:
  { :charset => "utf-8", :line_break => nil }
end

Instance Method Details

#commandObject

:nodoc:



28
29
30
# File 'lib/yui/compressor.rb', line 28

def command #:nodoc:
  @command.map { |word| Shellwords.escape(word) }.join(" ")
end

#compress(stream_or_string) ⇒ Object

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


65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
# File 'lib/yui/compressor.rb', line 65

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