Sprockets::Utils

`Utils`, we didn't know where else to put it!

Constants

UTF16_BOM_PATTERN
UTF8_BOM_PATTERN

Define UTF-8 BOM pattern matcher. Avoid using a Regexp literal because it inheirts the files encoding and we want to avoid syntax errors in other interpreters.

Public Class Methods

normalize_extension(extension) click to toggle source

Prepends a leading "." to an extension if its missing.

normalize_extension("js")
# => ".js"

normalize_extension(".css")
# => ".css"
# File lib/sprockets/utils.rb, line 58
def self.normalize_extension(extension)
  extension = extension.to_s
  if extension[/^\./]
    extension
  else
    ".#{extension}"
  end
end
read_unicode(pathname) click to toggle source
# File lib/sprockets/utils.rb, line 11
def self.read_unicode(pathname)
  pathname.read.tap do |data|
    # Eager validate the file's encoding. In most cases we
    # expect it to be UTF-8 unless `default_external` is set to
    # something else. An error is usually raised if the file is
    # saved as UTF-16 when we expected UTF-8.
    if !data.valid_encoding?
      raise EncodingError, "#{pathname} has a invalid " +
        "#{data.encoding} byte sequence"

    # If the file is UTF-8 and theres a BOM, strip it for safe concatenation.
    elsif data.encoding.name == "UTF-8" && data =~ UTF8_BOM_PATTERN
      data.sub!(UTF8_BOM_PATTERN, "")
    end
  end
end

[Validate]

Generated with the Darkfish Rdoc Generator 2.