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

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 3.8+ 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.

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

Uploaded Source

Built Distribution

python_mimeparse-2.0.0-py3-none-any.whl (5.6 kB view details)

Uploaded Python 3

File details

Details for the file python_mimeparse-2.0.0.tar.gz.

File metadata

  • Download URL: python_mimeparse-2.0.0.tar.gz
  • Upload date:
  • Size: 7.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.5

File hashes

Hashes for python_mimeparse-2.0.0.tar.gz
Algorithm Hash digest
SHA256 5b9a9dcf7aa82465e31bd667f5cb7000604811dce83554f1c8a43693a32cb303
MD5 e3d6505e9af0629a15b4d56d7f34b2ef
BLAKE2b-256 cd85c40f2e0b2128905f6c34894be01803c114f2b2efab0e8b4c3dca5e56b999

See more details on using hashes here.

File details

Details for the file python_mimeparse-2.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for python_mimeparse-2.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 574062a06f2e1d416535c8d3b83ccc6ebe95941e74e2c5939fc010a12e37cc09
MD5 050e64fa810eae5073b5936775044bed
BLAKE2b-256 65d91093a9d6d22d04d433003c96b9b1d46741b43fee5b11ece5098297737fce

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