module Middleman::Util

def self.all_files_under(*paths)

Returns:
  • (Array) - An array of filenames

Parameters:
  • path () -- A path string or Pathname
def self.all_files_under(*paths)
  paths.flatten!
  paths.map! { |p| Pathname(p) }
  files = paths.select { |p| p.file? }
  paths.select {|p| p.directory? }.each do |dir|
    files << all_files_under(dir.children)
  end
  files.flatten
end

def self.binary?(filename)

Returns:
  • (Boolean) -

Parameters:
  • filename (String) -- The file to check.
def self.binary?(filename)
  ext = File.extname(filename)
  return true if ext == '.svgz'
  return false if Tilt.registered?(ext.sub('.',''))
  ext = ".#{ext}" unless ext.to_s[0] == ?.
  mime = ::Rack::Mime.mime_type(ext, nil) 
  unless mime
    binary_bytes = [0, 1, 2, 3, 4, 5, 6, 11, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 28, 29, 30, 31]
    s = File.read(filename, 4096) || ''        
    s.each_byte do |c|
      return true if binary_bytes.include?(c)          
    end
    return false
  end
  return false if mime.start_with?('text/')
  return false if mime.include?('xml')
  return false if mime.include?('json')
  return false if mime.include?('javascript')
  true
end

def self.extract_response_text(response)

Returns:
  • (String) - The whole response as a string.

Parameters:
  • response () -- The response from #call
def self.extract_response_text(response)
  # The rack spec states all response bodies must respond to each
  result = ''
  response.each do |part, s|
    result << part
  end
  result
end

def self.instrument(name, payload={}, &block)

Facade for ActiveSupport/Notification
def self.instrument(name, payload={}, &block)
  name << ".middleman" unless name =~ /\.middleman$/
  ::ActiveSupport::Notifications.instrument(name, payload, &block)
end

def self.logger(*args)

Returns:
  • (Middleman::Logger) - The logger
def self.logger(*args)
  if !@_logger || args.length > 0
    @_logger = ::Middleman::Logger.new(*args)
  end
  @_logger
end

def self.normalize_path(path)

Returns:
  • (String) -

Parameters:
  • path (String) --
def self.normalize_path(path)
  # The tr call works around a bug in Ruby's Unicode handling
  path.sub(%r{^/}, "").tr('','')
end

def self.path_match(matcher, path)

Returns:
  • (Boolean) - Whether the path matches the matcher

Parameters:
  • path () -- A path as a string
  • matcher () -- A matcher string/regexp/proc/etc
def self.path_match(matcher, path)
  if matcher.respond_to? :match
    matcher.match path
  elsif matcher.respond_to? :call
    matcher.call path
  else
    File.fnmatch(matcher.to_s, path)
  end
end

def self.recursively_enhance(data)

Returns:
  • (Thor::CoreExt::HashWithIndifferentAccess) -

Parameters:
  • data (Hash) -- Normal hash

Other tags:
    Private: -
def self.recursively_enhance(data)
  if data.is_a? Hash
    data = ::Thor::CoreExt::HashWithIndifferentAccess.new(data)
    data.each do |key, val|
      data[key] = recursively_enhance(val)
    end
    data
  elsif data.is_a? Array
    data.each_with_index do |val, i|
      data[i] = recursively_enhance(val)
    end
    data
  else
    data
  end
end

def self.strip_leading_slash(path)

change how we normalize paths
This is a separate method from normalize_path in case we
def self.strip_leading_slash(path)
  path.sub(%r{^/}, "")
end