Metadata-Version: 1.1
Name: python-mimeparse
Version: 1.6.0
Summary: A module provides basic functions for parsing mime-type names and matching them against a list of media-ranges.
Home-page: https://github.com/dbtsai/python-mimeparse
Author: DB Tsai
Author-email: dbtsai@dbtsai.com
License: UNKNOWN
Download-URL: https://github.com/dbtsai/python-mimeparse/tarball/1.6.0
Description: Python-MimeParse
        ================
        
        .. image:: https://travis-ci.org/dbtsai/python-mimeparse.svg?branch=master
           :target: https://travis-ci.org/dbtsai/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 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:
        
        .. 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.
        
Keywords: mime-type
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
