Add guess_mime_type_str

src/lib.rs

@@ -69,9 +69,24 @@ pub fn guess_mime_type<P: AsRef<Path>>(path: P) -> Mime {
 ///
 /// Take care when processing files with assumptions based on the return value of this function.
 pub fn guess_mime_type_opt<P: AsRef<Path>>(path: P) -> Option<Mime> {
+    guess_mime_type_str(path)
+        .map(|mime| mime.parse::<Mime>().unwrap())
+}
+
+/// Guess the MIME type string of `path` by its extension (as defined by `Path::extension()`).
+///
+/// If `path` has no extension, or its extension has no known MIME type mapping,
+/// then `None` is returned.
+///
+/// ## Note
+/// **Guess** is the operative word here, as there are no guarantees that the contents of the file
+/// that `path` points to match the MIME type associated with the path's extension.
+///
+/// Take care when processing files with assumptions based on the return value of this function.
+pub fn guess_mime_type_str<P: AsRef<Path>>(path: P) -> Option<&'static str> {
     let ext = path.as_ref().extension().and_then(OsStr::to_str).unwrap_or("");
 
-    get_mime_type_opt(ext)
+    get_mime_type_str(ext)
 }
 
 /// Get the MIME type associated with a file extension.