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.10.0"

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(options = {}) ⇒ Compressor

:nodoc:



23
24
25
26
27
28
29
30
31
# File 'lib/yui/compressor.rb', line 23

def initialize(options = {}) #:nodoc:
  @options = self.class.default_options.merge(options)
  @command = [path_to_java]
  @command.push(*java_opts)
  @command.push("-jar")
  @command.push(path_to_jar_file)
  @command.push(*(command_option_for_type + command_options))
  @command.compact!
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:



33
34
35
# File 'lib/yui/compressor.rb', line 33

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("  div.error {\n    color: red;\n  }\n  div.warning {\n    display: none;\n  }\n")
# => "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


70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
# File 'lib/yui/compressor.rb', line 70

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