mime-types-data 3.2024.1001 → 3.2025.0318

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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: f2c4a58fc0920f93f675623adcda0313a45a36d3ddb2f7f4dc3a5c68a204fe8b
4
- data.tar.gz: 8a40a69501bb0603346b86150685cd16877a1f6eff0e3906b4e3611b012a0ff0
3
+ metadata.gz: '00473866fb852296efffaefade5670dfd0191ae000ab3e2a9fe06dbb02d9c8c1'
4
+ data.tar.gz: 44b6cc248b8b7c509425ffaafe1e366e91bf3e34c9e3a02efa5d8f1002ef9a51
5
5
  SHA512:
6
- metadata.gz: 9bcdfa93837e4f5c1b806c605c3eee8c6556133e078d886e0f7bcdffebd201eb7b5598f3dd5efb71c550dc5c86c905a346461f6bd155a3a38319664fbe51a7f2
7
- data.tar.gz: 6e7ef7a4d4434ea83c854a20b07ad5051c07b15cd510977d193941cd7dd92fb0c54fa5535e15e66ed93328983f414f3ff5543800017042e9b7fb2b262a261523
6
+ metadata.gz: 306705b318c292ed6c1078a83cdf5668323d8c8146db663c18c654272cd0454ede2158b99bbf27aed3028583e7fa0c55b3905dca99aa379165b4d50fec1a04a9
7
+ data.tar.gz: 23275e36afd51f312ba9b9ec5df7ee0e5c6e0b05755791ff8b5c6c4ea5d860f116441189bf95cb1274af9d4c76e15f9ee53f2732d96c412035fbe28c97521060
@@ -2,6 +2,60 @@
2
2
 
3
3
  <!-- automatic-release -->
4
4
 
5
+ ## 3.2025.0318 / 2025-03-18
6
+
7
+ - Updated the Apache and IANA media registry entries as of release date
8
+
9
+ ## 3.2025.0304 / 2025-03-04
10
+
11
+ - Updated the Apache and IANA media registry entries as of release date
12
+
13
+ ## 3.2025.0220 / 2025-02-20
14
+
15
+ - Updated the Apache and IANA media registry entries as of release date
16
+
17
+ - Added [trusted publishing][tp] for fully automated releases. Developed by
18
+ Samuel Giddins in [#109][pull-109], merged manually with some updates.
19
+
20
+ ## 3.2025.0204 / 2025-02-04
21
+
22
+ - Updated the Apache and IANA media registry entries as of release date
23
+
24
+ - Added the Changelog URL to the README so that RubyGems.org is updated with the
25
+ `changelog_uri` on release. Contributed by Mark Young in [#96][pull-96].
26
+
27
+ - Fixed an issue with automated releases that added thousands of files because
28
+ `vendor/` was no longer ignored.
29
+
30
+ - Fixed the automated release builder process to handle the case when the
31
+ `automatic-release` tag is followed by a `## NEXT / YYYY-MM-DD` header so that
32
+ changes merged normally are picked up on automatic releases. [#98][pull-98]
33
+
34
+ ## 3.2025.0107 / 2025-01-07
35
+
36
+ - Updated the Apache and IANA media registry entries as of release date
37
+ - Restructured documentation for how I prefer to manage Hoe projects now.
38
+ - Reworked the Rakefile because all data updates are now managed by GitHub
39
+ Actions and should not be managed manually any longer.
40
+
41
+ - `rake release:prepare` now does the same work as `rake release:gha`, but
42
+ does not commit or create a pull request.
43
+
44
+ - `rake convert` no longer has any subtasks.
45
+
46
+ - `rake update` has been removed with no replacement.
47
+
48
+ - Updated `.hoerc` to properly exclude `support/` and `types/` from the
49
+ manifest.
50
+
51
+ ## 3.2024.1203 / 2024-12-03
52
+
53
+ - Updated the Apache and IANA media registry entries as of release date
54
+
55
+ ## 3.2024.1105 / 2024-11-05
56
+
57
+ - Updated the Apache and IANA media registry entries as of release date
58
+
5
59
  ## 3.2024.1001 / 2024-10-01
6
60
 
7
61
  - Updated the Apache and IANA media registry entries as of release date
@@ -15,7 +69,7 @@
15
69
  - Updated the Apache and IANA media registry entries as of release date.
16
70
 
17
71
  - Added `.jxl` extension for `image/jxl`. Contributed by Shane Eskritt in
18
- [#81][#81].
72
+ [#81][pull-81].
19
73
 
20
74
  ## 3.2024.0806 / 2024-08-06
21
75
 
@@ -30,7 +84,7 @@
30
84
  - This update adds a new `haptics/` group with three media types defined.
31
85
 
32
86
  - Moved extensions from `audio/x-aac` to `audio/aac` and mark `audio/x-aac` as
33
- obsolete. Based on [#77][#77] by Samuel Williams.
87
+ obsolete. Based on [#77][pull-77] by Samuel Williams.
34
88
 
35
89
  - Made the same changes for `audio/flac` and `audio/matroska`.
36
90
 
@@ -93,8 +147,8 @@
93
147
  information available to deprecate `text/javascript` in favour of
94
148
  `application/javascript`. Since the previous update (2022-01-05), IANA has
95
149
  officially deprecated `application/javascript` in favour of `text/javascript`.
96
- Samuel Williams discovered this in [#55][#55] by noting that all `js` types
97
- were marked obsolete in version 3.2023.0218.
150
+ Samuel Williams discovered this in [#55][issue-55] by noting that all `js`
151
+ types were marked obsolete in version 3.2023.0218.
98
152
 
99
153
  A hotfix has been applied to resolve this. However, note that
100
154
  `application/javascript` will not be returned by default, only
@@ -105,15 +159,15 @@
105
159
  - Updated the Apache and IANA media registry entries as of release date.
106
160
 
107
161
  - Mohammed Gad added the `jfif` file extension for `image/jpeg` text format.
108
- [#52][#52]
162
+ [#52][pull-52]
109
163
 
110
164
  - Reworked the loading of IANA provisional media registries to merge them into
111
165
  the top-level media-type registries instead of a standalone registry file.
112
- [#53][#53] originally identified by Chris Salzberg in [#50][#50].
166
+ [#53][pull-53] originally identified by Chris Salzberg in [#50][pull-50].
113
167
 
114
168
  It is worth noting that this is an _imperfect_ solution as if a media type is
115
169
  provisionally registered and withdrawn, it will linger in the registry with no
116
- clean way of identifying them at the moment. See [#54][#54].
170
+ clean way of identifying them at the moment. See [#54][issue-54].
117
171
 
118
172
  This release also fixes [ruby-mime-types#163][ruby-mime-types#163], where logs
119
173
  show "Type application/netcdf is already registered as a variant of
@@ -124,25 +178,25 @@
124
178
  - Updated the Apache and IANA media registry entries as of release date.
125
179
 
126
180
  - Fixed an incorrect definition of `image/bmp`, which had been marked obsolete
127
- and later registered. Fixed [#48][#48], found by William T. Nelson.
181
+ and later registered. Fixed [#48][issue-48], found by William T. Nelson.
128
182
 
129
183
  ## 3.2021.1115 / 2021-11-15
130
184
 
131
185
  - Updated the Apache and IANA media registry entries as of release date.
132
186
 
133
187
  - Added conversion utilities that support the `mini_mime` data format. These
134
- have been ported from the [mini_mime][mini_mime] repository. [#47][#47]
188
+ have been ported from the [mini\_mime][mini_mime] repository. [#47][pull-47]
135
189
 
136
- - Added IANA provisional media registries. Added some notes to Contributing.md
190
+ - Added IANA provisional media registries. Added some notes to CONTRIBUTING.md
137
191
  about the transient nature of the provisional registration data. This was
138
- triggered in part by a pull request by Jon Sneyers. Thanks! [#45][#45],
139
- [#43][#43]
192
+ triggered in part by a pull request by Jon Sneyers. Thanks! [#45][pull-45],
193
+ [#43][pull-43]
140
194
 
141
195
  ## 3.2021.0901 / 2021-09-01
142
196
 
143
197
  - Updated the Apache and IANA media registry entries as of release date.
144
198
 
145
- - Added file extension for WebVTT text format. [#46][#46]
199
+ - Added file extension for WebVTT text format. [#46][pull-46]
146
200
 
147
201
  ## 3.2021.0704 / 2021-07-04
148
202
 
@@ -152,7 +206,7 @@
152
206
 
153
207
  - Updated the Apache and IANA media registry entries as of release date.
154
208
 
155
- - Added file extension for AVIF video format. [#40][#40]
209
+ - Added file extension for AVIF video format. [#40][pull-40]
156
210
 
157
211
  ## 3.2021.0212 / 2021-02-12
158
212
 
@@ -167,67 +221,68 @@
167
221
 
168
222
  - Updated the IANA media registry entries as of release date.
169
223
 
170
- - Added `application/x-zip-compressed`. [#36][#36]
224
+ - Added `application/x-zip-compressed`. [#36][pull-36]
171
225
 
172
226
  - Updated the contributing guide to include information about the release
173
- process as described in [#18][#18]
227
+ process as described in [#18][issue-18]
174
228
 
175
- - Corrected a misspelling of Yoran Brondsemas name. Sorry, Yoran. [#35][#35]
229
+ - Corrected a misspelling of Yoran Brondsema's name. Sorry, Yoran.
230
+ [#35][pull-35]
176
231
 
177
232
  ## 3.2020.0512 / 2020-05-12
178
233
 
179
234
  - Updated the IANA media registry entries as of release date.
180
235
 
181
- - Added file extensions for HEIC image types. [#34][#34]
236
+ - Added file extensions for HEIC image types. [#34][pull-34]
182
237
 
183
238
  ## 3.2020.0425 / 2020-04-25
184
239
 
185
240
  - Updated the IANA media registry entries as of release date.
186
241
 
187
242
  - Added several RAW image types based on data from GNOME RAW Thumbnailer.
188
- [#33][#33] fixing [#32][#32]
243
+ [#33][pull-33] fixing [#32][issue-32]
189
244
 
190
- - Added `audio/wav`. [#31][#31]
245
+ - Added `audio/wav`. [#31][pull-31]
191
246
 
192
- - Added a type for Smarttech notebook files. [#30][#30]
247
+ - Added a type for Smarttech notebook files. [#30][pull-30]
193
248
 
194
- - Added an alias for audio/m4a files. [#29][#29]
249
+ - Added an alias for audio/m4a files. [#29][pull-29]
195
250
 
196
- - Added application/x-ms-dos-executable. [#28][#28]
251
+ - Added application/x-ms-dos-executable. [#28][pull-28]
197
252
 
198
253
  ## 3.2019.1009 / 2019-10-09
199
254
 
200
255
  - Updated the IANA media registry entries as of release date.
201
256
 
202
257
  - Reordered the `.ai` extension so that it is not the preferred extension for
203
- `application/pdf` [#24][#24]
258
+ `application/pdf` [#24][pull-24]
204
259
 
205
260
  ## 3.2019.0904 / 2019-09-04
206
261
 
207
262
  - Updated the IANA media registry entries as of release date.
208
263
 
209
264
  - Moved the `.ai` extension from `application/postscript` to `application/pdf`.
210
- [#23][#23] fixing [#22][#22]
265
+ [#23][pull-23] fixing [#22][issue-22]
211
266
 
212
267
  ## 3.2019.0331 / 2019-03-31
213
268
 
214
269
  - Updated the IANA media registry entries as of release date.
215
270
 
216
- - Added support for `application/wasm` with extension `.wasm`. [#21][#21]
271
+ - Added support for `application/wasm` with extension `.wasm`. [#21][pull-21]
217
272
 
218
- - Fixed `application/ecmascript` extensions. [#20][#20]
273
+ - Fixed `application/ecmascript` extensions. [#20][pull-20]
219
274
 
220
275
  ## 3.2018.0812 / 2018-08-12
221
276
 
222
- - Added `.xsd` extension to `text/xml`. [#10][#10]
277
+ - Added `.xsd` extension to `text/xml`. [pull-10][pull-10]
223
278
 
224
279
  - Added `.js` and `.mjs` extensions to `text/ecmascript` and `text/javascript`.
225
- [#11][#11]
280
+ [#11][pull-11]
226
281
 
227
- - Added `.ipa` extension to `application/octet-stream`. [#12][#12]
282
+ - Added `.ipa` extension to `application/octet-stream`. [#12][pull-12]
228
283
 
229
284
  - Moved extensions `.markdown` and `.md` and added `.mkd` extension to
230
- `text/markdown`. [#13][#13]
285
+ `text/markdown`. [#13][pull-13]
231
286
 
232
287
  - Because of a bug found with mime-types 3 before 3.2.1, this version requires
233
288
  mime-types 3.1 or later to manage data.
@@ -246,7 +301,7 @@
246
301
  - Updated the known extension list for application/octet-stream and
247
302
  application/pgp-encrypted to include gpg as an extension. Fixes
248
303
  [#3](https://github.com/mime-types/mime-types-data/pull/3) by Tao Guo
249
- (@taoza).
304
+ ([@taoza](https://github.com/taoza)).
250
305
  - Updated the IANA media registry entries as of release date:
251
306
 
252
307
  - Updated metadata for application/EmergencyCallData.Comment+xml,
@@ -299,7 +354,7 @@
299
354
  ## 3.2015.1120 / 2015-11-20
300
355
 
301
356
  - Extracted from [ruby-mime-types][rmt].
302
- - Added a [Code of Conduct].
357
+ - Added a [Code of Conduct][Code of Conduct].
303
358
  - The versioning has changed to be semantic on format plus date in two parts.
304
359
 
305
360
  - All registry formats have been updated to remove deprecated data.
@@ -340,8 +395,10 @@
340
395
 
341
396
  ## 2.6 / 2015-05-25
342
397
 
343
- - Steven Michael Thomas (@stevenmichaelthomas) added `woff2` as an extension to
344
- application/font-woff, [ruby-mime-types#99][ruby-mime-types#99].
398
+ - Steven Michael Thomas
399
+ ([@stevenmichaelthomas](https://github.com/stevenmichaelthomas)) added `woff2`
400
+ as an extension to application/font-woff,
401
+ [ruby-mime-types#99][ruby-mime-types#99].
345
402
  - Updated the IANA media registry entries as of release date:
346
403
  - Updated metadata for application/jose, application/jose+json,
347
404
  application/jwk+json, application/jwk-set+json, application/jwt to reflect
@@ -372,17 +429,17 @@
372
429
  (RFC7396), application/smil, application/vnd.arastra.swi,
373
430
  application/vnd.geocube+xml, application/vnd.gmx, application/xhtml+xml,
374
431
  text/directory.
375
- - Andy Brody (@ab) fixed a pair of embarrassing typos in text/csv and
376
- text/tab-separated-values,
432
+ - Andy Brody ([@ab](https://github.com/ab)) fixed a pair of embarrassing typos
433
+ in text/csv and text/tab-separated-values,
377
434
  [ruby-mime-types#89](https://github.com/mime-types/ruby-mime-types/pull/89).
378
- - Aggelos Avgerinos (@eavgerinos) added the unregistered MIME type
379
- image/x-ms-bmp with the extension `bmp`,
435
+ - Aggelos Avgerinos ([@eavgerinos](https://github.com/eavgerinos)) added the
436
+ unregistered MIME type image/x-ms-bmp with the extension `bmp`,
380
437
  [ruby-mime-types#90](https://github.com/mime-types/ruby-mime-types/pull/90).
381
438
 
382
439
  ## 2.4.2 / 2014-10-15
383
440
 
384
441
  - Added application/vnd.ms-outlook as an unregistered MIME type with the
385
- extension `msg`. Provided by @keerthisiv in
442
+ extension `msg`. Provided by [@keerthisiv](https://github.com/keerthisiv) in
386
443
  [ruby-mime-types#72](https://github.com/mime-types/ruby-mime-types/pull/72).
387
444
 
388
445
  ## 2.4.1 / 2014-10-07
@@ -440,7 +497,7 @@
440
497
  ## 2.2 / 2014-03-14
441
498
 
442
499
  - Added <tt>.sj</tt> to `application/javascript` as provided by Brandon
443
- Galbraith (@brandongalbraith) in
500
+ Galbraith ([@brandongalbraith](https://github.com/brandongalbraith)) in
444
501
  [ruby-mime-types#58](https://github.com/mime-types/ruby-mime-types/pull/58).
445
502
  - Marked application/excel and application/x-excel as obsolete in favour of
446
503
  application/vnd.ms-excel per
@@ -572,40 +629,44 @@
572
629
  video/x-mng, video/x-ms-vob, video/x-smv
573
630
  - Merged the non-standard VMS platform text/plain with the standard text/plain.
574
631
 
575
- [#10]: https://github.com/mime-types/mime-types-data/pull/10
576
- [#11]: https://github.com/mime-types/mime-types-data/pull/11
577
- [#12]: https://github.com/mime-types/mime-types-data/pull/12
578
- [#13]: https://github.com/mime-types/mime-types-data/pull/13
579
- [#18]: https://github.com/mime-types/mime-types-data/issues/18
580
- [#20]: https://github.com/mime-types/mime-types-data/pull/20
581
- [#21]: https://github.com/mime-types/mime-types-data/pull/21
582
- [#22]: https://github.com/mime-types/mime-types-data/issues/22
583
- [#23]: https://github.com/mime-types/mime-types-data/pull/23
584
- [#24]: https://github.com/mime-types/mime-types-data/pull/24
585
- [#28]: https://github.com/mime-types/mime-types-data/pull/28
586
- [#29]: https://github.com/mime-types/mime-types-data/pull/29
587
- [#30]: https://github.com/mime-types/mime-types-data/pull/30
588
- [#31]: https://github.com/mime-types/mime-types-data/pull/31
589
- [#32]: https://github.com/mime-types/mime-types-data/issues/32
590
- [#33]: https://github.com/mime-types/mime-types-data/pull/33
591
- [#34]: https://github.com/mime-types/mime-types-data/pull/34
592
- [#35]: https://github.com/mime-types/mime-types-data/pull/35
593
- [#36]: https://github.com/mime-types/mime-types-data/pull/36
594
- [#40]: https://github.com/mime-types/mime-types-data/pull/40
595
- [#43]: https://github.com/mime-types/mime-types-data/pull/43
596
- [#45]: https://github.com/mime-types/mime-types-data/pull/45
597
- [#46]: https://github.com/mime-types/mime-types-data/pull/46
598
- [#47]: https://github.com/mime-types/mime-types-data/pull/47
599
- [#48]: https://github.com/mime-types/mime-types-data/issues/48
600
- [#50]: https://github.com/mime-types/mime-types-data/pull/50
601
- [#52]: https://github.com/mime-types/mime-types-data/pull/52
602
- [#53]: https://github.com/mime-types/mime-types-data/pull/53
603
- [#54]: https://github.com/mime-types/mime-types-data/issues/54
604
- [#55]: https://github.com/mime-types/mime-types-data/issues/55
605
- [#77]: https://github.com/mime-types/mime-types-data/pull/77
606
- [#81]: https://github.com/mime-types/mime-types-data/pull/81
607
- [rmt]: https://github.com/mime-types/ruby-mime-types
608
- [code of conduct]: Code-of-Conduct.md
632
+ [code of conduct]: CODE_OF_CONDUCT.md
633
+ [issue-18]: https://github.com/mime-types/mime-types-data/issues/18
634
+ [issue-22]: https://github.com/mime-types/mime-types-data/issues/22
635
+ [issue-32]: https://github.com/mime-types/mime-types-data/issues/32
636
+ [issue-48]: https://github.com/mime-types/mime-types-data/issues/48
637
+ [issue-54]: https://github.com/mime-types/mime-types-data/issues/54
638
+ [issue-55]: https://github.com/mime-types/mime-types-data/issues/55
609
639
  [mini_mime]: https://github.com/discourse/mini_mime/issues/41
610
- [ruby-mime-types#99]: https://github.com/mime-types/ruby-mime-types/pull/99
640
+ [pull-109]: https://github.com/mime-types/mime-types-data/pull/109
641
+ [pull-10]: https://github.com/mime-types/mime-types-data/pull/10
642
+ [pull-11]: https://github.com/mime-types/mime-types-data/pull/11
643
+ [pull-12]: https://github.com/mime-types/mime-types-data/pull/12
644
+ [pull-13]: https://github.com/mime-types/mime-types-data/pull/13
645
+ [pull-20]: https://github.com/mime-types/mime-types-data/pull/20
646
+ [pull-21]: https://github.com/mime-types/mime-types-data/pull/21
647
+ [pull-23]: https://github.com/mime-types/mime-types-data/pull/23
648
+ [pull-24]: https://github.com/mime-types/mime-types-data/pull/24
649
+ [pull-28]: https://github.com/mime-types/mime-types-data/pull/28
650
+ [pull-29]: https://github.com/mime-types/mime-types-data/pull/29
651
+ [pull-30]: https://github.com/mime-types/mime-types-data/pull/30
652
+ [pull-31]: https://github.com/mime-types/mime-types-data/pull/31
653
+ [pull-33]: https://github.com/mime-types/mime-types-data/pull/33
654
+ [pull-34]: https://github.com/mime-types/mime-types-data/pull/34
655
+ [pull-35]: https://github.com/mime-types/mime-types-data/pull/35
656
+ [pull-36]: https://github.com/mime-types/mime-types-data/pull/36
657
+ [pull-40]: https://github.com/mime-types/mime-types-data/pull/40
658
+ [pull-43]: https://github.com/mime-types/mime-types-data/pull/43
659
+ [pull-45]: https://github.com/mime-types/mime-types-data/pull/45
660
+ [pull-46]: https://github.com/mime-types/mime-types-data/pull/46
661
+ [pull-47]: https://github.com/mime-types/mime-types-data/pull/47
662
+ [pull-50]: https://github.com/mime-types/mime-types-data/pull/50
663
+ [pull-52]: https://github.com/mime-types/mime-types-data/pull/52
664
+ [pull-53]: https://github.com/mime-types/mime-types-data/pull/53
665
+ [pull-77]: https://github.com/mime-types/mime-types-data/pull/77
666
+ [pull-81]: https://github.com/mime-types/mime-types-data/pull/81
667
+ [pull-96]: https://github.com/mime-types/mime-types-data/pull/96
668
+ [pull-98]: https://github.com/mime-types/mime-types-data/pull/98
669
+ [rmt]: https://github.com/mime-types/ruby-mime-types
611
670
  [ruby-mime-types#163]: https://github.com/mime-types/ruby-mime-types/issues/163
671
+ [ruby-mime-types#99]: https://github.com/mime-types/ruby-mime-types/pull/99
672
+ [tp]: https://guides.rubygems.org/trusted-publishing/
data/CONTRIBUTING.md ADDED
@@ -0,0 +1,150 @@
1
+ # Contributing
2
+
3
+ Contribution to mime-types-data is encouraged in any form: a bug report, new
4
+ MIME type definitions, or additional code to help manage the MIME types. There
5
+ are a few DOs and DON'Ts for contributions.
6
+
7
+ - DO:
8
+
9
+ - Keep the coding style that already exists for any updated Ruby code (support
10
+ or otherwise). I use [Standard Ruby][standardrb] for linting and formatting.
11
+
12
+ - Use thoughtfully-named topic branches for contributions. Rebase your commits
13
+ into logical chunks as necessary.
14
+
15
+ - Use [quality commit messages][qcm].
16
+
17
+ - Add your name or GitHub handle to `CONTRIBUTORS.md` and a record in the
18
+ `CHANGELOG.md` as a separate commit from your main change. (Follow the style
19
+ in the `CHANGELOG.md` and provide a link to your PR.)
20
+
21
+ - DO NOT:
22
+
23
+ - Modify `VERSION` in `lib/mime/types/data.rb`. When your patch is accepted
24
+ and a release is made, the version will be updated at that point. Most
25
+ likely, once merged, your release will be rolled into the next automatic
26
+ release.
27
+
28
+ - Modify `mime-types-data.gemspec`; it is a generated file. (You _may_ use
29
+ `rake gemspec` to regenerate it if your change involves metadata related to
30
+ gem itself).
31
+
32
+ - Modify the `Gemfile`.
33
+
34
+ - Modify any files in `data/`. Any changes to be captured here will be
35
+ automatically updated on the next release.
36
+
37
+ Although mime-types-data was extracted from the [Ruby mime-types][rmt] gem and
38
+ the support files are written in Ruby, the _target_ of mime-types-data is any
39
+ implementation that wishes to use the data as a MIME types registry, so I am
40
+ particularly interested in tools that will create a mime-types-data package for
41
+ other languages.
42
+
43
+ ## Adding or Modifying MIME Types
44
+
45
+ The Ruby mime-types gem loads its data from files encoded in the `data`
46
+ directory in this gem by loading `mime-types-data` and reading
47
+ MIME::Types::Data::PATH. These files are compiled files from the collection of
48
+ data in the `types` directory.
49
+
50
+ > [!WARNING]
51
+ >
52
+ > Pull requests that include changes to files in `data/` will require amendment
53
+ > to revert these files.
54
+
55
+ New or modified MIME types should be edited in the appropriate YAML file under
56
+ `types`. The format is as shown below for the `application/xml` MIME type in
57
+ `types/application.yml`.
58
+
59
+ ```yaml
60
+ - !ruby/object:MIME::Type
61
+ content-type: application/xml
62
+ encoding: 8bit
63
+ extensions:
64
+ - xml
65
+ - xsl
66
+ references:
67
+ - IANA
68
+ - RFC3023
69
+ xrefs:
70
+ rfc:
71
+ - rfc3023
72
+ registered: true
73
+ ```
74
+
75
+ There are other fields that can be added, matching the fields discussed in the
76
+ documentation for MIME::Type. Pull requests for MIME types should just contain
77
+ the changes to the YAML files for the new or modified MIME types; I will convert
78
+ the YAML files to JSON prior to a new release. I would rather not have to verify
79
+ that the JSON matches the YAML changes, which is why it is not necessary to
80
+ convert for the pull request.
81
+
82
+ If you are making a change for a private fork, use `rake convert:yaml:json` to
83
+ convert the YAML to JSON, or `rake convert:yaml:columnar` to convert it to the
84
+ new columnar format.
85
+
86
+ ### Updating Types from the IANA or Apache Lists
87
+
88
+ If you are maintaining a private fork and wish to update your copy of the MIME
89
+ types registry used by this gem, you can do this with the rake tasks:
90
+
91
+ ```sh
92
+ $ rake mime:iana
93
+ $ rake mime:apache
94
+ ```
95
+
96
+ #### A Note on Provisional Types
97
+
98
+ Provisionally registered types from IANA are contained in the `types/*.yaml`
99
+ files. Per IANA,
100
+
101
+ > This registry, unlike some other provisional IANA registries, is only for
102
+ > temporary use. Entries in this registry are either finalized and moved to the
103
+ > main media types registry or are abandoned and deleted. Entries in this
104
+ > registry are suitable for use for development and test purposes only.
105
+
106
+ Provisional types are rewritten when updated, so pull requests to manually
107
+ customize provisional types (such as with extensions) are considered lower
108
+ priority. It is recommended that any updates required to the data be performed
109
+ in your application if you require provisional types.
110
+
111
+ ## The Release Process
112
+
113
+ The release process is almost completely automated, where upstream MIME types
114
+ will be updated weekly (on Tuesdays) and be presented in a reviewable pull
115
+ request. Once merged, the release will be automatically published to RubyGems.
116
+
117
+ With the addition of [trusted publishing][tp], there should no longer be a need
118
+ for manual releases outside of the update cycle. Pull requests merged between
119
+ cycles will be released on the next cycle.
120
+
121
+ If it becomes necessary to perform a manual release, IANA updates should be
122
+ performed manually.
123
+
124
+ 1. Review any outstanding issues or pull requests to see if anything needs to be
125
+ addressed. This is necessary because there is no automated source for
126
+ extensions for the thousands of MIME entries. (Suggestions and/or pull
127
+ requests for same would be deeply appreciated.)
128
+ 2. `bundle install`
129
+ 3. Review the changes to make sure that the changes are sane. The IANA data
130
+ source changes from time to time, resulting in big changes or even a broken
131
+ step 4. (The most recent change was the addition of the `font/*` top-level
132
+ category.)
133
+ 4. Write up the changes in `CHANGELOG.md`. If any PRs have been merged, these
134
+ should be noted specifically and contributions should be added in
135
+ `Contributing.md`.
136
+ 5. Ensure that the `VERSION` in `lib/mime/types/data.rb` is updated with the
137
+ current date UTC.
138
+ 6. Run `rake gemspec` to ensure that `mime-types.gemspec` has been updated.
139
+ 7. Commit the changes and push to GitHub. The automated trusted publishing
140
+ workflow will pick up the changes.
141
+
142
+ This list is based on issue [#18][issue-18].
143
+
144
+ [hoe]: https://github.com/seattlerb/hoe
145
+ [issue-18]: https://github.com/mime-types/mime-types-data/issues/18
146
+ [qcm]: http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html
147
+ [release-gem]: https://github.com/rubygems/release-gem
148
+ [rmt]: https://github.com/mime-types/ruby-mime-types/
149
+ [standardrb]: https://github.com/standardrb/standard
150
+ [tp]: https://guides.rubygems.org/trusted-publishing/
data/CONTRIBUTORS.md ADDED
@@ -0,0 +1,54 @@
1
+ # Contributors
2
+
3
+ - Austin Ziegler created mime-types.
4
+
5
+ Thanks to everyone else who has contributed to mime-types:
6
+
7
+ - Aaron Patterson
8
+ - Aggelos Avgerinos
9
+ - Alessio Parma
10
+ - Alex Balhatchet
11
+ - Andre Pankratz
12
+ - Andrey Eremin
13
+ - Andy Brody
14
+ - Arnaud Meuret
15
+ - Bradley Meck
16
+ - Brandon Galbraith
17
+ - Chris Gat
18
+ - Chris Salzberg
19
+ - David Genord
20
+ - Eric Marden
21
+ - Garret Alfert
22
+ - Godfrey Chan
23
+ - Greg Brockman
24
+ - Hans de Graaff
25
+ - Henrik Hodne
26
+ - Jeremy Evans
27
+ - John Gardner
28
+ - Jon Sneyers
29
+ - Jonas Petersen
30
+ - Juanito Fatas
31
+ - Keerthi Siva
32
+ - Ken Ip
33
+ - Łukasz Śliwa
34
+ - Lucia
35
+ - Mark Young
36
+ - Martin d'Allens
37
+ - Mauricio Linhares
38
+ - Mohammed Gad
39
+ - Myk Klemme
40
+ - nycvotes-dev
41
+ - Postmodern
42
+ - Richard Hirner
43
+ - Richard Hurt
44
+ - Richard Schneeman
45
+ - Robert Buchberger
46
+ - Samuel Giddins
47
+ - Samuel Williams
48
+ - Sergio Baptista
49
+ - Shane Eskritt
50
+ - Tao Guo
51
+ - Thomas Leese
52
+ - Tibor Szolár
53
+ - Todd Carrico
54
+ - Yoran Brondsema
@@ -1,6 +1,6 @@
1
1
  ## Licence
2
2
 
3
- - Copyright 2003–2024 Austin Ziegler and other contributors.
3
+ - Copyright 2003–2025 Austin Ziegler and other contributors.
4
4
 
5
5
  The software in this repository is made available under the MIT license.
6
6
 
data/Manifest.txt CHANGED
@@ -1,7 +1,8 @@
1
- Code-of-Conduct.md
2
- Contributing.md
3
- History.md
4
- Licence.md
1
+ CHANGELOG.md
2
+ CODE_OF_CONDUCT.md
3
+ CONTRIBUTING.md
4
+ CONTRIBUTORS.md
5
+ LICENCE.md
5
6
  Manifest.txt
6
7
  README.md
7
8
  Rakefile
@@ -19,18 +20,3 @@ data/mime.use_instead.column
19
20
  data/mime.xrefs.column
20
21
  lib/mime-types-data.rb
21
22
  lib/mime/types/data.rb
22
- types/application.yaml
23
- types/audio.yaml
24
- types/chemical.yaml
25
- types/conference.yaml
26
- types/drawing.yaml
27
- types/example.yaml
28
- types/font.yaml
29
- types/haptics.yaml
30
- types/image.yaml
31
- types/message.yaml
32
- types/model.yaml
33
- types/multipart.yaml
34
- types/text.yaml
35
- types/video.yaml
36
- types/world.yaml