ó
äL]c           @   sv   d  Z  d d l m Z d d l m Z d d l m Z d d  Z d d  Z d d  Z	 d d	  Z
 d d
  Z d S(   sĒ   
Module containing the simple and functional API for rfc3986.

This module defines functions and provides access to the public attributes
and classes of rfc3986.
i   (   t   IRIReference(   t   ParseResult(   t   URIReferences   utf-8c         C   s   t  j |  |  S(   sb  Parse a URI string into a URIReference.

    This is a convenience function. You could achieve the same end by using
    ``URIReference.from_string(uri)``.

    :param str uri: The URI which needs to be parsed into a reference.
    :param str encoding: The encoding of the string provided
    :returns: A parsed URI
    :rtype: :class:`URIReference`
    (   R   t   from_string(   t   urit   encoding(    (    sE   /tmp/pip-build-sZz8gW/pip/pip/_vendor/urllib3/packages/rfc3986/api.pyt   uri_reference   s    c         C   s   t  j |  |  S(   sc  Parse a IRI string into an IRIReference.

    This is a convenience function. You could achieve the same end by using
    ``IRIReference.from_string(iri)``.

    :param str iri: The IRI which needs to be parsed into a reference.
    :param str encoding: The encoding of the string provided
    :returns: A parsed IRI
    :rtype: :class:`IRIReference`
    (   R    R   (   t   iriR   (    (    sE   /tmp/pip-build-sZz8gW/pip/pip/_vendor/urllib3/packages/rfc3986/api.pyt   iri_reference)   s    c         K   s   t  j |  |  j |   S(   sã  Determine if the URI given is valid.

    This is a convenience function. You could use either
    ``uri_reference(uri).is_valid()`` or
    ``URIReference.from_string(uri).is_valid()`` to achieve the same result.

    :param str uri: The URI to be validated.
    :param str encoding: The encoding of the string provided
    :param bool require_scheme: Set to ``True`` if you wish to require the
        presence of the scheme component.
    :param bool require_authority: Set to ``True`` if you wish to require the
        presence of the authority component.
    :param bool require_path: Set to ``True`` if you wish to require the
        presence of the path component.
    :param bool require_query: Set to ``True`` if you wish to require the
        presence of the query component.
    :param bool require_fragment: Set to ``True`` if you wish to require the
        presence of the fragment component.
    :returns: ``True`` if the URI is valid, ``False`` otherwise.
    :rtype: bool
    (   R   R   t   is_valid(   R   R   t   kwargs(    (    sE   /tmp/pip-build-sZz8gW/pip/pip/_vendor/urllib3/packages/rfc3986/api.pyt   is_valid_uri7   s    c         C   s"   t  j |  |  j   } | j   S(   sn  Normalize the given URI.

    This is a convenience function. You could use either
    ``uri_reference(uri).normalize().unsplit()`` or
    ``URIReference.from_string(uri).normalize().unsplit()`` instead.

    :param str uri: The URI to be normalized.
    :param str encoding: The encoding of the string provided
    :returns: The normalized URI.
    :rtype: str
    (   R   R   t	   normalizet   unsplit(   R   R   t   normalized_reference(    (    sE   /tmp/pip-build-sZz8gW/pip/pip/_vendor/urllib3/packages/rfc3986/api.pyt   normalize_uriP   s    c         C   s   t  j |  | d t S(   s:  Parse a given URI and return a ParseResult.

    This is a partial replacement of the standard library's urlparse function.

    :param str uri: The URI to be parsed.
    :param str encoding: The encoding of the string provided.
    :returns: A parsed URI
    :rtype: :class:`~rfc3986.parseresult.ParseResult`
    t   strict(   R   R   t   False(   R   R   (    (    sE   /tmp/pip-build-sZz8gW/pip/pip/_vendor/urllib3/packages/rfc3986/api.pyt   urlparse`   s    
N(   t   __doc__R   R    t   parseresultR   R   R   R   R   R   R   R   (    (    (    sE   /tmp/pip-build-sZz8gW/pip/pip/_vendor/urllib3/packages/rfc3986/api.pyt   <module>   s   