o h3@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|js ddddS|}|durt|j|j|}|d}|r;tj |r;t |s;t|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 rV/var/www/html/magazine_api/magazine_env/lib/python3.10/site-packages/rfc3986/_mixin.pyauthority_infos   zURIMixin.authority_infocCstj|jSN)rZSUBAUTHORITY_MATCHERrr rrrrr 8szURIMixin._match_subauthoritycC*z |}W|dStjyYdSw)z+If present, a string representing the host.Nr rr rrr rrrr ;  z URIMixin.hostcCr)z2If present, the port extracted from the authority.Nr rrrrrr Drz URIMixin.portcCr)z6If present, the userinfo extracted from the authority.NrrrrrrrMrzURIMixin.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_validFcCsDtdtz|Wn tjyYdSwtj|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 rr2rrrr+s zURIMixin.authority_is_validcCtdtt|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*schemer3rrrr*  zURIMixin.scheme_is_validcCr4)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,pathr3rrrr,r6zURIMixin.path_is_validcCr4)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-queryr3rrrr-r6zURIMixin.query_is_validcCr4)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.fragmentr3rrrr.r6zURIMixin.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_equalitycCs"t|ts t||}|st||}|}|s)|j|jkr)|j dd}|jdur:|j t |j d}|S|j durM|j |jt |j d}|S|j durl|jdur[|j}n|j}|j |j|j |j |d}|S|j dryt |j }n t 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)r5)r7)r5r7)r5r r7r8/) isinstancertypeZ from_stringr!r ResolutionErrorr;r5 copy_withrnormalize_pathr7r r8 startswithrZ merge_paths)rZbase_uristrictZ resolvingtargetr8r7rrr resolve_withsT     "     zURIMixin.resolve_withcCsg}|jr ||jdg|jr|d|jg|jr!||j|jdur.|d|jg|jdur;|d|jgd|S)zCreate a URI string from the components. :returns: The URI Reference reconstituted as a string. :rtype: str :z//N?#)r5extendr r7appendr8r9join)rZ result_listrrrr <s    zURIMixin.unsplitc CsR|||||d}t|D] \}}|tjur||=q|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 )r5r r7r8r9Nr)listitemsr UseExisting_replacer) rr5r r7r8r9 attributeskeyvalueurirrrrAPs zURIMixin.copy_withN)F)__name__ __module__ __qualname____doc__r:__hash__rr propertyr r rr!r1r+r*r,r-r.r<rFr rrPrArrrrr s6)    "     Fr) rYr'rJrr rrrobjectrrrrrs