mime-types 2.99.3 → 3.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 6fc8f9668b867116a596617ef0c7a3deb6525d4f
-  data.tar.gz: da57ee98722d4b5cee6ae754df620202a3d4a7db
+SHA256:
+  metadata.gz: 443bfcc0047c25a8ac7cc9e7a2fea95f8d4707e8fa3a98d0b99bee421e168708
+  data.tar.gz: 39756d60550165df9787a4967c376faac32179fd442d176766893b7454ed977d
 SHA512:
-  metadata.gz: a82b94ceb52e642b263c8223a55c213220125a576d5abeaa5a72c2ad7941d967921bfc13385a300d4c02f45228d9f9f4fccb9999da6dd16ea29cf5fe8388a3a0
-  data.tar.gz: c5411c2e67a87c342cde930311d3c3df806e2699f5e27bccd72df1c8ab4095bb81db256b787e354ab13e8ec953b8b8b3aa41b3891a6f749aa0a579419d1a133a
+  metadata.gz: d711882ac22adb5a8ab3e4953a508c06e870990ad0d41d0256679bcb66c7953686ba4b23ac1470ea6ee07d6026d793f57fb7d377d321fb972252365c8fd22622
+  data.tar.gz: 3d20e16be727ee9b62ab599a939524148577b54281a63705b0b75a9eea7c6f51df169bc6979ce8b616c3b707921c1021ac06b226bb8df28f5337d1f76107a293

data/{Code-of-Conduct.rdoc → Code-of-Conduct.md}

@@ -1,37 +1,37 @@
-== Contributor Covenant Code of Conduct
+# Contributor Covenant Code of Conduct
 
 ## Our Pledge
 
 In the interest of fostering an open and welcoming environment, we as
 contributors and maintainers pledge to making participation in our project and
-our community a harassment-free experience for everyone, regardless of age,
-body size, disability, ethnicity, gender identity and expression, level of
-experience, nationality, personal appearance, race, religion, or sexual
-identity and orientation.
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, sex characteristics, gender identity and expression,
+level of experience, education, socio-economic status, nationality, personal
+appearance, race, religion, or sexual identity and orientation.
 
-=== Our Standards
+## Our Standards
 
 Examples of behavior that contributes to creating a positive environment
 include:
 
-* Using welcoming and inclusive language
-* Being respectful of differing viewpoints and experiences
-* Gracefully accepting constructive criticism
-* Focusing on what is best for the community
-* Showing empathy towards other community members
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints and experiences
+- Gracefully accepting constructive criticism
+- Focusing on what is best for the community
+- Showing empathy towards other community members
 
 Examples of unacceptable behavior by participants include:
 
-* The use of sexualized language or imagery and unwelcome sexual attention or
+- The use of sexualized language or imagery and unwelcome sexual attention or
   advances
-* Trolling, insulting/derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or electronic
+- Trolling, insulting/derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or electronic
   address, without explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
+- Other conduct which could reasonably be considered inappropriate in a
   professional setting
 
-=== Our Responsibilities
+## Our Responsibilities
 
 Project maintainers are responsible for clarifying the standards of acceptable
 behavior and are expected to take appropriate and fair corrective action in
@@ -43,32 +43,31 @@ that are not aligned to this Code of Conduct, or to ban temporarily or
 permanently any contributor for other behaviors that they deem inappropriate,
 threatening, offensive, or harmful.
 
-=== Scope
+## Scope
 
 This Code of Conduct applies both within project spaces and in public spaces
 when an individual is representing the project or its community. Examples of
 representing a project or community include using an official project e-mail
-address, posting via an official social media account, or acting as an
-appointed representative at an online or offline event. Representation of a
-project may be further defined and clarified by project maintainers.
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
 
-=== Enforcement
+## Enforcement
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be
 reported by contacting the project team at [INSERT EMAIL ADDRESS]. All
 complaints will be reviewed and investigated and will result in a response that
 is deemed necessary and appropriate to the circumstances. The project team is
-obligated to maintain confidentiality with regard to the reporter of an
-incident. Further details of specific enforcement policies may be posted
-separately.
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
 
 Project maintainers who do not follow or enforce the Code of Conduct in good
 faith may face temporary or permanent repercussions as determined by other
 members of the project's leadership.
 
-=== Attribution
+## Attribution
 
-This Code of Conduct is adapted from the {Contributor
-Covenant}[http://contributor-covenant.org], version 1.4,
-available at
-{http://contributor-covenant.org/version/1/4/}[http://contributor-covenant.org/version/1/4/].
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
+
+[homepage]: https://www.contributor-covenant.org

data/Contributing.md

@@ -0,0 +1,132 @@
+# Contributing
+
+I value any contribution to mime-types you can provide: a bug report, a feature
+request, or code contributions.
+
+There are a few guidelines for contributing to mime-types:
+
+- Code changes _will_ _not_ be accepted without tests. The test suite is
+  written with [minitest].
+- Match my coding style.
+- Use a thoughtfully-named topic branch that contains your change. Rebase your
+  commits into logical chunks as necessary.
+- Use [quality commit messages].
+- Do not change the version number; when your patch is accepted and a release
+  is made, the version will be updated at that point.
+- Submit a GitHub pull request with your changes.
+- New or changed behaviours require new or updated documentation.
+
+## Adding or Modifying MIME Types
+
+The mime-types registry is no longer contained in mime-types, but in
+[mime-types-data]. Please see that project for contributions there.
+
+### Test Dependencies
+
+mime-types uses Ryan Davis’s [Hoe] to manage the release process, and it adds
+a number of rake tasks. You will mostly be interested in `rake`, which runs
+the tests the same way that `rake test` or `rake travis` 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.
+
+You can run tests with code coverage analysis by running `rake
+test:coverage`.
+
+## Benchmarks
+
+mime-types offers several benchmark tasks to measure different measures of
+performance.
+
+There is a repeated load test, measuring how long it takes to start and load
+mime-types with its full registry. By default, it runs fifty loops and uses the
+built-in benchmark library:
+
+- `rake benchmark:load`
+
+There are two allocation tracing benchmarks (for normal and columnar loads).
+These can only be run on Ruby 2.1 or better and requires the
+[allocation\_tracer] gem (not installed by default).
+
+- `rake benchmark:allocations`
+- `rake benchmark:allocations:columnar`
+
+There are two loaded object count benchmarks (for normal and columnar loads).
+These use `ObjectSpace.count_objects`.
+
+- `rake benchmark:objects`
+- `rake benchmark:objects:columnar`
+
+## Workflow
+
+Here's the most direct way to get your work merged into the project:
+
+- Fork the project.
+- Clone down your fork (`git clone git://github.com/<username>/ruby-mime-types.git`).
+- Create a topic branch to contain your change (`git checkout -b my_awesome_feature`).
+- Hack away, add tests. Not necessarily in that order.
+- Make sure everything still passes by running `rake`.
+- If necessary, rebase your commits into logical chunks, without errors.
+- Push the branch up (`git push origin my_awesome_feature`).
+- Create a pull request against mime-types/ruby-mime-types and describe what
+  your change does and the why you think it should be merged.
+
+## Contributors
+
+- Austin Ziegler created mime-types.
+
+Thanks to everyone else who has contributed to mime-types over the years:
+
+- Aaron Patterson
+- Aggelos Avgerinos
+- Al Snow
+- Andre Pankratz
+- Andy Brody
+- Arnaud Meuret
+- Brandon Galbraith
+- Burke Libbey
+- Chris Gat
+- David Genord
+- Dillon Welch
+- Eric Marden
+- Edward Betts
+- Garret Alfert
+- Godfrey Chan
+- Greg Brockman
+- Hans de Graaff
+- Henrik Hodne
+- Igor Victor
+- Janko Marohnić
+- Jean Boussier
+- Jeremy Evans
+- Juanito Fatas
+- Jun Aruga
+- Łukasz Śliwa
+- Keerthi Siva
+- Ken Ip
+- Kevin Menard
+- Koichi ITO
+- Martin d'Allens
+- Mauricio Linhares
+- Nicolas Leger
+- Nicholas La Roux
+- nycvotes-dev
+- Olle Jonsson
+- Postmodern
+- Richard Hirner
+- Richard Hurt
+- Richard Schneeman
+- Tibor Szolár
+- Todd Carrico
+
+[minitest]: https://github.com/seattlerb/minitest
+[quality commit messages]: http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html
+[mime-types-data]: https://github.com/mime-types/mime-types-data
+[hoe]: https://github.com/seattlerb/hoe
+[allocation\_tracer]: https://github.com/ko1/allocation_tracer

data/History.md

@@ -0,0 +1,269 @@
+# Changelog
+
+## 3.4.1 / 2021-11-16
+
+- 1 bugfix:
+
+  - Fixed a Ruby < 2.3 incompatibility introduced by the use of standardrb,
+    where `<<-` heredocs were converted to `<<~` heredocs. These have been
+    reverted back to `<<-` with the indentation kept and a `.strip` call
+    to prevent excess whitespace.
+
+## 3.4.0 / 2021-11-15
+
+- 1 minor enhancement:
+
+  - Added a new field to `MIME::Type` for checking provisional registrations
+    from IANA. [#157]
+
+- Documentation:
+
+  - Kevin Menard synced the documentation so that all examples are correct.
+    [#153]
+
+- Administrivia:
+
+  - Added Ruby 3.0 to the CI test matrix. Added `windows/jruby` to the
+    CI exclusion list; it refuses to run successfully.
+  - Removed the Travis CI configuration and changed it to Github Workflows
+    [#150]. Removed Coveralls configuration.
+  - Igor Victor added TruffleRuby to the Travis CI configuration. [#149]
+  - Koichi ITO loosened an excessively tight dependency. [#147]
+  - Started using `standardrb` for Ruby formatting and validation.
+  - Moved `deps:top` functionality to a support file.
+
+## 3.3.1 / 2019-12-26
+
+- 1 minor bugfix:
+
+  - Al Snow fixed a warning with MIME::Types::Logger producing a warning
+    because Ruby 2.7 introduces numbered block parameters. Because of the way
+    that the MIME::Types::Logger works for deprecation messages, the
+    initializer parameters had been named `_1`, `_2`, and `_3`. This has now
+    been resolved. [#146]
+
+- Administrivia:
+
+  - Olle Jonsson removed an outdated Travis configuration option (`sudo: false`). [#142]
+
+## 3.3 / 2019-09-04
+
+- 1 minor enhancement
+
+  - Jean Boussier reduced memory usage for Ruby versions 2.3 or higher by
+    interning various string values in each type. This is done with a
+    backwards-compatible call that _freezes_ the strings on older versions of
+    Ruby. [#141]
+
+- Administrivia:
+
+  - Nicholas La Roux updated Travis build configurations. [#139]
+
+## 3.2.2 / 2018-08-12
+
+- Hiroto Fukui removed a stray `debugger` statement that I had used in
+  producing v3.2.1. [#137]
+
+## 3.2.1 / 2018-08-12
+
+- A few bugs related to MIME::Types::Container and its use in the
+  mime-types-data helper tools reared their head because I released 3.2
+  before verifying against mime-types-data.
+
+## 3.2 / 2018-08-12
+
+- 2 minor enhancements
+
+  - Janko Marohnić contributed a change to `MIME::Type#priority_order` that
+    should improve on strict sorting when dealing with MIME types that appear
+    to be in the same family even if strict sorting would cause an
+    unregistered type to be sorted first. [#132]
+
+  - Dillon Welch contributed a change that added `frozen_string_literal: true` to files so that modern Rubies can automatically reduce duplicate
+    string allocations. [#135]
+
+- 2 bug fixes
+
+  - Burke Libbey fixed a problem with cached data loading. [#126]
+
+  - Resolved an issue where Enumerable#inject returns `nil` when provided an
+    empty enumerable and a default value has not been provided. This is
+    because when Enumerable#inject isn't provided a starting value, the first
+    value is used as the default value. In every case where this error was
+    happening, the result was supposed to be an array containing Set objects
+    so they can be reduced to a single Set. [#117], [#127], [#134]
+
+  - Fixed an uncontrolled growth bug in MIME::Types::Container where a key
+    miss would create a new entry with an empty Set in the container. This
+    was working as designed (this particular feature was heavily used during
+    MIME::Type registry construction), but the design was flawed in that it
+    did not have any way of determining the difference between construction
+    and querying. This would mean that, if you have a function in your web
+    app that queries the MIME::Types registry by extension, the extension
+    registry would grow uncontrollably. [#136]
+
+- Deprecations:
+
+  - Lazy loading (`$RUBY_MIME_TYPES_LAZY_LOAD`) has been deprecated.
+
+- Documentation Changes:
+
+  - Supporting files are now Markdown instead of rdoc, except for the README.
+
+  - The history file has been modified to remove all history prior to 3.0.
+    This history can be found in previous commits.
+
+  - A spelling error was corrected by Edward Betts ([#129]).
+
+- Administrivia:
+
+  - CI configuration for more modern versions of Ruby were added by Nicolas
+    Leger ([#130]), Jun Aruga ([#125]), and Austin Ziegler. Removed
+    ruby-head-clang and rbx (Rubinius) from CI.
+
+  - Fixed tests which were asserting equality against nil, which will become
+    an error in Minitest 6.
+
+## 3.1 / 2016-05-22
+
+- 1 documentation change:
+
+  - Tim Smith (@tas50) updated the build badges to be SVGs to improve
+    readability on high-density (retina) screens with pull request [#112].
+
+- 3 bug fixes
+
+  - A test for `MIME::Types::Cache` fails under Ruby 2.3 because of frozen
+    strings, [#118]. This has been fixed.
+
+  - The JSON data has been incorrectly encoded since the release of
+    mime-types 3 on the `xrefs` field, because of the switch to using a Set
+    to store cross-reference information. This has been fixed.
+
+  - A tentative fix for [#117] has been applied, removing the only circular
+    require dependencies that exist (and for which there was code to prevent,
+    but the current fix is simpler). I have no way to verify this fix and
+    depending on how things are loaded by `delayed_job`, this fix may not be
+    sufficient.
+
+- 1 governance change
+
+  - Updated to Contributor Covenant 1.4.
+
+## 3.0 / 2015-11-21
+
+- 2 governance changes
+
+  - This project and the related mime-types-data project are now exclusively
+    MIT licensed. Resolves [#95].
+
+  - All projects under the mime-types organization now have a standard code
+    of conduct adapted from the [Contributor Covenant]. This text can be
+    found in the [Code-of-Conduct.md] file.
+
+- 3 major changes
+
+  - All methods deprecated in mime-types 2.x have been removed.
+
+  - mime-types now requires Ruby 2.0 compatibility or later. Resolves
+    [#97].
+
+  - The registry data has been removed from mime-types and put into
+    mime-types-data, maintained and released separately. It can be found at
+    [mime-types-data].
+
+- 17 minor changes:
+
+  - `MIME::Type` changes:
+
+    - Changed the way that simplified types representations are created to
+      reflect the fact that `x-` prefixes are no longer considered special
+      according to IANA. A simplified MIME type is case-folded to lowercase.
+      A new keyword parameter, `remove_x_prefix`, can be provided to remove
+      `x-` prefixes.
+
+    - Improved initialization with an Array works so that extensions do not
+      need to be wrapped in another array. This means that `%w(text/yaml yaml yml)` works in the same way that `['text/yaml', %w(yaml yml)]` did (and
+      still does).
+
+    - Changed `priority_compare` to conform with attributes that no longer
+      exist.
+
+    - Changed the internal implementation of extensions to use a frozen Set.
+
+    - When extensions are set or modified with `add_extensions`, the primary
+      registry will be informed of a need to reindex extensions. Resolves
+      [#84].
+
+    - The preferred extension can be set explicitly. If not set, it will be
+      the first extension. If the preferred extension is not in the extension
+      list, it will be added.
+
+    - Improved how xref URLs are generated.
+
+    - Converted `obsolete`, `registered` and `signature` to `attr_accessors`.
+
+  - `MIME::Types` changes:
+
+    - Modified `MIME::Types.new` to track instances of `MIME::Types` so that
+      they can be told to reindex the extensions as necessary.
+
+    - Removed `data_version` attribute.
+
+    - Changed `#[]` so that the `complete` and `registered` flags are
+      keywords instead of a generic options parameter.
+
+    - Extracted the class methods to a separate file.
+
+    - Changed the container implementation to use a Set instead of an Array
+      to prevent data duplication. Resolves [#79].
+
+  - `MIME::Types::Cache` changes:
+
+    - Caching is now based on the data gem version instead of the mime-types
+      version.
+
+    - Caching is compatible with columnar registry stores.
+
+  - `MIME::Types::Loader` changes:
+
+    - `MIME::Types::Loader::PATH` has been removed and replaced with
+      `MIME::Types::Data::PATH` from the mime-types-data gem. The environment
+      variable `RUBY_MIME_TYPES_DATA` is still used.
+
+    - Support for the long-deprecated mime-types v1 format has been removed.
+
+    - The registry is default loaded from the columnar store by default. The
+      internal format of the columnar store has changed; many of the boolean
+      flags are now loaded from a single file. Resolves [#85].
+
+[#79]: https://github.com/mime-types/ruby-mime-types/pull/79
+[#84]: https://github.com/mime-types/ruby-mime-types/pull/84
+[#85]: https://github.com/mime-types/ruby-mime-types/pull/85
+[#95]: https://github.com/mime-types/ruby-mime-types/pull/95
+[#97]: https://github.com/mime-types/ruby-mime-types/pull/97
+[#112]: https://github.com/mime-types/ruby-mime-types/pull/112
+[#117]: https://github.com/mime-types/ruby-mime-types/issues/117
+[#118]: https://github.com/mime-types/ruby-mime-types/pull/118
+[#125]: https://github.com/mime-types/ruby-mime-types/pull/125
+[#126]: https://github.com/mime-types/ruby-mime-types/pull/126
+[#127]: https://github.com/mime-types/ruby-mime-types/issues/127
+[#129]: https://github.com/mime-types/ruby-mime-types/pull/129
+[#130]: https://github.com/mime-types/ruby-mime-types/pull/130
+[#127]: https://github.com/mime-types/ruby-mime-types/issues/127
+[#132]: https://github.com/mime-types/ruby-mime-types/pull/132
+[#134]: https://github.com/mime-types/ruby-mime-types/issues/134
+[#135]: https://github.com/mime-types/ruby-mime-types/pull/135
+[#136]: https://github.com/mime-types/ruby-mime-types/issues/136
+[#137]: https://github.com/mime-types/ruby-mime-types/pull/137
+[#139]: https://github.com/mime-types/ruby-mime-types/pull/139
+[#141]: https://github.com/mime-types/ruby-mime-types/pull/141
+[#142]: https://github.com/mime-types/ruby-mime-types/pull/142
+[#146]: https://github.com/mime-types/ruby-mime-types/pull/146
+[#147]: https://github.com/mime-types/ruby-mime-types/pull/147
+[#149]: https://github.com/mime-types/ruby-mime-types/pull/149
+[#150]: https://github.com/mime-types/ruby-mime-types/pull/150
+[#153]: https://github.com/mime-types/ruby-mime-types/pull/153
+[code-of-conduct.md]: Code-of-Conduct_md.html
+[contributor covenant]: http://contributor-covenant.org
+[mime-types-data]: https://github.com/mime-types/mime-types-data

data/{Licence.rdoc → Licence.md}

@@ -1,18 +1,10 @@
-== Licence
+# Licence
 
-This software is available under three licences: the GNU GPL version 2 (or at
-your option, a later version), the Perl Artistic License, or the MIT License.
-The licence preferred by me is the MIT licence.
+- Copyright 2003–2019 Austin Ziegler and contributors.
 
-The original Perl MIME::Types was dually originally licensed with the Perl
-Artistic Licence and the GNU GPL ("the same terms as Perl itself") and given
-that the Ruby implementation originally hewed pretty closely to the Perl
-version, I chose to maintain the additional licensing terms.
+The software in this repository is made available under the MIT license.
 
-* Copyright 2003–2016 Austin Ziegler and other contributors.
-* Adapted from MIME::Types (Perl) by Mark Overmeer.
-
-=== MIT License
+## 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
@@ -31,9 +23,3 @@ 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.
-
-=== Perl Artistic License (version 2)
-See the file docs/artistic.txt in the main distribution.
-
-=== GNU GPL version 2
-See the file docs/COPYING.txt in the main distribution.

data/Manifest.txt

@@ -1,40 +1,23 @@
-Code-of-Conduct.rdoc
-Contributing.rdoc
-History-Types.rdoc
-History.rdoc
-Licence.rdoc
+Code-of-Conduct.md
+Contributing.md
+History.md
+Licence.md
 Manifest.txt
 README.rdoc
 Rakefile
-data/mime-types.json
-data/mime.content_type.column
-data/mime.docs.column
-data/mime.encoding.column
-data/mime.friendly.column
-data/mime.obsolete.column
-data/mime.registered.column
-data/mime.signature.column
-data/mime.use_instead.column
-data/mime.xrefs.column
-docs/COPYING.txt
-docs/artistic.txt
 lib/mime-types.rb
 lib/mime/type.rb
 lib/mime/type/columnar.rb
 lib/mime/types.rb
+lib/mime/types/_columnar.rb
 lib/mime/types/cache.rb
 lib/mime/types/columnar.rb
+lib/mime/types/container.rb
 lib/mime/types/deprecations.rb
+lib/mime/types/full.rb
 lib/mime/types/loader.rb
-lib/mime/types/loader_path.rb
 lib/mime/types/logger.rb
-support/apache_mime_types.rb
-support/benchmarks/load.rb
-support/benchmarks/load_allocations.rb
-support/benchmarks/object_counts.rb
-support/convert.rb
-support/convert/columnar.rb
-support/iana_registry.rb
+lib/mime/types/registry.rb
 test/bad-fixtures/malformed
 test/fixture/json.json
 test/fixture/old-data