mime-types 3.3.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 727050c60daa98ccb85692629f83999009ca6d6cd259e15ceebdaf524da14c0a
+  data.tar.gz: 28a5af3883b49bd685f35cd84247dbe3c6894d5cca8417c212d3bb0d261b23d4
+SHA512:
+  metadata.gz: bb64be5b69ac765df59ea4ae0fd17f549263107c59878954e3613b44519a73eacfe00f2e28e0369452afe1a4c4846a98a5f59402d559a7b3acf9de78388bff4a
+  data.tar.gz: 1141d794103db9810da89504387f56caa84e704f523197072393855a8f9a89e474b52794d9de6a09d750634711446ce4731971a13fbe642a32f58e5f7f27b0fb

data/Code-of-Conduct.md

@@ -0,0 +1,73 @@
+# 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, 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
+
+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
+
+Examples of unacceptable behavior by participants include:
+
+* 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
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+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
+
+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.
+
+## 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.
+
+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
+
+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,143 @@
+## 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
+    $ 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
+*   Janko Marohnić
+*   Jean Boussier
+*   Jeremy Evans
+*   Juanito Fatas
+*   Jun Aruga
+*   Łukasz Śliwa
+*   Keerthi Siva
+*   Ken Ip
+*   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,240 @@
+## 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
+[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