a3TdZddlZddlmZddlmZddlmZddlmZGdd Zy) z;Module containing the implementation of the URIMixin class.N) exceptions)misc) normalizers) validatorsc"eZdZdZej ZdZdZedZ edZ edZ dZ dZ dd Zdd Zdd Zdd Zdd ZdZddZdZej.ej.ej.ej.ej.fdZy)URIMixinz0Mixin with all shared methods for URIs and IRIs.c|jsddddS|j}|8tj|jj |j |j }|jd}|rltjj|rMtj|s8tj|jj |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 groupdictgetr IPv4_MATCHERmatchrvalid_ipv4_host_address)selfrmatchesr s 0/usr/lib/python3/dist-packages/rfc3986/_mixin.pyauthority_infozURIMixin.authority_infos~~ $dDA A((* = &&t~~'<'>rc` |j}|dS#tj$rYywxYw)z+If present, a string representing the host.Nr rrrrrs rr z URIMixin.host;< ++-I  ##   --c` |j}|dS#tj$rYywxYw)z2If present, the port extracted from the authority.Nr r#r$s rr z URIMixin.portDr%r&c` |j}|dS#tj$rYywxYw)z6If present, the userinfo extracted from the authority.Nr r#r$s rr zURIMixin.userinfoMs< ++-I$$##  r&cnttjj|j 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 )boolrABSOLUTE_URI_MATCHERrunsplitr!s r is_absolutezURIMixin.is_absoluteVs&D--33DLLNCDDrc tjdt|j|j ddf|j |j ddf|j |j ddf|j|j ddf|j|j ddfg}td|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.require_schemeFrequire_authority require_path require_queryrequire_fragmentc32K|]\}}||ywr).0vrs r z$URIMixin.is_valid..s/DAq1Q4/s) warningswarnDeprecationWarningscheme_is_validrauthority_is_valid path_is_validquery_is_validfragment_is_validall)rkwargsrs ris_validzURIMixin.is_valid`s(   6   ! !6::.>#F G  $ $fjj1De&L M   NE!B C  &**_e"D E  # #VZZ0BE%J K  /J///rctjdt |jt j|j|j|S#tj $rYywxYw)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=rrrrr?rr rrGs rr?zURIMixin.authority_is_validsi   6       !,, NN  ##  sAA.-A.cvtjdttj|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>schemerHs rr>zURIMixin.scheme_is_valids1   6  ))$++w??rcvtjdttj|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@pathrHs rr@zURIMixin.path_is_valids1   6  '' 7;;rcvtjdttj|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=rrAqueryrHs rrAzURIMixin.query_is_valids1   6  ((W==rcvtjdttj|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=rrBfragmentrHs rrBzURIMixin.fragment_is_valids1   6  ++DMM7CCrcht|jt|jk(S)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)r other_refs rnormalized_equalityzURIMixin.normalized_equalitys)T^^%&% 0C0C0E*FFFrc>t|tst|j|}|j dst j ||j}|}|s+|j|jk(r|jd}|j1|jtj|j}|S|j<|j|jtj|j}|S|jZ|j |j}n |j}|j|j|j|j|}|S|jjdr tj|j}n3tjt!j"||j}|j|j|j||j}|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`` does not at least have a scheme. T)r0N)rJ)rL)rJrL)rJrrLrN/) isinstancer type from_stringrErResolutionErrorrSrJ copy_withrnormalize_pathrLrrN startswithr merge_paths)rbase_uristrict resolvingtargetrNrLs r resolve_withzURIMixin.resolve_withs (H-Dz--h7H   5%%h/ /%%' )**hoo=!++4+8I    '(( // ?)FD ="".",,#??$33INNC-: 1>>) 2 ) (&00'"*"4"4%]]# 1F& !~~005*99)..I*99 ,,Xy~~F '00'"*"4"4!'oo 1F  rcg}|jr|j|jdg|jr|jd|jg|jr|j |j|j |jd|j g|j |jd|j gdj|S)zCreate a URI string from the components. :returns: The URI Reference reconstituted as a string. :rtype: str :z//?#)rJextendrrLappendrNrPjoin)r result_lists rr,zURIMixin.unsplit<s ;;    S1 2 >>   dnn5 6 99   tyy ) :: !   TZZ0 1 == $   T]]3 4ww{##rc|||||d}t|jD]\}}|tjus||=|jdi|} |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 )rJrrLrNrPr6)listitemsr UseExisting_replacer) rrJrrLrNrP attributeskeyvalueuris rr\zURIMixin.copy_withPsw4"  z//12 $JC(((sO $dmm)j)}}  rN)F)__name__ __module__ __qualname____doc__rR__hash__rrpropertyr r r r-rEr?r>r@rArBrUrdr,rrqr\r6rrr r s:~~H'R?!!!!%%E 0D <@&<&>&D&GDL$,""   !! %rr ) rzr;rirrrrrr r6rrr}s#Akkr