This module provides basic functions for handling mime-types. It can handle matching mime-types against a list of media-ranges.See section 14.1 of the HTTP specification RFC 2616 for a complete explanation.

Contents

• parse_mime_type(): Parses a mime-type into it's component parts.
• parse_media_range(): Media-ranges are mime-types with wild-cards and a 'q' quality parameter.
• quality(): Determines the quality ('q') of a mime-type when compared against a list of media-ranges.
• quality_parsed(): Just like quality() except the second parameter must be pre-parsed.
• best_match(): Choose the mime-type with the highest quality ('q') from a list of candidates.

Usage

>>> import mimeparse
>>> mimeparse.best_match(['application/xbel+xml', 'text/xml'], 
      'text/*;q=0.5,*/*; q=0.1')
'text/xml'

Usage (Ruby version)

require "mimeparse"
    ==>true
MIMEParse.best_match(['application/xbel+xml', 'text/xml'],
  'text/*;q=0.5,*/*; q=0.1')
    ==>"text/xml"

Usage (PHP version)

include_once 'mimeparse.php';

echo Mimeparse::best_match(array('application/xbel+xml', 'text/xml'),
  'text/*;q=0.5,*/*; q=0.1');
    ==>"text/xml"

Further Reading

More information on the library can be found on the XML.com article Just use Media Types?