U ʼb3@sPdZddlZddlmZddlmZddlmZddlmZGdd d eZ dS) z;Module containing the implementation of the URIMixin class.N) exceptions)misc) normalizers) validatorsc@seZdZdZejZddZddZeddZ edd Z ed d Z d d Z ddZ d$ddZd%ddZd&ddZd'ddZd(ddZddZd)ddZdd Zejejejejejfd!d"Zd#S)*URIMixinz0Mixin with all shared methods for URIs and IRIs.cCsz|jsddddS|}|dkr6t|j|j|}|d}|rvtj |rvt |svt|j|j|S)aReturn a dictionary with the ``userinfo``, ``host``, and ``port``. If the authority is not valid, it will raise a :class:`~rfc3986.exceptions.InvalidAuthority` Exception. :returns: ``{'userinfo': 'username:password', 'host': 'www.example.com', 'port': '80'}`` :rtype: dict :raises rfc3986.exceptions.InvalidAuthority: If the authority is not ``None`` and can not be parsed. N)userinfohostportr ) authority_match_subauthorityexcInvalidAuthorityencodeencoding groupdictgetrZ IPv4_MATCHERmatchrZvalid_ipv4_host_address)selfrmatchesr r2/tmp/pip-unpacked-wheel-9bk_1qnx/rfc3986/_mixin.pyauthority_infos    zURIMixin.authority_infocCstj|jSN)rZSUBAUTHORITY_MATCHERrr rrrrr 8szURIMixin._match_subauthoritycCs.z |}Wntjk r$YdSX|dS)z+If present, a string representing the host.Nr rr rrr rrrr ;s  z URIMixin.hostcCs.z |}Wntjk r$YdSX|dS)z2If present, the port extracted from the authority.Nr rrrrrr Ds  z URIMixin.portcCs.z |}Wntjk r$YdSX|dS)z6If present, the userinfo extracted from the authority.NrrrrrrrMs  zURIMixin.userinfocCsttj|S)zDetermine if this URI Reference is an absolute URI. See http://tools.ietf.org/html/rfc3986#section-4.3 for explanation. :returns: ``True`` if it is an absolute URI, ``False`` otherwise. :rtype: bool )boolrZABSOLUTE_URI_MATCHERrunsplitrrrr is_absoluteVszURIMixin.is_absolutec Ksrtdt|j|ddf|j|ddf|j|ddf|j|ddf|j|ddfg}t dd |DS) abDetermine if the URI is valid. .. deprecated:: 1.1.0 Use the :class:`~rfc3986.validators.Validator` object instead. :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 XPlease use rfc3986.validators.Validator instead. This method will be eventually removed.Zrequire_schemeFZrequire_authorityZ require_pathZ require_queryZrequire_fragmentcss|]\}}||VqdSrr).0vrrrr sz$URIMixin.is_valid..) warningswarnDeprecationWarningscheme_is_validrauthority_is_valid path_is_validquery_is_validfragment_is_validall)rkwargsrrrris_valid`szURIMixin.is_validFcCsFtdtz |Wntjk r0YdSXtj|j|j |dS)aDetermine if the authority component is valid. .. deprecated:: 1.1.0 Use the :class:`~rfc3986.validators.Validator` object instead. :param bool require: Set to ``True`` to require the presence of this component. :returns: ``True`` if the authority is valid. ``False`` otherwise. :rtype: bool r F)r require) r%r&r'rr rrr)r r rr0rrrr)s zURIMixin.authority_is_validcCstdtt|j|S)a`Determine if the scheme component is valid. .. deprecated:: 1.1.0 Use the :class:`~rfc3986.validators.Validator` object instead. :param str require: Set to ``True`` to require the presence of this component. :returns: ``True`` if the scheme is valid. ``False`` otherwise. :rtype: bool r )r%r&r'rr(schemer1rrrr(s zURIMixin.scheme_is_validcCstdtt|j|S)a\Determine if the path component is valid. .. deprecated:: 1.1.0 Use the :class:`~rfc3986.validators.Validator` object instead. :param str require: Set to ``True`` to require the presence of this component. :returns: ``True`` if the path is valid. ``False`` otherwise. :rtype: bool r )r%r&r'rr*pathr1rrrr*s zURIMixin.path_is_validcCstdtt|j|S)a^Determine if the query component is valid. .. deprecated:: 1.1.0 Use the :class:`~rfc3986.validators.Validator` object instead. :param str require: Set to ``True`` to require the presence of this component. :returns: ``True`` if the query is valid. ``False`` otherwise. :rtype: bool r )r%r&r'rr+queryr1rrrr+s zURIMixin.query_is_validcCstdtt|j|S)aGDetermine if the fragment component is valid. .. deprecated:: 1.1.0 Use the Validator object instead. :param str require: Set to ``True`` to require the presence of this component. :returns: ``True`` if the fragment is valid. ``False`` otherwise. :rtype: bool r )r%r&r'rr,fragmentr1rrrr,s zURIMixin.fragment_is_validcCst|t|kS)aCompare this URIReference to another URIReference. :param URIReference other_ref: (required), The reference with which we're comparing. :returns: ``True`` if the references are equal, ``False`` otherwise. :rtype: bool )tuple normalize)rZ other_refrrrnormalized_equalityszURIMixin.normalized_equalitycCst|tst||}|s*t||}|}|sR|j|jkrR|j dd}|jdk rr|j t |j d}n|j dk r|j |jt |j d}n|j dkr|jdk r|j}n|j}|j |j|j |j |d}nF|j drt |j }nt t||j }|j |j|j ||jd}|S)aUse an absolute URI Reference to resolve this relative reference. Assuming this is a relative reference that you would like to resolve, use the provided base URI to resolve it. See http://tools.ietf.org/html/rfc3986#section-5 for more information. :param base_uri: Either a string or URIReference. It must be an absolute URI or it will raise an exception. :returns: A new URIReference which is the result of resolving this reference using ``base_uri``. :rtype: :class:`URIReference` :raises rfc3986.exceptions.ResolutionError: If the ``base_uri`` is not an absolute URI. N)r2)r3)r2r3)r2r r3r4/) isinstancertypeZ from_stringrr ResolutionErrorr7r2 copy_withrnormalize_pathr3r r4 startswithrZ merge_paths)rZbase_uristrictZ resolvingtargetr4r3rrr resolve_withsN           zURIMixin.resolve_withcCsg}|jr||jdg|jr0|d|jg|jrB||j|jdk r\|d|jg|jdk rv|d|jgd|S)zCreate a URI string from the components. :returns: The URI Reference reconstituted as a string. :rtype: str :z//N?#)r2extendr r3appendr4r5join)rZ result_listrrrr<s   zURIMixin.unsplitc CsN|||||d}t|D]\}}|tjkr||=q|jf|} |j| _| S)aCreate a copy of this reference with the new components. :param str scheme: (optional) The scheme to use for the new reference. :param str authority: (optional) The authority to use for the new reference. :param str path: (optional) The path to use for the new reference. :param str query: (optional) The query to use for the new reference. :param str fragment: (optional) The fragment to use for the new reference. :returns: New URIReference with provided components. :rtype: URIReference )r2r r3r4r5)listitemsr UseExisting_replacer) rr2r r3r4r5 attributeskeyvalueurirrrr=Ps  zURIMixin.copy_withN)F)F)F)F)F)F)__name__ __module__ __qualname____doc__r6__hash__rr propertyr r rrr/r)r(r*r+r,r8rBrrrLr=rrrrr s4)    "      Fr) rUr%rFrr rrrobjectrrrrrs