mime-types 2.0 → 2.1

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    N2MyNjFiODUzNTEwYmVhMGFkOWQwZmEyMzYyMmMzNWEzMmVlYzM1YQ==
+    YzY3MzFkN2FjY2E2YTQ4NDZkNTE3YzBhMWJlMzQ4ZjJiMDNhYjIyNA==
   data.tar.gz: !binary |-
-    MmRjNzA1NGFiY2FhNzlmZTkyNGVlNzYwNzViODYxMmY3OGYxNzJhYQ==
-!binary "U0hBNTEy":
+    ODFhNGZkNDMyZGEwM2Y3NzA0ZjYxZTQwZDU2NWUxZDVlNTdmNjlmOA==
+SHA512:
   metadata.gz: !binary |-
-    Y2FjMDNlNTI3MThiZTJhN2JlZTUxN2FiY2MyZWRjNDcxNDg2ZWNjYjgxNjA5
-    OTczMGNlNDZhZDJlZWY2Zjk4NmZmZDVjMjIxOGRmN2Y5MTdjNDVlMTQ0NThm
-    ZTg0N2JkNzc1MmVmNzU3ZWEyNDQ0NWVlN2ZkOGQ1ZGEyMWVjYTg=
+    YmVmYzE3Mjg5YzgzNDg3NGE3NDQ4YjQyMDM3NTE1YjI1MmI1MmM0MmQ1MGM2
+    ZDJlZjQyYWJkNTZmMGVlOTAxMjEzYjAzNGY2MDhhYTRlNjBmNGM0Zjg5ZmI4
+    NzdmYjFkNDU0MWIwNmM0MzI3MjM2MDJiYjEyZjIyNmIzM2FlZmI=
   data.tar.gz: !binary |-
-    MTc4ZDNlYTc5MGU2OWZhZDQ4YmI0NDhlMzk5ZTM0OTk2Y2VkODYzZTQ1ZTJl
-    Nzk1YjgzZDYzOTM3Mjc3YWE0ZGUwZTFmZGFlNzY1ZGI2OTdiMjNlNDg1MmFj
-    ZDEwMjkzZTYwMjNlOWJhNWYyYzcyYzgxOGFkYWU4ZWZlMzA2Mzg=
+    MDY1MTg3MjljNjA0OWMxMjYwNzc3YjI2NTFjZDQxMjI0NWNlYTgzNTM1MGFm
+    NjljNjMyMDRhNmM1NGNhODhkZWYwMmYyMzcxNzgxYWQ2MWIyMTJmMzEzYWIw
+    NTY2NGU3OWE0ODFiZGU0MTk4ZGQzYWYxZTYyNmQ1YWVmZTcxZTY=

data.tar.gz.sig

@@ -1,5 +1 @@
-�l��bH܍s�S�2�X���]c\�
-0♜sF�M�
-:]Ēݢנ���l�����r.
-�M�x"��`_���EA�vq�w։.LME�i��0p!��?���q����h�z6W!�p�SY0S�Fs����=>�
-)y^(�����BGu��r|2��@��~�{"N�u��B�Z�
��;3�V��e��U���S�{+7���n��Z���,���,�f�(�Ϥu(�ʨ�Yye�Vk��'�jzѳw,�h��M
+o��eY!�`���eL5��w�
���|��u3(�u(V6���򄘭�AyyV@�==D�G��/�\_/����.�K}*�N7c.P��MZ��G������A������m��6^�VP�~��f?ga,t��t�s%"Pu��d�d�/�V�m�<7��E���Ȗ���N1��H�|�s1�X�}يҶZ�9Q��C���O9��c�W]��1��0�KUn��

data/.travis.yml

@@ -1,23 +1,34 @@
 ---
-after_script:
-- rake travis:after -t
-before_script:
-- gem install hoe-travis --no-rdoc --no-ri
-- rake travis:before -t
 language: ruby
-notifications:
-  email: true
 rvm:
+  - 2.1.0
   - 2.0.0
   - 1.9.3
   - 1.9.2
+  - ruby-head
   - jruby-19mode
-  - rbx-19mode
-# - ruby-head
-# - jruby-head
+  - jruby-head
+  - rbx
 matrix:
   allow_failures:
-    - rvm:
-      - ruby-head
-      - jruby-head
+    - rvm: rbx
+gemfile:
+  - Gemfile
+before_script:
+  - |
+    case "${TRAVIS_RUBY_VERSION}" in
+      rbx*)
+        gem install psych
+        gem install -v '~> 2.0' rubysl
+        ;;
+    esac
+  - rake travis:before -t
 script: rake travis
+after_script:
+  - rake travis:after -t
+notifications:
+  recipients:
+    - austin@rubyforge.org
+  email:
+    - on_success: change
+    - on_failure: always

data/Contributing.rdoc

@@ -6,7 +6,8 @@ request, or code contributions.
 As mime-types is a complex codebase, there are a few guidelines:
 
 * Changes (aside from new MIME types) *will* *not* be accepted
-  without tests. The test suite is written with Minitest.
+  without tests. The test suite is written with
+  {Minitest}[https://github.com/seattlerb/minitest].
 * Match my coding style.
 * Use a thoughtfully-named topic branch that contains your change. Rebase your
   commits into logical chunks as necessary.
@@ -18,14 +19,9 @@ As mime-types is a complex codebase, there are a few guidelines:
 
 === Test Dependencies
 
-To run the test suite, you will need to install the development dependencies
-for mime-types. If you have Bundler, you can accomplish this easily:
-
-    $ bundle install
-
-mime-types uses Ryan Davis’s excellent {Hoe}[https://github.com/seattlerb/hoe]
-to manage the release process, and it adds a number of rake tasks. You will
-mostly be interested in:
+mime-types uses Ryan Davis’s {Hoe}[https://github.com/seattlerb/hoe] to manage
+the release process, and it adds a number of rake tasks. You will mostly be
+interested in:
 
     $ rake
 
@@ -36,6 +32,20 @@ which runs the tests the same way that:
 
 will do.
 
+To assist with the installation of the development dependencies for mime-types,
+I have provided the simplest possible Gemfile pointing to the (generated)
++mime-types.gemspec+ file. This will permit you to do:
+
+    $ bundle install
+
+to get the development dependencies. If you aleady have +hoe+ installed, you
+can accomplish the same thing with:
+
+    $ rake newb
+
+This task will install any missing dependencies, run the tests/specs, and
+generate the RDoc.
+
 === Workflow
 
 Here's the most direct way to get your work merged into the project:

data/Gemfile

@@ -1,21 +1,9 @@
 # -*- ruby -*-
 
-# DO NOT EDIT THIS FILE. Instead, edit Rakefile, and run `rake bundler:gemfile`.
+# NOTE: This file is present to keep Travis CI happy. Edits to it will not
+# be accepted.
 
 source "https://rubygems.org/"
-
-
-gem "rubyforge", ">=2.0.4", :group => [:development, :test]
-gem "minitest", "~>5.0", :group => [:development, :test]
-gem "rdoc", "~>4.0", :group => [:development, :test]
-gem "hoe-bundler", "~>1.2", :group => [:development, :test]
-gem "hoe-doofus", "~>1.0", :group => [:development, :test]
-gem "hoe-gemspec2", "~>1.1", :group => [:development, :test]
-gem "hoe-git", "~>1.5", :group => [:development, :test]
-gem "hoe-rubygems", "~>1.0", :group => [:development, :test]
-gem "hoe-travis", "~>1.2", :group => [:development, :test]
-gem "rake", "~>10.0", :group => [:development, :test]
-gem "simplecov", "~>0.7", :group => [:development, :test]
-gem "hoe", "~>3.7", :group => [:development, :test]
+gemspec
 
 # vim: syntax=ruby

data/History-Types.rdoc

@@ -0,0 +1,209 @@
+= MIME Types Changes by Version
+
+== 2.1 / 2014-01-25
+
+* The IANA media type registry format changed, resulting in updates to most of
+  the 1,427 registered MIME types.
+  * Many registered MIME types have had some metadata updates due to the change
+    in the IANA registry format.
+    * MIME types having a publicly available registry application now include a
+      link to that file in references.
+    * Added +xrefs+ data as discovered (see the API changes noted above).
+* The Apache mime types configuration has been added to track additional common
+  but unregistered MIME types and known extensions for those MIME types. This
+  has affected many of the available MIME types.
+* Added newly registered MIME types:
+  * application/emotionml\+xml
+  * application/ODX
+  * application/prs.hpub\+zip
+  * application/vcard\+json
+  * application/vnd.bekitzur-stech\+json
+  * application/vnd.etsi.timestamp-token
+  * application/vnd.oma.cab-feature-handler\+xml
+  * application/vnd.openeye.oeb
+  * application/vnd.tcpdump.pcap
+  * audio/amr-wb
+  * model/x3d\+xml
+  * model/x3d-vrml
+* Added 180 unregistered MIME types from the Apache list:
+  * application/applixware
+  * application/cu-seeme
+  * application/docbook\+xml
+  * application/gml\+xml
+  * application/gpx\+xml
+  * application/gxf
+  * application/java-archive
+  * application/java-serialized-object
+  * application/java-vm
+  * application/jsonml\+json
+  * application/metalink\+xml
+  * application/omdoc\+xml
+  * application/onenote
+  * application/pics-rules
+  * application/rsd\+xml
+  * application/ssdl\+xml
+  * application/vnd.3m.post-it-notes
+  * application/vnd.amazon.ebook
+  * application/vnd.anser-web-funds-transfer-initiation
+  * application/vnd.curl.car
+  * application/vnd.curl.pcurl
+  * application/vnd.dolby.mlp
+  * application/vnd.ds-keypoint
+  * application/vnd.flographit
+  * application/vnd.handheld-entertainment\+xml
+  * application/vnd.hp-hpgl
+  * application/vnd.hp-pcl
+  * application/vnd.hp-pclxl
+  * application/vnd.ibm.minipay
+  * application/vnd.kinar
+  * application/vnd.mfer
+  * application/vnd.mobius.daf
+  * application/vnd.mobius.dis
+  * application/vnd.mobius.mbk
+  * application/vnd.mobius.mqy
+  * application/vnd.mobius.msl
+  * application/vnd.mobius.plc
+  * application/vnd.mobius.txf
+  * application/vnd.ms-excel.addin.macroenabled.12
+  * application/vnd.ms-excel.sheet.binary.macroenabled.12
+  * application/vnd.ms-excel.sheet.macroenabled.12
+  * application/vnd.ms-excel.template.macroenabled.12
+  * application/vnd.ms-pki.seccat
+  * application/vnd.ms-pki.stl
+  * application/vnd.ms-powerpoint.addin.macroenabled.12
+  * application/vnd.ms-powerpoint.presentation.macroenabled.12
+  * application/vnd.ms-powerpoint.slide.macroenabled.12
+  * application/vnd.ms-powerpoint.slideshow.macroenabled.12
+  * application/vnd.ms-powerpoint.template.macroenabled.12
+  * application/vnd.ms-word.document.macroenabled.12
+  * application/vnd.ms-word.template.macroenabled.12
+  * application/vnd.novadigm.edm
+  * application/vnd.novadigm.edx
+  * application/vnd.novadigm.ext
+  * application/vnd.quark.quarkxpress
+  * application/vnd.rim.cod
+  * application/vnd.rn-realmedia-vbr
+  * application/vnd.simtech-mindmapper
+  * application/vnd.symbian.install
+  * application/winhlp
+  * application/x-abiword
+  * application/x-ace-compressed
+  * application/x-authorware-bin
+  * application/x-authorware-map
+  * application/x-authorware-seg
+  * application/x-bittorrent
+  * application/x-blorb
+  * application/x-bzip
+  * application/x-cbr
+  * application/x-cfs-compressed
+  * application/x-chat
+  * application/x-conference
+  * application/x-dgc-compressed
+  * application/x-doom
+  * application/x-dtbncx\+xml
+  * application/x-dtbook\+xml
+  * application/x-dtbresource\+xml
+  * application/x-envoy
+  * application/x-eva
+  * application/x-font-bdf
+  * application/x-font-ghostscript
+  * application/x-font-linux-psf
+  * application/x-font-otf
+  * application/x-font-pcf
+  * application/x-font-snf
+  * application/x-font-ttf
+  * application/x-font-type1
+  * application/x-freearc
+  * application/x-gca-compressed
+  * application/x-glulx
+  * application/x-gnumeric
+  * application/x-gramps-xml
+  * application/x-install-instructions
+  * application/x-iso9660-image
+  * application/x-lzh-compressed
+  * application/x-mie
+  * application/x-ms-application
+  * application/x-ms-shortcut
+  * application/x-ms-xbap
+  * application/x-msbinder
+  * application/x-mscardfile
+  * application/x-msclip
+  * application/x-msmediaview
+  * application/x-msmetafile
+  * application/x-msmoney
+  * application/x-mspublisher
+  * application/x-msschedule
+  * application/x-msterminal
+  * application/x-mswrite
+  * application/x-nzb
+  * application/x-pkcs12
+  * application/x-pkcs7-certificates
+  * application/x-pkcs7-certreqresp
+  * application/x-research-info-systems
+  * application/x-silverlight-app
+  * application/x-sql
+  * application/x-stuffitx
+  * application/x-subrip
+  * application/x-t3vm-image
+  * application/x-tads
+  * application/x-tex-tfm
+  * application/x-tgif
+  * application/x-xfig
+  * application/x-xliff\+xml
+  * application/x-xz
+  * application/x-zmachine
+  * application/xaml\+xml
+  * application/xproc\+xml
+  * application/xspf\+xml
+  * audio/adpcm
+  * audio/amr-wb
+  * audio/AMR-WB
+  * audio/midi
+  * audio/s3m
+  * audio/silk
+  * audio/x-caf
+  * audio/x-flac
+  * audio/x-matroska
+  * audio/x-mpegurl
+  * audio/xm
+  * chemical/x-cdx
+  * chemical/x-cif
+  * chemical/x-cmdf
+  * chemical/x-cml
+  * chemical/x-csml
+  * image/sgi
+  * image/vnd.ms-photo
+  * image/x-3ds
+  * image/x-cmx
+  * image/x-freehand
+  * image/x-icon
+  * image/x-mrsid-image
+  * image/x-pcx
+  * image/x-tga
+  * model/x3d\+binary
+  * model/x3d\+vrml
+  * text/plain
+  * text/vnd.curl.dcurl
+  * text/vnd.curl.mcurl
+  * text/vnd.curl.scurl
+  * text/x-asm
+  * text/x-c
+  * text/x-fortran
+  * text/x-java-source
+  * text/x-nfo
+  * text/x-opml
+  * text/x-pascal
+  * text/x-sfv
+  * text/x-uuencode
+  * video/h261
+  * video/h263
+  * video/h264
+  * video/jpeg
+  * video/jpm
+  * video/mj2
+  * video/x-f4v
+  * video/x-m4v
+  * video/x-mng
+  * video/x-ms-vob
+  * video/x-smv
+* Merged the non-standard VMS platform text/plain with the standard text/plain.

data/History.rdoc

@@ -1,4 +1,22 @@
-== 2.0 / 2013-10-DD
+== 2.1 / 2014-01-25
+
+* API Changes (MIME::Type):
+  * Added MIME::Type#xrefs and MIME::Type#xref_urls that have better handling
+    of types of reference information. MIME::Type#references= has been
+    deprecated. In a future release, both MIME::Type#references will be turned
+    into a short-hand view on MIME::Type#xrefs, MIME::Type#urls will be an
+    alias for MIME::Type#xref_urls, and MIME::Type#references= will be removed.
+* New or Updated MIME Types:
+  * This information is now tracked in History-Types.rdoc.
+* MIME Type Development Tools
+  * The IANA registry format changed, breaking the IANA registry tool
+    previously used. Rewrote IANADownloader and IANADownloader::Parser as
+    IANARegistryParser using the XML form.
+  * The LTSW list has been dropped as it has not been updated since 2002.
+  * The default Apache MIME types configuration list is now used to enrich MIME
+    type data with additional extension information.
+
+== 2.0 / 2013-10-27
 
 * API Changes (General):
   * mime-types is no longer compatible with Ruby 1.8. Additionally, for its

data/Manifest.txt

@@ -5,6 +5,7 @@
 .travis.yml
 Contributing.rdoc
 Gemfile
+History-Types.rdoc
 History.rdoc
 Licence.rdoc
 Manifest.txt
@@ -20,9 +21,10 @@ lib/mime/types.rb
 lib/mime/types/cache.rb
 lib/mime/types/loader.rb
 lib/mime/types/loader_path.rb
+support/apache_mime_types.rb
 support/benchmarker.rb
 support/convert.rb
-support/iana_downloader.rb
+support/iana_registry.rb
 test/fixture/json.json
 test/fixture/old-data
 test/fixture/yaml.yaml

data/README.rdoc

@@ -24,18 +24,22 @@ add additional type definitions (see Contributing.rdoc). The primary sources
 for MIME type definitions found in mime-types is the IANA collection of
 registrations (see below for the link), RFCs, and W3C recommendations.
 
-The mime-types library uses semantic versioning. This is release 2.0; there are
-incompatible changes in the API provided by mime-types, mostly around registry
-initialization (see History.rdoc for full details), and the removal of support
-for Ruby 1.8 interpreters.
+This is release 2.1, mostly changing how the MIME type registry is updated from
+the IANA registry (the format of which was incompatibly changed shortly before
+this release) and taking advantage of the extra data available from IANA
+registry in the form of MIME::Type#xrefs. In addition, the {LTSW
+list}[http://www.ltsw.se/knbase/internet/mime.htp] has been dropped as a
+supported list.
+
+As a reminder, mime-types 2.x is no longer compatible with Ruby 1.8 and
+mime-types 1.x is only being maintained for security issues. No new MIME types
+or features will be added.
 
 mime-types (previously called MIME::Types for Ruby) was originally based on
 MIME::Types for Perl by Mark Overmeer, copyright 2001 - 2009. It is built to
-conform to the MIME types of RFCs 2045 and 2231. It tracks the {IANA
-registry}[http://www.iana.org/assignments/media-types/]
-({ftp}[ftp://ftp.iana.org/assignments/media-types]) with some unofficial types
-added from the {LTSW collection}[http://www.ltsw.se/knbase/internet/mime.htp]
-and added by the users of mime-types.
+conform to the MIME types of RFCs 2045 and 2231. It tracks the {IANA Media
+Types registry}[https://www.iana.org/assignments/media-types/media-types.xhtml]
+with some types added by the users of mime-types.
 
 == Synopsis
 
@@ -68,6 +72,36 @@ files). A MIME::Type stores the known information about one MIME type.
     puts MIME::Types.all?(&:registered?)
                                     # => false
 
+== mime-types Modified Semantic Versioning
+
+The mime-types library has one version number, but this single version number
+tracks both API changes and registry data changes; this is not wholly
+compatible with all aspects of {Semantic Versioning}[http://semver.org/];
+removing a MIME type from the registry *could* be considered a breaking change
+under some interpretations of semantic versioning (as lookups for that
+particular type would no longer work by default).
+
+mime-types uses a modified semantic versioning scheme. Given the version
+MAJOR.MINOR:
+
+1. If an incompatible API (code) change is made, the MAJOR version will be
+   incremented, MINOR will be set to zero, and PATCH will be reset to the
+   implied zero.
+
+2. If an API (code) feature is added that does not break compatibilty OR if
+   there are MIME types added, removed, or changed in the registry, the MINOR
+   version will be incremented and PATCH will be reset to the implied zero.
+
+3. If there is a bugfix to a feature added in the most recent MAJOR.MINOR
+   release, OR if purely typographical errors are fixed in MIME types, the
+   implied PATCH value will be incremented resulting in MAJOR.MINOR.PATCH.
+
+In practical terms, there should be a MINOR release roughly monthly to track
+updated or changed MIME types from the official IANA registry. This does not
+indicate when new API features have been added, but all minor versions of
+mime-types 2.x will be backwards compatible; the interfaces marked deprecated
+will not be removed until at least mime-types 3.x or possibly later.
+
 :include: Contributing.rdoc
 
 :include: Licence.rdoc