U
    ʼb/                     @   s^   d Z ddlmZ ddlmZ ddlmZ dddZddd	Zdd
dZ	dddZ
dddZdS )z
Module containing the simple and functional API for rfc3986.

This module defines functions and provides access to the public attributes
and classes of rfc3986.
   )IRIReference)ParseResult)URIReferenceutf-8c                 C   s   t | |S )ab  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   from_stringuriencoding r
   //tmp/pip-unpacked-wheel-9bk_1qnx/rfc3986/api.pyuri_reference   s    r   c                 C   s   t | |S )ac  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   )irir	   r
   r
   r   iri_reference)   s    r   c                 K   s   t | |jf |S )a  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   Zis_valid)r   r	   kwargsr
   r
   r   is_valid_uri7   s    r   c                 C   s   t | | }| S )an  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   	normalizeZunsplit)r   r	   Znormalized_referencer
   r
   r   normalize_uriP   s    r   c                 C   s   t j| |ddS )a:  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`
    F)strict)r   r   r   r
   r
   r   urlparse`   s    
r   N)r   )r   )r   )r   )r   )__doc__r   r   Zparseresultr   r   r   r   r   r   r   r   r
   r
   r
   r   <module>   s   



