mime-types 2.99.3 → 3.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (52) hide show
  1. checksums.yaml +5 -5
  2. data/{Code-of-Conduct.rdoc → Code-of-Conduct.md} +29 -30
  3. data/Contributing.md +132 -0
  4. data/History.md +269 -0
  5. data/{Licence.rdoc → Licence.md} +4 -18
  6. data/Manifest.txt +8 -25
  7. data/README.rdoc +63 -73
  8. data/Rakefile +200 -97
  9. data/lib/mime/type/columnar.rb +30 -63
  10. data/lib/mime/type.rb +294 -458
  11. data/lib/mime/types/_columnar.rb +137 -0
  12. data/lib/mime/types/cache.rb +52 -74
  13. data/lib/mime/types/columnar.rb +2 -147
  14. data/lib/mime/types/container.rb +96 -0
  15. data/lib/mime/types/deprecations.rb +17 -34
  16. data/lib/mime/types/full.rb +19 -0
  17. data/lib/mime/types/loader.rb +36 -152
  18. data/lib/mime/types/logger.rb +7 -5
  19. data/lib/mime/types/registry.rb +90 -0
  20. data/lib/mime/types.rb +55 -148
  21. data/lib/mime-types.rb +2 -2
  22. data/test/minitest_helper.rb +8 -18
  23. data/test/test_mime_type.rb +489 -464
  24. data/test/test_mime_types.rb +139 -91
  25. data/test/test_mime_types_cache.rb +85 -57
  26. data/test/test_mime_types_class.rb +120 -100
  27. data/test/test_mime_types_lazy.rb +30 -28
  28. data/test/test_mime_types_loader.rb +18 -45
  29. metadata +92 -77
  30. data/Contributing.rdoc +0 -170
  31. data/History-Types.rdoc +0 -454
  32. data/History.rdoc +0 -590
  33. data/data/mime-types.json +0 -1
  34. data/data/mime.content_type.column +0 -1980
  35. data/data/mime.docs.column +0 -1980
  36. data/data/mime.encoding.column +0 -1980
  37. data/data/mime.friendly.column +0 -1980
  38. data/data/mime.obsolete.column +0 -1980
  39. data/data/mime.registered.column +0 -1980
  40. data/data/mime.signature.column +0 -1980
  41. data/data/mime.use_instead.column +0 -1980
  42. data/data/mime.xrefs.column +0 -1980
  43. data/docs/COPYING.txt +0 -339
  44. data/docs/artistic.txt +0 -127
  45. data/lib/mime/types/loader_path.rb +0 -15
  46. data/support/apache_mime_types.rb +0 -108
  47. data/support/benchmarks/load.rb +0 -64
  48. data/support/benchmarks/load_allocations.rb +0 -83
  49. data/support/benchmarks/object_counts.rb +0 -41
  50. data/support/convert/columnar.rb +0 -88
  51. data/support/convert.rb +0 -158
  52. data/support/iana_registry.rb +0 -172
@@ -1,121 +1,169 @@
1
- # -*- ruby encoding: utf-8 -*-
2
-
3
- require 'mime/types'
4
- require 'minitest_helper'
5
-
6
- class TestMIMETypes < Minitest::Test
7
- def setup
8
- @mime_types = MIME::Types.new
9
- @mime_types.add(MIME::Type.new(['text/plain', %w(txt)]),
10
- MIME::Type.new(['image/jpeg', %w(jpg jpeg)]),
11
- MIME::Type.new('application/x-wordperfect6.1'),
12
- MIME::Type.new('content-type' => 'application/x-www-form-urlencoded', 'registered' => true),
13
- MIME::Type.new(['application/x-gzip', %w(gz)]),
14
- MIME::Type.new(['application/gzip', %w(gz)]))
1
+ # frozen_string_literal: true
2
+
3
+ require "mime/types"
4
+ require "minitest_helper"
5
+
6
+ describe MIME::Types do
7
+ def mime_types
8
+ @mime_types ||= MIME::Types.new.tap { |mt|
9
+ mt.add MIME::Type.new(["text/plain", %w[txt]]),
10
+ MIME::Type.new(["image/jpeg", %w[jpg jpeg]]),
11
+ MIME::Type.new("application/x-wordperfect6.1"),
12
+ MIME::Type.new(
13
+ "content-type" => "application/x-www-form-urlencoded",
14
+ "registered" => true
15
+ ),
16
+ MIME::Type.new(["application/x-gzip", %w[gz]]),
17
+ MIME::Type.new(
18
+ "content-type" => "application/gzip",
19
+ "extensions" => "gz",
20
+ "registered" => true
21
+ )
22
+ }
15
23
  end
16
24
 
17
- def test_enumerable
18
- assert(@mime_types.any? { |type| type.content_type == 'text/plain' })
19
- assert_kind_of(Enumerator, @mime_types.each)
20
- assert_equal(6, @mime_types.each.count)
21
- end
25
+ describe "is enumerable" do
26
+ it "correctly uses an Enumerable method like #any?" do
27
+ assert(mime_types.any? { |type| type.content_type == "text/plain" })
28
+ end
22
29
 
23
- def test_index_with_mime_type
24
- xtxp = MIME::Type.new('x-text/x-plain')
25
- assert_includes(@mime_types[xtxp], 'text/plain')
26
- assert_equal(1, @mime_types[xtxp].size)
27
- end
30
+ it "implements each with no parameters to return an Enumerator" do
31
+ assert_kind_of Enumerator, mime_types.each
32
+ assert_kind_of Enumerator, mime_types.map
33
+ end
28
34
 
29
- def test_index_with_regex
30
- assert_includes(@mime_types[/plain/], 'text/plain')
31
- assert_equal(1, @mime_types[/plain/].size)
32
- end
35
+ it "will create a lazy enumerator" do
36
+ assert_kind_of Enumerator::Lazy, mime_types.lazy
37
+ assert_kind_of Enumerator::Lazy, mime_types.map.lazy
38
+ end
33
39
 
34
- def test_index_with_string
35
- assert_includes(@mime_types['text/plain'], 'text/plain')
36
- assert_equal(1, @mime_types['text/plain'].size)
40
+ it "is countable with an enumerator" do
41
+ assert_equal 6, mime_types.each.count
42
+ assert_equal 6, mime_types.lazy.count
43
+ end
37
44
  end
38
45
 
39
- def test_index_with_complete_flag
40
- assert_empty(@mime_types['text/vnd.fly', complete: true])
41
- refute_empty(@mime_types['text/plain', complete: true])
42
- end
46
+ describe "#[]" do
47
+ it "can be searched with a MIME::Type" do
48
+ text_plain = MIME::Type.new("text/plain")
49
+ assert_includes mime_types[text_plain], "text/plain"
50
+ assert_equal 1, mime_types[text_plain].size
51
+ end
43
52
 
44
- def test_index_with_registered_flag
45
- assert_empty(@mime_types['application/x-wordperfect6.1',
46
- registered: true])
47
- refute_empty(@mime_types['application/x-www-form-urlencoded',
48
- registered: true])
49
- refute_empty(@mime_types['application/gzip', registered: true])
50
- refute_equal(@mime_types['application/gzip'].size,
51
- @mime_types['application/gzip', registered: true])
52
- end
53
+ it "can be searched with a regular expression" do
54
+ assert_includes mime_types[/plain$/], "text/plain"
55
+ assert_equal 1, mime_types[/plain$/].size
56
+ end
53
57
 
54
- def test_index_with_platform_flag
55
- assert_deprecated('MIME::Types#[]', 'using the :platform flag') do
56
- refute_empty MIME::Types['text/plain', platform: true]
58
+ it "sorts by priority with multiple matches" do
59
+ assert_equal %w[application/gzip application/x-gzip], mime_types[/gzip$/]
60
+ assert_equal 2, mime_types[/gzip$/].size
61
+ end
62
+
63
+ it "can be searched with a string" do
64
+ assert_includes mime_types["text/plain"], "text/plain"
65
+ assert_equal 1, mime_types["text/plain"].size
57
66
  end
58
- end
59
67
 
60
- def test_add
61
- eruby = MIME::Type.new('application/x-eruby') do |t|
62
- t.extensions = 'rhtml'
63
- t.encoding = '8bit'
68
+ it "can be searched with the complete flag" do
69
+ assert_empty mime_types[
70
+ "application/x-www-form-urlencoded",
71
+ complete: true
72
+ ]
73
+ assert_includes mime_types["text/plain", complete: true], "text/plain"
74
+ assert_equal 1, mime_types["text/plain", complete: true].size
64
75
  end
65
76
 
66
- @mime_types.add(eruby)
77
+ it "can be searched with the registered flag" do
78
+ assert_empty mime_types["application/x-wordperfect6.1", registered: true]
79
+ refute_empty mime_types[
80
+ "application/x-www-form-urlencoded",
81
+ registered: true
82
+ ]
83
+ refute_empty mime_types[/gzip/, registered: true]
84
+ refute_equal mime_types[/gzip/], mime_types[/gzip/, registered: true]
85
+ end
67
86
 
68
- assert_equal(@mime_types['application/x-eruby'], [eruby])
87
+ it "properly returns an empty result on a regular expression miss" do
88
+ assert_empty mime_types[/^foo/]
89
+ assert_empty mime_types[/^foo/, registered: true]
90
+ assert_empty mime_types[/^foo/, complete: true]
91
+ end
69
92
  end
70
93
 
71
- def test_type_for
72
- assert_equal(%w(application/gzip application/x-gzip),
73
- @mime_types.type_for('gz'))
74
- assert_equal(%w(image/jpeg), MIME::Types.of('foo.jpeg'))
75
- assert_equal(%w(image/jpeg text/plain),
76
- MIME::Types.type_for(%w(foo.txt foo.jpeg)))
77
- assert_deprecated('MIME::Types#type_for', 'using the platform parameter') do
78
- assert_equal(@mime_types.of('gif', true), @mime_types['image/gif'])
94
+ describe "#add" do
95
+ let(:eruby) { MIME::Type.new("application/x-eruby") }
96
+ let(:jinja) { MIME::Type.new("application/jinja2") }
97
+
98
+ it "successfully adds a new type" do
99
+ mime_types.add(eruby)
100
+ assert_equal mime_types["application/x-eruby"], [eruby]
79
101
  end
80
- assert_empty(MIME::Types.type_for('coverallsjson'))
81
- assert_deprecated('MIME::Types#type_for', 'using the platform parameter') do
82
- assert_equal @mime_types.type_for('jpeg', true), @mime_types['image/jpeg']
102
+
103
+ it "complains about adding a duplicate type" do
104
+ mime_types.add(eruby)
105
+ assert_output "", /is already registered as a variant/ do
106
+ mime_types.add(eruby)
107
+ end
108
+ assert_equal mime_types["application/x-eruby"], [eruby]
83
109
  end
84
- assert_empty(@mime_types.type_for('zzz'))
85
- end
86
110
 
87
- def test_count
88
- assert_equal(6, @mime_types.count)
89
- end
111
+ it "does not complain about adding a duplicate type when quiet" do
112
+ mime_types.add(eruby)
113
+ assert_output "", "" do
114
+ mime_types.add(eruby, :silent)
115
+ end
116
+ assert_equal mime_types["application/x-eruby"], [eruby]
117
+ end
90
118
 
91
- # This tests the instance implementation through the class implementation.
92
- def test_add_type_variant
93
- xtxp = MIME::Type.new('x-text/x-plain')
94
- assert_deprecated('MIME::Types#add_type_variant', 'and will be private') do
95
- @mime_types.add_type_variant(xtxp)
119
+ it "successfully adds from an array" do
120
+ mime_types.add([eruby, jinja])
121
+ assert_equal mime_types["application/x-eruby"], [eruby]
122
+ assert_equal mime_types["application/jinja2"], [jinja]
96
123
  end
97
- assert_includes(@mime_types['text/plain'], xtxp)
98
- end
99
124
 
100
- def test_data_version
101
- assert_equal(MIME::Type::VERSION, @mime_types.data_version)
102
- end
125
+ it "successfully adds from another MIME::Types" do
126
+ mt = MIME::Types.new
127
+ mt.add(mime_types)
128
+ assert_equal mime_types.count, mt.count
103
129
 
104
- # This tests the instance implementation through the class implementation.
105
- def test_index_extensions
106
- xtxp = MIME::Type.new(['x-text/x-plain', %w(tzt)])
107
- assert_deprecated('MIME::Types#index_extensions', 'and will be private') do
108
- @mime_types.index_extensions(xtxp)
130
+ mime_types.each do |type|
131
+ assert_equal mt[type.content_type], [type]
132
+ end
109
133
  end
110
- assert_includes(@mime_types.of('tzt'), xtxp)
111
134
  end
112
135
 
113
- def test_defined_types
114
- assert_deprecated('MIME::Types#defined_types') do
115
- assert_empty(MIME::Types.new.defined_types)
136
+ describe "#type_for" do
137
+ it "finds all types for a given extension" do
138
+ assert_equal %w[application/gzip application/x-gzip],
139
+ mime_types.type_for("gz")
140
+ end
141
+
142
+ it "separates the extension from filenames" do
143
+ assert_equal %w[image/jpeg], mime_types.of(["foo.jpeg", "bar.jpeg"])
116
144
  end
117
- assert_deprecated('MIME::Types#defined_types') do
118
- refute_empty(@mime_types.defined_types)
145
+
146
+ it "finds multiple extensions" do
147
+ assert_equal %w[image/jpeg text/plain],
148
+ mime_types.type_for(%w[foo.txt foo.jpeg])
149
+ end
150
+
151
+ it "does not find unknown extensions" do
152
+ keys = mime_types.instance_variable_get(:@extension_index).keys
153
+ assert_empty mime_types.type_for("zzz")
154
+ assert_equal keys, mime_types.instance_variable_get(:@extension_index).keys
155
+ end
156
+
157
+ it "modifying type extensions causes reindexing" do
158
+ plain_text = mime_types["text/plain"].first
159
+ plain_text.add_extensions("xtxt")
160
+ assert_includes mime_types.type_for("xtxt"), "text/plain"
161
+ end
162
+ end
163
+
164
+ describe "#count" do
165
+ it "can count the number of types inside" do
166
+ assert_equal 6, mime_types.count
119
167
  end
120
168
  end
121
169
  end
@@ -1,19 +1,26 @@
1
- # -*- ruby encoding: utf-8 -*-
1
+ # frozen_string_literal: true
2
2
 
3
- require 'mime/types'
4
- require 'minitest_helper'
3
+ require "mime/types"
4
+ require "minitest_helper"
5
5
 
6
- class TestMIMETypesCache < Minitest::Test
7
- def setup
8
- require 'fileutils'
9
- @cache_file = File.expand_path('../cache.tst', __FILE__)
10
- ENV['RUBY_MIME_TYPES_CACHE'] = @cache_file
11
- clear_cache_file
12
- end
6
+ MUTEX = Mutex.new
7
+
8
+ describe MIME::Types::Cache do
9
+ include Minitest::Hooks
10
+
11
+ def around
12
+ require "fileutils"
13
+
14
+ MUTEX.synchronize do
15
+ @cache_file = File.expand_path("../cache.tst", __FILE__)
16
+ ENV["RUBY_MIME_TYPES_CACHE"] = @cache_file
17
+ clear_cache_file
13
18
 
14
- def teardown
15
- clear_cache_file
16
- ENV.delete('RUBY_MIME_TYPES_CACHE')
19
+ super
20
+
21
+ clear_cache_file
22
+ ENV.delete("RUBY_MIME_TYPES_CACHE")
23
+ end
17
24
  end
18
25
 
19
26
  def reset_mime_types
@@ -25,66 +32,87 @@ class TestMIMETypesCache < Minitest::Test
25
32
  FileUtils.rm @cache_file if File.exist? @cache_file
26
33
  end
27
34
 
28
- def test_does_not_use_cache_when_unset
29
- ENV.delete('RUBY_MIME_TYPES_CACHE')
30
- assert_equal(nil, MIME::Types::Cache.load)
31
- end
35
+ describe ".load" do
36
+ it "does not use cache when RUBY_MIME_TYPES_CACHE is unset" do
37
+ ENV.delete("RUBY_MIME_TYPES_CACHE")
38
+ assert_nil MIME::Types::Cache.load
39
+ end
32
40
 
33
- def test_does_not_use_cache_when_missing
34
- assert_equal(nil, MIME::Types::Cache.load)
35
- end
41
+ it "does not use cache when missing" do
42
+ assert_nil MIME::Types::Cache.load
43
+ end
36
44
 
37
- def test_does_not_create_cache_when_unset
38
- ENV.delete('RUBY_MIME_TYPES_CACHE')
39
- assert_equal(nil, MIME::Types::Cache.save)
40
- end
45
+ it "registers the data to be updated by #add_extensions" do
46
+ MIME::Types::Cache.save
47
+ reset_mime_types
48
+ assert_equal([], MIME::Types.type_for("foo.additional"))
49
+ html = MIME::Types["text/html"][0]
50
+ html.add_extensions("additional")
51
+ assert_equal([html], MIME::Types.type_for("foo.additional"))
52
+ end
41
53
 
42
- def test_creates_cache
43
- assert_equal(false, File.exist?(@cache_file))
44
- MIME::Types::Cache.save
45
- assert_equal(true, File.exist?(@cache_file))
54
+ it "outputs an error when there is an invalid version" do
55
+ v = MIME::Types::Data::VERSION
56
+ MIME::Types::Data.send(:remove_const, :VERSION)
57
+ MIME::Types::Data.const_set(:VERSION, "0.0")
58
+ MIME::Types::Cache.save
59
+ MIME::Types::Data.send(:remove_const, :VERSION)
60
+ MIME::Types::Data.const_set(:VERSION, v)
61
+ MIME::Types.instance_variable_set(:@__types__, nil)
62
+ assert_output "", /MIME::Types cache: invalid version/ do
63
+ MIME::Types["text/html"]
64
+ end
65
+ end
66
+
67
+ it "outputs an error when there is a marshal file incompatibility" do
68
+ MIME::Types::Cache.save
69
+ data = File.binread(@cache_file).reverse
70
+ File.open(@cache_file, "wb") { |f| f.write(data) }
71
+ MIME::Types.instance_variable_set(:@__types__, nil)
72
+ assert_output "", /incompatible marshal file format/ do
73
+ MIME::Types["text/html"]
74
+ end
75
+ end
46
76
  end
47
77
 
48
- def test_uses_cache
49
- MIME::Types['text/html'].first.extensions << 'hex'
50
- MIME::Types::Cache.save
51
- MIME::Types.instance_variable_set(:@__types__, nil)
78
+ describe ".save" do
79
+ it "does not create cache when RUBY_MIME_TYPES_CACHE is unset" do
80
+ ENV.delete("RUBY_MIME_TYPES_CACHE")
81
+ assert_nil MIME::Types::Cache.save
82
+ end
52
83
 
53
- assert_includes(MIME::Types['text/html'].first.extensions, 'hex')
84
+ it "creates the cache " do
85
+ assert_equal(false, File.exist?(@cache_file))
86
+ MIME::Types::Cache.save
87
+ assert_equal(true, File.exist?(@cache_file))
88
+ end
54
89
 
55
- reset_mime_types
56
- end
90
+ it "uses the cache" do
91
+ MIME::Types["text/html"].first.add_extensions("hex")
92
+ MIME::Types::Cache.save
93
+ MIME::Types.instance_variable_set(:@__types__, nil)
57
94
 
58
- def test_load_different_version
59
- v = MIME::Types::VERSION.dup
60
- MIME::Types::VERSION.gsub!(/.*/, '0.0')
61
- MIME::Types::Cache.save
62
- MIME::Types::VERSION.gsub!(/.*/, v)
63
- MIME::Types.instance_variable_set(:@__types__, nil)
64
- assert_output(nil, /MIME::Types cache: invalid version/) do
65
- MIME::Types['text/html']
66
- end
67
- end
95
+ assert_includes MIME::Types["text/html"].first.extensions, "hex"
68
96
 
69
- def test_cache_load_failure
70
- MIME::Types::Cache.save
71
- data = File.binread(@cache_file).reverse
72
- File.open(@cache_file, 'wb') { |f| f.write(data) }
73
- MIME::Types.instance_variable_set(:@__types__, nil)
74
- assert_output(nil, /Could not load MIME::Types cache: incompatible marshal file format/) do
75
- MIME::Types['text/html']
97
+ reset_mime_types
76
98
  end
77
99
  end
100
+ end
78
101
 
79
- def test_container_marshalling
102
+ describe MIME::Types::Container do
103
+ it "marshals and unmarshals correctly" do
80
104
  container = MIME::Types::Container.new
81
- # default proc should return []
82
- assert_equal([], container['abc'])
105
+ container.add("xyz", "abc")
106
+
107
+ # default proc should return Set[]
108
+ assert_equal(Set[], container["abc"])
109
+ assert_equal(Set["abc"], container["xyz"])
83
110
 
84
111
  marshalled = Marshal.dump(container)
85
112
  loaded_container = Marshal.load(marshalled)
86
113
 
87
- # default proc should still return []
88
- assert_equal([], loaded_container['abcd'])
114
+ # default proc should still return Set[]
115
+ assert_equal(Set[], loaded_container["abc"])
116
+ assert_equal(Set["abc"], container["xyz"])
89
117
  end
90
118
  end