/usr/lib/ruby/vendor_ruby/mime/types/loader.rb is in ruby-mime-types 2.6.1-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 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 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 | # -*- ruby encoding: utf-8 -*-
module MIME; end
class MIME::Types; end
require 'mime/types/loader_path'
# This class is responsible for initializing the MIME::Types registry from
# the data files supplied with the mime-types library.
#
# The Loader will use one of the following paths:
# 1. The +path+ provided in its constructor argument;
# 2. The value of ENV['RUBY_MIME_TYPES_DATA']; or
# 3. The value of MIME::Types::Loader::PATH.
#
# When #load is called, the +path+ will be searched recursively for all YAML
# (.yml or .yaml) files. By convention, there is one file for each media
# type (application.yml, audio.yml, etc.), but this is not required.
class MIME::Types::Loader
# The path that will be read for the MIME::Types files.
attr_reader :path
# The MIME::Types container instance that will be loaded. If not provided
# at initialization, a new MIME::Types instance will be constructed.
attr_reader :container
# Creates a Loader object that can be used to load MIME::Types registries
# into memory, using YAML, JSON, or v1 registry format loaders.
def initialize(path = nil, container = nil)
path = path || ENV['RUBY_MIME_TYPES_DATA'] || MIME::Types::Loader::PATH
@container = container || MIME::Types.new
@path = File.expand_path(path)
# begin
# require 'mime/lazy_types'
# @container.extend(MIME::LazyTypes)
# end
end
# Loads a MIME::Types registry from YAML files (<tt>*.yml</tt> or
# <tt>*.yaml</tt>) recursively found in +path+.
#
# It is expected that the YAML objects contained within the registry array
# will be tagged as <tt>!ruby/object:MIME::Type</tt>.
#
# Note that the YAML format is about 2½ times *slower* than either the v1
# format or the JSON format.
#
# NOTE: The purpose of this format is purely for maintenance reasons.
def load_yaml
Dir[yaml_path].sort.each do |f|
container.add(*self.class.load_from_yaml(f), :silent)
end
container
end
# Loads a MIME::Types registry from JSON files (<tt>*.json</tt>)
# recursively found in +path+.
#
# It is expected that the JSON objects will be an array of hash objects.
# The JSON format is the registry format for the MIME types registry
# shipped with the mime-types library.
def load_json
Dir[json_path].sort.each do |f|
types = self.class.load_from_json(f)
container.add(*types, :silent)
end
container
end
# Loads a MIME::Types registry from columnar files recursively found in
# +path+.
def load_columnar
require 'mime/types/columnar' unless defined?(MIME::Types::Columnar)
container.extend(MIME::Types::Columnar)
container.load_base_data(path)
container
end
# Loads a MIME::Types registry. Loads from JSON files by default
# (#load_json).
#
# This will load from columnar files (#load_columnar) if <tt>columnar:
# true</tt> is provided in +options+ and there are columnar files in +path+.
def load(options = { columnar: false })
if options[:columnar] && !Dir[columnar_path].empty?
load_columnar
else
load_json
end
end
# Loads a MIME::Types registry from files found in +path+ that are in the
# v1 data format. The file search for this will exclude both JSON
# (<tt>*.json</tt>) and YAML (<tt>*.yml</tt> or <tt>*.yaml</tt>) files.
#
# This method has been deprecated and will be removed from mime-types 3.0.
def load_v1
MIME::Types.deprecated(self.class, __method__)
Dir[v1_path].sort.each do |f|
next if f =~ /\.(?:ya?ml|json|column)$/
container.add(self.class.load_from_v1(f, true), true)
end
container
end
# Raised when a V1 format file is discovered. This exception will be removed
# for mime-types 3.0.
BadV1Format = Class.new(Exception)
class << self
# Loads the default MIME::Type registry.
def load(options = { columnar: false })
new.load(options)
end
# Build the type list from a file in the format:
#
# [*][!][os:]mt/st[<ws>@ext][<ws>:enc][<ws>'url-list][<ws>=docs]
#
# == *
# An unofficial MIME type. This should be used if and only if the MIME type
# is not properly specified (that is, not under either x-type or
# vnd.name.type).
#
# == !
# An obsolete MIME type. May be used with an unofficial MIME type.
#
# == os:
# Platform-specific MIME type definition.
#
# == mt
# The media type.
#
# == st
# The media subtype.
#
# == <ws>@ext
# The list of comma-separated extensions.
#
# == <ws>:enc
# The encoding.
#
# == <ws>'url-list
# The list of comma-separated URLs.
#
# == <ws>=docs
# The documentation string.
#
# That is, everything except the media type and the subtype is optional. The
# more information that's available, though, the richer the values that can
# be provided.
#
# This method has been deprecated and will be removed in mime-types 3.0.
def load_from_v1(filename, __internal__ = false)
MIME::Types.deprecated(self.class, __method__) unless __internal__
data = read_file(filename).split($/)
mime = MIME::Types.new
data.each_with_index { |line, index|
item = line.chomp.strip
next if item.empty?
m = V1_FORMAT.match(item)
unless m
MIME::Types.logger.warn <<-EOS
#{filename}:#{index + 1}: Parsing error in v1 MIME type definition.
=> #{line}
EOS
fail BadV1Format, line
end
unregistered, obsolete, platform, mediatype, subtype, extensions,
encoding, urls, docs, _ = *m.captures
next if mediatype.nil?
extensions &&= extensions.split(/,/)
urls &&= urls.split(/,/)
if docs.nil?
use_instead = nil
else
use_instead = docs.scan(%r{use-instead:(\S+)}).flatten.first
docs = docs.gsub(%r{use-instead:\S+}, '').squeeze(' \t')
end
mime_type = MIME::Type.new("#{mediatype}/#{subtype}") do |t|
t.extensions = extensions
t.encoding = encoding
t.system = platform
t.obsolete = obsolete
t.registered = false if unregistered
t.use_instead = use_instead
t.docs = docs
# This is being removed. Cheat to silence it for now.
t.instance_variable_set :@references,
Array(urls).flatten.compact.uniq
end
mime.add_type(mime_type, true)
}
mime
end
# Loads MIME::Types from a single YAML file.
#
# It is expected that the YAML objects contained within the registry
# array will be tagged as <tt>!ruby/object:MIME::Type</tt>.
#
# Note that the YAML format is about 2½ times *slower* than either the v1
# format or the JSON format.
#
# NOTE: The purpose of this format is purely for maintenance reasons.
def load_from_yaml(filename)
begin
require 'psych'
rescue LoadError
nil
end
require 'yaml'
YAML.load(read_file(filename))
end
# Loads MIME::Types from a single JSON file.
#
# It is expected that the JSON objects will be an array of hash objects.
# The JSON format is the registry format for the MIME types registry
# shipped with the mime-types library.
def load_from_json(filename)
require 'json'
JSON.parse(read_file(filename)).map { |type| MIME::Type.new(type) }
end
private
def read_file(filename)
File.open(filename, 'r:UTF-8:-') { |f| f.read }
end
end
private
def yaml_path
File.join(path, '*.y{,a}ml')
end
def json_path
File.join(path, '*.json')
end
def columnar_path
File.join(path, '*.column')
end
def v1_path
File.join(path, '*')
end
# The regular expression used to match a v1-format file-based MIME type
# definition.
#
# This constant has been deprecated and will be removed in mime-types 3.0.
V1_FORMAT = # :nodoc:
%r{\A\s*
([*])? # 0: Unregistered?
(!)? # 1: Obsolete?
(?:(\w+):)? # 2: Platform marker
([-\w.+]+)/([-\w.+]*) # 3, 4: Media Type
(?:\s+@(\S+))? # 5: Extensions
(?:\s+:(base64|7bit|8bit|quoted\-printable))? # 6: Encoding
(?:\s+'(\S+))? # 7: URL list
(?:\s+=(.+))? # 8: Documentation
(?:\s*([#].*)?)? # Comments
\s*
\z
}x
private_constant :V1_FORMAT if respond_to? :private_constant
end
|