9 releases

Uses old Rust 2015

0.1.52 Feb 21, 2022
0.1.51 Nov 9, 2021
0.1.50 Sep 16, 2021
0.1.49 Aug 1, 2021
0.1.1 Feb 15, 2021

#524 in Filesystem

Download history 2662/week @ 2024-03-13 2658/week @ 2024-03-20 2140/week @ 2024-03-27 1825/week @ 2024-04-03 2364/week @ 2024-04-10 2004/week @ 2024-04-17 1599/week @ 2024-04-24 2052/week @ 2024-05-01 1757/week @ 2024-05-08 1695/week @ 2024-05-15 2518/week @ 2024-05-22 1892/week @ 2024-05-29 1591/week @ 2024-06-05 1861/week @ 2024-06-12 1838/week @ 2024-06-19 1843/week @ 2024-06-26

7,607 downloads per month
Used in 14 crates (5 directly)

MIT license

27KB
184 lines

mime2ext

Crates.io API reference MSRV CI

A simple crate to look up a file extension for a mime type.

It embeds part of the mime-db database, packed efficiently into around 20 KiB. There are no dependencies, and it's no_std-compatible.

It was created for xh, which does at most one lookup per run. It prioritizes a small size over a high speed, but it should nevertheless be fast enough for most purposes.

Example

use mime2ext::mime2ext;

assert_eq!(mime2ext("image/png"), Some("png"));
assert_eq!(mime2ext("application/octet-stream"), Some("bin"));
assert_eq!(mime2ext("text/html; charset=UTF-8"), Some("html"));
assert_eq!(mime2ext("nonexistent/mimetype"), None);
assert_eq!(mime2ext("invalid-mimetype"), None);

Interoperability with mime

mime's Mime type is supported through its implementation of AsRef<str>, without any dependency on the crate:

use mime::{Mime, TEXT_PLAIN};
use mime2ext::mime2ext;

assert_eq!(mime2ext(TEXT_PLAIN), Some("txt"));
let mime: Mime = "text/xml; charset=latin1".parse()?;
assert_eq!(mime2ext(&mime), Some("xml"));

Versioning

mime2ext includes a static version of mime-db. A new version of mime2ext has to be released for each new version of mime-db.

mime2ext's version number tracks that of mime-db. mime2ext version 0.1.49 corresponds to mime-db version 1.49.0.

See CHANGELOG.md for differences between versions, including relevant changes to mime-db.

License

Both mime2ext and mime-db are licensed under the MIT license. See LICENSE and mime-db/LICENSE.

See also

  • mime_guess, which mainly converts in the opposite direction. It can also convert mime types to extensions but often suggests rarely-used extensions.

No runtime deps