Skip to main content

A module provides basic functions for parsing mime-type names and matching them against a list of media-ranges.

Project description

https://travis-ci.org/dbtsai/python-mimeparse.svg?branch=master

This module provides basic functions for handling mime-types. It can handle matching mime-types against a list of media-ranges. See section 5.3.2 of the HTTP 1.1 Semantics and Content specification [RFC 7231] for a complete explanation: https://tools.ietf.org/html/rfc7231#section-5.3.2

Installation

Use pip:

$ pip install python-mimeparse

It supports Python 2.7 - 3.5 and PyPy.

Functions

parse_mime_type()

Parses a mime-type into its 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.

Testing

Run the tests by typing: python mimeparse_test.py. The tests require Python 2.6.

To make sure that the package works in all the supported environments, you can run tox tests:

$ pip install tox
$ tox

The format of the JSON test data file is as follows: A top-level JSON object which has a key for each of the functions to be tested. The value corresponding to that key is a list of tests. Each test contains: the argument or arguments to the function being tested, the expected results and an optional description.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
python_mimeparse-1.6.0-py2.py3-none-any.whl (6.1 kB) Copy SHA256 hash SHA256 Wheel 2.7
python-mimeparse-1.6.0.tar.gz (6.5 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page