Class: Sprockets::Utils::Gzip

Inherits:
Object
  • Object
show all
Defined in:
lib/sprockets/utils/gzip.rb

Instance Method Summary collapse

Constructor Details

#initialize(asset) ⇒ Gzip

Private: Generates a gzipped file based off of reference file.



5
6
7
8
9
 
# File 'lib/sprockets/utils/gzip.rb', line 5

def initialize(asset)
  @content_type  = asset.content_type
  @source        = asset.source
  @charset       = asset.charset
end

Instance Method Details

#can_compress?(mime_types) ⇒ Boolean

Private: Returns whether or not an asset can be compressed.

We want to compress any file that is text based. You do not want to compress binary files as they may already be compressed and running them through a compression algorithm would make them larger.

Return Boolean.

Returns:

  • (Boolean) 


19
20
21
22
23
24
25
26
27
 
# File 'lib/sprockets/utils/gzip.rb', line 19

def can_compress?(mime_types)
  # The "charset" of a mime type is present if the value is
  # encoded text. We can check this value to see if the asset
  # can be compressed.
  #
  # SVG images are text but do not have
  # a charset defined, this is special cased.
  @charset || @content_type == "image/svg+xml".freeze
end

#cannot_compress?(mime_types) ⇒ Boolean

Private: Opposite of ‘can_compress?`.

Returns Boolean.

Returns:

  • (Boolean) 


32
33
34
 
# File 'lib/sprockets/utils/gzip.rb', line 32

def cannot_compress?(mime_types)
  !can_compress?(mime_types)
end

#compress(target) ⇒ Object

Private: Generates a gzipped file based off of reference asset.

Compresses the target asset’s contents and puts it into a file with the same name plus a ‘.gz` extension in the same folder as the original. Does not modify the target asset.

Returns nothing.



43
44
45
46
47
48
49
50
51
52
53
54
55
 
# File 'lib/sprockets/utils/gzip.rb', line 43

def compress(target)
  mtime = PathUtils.stat(target).mtime
  PathUtils.atomic_write("#{target}.gz") do |f|
    gz = Zlib::GzipWriter.new(f, Zlib::BEST_COMPRESSION)
    gz.mtime = mtime
    gz.write(@source)
    gz.close

    File.utime(mtime, mtime, f.path)
  end

  nil
end