mime-types-data 3.2016.0521 → 3.2022.0105

data/Licence.md

@@ -1,6 +1,6 @@
 ## Licence
 
-*   Copyright 2003–2016 Austin Ziegler and other contributors.
+- Copyright 2003–2021 Austin Ziegler and other contributors.
 
 The software in this repository is made available under the MIT license.
 
@@ -9,17 +9,16 @@ The software in this repository is made available under the MIT license.
 Permission is hereby granted, free of charge, to any person obtaining a copy of
 this software and associated documentation files (the "Software"), to deal in
 the Software without restriction, including without limitation the rights to
-use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
-of the Software, and to permit persons to whom the Software is furnished to do
-so, subject to the following conditions:
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
 
 The above copyright notice and this permission notice shall be included in all
 copies or substantial portions of the Software.
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Manifest.txt

@@ -5,6 +5,8 @@ Licence.md
 Manifest.txt
 README.md
 Rakefile
+data/content_type_mime.db
+data/ext_mime.db
 data/mime-types.json
 data/mime.content_type.column
 data/mime.docs.column
@@ -16,3 +18,17 @@ data/mime.use_instead.column
 data/mime.xrefs.column
 lib/mime-types-data.rb
 lib/mime/types/data.rb
+types/application.yaml
+types/audio.yaml
+types/chemical.yaml
+types/conference.yaml
+types/drawing.yaml
+types/font.yaml
+types/image.yaml
+types/message.yaml
+types/model.yaml
+types/multipart.yaml
+types/provisional-standard-types.yaml
+types/text.yaml
+types/video.yaml
+types/world.yaml

data/README.md

@@ -1,8 +1,8 @@
 # mime-types-data
 
-* home :: https://github.com/mime-types/mime-types-data/
-* code :: https://github.com/mime-types/mime-types-data/
-* issues :: https://github.com/mime-types/mime-types-data/issues
+- home :: https://github.com/mime-types/mime-types-data/
+- code :: https://github.com/mime-types/mime-types-data/
+- issues :: https://github.com/mime-types/mime-types-data/issues
 
 ## Description
 
@@ -24,18 +24,29 @@ contributions. It conforms to RFCs 2045 and 2231.
 
 ### Data Formats Supported in this Registry
 
-This registry contains the MIME media types in three formats:
+This registry contains the MIME media types in four formats:
 
-*   A YAML format matching the Ruby mime-types library objects (MIME::Type).
-    This is the primary user-editable format.
-*   A JSON format converted from the YAML format. Prior to Ruby mime-types 3.0,
-    this was the main consumption format and is still recommended for any
-    implementation that does not wish to implement the columnar format.
-*   An encoded text format splitting the data for each MIME type across
-    multiple files. This columnar data format reduces the minimal data load
-    substantially, resulting in a performance improvement at the cost of more
-    complex code for loading the data on-demand. This is the default format for
-    Ruby mime-types 3.0.
+- A YAML format matching the Ruby mime-types library objects (MIME::Type).
+  This is the primary user-editable format for developers. It is _not_
+  shipped with the gem due to size considerations.
+- A JSON format converted from the YAML format. Prior to Ruby mime-types 3.0,
+  this was the main consumption format and is still recommended for any
+  implementation that does not wish to implement the columnar format, which
+  has a significant implementation effort cost.
+- An encoded text format splitting the data for each MIME type across
+  multiple files. This columnar data format reduces the minimal data load
+  substantially, resulting in a performance improvement at the cost of more
+  complex code for loading the data on-demand. This is the default format for
+  Ruby mime-types 3.0.
+- An encoded text format for use with [`mini_mime`][] (as of 3.2021.1108). This
+  can be enabled with:
+
+  ```ruby
+  MiniMime::Configuration.ext_db_path =
+    File.join(MIME::Types::Data::PATH, "ext_mime.db")
+  MiniMime::Configuration.content_type_db_path =
+    File.join(MIME::Types::Data::PATH, "content_type_mime.db")
+  ```
 
 ## mime-types-data Modified Semantic Versioning
 
@@ -43,19 +54,20 @@ mime-types-data uses a heavily modified [Semantic Versioning][] scheme to
 indicate that the data formats compatibility based on a `SCHEMA` version and
 the date of the data update: `SCHEMA.YEAR.MONTHDAY`.
 
-1.  If an incompatible data format change is made to any of the supported
-    formts, `SCHEMA` will be incremented. The current `SCHEMA` is 3, supporting
-    the YAML, JSON, and columnar formats required for Ruby mime-types 3.0.
+1. If an incompatible data format change is made to any of the supported
+   formts, `SCHEMA` will be incremented. The current `SCHEMA` is 3, supporting
+   the YAML, JSON, and columnar formats required for Ruby mime-types 3.0.
 
-2.  When the data is updated, the `YEAR.MONTHDAY` combination will be updated.
-    An update on the last day of October 2015 would be written as `2015.1031`,
-    resulting in the full version of `3.2015.1031`.
+2. When the data is updated, the `YEAR.MONTHDAY` combination will be updated.
+   An update on the last day of October 2015 would be written as `2015.1031`,
+   resulting in the full version of `3.2015.1031`.
 
-3.  If multiple versions of the data need to be released on the same day due to
-    error, there will be an additional `REVISION` field incremented on the end
-    of the version. Thus, if three revisions need to be published on October
-    31st, 2015, the last release would be `3.2015.1031.2` (remember that the
-    first release has an implied `0`.)
+3. If multiple versions of the data need to be released on the same day due to
+   error, there will be an additional `REVISION` field incremented on the end
+   of the version. Thus, if three revisions need to be published on October
+   31st, 2015, the last release would be `3.2015.1031.2` (remember that the
+   first release has an implied `0`.)
 
 [registry]: https://www.iana.org/assignments/media-types/media-types.xhtml
-[Semantic Versioning]: http://semver.org/
+[semantic versioning]: http://semver.org/
+[`mini_mime`]: https://github.com/discourse/mini_mime

data/Rakefile

@@ -1,80 +1,155 @@
 # frozen_string_literal: true
 
-require 'rubygems'
-require 'hoe'
-require 'rake/clean'
+require "rubygems"
+require "hoe"
+require "rake/clean"
 
 Hoe.plugin :doofus
 Hoe.plugin :gemspec2
 Hoe.plugin :git
 Hoe.plugin :travis
-Hoe.plugin :email unless ENV['CI'] or ENV['TRAVIS']
+Hoe.plugin :email unless ENV["CI"] || ENV["TRAVIS"]
 
-Hoe.spec 'mime-types-data' do
-  developer('Austin Ziegler', 'halostatue@gmail.com')
+Hoe.spec "mime-types-data" do
+  developer("Austin Ziegler", "halostatue@gmail.com")
 
-  require_ruby_version '>= 2.0'
+  require_ruby_version ">= 2.0"
 
-  self.history_file = 'History.md'
-  self.readme_file = 'README.md'
+  self.history_file = "History.md"
+  self.readme_file = "README.md"
 
-  license 'MIT'
+  license "MIT"
 
-  extra_dev_deps << ['nokogiri', '~> 1.6']
-  extra_dev_deps << ['hoe-doofus', '~> 1.0']
-  extra_dev_deps << ['hoe-gemspec2', '~> 1.1']
-  extra_dev_deps << ['hoe-git', '~> 1.6']
-  extra_dev_deps << ['hoe-rubygems', '~> 1.0']
-  extra_dev_deps << ['rake', '~> 10.0']
-  extra_dev_deps << ['mime-types', '~> 3.0']
+  extra_dev_deps << ["nokogiri", "~> 1.6"]
+  extra_dev_deps << ["hoe-doofus", "~> 1.0"]
+  extra_dev_deps << ["hoe-gemspec2", "~> 1.1"]
+  extra_dev_deps << ["hoe-git", "~> 1.6"]
+  extra_dev_deps << ["hoe-rubygems", "~> 1.0"]
+  extra_dev_deps << ["rake", ">= 10.0", "< 14"]
+  extra_dev_deps << ["mime-types", ">= 3.4.0", "< 4"]
+  extra_dev_deps << ["standardrb", "~> 1.0"]
+  extra_dev_deps << ["psych", "~> 3.0"]
 end
 
-$LOAD_PATH.unshift 'lib'
-$LOAD_PATH.unshift 'support'
+$LOAD_PATH.unshift "lib"
+$LOAD_PATH.unshift "support"
+
+def new_version
+  version =
+    IO.read("lib/mime/types/data.rb").scan(/VERSION = ['"](\d\.\d{4}\.\d{4})['"]/).flatten.first
+
+  major = Gem::Version.new(version).canonical_segments.first
+  minor = Date.today.strftime("%Y.%m%d")
+
+  "#{major}.#{minor}"
+end
+
+def release_header
+  "#{new_version} / #{Date.today.strftime("%Y-%m-%d")}"
+end
 
 namespace :mime do
-  desc 'Download the current MIME type registrations from IANA.'
-  task :iana, [ :destination ] do |_, args|
-    require 'iana_registry'
+  desc "Download the current MIME type registrations from IANA."
+  task :iana, [:destination] do |_, args|
+    require "iana_registry"
     IANARegistry.download(to: args.destination)
   end
 
-  desc 'Download the current MIME type configuration from Apache.'
-  task :apache, [ :destination ] do |_, args|
-    require 'apache_mime_types'
+  desc "Download the current MIME type configuration from Apache."
+  task :apache, [:destination] do |_, args|
+    require "apache_mime_types"
     ApacheMIMETypes.download(to: args.destination)
   end
 end
 
+namespace :release do
+  task __pull: %w[mime:apache mime:iana convert]
+  task __prepare: %w[update:version update:history git:manifest]
+  task :__commit do
+    history = IO.read("History.md")
+    message = history.scan(%r{## (#{release_header}.+?)## \d\.\d{4}\.\d{4} /}m).flatten.first
+
+    IO.popen("git commit -a -F -", "w") { |commit|
+      commit.puts message
+    }
+  end
+
+  desc "Prepare a new automatic release"
+  task automatic: :__pull do
+    if system("git diff --quiet --exit-code") == false
+      Rake::Task["release:__prepare"].invoke
+      Rake::Task["gemspec"].invoke
+      Rake::Task["release:__commit"].invoke
+    else
+      warn "No changes detected."
+    end
+  end
+end
+
 namespace :convert do
   namespace :yaml do
-    desc 'Convert from YAML to JSON'
-    task :json, [ :source, :destination, :multiple_files ] => :support do |_, args|
-      require 'convert'
+    desc "Convert from YAML to JSON"
+    task :json, [:source, :destination, :multiple_files] => :support do |_, args|
+      require "convert"
       Convert.from_yaml_to_json(args)
     end
 
-    desc 'Convert from YAML to Columnar'
-    task :columnar, [ :source, :destination ] => :support do |_, args|
-      require 'convert/columnar'
+    desc "Convert from YAML to Columnar"
+    task :columnar, [:source, :destination] => :support do |_, args|
+      require "convert/columnar"
       Convert::Columnar.from_yaml_to_columnar(args)
     end
+
+    desc "Convert from YAML to mini_mime db format"
+    task :mini_mime, [:source, :destination] => :support do |_, args|
+      require "convert/mini_mime_db"
+      Convert::MiniMimeDb.from_yaml_to_mini_mime(args)
+    end
   end
 
   namespace :json do
-    desc 'Convert from JSON to YAML'
-    task :yaml, [ :source, :destination, :multiple_files ] => :support do |_, args|
-      require 'convert'
+    desc "Convert from JSON to YAML"
+    task :yaml, [:source, :destination, :multiple_files] => :support do |_, args|
+      require "convert"
       Convert.from_json_to_yaml(args)
     end
   end
 end
 
-desc 'Default conversion from YAML to JSON and Columnar'
-task convert: [ 'convert:yaml:json', 'convert:yaml:columnar' ]
+namespace :update do
+  desc "Update the release version"
+  task :version do
+    file = IO.read("lib/mime/types/data.rb")
+    updated = file.sub(/VERSION = ['"][.0-9]+['"]/, %Q(VERSION = "#{new_version}"))
+
+    IO.write("lib/mime/types/data.rb", updated)
+  end
+
+  desc "Update the history file with automatic release notes"
+  task :history do
+    history = IO.read("History.md")
+
+    if !/^## #{release_header}$/.match?(history)
+      note = <<-NOTE
+<!-- automatic-release -->
+
+## #{release_header}
+
+- Updated the Apache and IANA media registry entries as of release date.
+      NOTE
+
+      updated = history.sub(/<!-- automatic-release -->\n/, note)
+
+      IO.write("History.md", updated)
+    end
+  end
+end
+
+desc "Default conversion from YAML to JSON and Columnar"
+task convert: ["convert:yaml:json", "convert:yaml:columnar", "convert:yaml:mini_mime"]
 
-Rake::Task['gem'].prerequisites.unshift('convert')
-Rake::Task['gem'].prerequisites.unshift('git:manifest')
-Rake::Task['gem'].prerequisites.unshift('gemspec')
+Rake::Task["gem"].prerequisites.unshift("convert")
+Rake::Task["gem"].prerequisites.unshift("git:manifest")
+Rake::Task["gem"].prerequisites.unshift("gemspec")
 
 # vim: syntax=ruby