ó
ž^Yc           @@  s   d  Z  d d l m Z d d l m Z d d l Z d Z d Z d Z d Z	 d	 Z
 d
   Z d   Z d   Z d   Z d   Z d   Z d   Z d S(   su  MIME-Type Parser

This module provides basic functions for handling mime-types. It can handle
matching mime-types against a list of media-ranges. See section 14.1 of the
HTTP specification [RFC 2616] for a complete explanation.

   http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.1

Contents:
 - 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.
i    (   t   absolute_import(   t   reduceNs   0.1.3s   Joe Gregorios   joe@bitworking.orgs   MIT Licenset    c         C@  s°   |  j  d  } t g  | d D]7 } t g  | j  d d  D] } | j   ^ q9  ^ q  } | d j   } | d k r d } n  | j  d  \ } } | j   | j   | f S(   sU  Parses a mime-type into its component parts.

    Carves up a mime-type and returns a tuple of the (type, subtype, params)
    where 'params' is a dictionary of all the parameters for the media range.
    For example, the media range 'application/xhtml;q=0.5' would get parsed
    into:

       ('application', 'xhtml', {'q', '0.5'})
       t   ;i   t   =i    t   *s   */*t   /(   t   splitt   dictt   tuplet   strip(   t	   mime_typet   partst   paramt   st   paramst	   full_typet   typet   subtype(    (    sK   /tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/mimeparse.pyt   parse_mime_type#   s    
H	c         C@  s   t  |   \ } } } d | k si | d si t | d  si t | d  d k si t | d  d k  rv d | d <n  | | | f S(   sď  Parse a media-range into its component parts.

    Carves up a media range and returns a tuple of the (type, subtype,
    params) where 'params' is a dictionary of all the parameters for the media
    range.  For example, the media range 'application/*;q=0.5' would get parsed
    into:

       ('application', '*', {'q', '0.5'})

    In addition this function also guarantees that there is a value for 'q'
    in the params dictionary, filling it in with a proper default if
    necessary.
    t   qi   i    t   1(   R   t   float(   t   rangeR   R   R   (    (    sK   /tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/mimeparse.pyt   parse_media_range;   s    'c         C@  s^  d } d } t  |   \ } } } x*| D]"\ } } }	 | | k pX | d k pX | d k }
 | | k p| | d k p| | d k } |
 r( | r( t d   g  t j |  D]: \ } } | d k r¤ | |	 k r¤ | |	 | k r¤ d ^ q¤ d  } | | k rü d p˙ d } | | | k rd pd 7} | | 7} | | k rJ| } |	 d } qJq( q( W| t |  f S(	   sł  Find the best match for a mime-type amongst parsed media-ranges.

    Find the best match for a given mime-type against a list of media_ranges
    that have already been parsed by parse_media_range(). Returns a tuple of
    the fitness value and the value of the 'q' quality parameter of the best
    match, or (-1, 0) if no match was found. Just as for quality_parsed(),
    'parsed_ranges' must be a list of parsed media ranges.
    i˙˙˙˙i    R   c         S@  s   |  | S(   N(    (   t   xt   y(    (    sK   /tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/mimeparse.pyt   <lambda>g   s    R   i   id   i
   (   R   R   t   sixt	   iteritemsR   (   R   t   parsed_rangest   best_fitnesst
   best_fit_qt   target_typet   target_subtypet   target_paramsR   R   R   t
   type_matcht   subtype_matcht   keyt   valuet   param_matchest   fitness(    (    sK   /tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/mimeparse.pyt   fitness_and_quality_parsedR   s*    	%.
c         C@  s   t  |  |  d S(   s  Find the best match for a mime-type amongst parsed media-ranges.

    Find the best match for a given mime-type against a list of media_ranges
    that have already been parsed by parse_media_range(). Returns the 'q'
    quality parameter of the best match, 0 if no match was found. This function
    bahaves the same as quality() except that 'parsed_ranges' must be a list of
    parsed media ranges.
    i   (   R*   (   R   R   (    (    sK   /tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/mimeparse.pyt   quality_parsedt   s    
c         C@  s5   g  | j  d  D] } t |  ^ q } t |  |  S(   sK  Return the quality ('q') of a mime-type against a list of media-ranges.

    Returns the quality 'q' of a mime-type when compared against the
    media-ranges in ranges. For example:

    >>> quality('text/html','text/*;q=0.3, text/html;q=0.7,
                  text/html;level=1, text/html;level=2;q=0.4, */*;q=0.5')
    0.7

    t   ,(   R   R   R+   (   R   t   rangest   rR   (    (    sK   /tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/mimeparse.pyt   quality   s    (c         C@  s¨   t  | j d   } g  | D] } t |  ^ q } g  } d } x7 |  D]/ } | j t | |  | | f  | d 7} qG W| j   | d d d r¤ | d d p§ d S(   sY  Return mime-type with the highest quality ('q') from list of candidates.

    Takes a list of supported mime-types and finds the best match for all the
    media-ranges listed in header. The value of header must be a string that
    conforms to the format of the HTTP Accept: header. The value of 'supported'
    is a list of mime-types. The list of supported mime-types should be sorted
    in order of increasing desirability, in case of a situation where there is
    a tie.

    >>> best_match(['application/xbel+xml', 'text/xml'],
                   'text/*;q=0.5,*/*; q=0.1')
    'text/xml'
    R,   i    i   i˙˙˙˙i   R   (   t   _filter_blankR   R   t   appendR*   t   sort(   t	   supportedt   headert   split_headerR.   t   parsed_headert   weighted_matchest   posR   (    (    sK   /tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/mimeparse.pyt
   best_match   s    
c         c@  s)   x" |  D] } | j    r | Vq q Wd  S(   N(   R
   (   t   iR   (    (    sK   /tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/mimeparse.pyR0   Ź   s    (   t   __doc__t
   __future__R    t	   functoolsR   R   t   __version__t
   __author__t	   __email__t   __license__t   __credits__R   R   R*   R+   R/   R9   R0   (    (    (    sK   /tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/mimeparse.pyt   <module>   s   			"			