Commit f1f446c2 by Zach Millman Committed by Jon Yurek

Add documentation of content-type detection strategy

Also refactored to make the strategy hierarchy clearer
parent d42adb8a
module Paperclip
class ContentTypeDetector
# The content-type detection strategy is as follows:
#
# 1. Blank/Empty files: If there's no filename or the file is empty, provide a sensible default
# (application/octet-stream or inode/x-empty)
#
# 2. Uploaded file: Use the uploaded file's content type if it is in the list of mime-types
# for the file's extension
#
# 3. Standard types: Return the first standard (without an x- prefix) entry in the list of
# mime-types
#
# 4. Experimental types: If there were no standard types in the mime-types list, try to return
# the first experimental one
#
# 5. Unrecognized extension: Use the file's content type or a sensible default if there are
# no entries in mime-types for the extension
#
EMPTY_TYPE = "inode/x-empty"
SENSIBLE_DEFAULT = "application/octet-stream"
......@@ -7,17 +25,16 @@ module Paperclip
@filename = filename
end
# Returns a String describing the file's content type
def detect
if blank_name?
SENSIBLE_DEFAULT
elsif empty_file?
EMPTY_TYPE
elsif !match?
type_from_file_command
elsif !multiple?
possible_types.first
elsif best_from_possible_types
best_from_possible_types.content_type
else
best_type_match
type_from_file_command || SENSIBLE_DEFAULT
end.to_s
end
......@@ -31,22 +48,24 @@ module Paperclip
@filename.nil? || @filename.empty?
end
def empty?
File.exists?(@filename) && File.size(@filename) == 0
end
def possible_types
@possible_types ||= MIME::Types.type_for(@filename)
end
def match?
possible_types.length > 0
def official_types
@official_types ||= possible_types.reject {|type| type.content_type.match(/\/x-/) }
end
def multiple?
possible_types.length > 1
def types_matching_file
possible_types.select{|type| type.content_type == type_from_file_command}
end
def best_type_match
types_matching_file = possible_types.select {|type| type.content_type == type_from_file_command}
official_types = possible_types.reject {|type| type.content_type.match(/\/x-/) }
(types_matching_file.first || official_types.first || possible_types.first).content_type
def best_from_possible_types
@best_from_possible_types ||= (types_matching_file.first || official_types.first || possible_types.first)
end
def type_from_file_command
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment