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

```rust use mime2ext::mime2ext;

asserteq!(mime2ext("image/png"), Some("png")); asserteq!(mime2ext("application/octet-stream"), Some("bin")); asserteq!(mime2ext("text/html; charset=UTF-8"), Some("html")); asserteq!(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:

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

asserteq!(mime2ext(TEXTPLAIN), 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