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.4.tar.gz (6.4 kB view details)

Uploaded Source

File details

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

File metadata

File hashes

Hashes for python-mimeparse-1.5.4.tar.gz
Algorithm Hash digest
SHA256 54b2bdd8b0ec4a6824ab3d4107c6dc89d067f0472571acf4c1ec754406faa822
MD5 c24ebcf7ba73dc506268c39a65867de9
BLAKE2b-256 cc499be78ffa20411fd3c6ea175d3727dab63e61765da2993d0709188d75b8ec

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