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.

Source Distribution

python-mimeparse-1.5.3.tar.gz (6.4 kB view details)

Uploaded Source

File details

Details for the file python-mimeparse-1.5.3.tar.gz.

File metadata

File hashes

Hashes for python-mimeparse-1.5.3.tar.gz
Algorithm Hash digest
SHA256 ba91676c824648ec677eed9ea8b5ed370d404e25ef19ea42c3359c06e0bcfd72
MD5 5d1f50dbe87fb701b40c7dcad887bd93
BLAKE2b-256 740bddef0d228a4ad84b28b48956f3baee19e8be0e7bfa078110c3c5e290e65f

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page