https://github.com/falconry/python-mimeparse

Basic functions for handling mime-types in Python
https://github.com/falconry/python-mimeparse

internet media mime-type python

Last synced: 6 months ago
JSON representation

Basic functions for handling mime-types in Python

• Host: GitHub
• URL: https://github.com/falconry/python-mimeparse
• Owner: falconry
• License: mit
• Created: 2012-08-22T20:10:42.000Z (about 13 years ago)
• Default Branch: master
• Last Pushed: 2024-01-02T14:49:26.000Z (almost 2 years ago)
• Last Synced: 2024-04-13T04:59:28.177Z (over 1 year ago)
• Topics: internet, media, mime-type, python
• Language: Python
• Homepage:
• Size: 71.3 KB
• Stars: 18
• Watchers: 7
• Forks: 9
• Open Issues: 4
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

          
Python-MimeParse

================

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**:

.. code-block:: sh

    $ 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:

.. code-block:: sh

    $ 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.