#mime #extension #media-types #filesystem #no-std

no-std mime2ext

Given a mimetype, suggest a file extension

7 releases

Uses old Rust 2015

new 0.1.50 Sep 16, 2021
0.1.49 Aug 1, 2021
0.1.4 May 31, 2021
0.1.3 Apr 1, 2021
0.1.1 Feb 15, 2021

#66 in Filesystem

Download history 354/week @ 2021-05-28 265/week @ 2021-06-04 310/week @ 2021-06-11 455/week @ 2021-06-18 219/week @ 2021-06-25 185/week @ 2021-07-02 204/week @ 2021-07-09 362/week @ 2021-07-16 393/week @ 2021-07-23 572/week @ 2021-07-30 417/week @ 2021-08-06 255/week @ 2021-08-13 273/week @ 2021-08-20 221/week @ 2021-08-27 350/week @ 2021-09-03 326/week @ 2021-09-10

1,401 downloads per month
Used in 2 crates

MIT license

29KB
180 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