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

Uploaded Source

Built Distribution

python_mimeparse-1.6.0-py2.py3-none-any.whl (6.1 kB view details)

Uploaded Python 2 Python 3

File details

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

File metadata

File hashes

Hashes for python-mimeparse-1.6.0.tar.gz
Algorithm Hash digest
SHA256 76e4b03d700a641fd7761d3cd4fdbbdcd787eade1ebfac43f877016328334f78
MD5 a32ae1df93be1ddb581d1c0fa124bab4
BLAKE2b-256 0f40ac5f9e44a55b678c3cd881b4c3376e5b002677dbeab6fb3a50bac5d50d29

See more details on using hashes here.

File details

Details for the file python_mimeparse-1.6.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for python_mimeparse-1.6.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 a295f03ff20341491bfe4717a39cd0a8cc9afad619ba44b77e86b0ab8a2b8282
MD5 e2780ceb12929f2f8557c467fa8c2567
BLAKE2b-256 262e03bce213a9bf02a2750dcb04e761785e9c763fc11071edc4b447eacbb842

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