mime_sniff

A MIME Type detection by magic number in Elixir.

MimeSniff implements the MIME Sniffing Standard which detect MIME Type from few bytes sequence at the beginning of a file or binary input. This work is faster than calling System.cmd("file", ["--mime-type", file_path] by about 50 times and consume memory 8 times less (see benchmark).

Installation

The package can be installed by adding mime_sniff to your list of dependencies in mix.exs:

def deps do
  [
    {:mime_sniff, "~> 0.1.1"}
  ]
end

Example

iex> MimeSniff.from_file("path/to/png_file.png")
{:ok, "image/png"}

iex> MimeSniff.from_binary(" <h1>Hello, World!<h1/>   ")
{:ok, "text/html"}

# only read 16 bytes, if not provided default is 32 bytes
iex> MimeSniff.from_file("path/to/jpg_file.jpg", sniff_len: 16)
{:ok, "image/jpeg"}

Support types

This library support most of the MIME Type defined in MIME Sniffing Standard. See Support types for the full list and minimum number of bytes need to perform the sniffing.

Benchmark

The benchmark result shows that MimeSniff, compared to System.cmd("file", ["--mime-type", file_path]), is about 50 times faster and consume memory 8 times less with one file and more than 100 times faster with 10,000 files.

Full result can be found in benchmark result.

or you can run it yourself by executing mix bench. This command will execute benchmark.exs file.

License

MimeSniff is released under the MIT License - see the LICENSE file.

This work is an implemented from MIME Sniffing Standard that was licensed under Creative Commons Attribution 4.0 International Public License