# MultiMime

A generic swappable back-end for Mime Type detection

Lots of Ruby libraries utilize Mime Type detection in some form. In order to best support multiple Mime Type detection libraries, `multi_mime` is a general-purpose swappable Mime Type detection backend library. eg [MultiJson](https://github.com/intridea/multi_json) for Mime Types.

## Installation

```ruby
gem 'multi_mime', '~> 0.0.3'
```

```ruby
require 'multi_mime'
```

## Features / Usage Examples

```ruby
MultiMime.type_for('text/html') # 'text/html'
# alias :by_type

MultiMime.type_for_extension('.html') # 'text/html'
# alias :by_extension

MultiMime.type_for_path('/usr/local/foo/bar/foo.html') # 'text/html'
# alias :by_path

MultiMime.type_for_file( File.open('foo.html', 'w') ) # 'text/html'
# alias :by_file
```

## Badges

[![Gem Version](http://img.shields.io/gem/v/multi_mime.svg)][gem]
[![Build Status](http://img.shields.io/travis/karlfreeman/multi_mime.svg)][travis]
[![Code Quality](http://img.shields.io/codeclimate/github/karlfreeman/multi_mime.svg)][codeclimate]
[![Gittip](http://img.shields.io/gittip/karlfreeman.svg)][gittip]

## Supported Mime Engines

* [MIME::Types](https://github.com/halostatue/mime-types)
* [MagicMime](https://github.com/minad/mimemagic)
* [Rails](http://api.rubyonrails.org/classes/Mime/Type.html) (ActionDispatch::Http::Mime)
* [Rack](http://rack.rubyforge.org/doc/Rack/Mime.html) (Rack::Mime)

## Supported Ruby Versions

This library aims to support and is [tested against][travis] the following Ruby
implementations:

- Ruby 2.1.0
- Ruby 2.0.0
- Ruby 1.9.3
- [JRuby][jruby]
- [Rubinius][rubinius]

# Credits

Inspiration:

- [MultiJSON](https://github.com/intridea/multi_json)
- [MultiXML](https://github.com/sferik/multi_xml)

Cribbed:

- [MultiJSON](https://github.com/intridea/multi_json)
- [Asset_Sync"s MultiMime module](https://github.com/rumblelabs/asset_sync/commit/9333bd01ae1a7cf2ffa046b8390fbc4165c38030)

[gem]: https://rubygems.org/gems/multi_mime
[travis]: http://travis-ci.org/karlfreeman/multi_mime
[codeclimate]: https://codeclimate.com/github/karlfreeman/multi_mime
[gittip]: https://www.gittip.com/karlfreeman/
[jruby]: http://www.jruby.org
[rubinius]: http://rubini.us