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:
The path
provided in its constructor argument;
The value of ENV; or
The value of MIME::Types::Data::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.
The MIME::Types container instance that will be loaded. If not provided at initialization, a new MIME::Types instance will be constructed.
The path that will be read for the MIME::Types files.
Loads the default MIME::Type registry.
# File lib/mime/types/loader.rb, line 94 def load(options = { columnar: false }) new.load(options) 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.
# File lib/mime/types/loader.rb, line 122 def load_from_json(filename) require 'json' JSON.parse(read_file(filename)).map { |type| MIME::Type.new(type) } 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 !ruby/object:MIME::Type
.
Note that the YAML format is about 2½ times slower than the JSON format.
NOTE: The purpose of this format is purely for maintenance reasons.
# File lib/mime/types/loader.rb, line 107 def load_from_yaml(filename) begin require 'psych' rescue LoadError nil end require 'yaml' YAML.load(read_file(filename)) end
Creates a Loader object that can be used to load MIME::Types registries into memory, using YAML, JSON, or Columnar registry format loaders.
# File lib/mime/types/loader.rb, line 29 def initialize(path = nil, container = nil) path = path || ENV['RUBY_MIME_TYPES_DATA'] || MIME::Types::Data::PATH @container = container || MIME::Types.new @path = File.expand_path(path) # begin # require 'mime/lazy_types' # @container.extend(MIME::LazyTypes) # end end
# File lib/mime/types/loader.rb, line 129 def read_file(filename) File.open(filename, 'r:UTF-8:-', &:read) end
Loads a MIME::Types registry. Loads from JSON files by default (#load_json).
This will load from columnar files (#load_columnar) if columnar:
true
is provided in options
and there are columnar
files in path
.
# File lib/mime/types/loader.rb, line 84 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 columnar
files recursively found in path
.
# File lib/mime/types/loader.rb, line 71 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 from JSON files
(*.json
) 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.
# File lib/mime/types/loader.rb, line 61 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 YAML files
(*.yml
or *.yaml
) recursively found in
path
.
It is expected that the YAML objects contained within the registry array
will be tagged as !ruby/object:MIME::Type
.
Note that the YAML format is about 2½ times slower than the JSON format.
NOTE: The purpose of this format is purely for maintenance reasons.
# File lib/mime/types/loader.rb, line 48 def load_yaml Dir[yaml_path].sort.each do |f| container.add(*self.class.load_from_yaml(f), :silent) end container end
# File lib/mime/types/loader.rb, line 144 def columnar_path File.join(path, '*.column') end
# File lib/mime/types/loader.rb, line 140 def json_path File.join(path, '*.json') end
# File lib/mime/types/loader.rb, line 136 def yaml_path File.join(path, '*.y{,a}ml') end