o h6@sdZddlmZddlmZddlmZGdddeZddZd d Zd d Z d dZ d%ddZ d&ddZ d&ddZ d&ddZd&ddZd&ddZddZe eeedZegd Zd!d"Zd#d$ZdS)'z3Module containing the validation logic for rfc3986.) exceptions)misc) normalizersc@sdeZdZdZegdZddZddZddZd d Z d d Z d dZ ddZ ddZ ddZdS) ValidatoraObject used to configure validation of all objects in rfc3986. .. versionadded:: 1.0 Example usage:: >>> from rfc3986 import api, validators >>> uri = api.uri_reference('https://github.com/') >>> validator = validators.Validator().require_presence_of( ... 'scheme', 'host', 'path', ... ).allow_schemes( ... 'http', 'https', ... ).allow_hosts( ... '127.0.0.1', 'github.com', ... ) >>> validator.validate(uri) >>> invalid_uri = rfc3986.uri_reference('imap://mail.google.com') >>> validator.validate(invalid_uri) Traceback (most recent call last): ... rfc3986.exceptions.MissingComponentError: ('path was required but missing', URIReference(scheme=u'imap', authority=u'mail.google.com', path=None, query=None, fragment=None), ['path']) schemeuserinfohostportpathqueryfragmentcCsDt|_t|_t|_d|_dddddddd|_|j|_dS)z#Initialize our default validations.TFrN)setallowed_schemes allowed_hosts allowed_portsallow_passwordrequired_componentscopyvalidated_componentsselfrZ/var/www/html/magazine_api/magazine_env/lib/python3.10/site-packages/rfc3986/validators.py__init__4s zValidator.__init__cG |D] }|jt|q|S)a Require the scheme to be one of the provided schemes. .. versionadded:: 1.0 :param schemes: Schemes, without ``://`` that are allowed. :returns: The validator instance. :rtype: Validator )raddrZnormalize_scheme)rschemesrrrr allow_schemesE zValidator.allow_schemescGr)zRequire the host to be one of the provided hosts. .. versionadded:: 1.0 :param hosts: Hosts that are allowed. :returns: The validator instance. :rtype: Validator )rrrnormalize_host)rhostsr rrr allow_hostsUrzValidator.allow_hostscGs>|D]}t|dd}d|krdkrnq|j|q|S)zRequire the port to be one of the provided ports. .. versionadded:: 1.0 :param ports: Ports that are allowed. :returns: The validator instance. :rtype: Validator base)intrr)rZportsr Zport_intrrr allow_portses   zValidator.allow_portscC d|_|S)zAllow passwords to be present in the URI. .. versionadded:: 1.0 :returns: The validator instance. :rtype: Validator Trrrrrallow_use_of_passwordw zValidator.allow_use_of_passwordcCr*)zPrevent passwords from being included in the URI. .. versionadded:: 1.0 :returns: The validator instance. :rtype: Validator Fr+rrrrforbid_use_of_passwordr-z Validator.forbid_use_of_passwordcGJdd|D}|D]}||jvrtd|q |jdd|D|S)aACheck the validity of the components provided. This can be specified repeatedly. .. versionadded:: 1.1 :param components: Names of components from :attr:`Validator.COMPONENT_NAMES`. :returns: The validator instance. :rtype: Validator cSg|]}|qSrlower.0crrr z/Validator.check_validity_of.."{}" is not a valid componentcSi|]}|dqSTrr4 componentrrr z/Validator.check_validity_of..)COMPONENT_NAMES ValueErrorformatrupdater componentsr<rrrcheck_validity_of  zValidator.check_validity_ofcGr/)a3Require the components provided. This can be specified repeatedly. .. versionadded:: 1.0 :param components: Names of components from :attr:`Validator.COMPONENT_NAMES`. :returns: The validator instance. :rtype: Validator cSr0rr1r3rrrr6r7z1Validator.require_presence_of..r8cSr9r:rr;rrrr=r>z1Validator.require_presence_of..)r?r@rArrBrCrrrrequire_presence_ofrFzValidator.require_presence_ofcCs|jst|dd|jD}dd|jD}|r"t|||r)t||t|j|dt|j |dt|j |ddS)aCheck a URI for conditions specified on this validator. .. versionadded:: 1.0 :param uri: Parsed URI to validate. :type uri: rfc3986.uri.URIReference :raises MissingComponentError: When a required component is missing. :raises UnpermittedComponentError: When a component is not one of those allowed. :raises PasswordForbidden: When a password is present in the userinfo component but is not permitted by configuration. :raises InvalidComponentsError: When a component was found to be invalid. cSg|]\}}|r|qSrrr4r<requiredrrrr6 z&Validator.validate..cSrHrrrIrrrr6rKrr r N) rcheck_passwordritemsr ensure_required_components_existensure_components_are_valid ensure_one_ofrrr)rurirrrrrvalidates  zValidator.validateN)__name__ __module__ __qualname____doc__ frozensetr?rrr"r)r,r.rErGrRrrrrrs   rcCs4|j}|sdS|dd}t|dkrdSt|)z4Assert that there is no password present in the uri.N:r)rsplitlenrZPasswordForbidden)rQr credentialsrrrrLs   rLcCs8t||}|dur|r||vrt|||dSdSdS)z=Assert that the uri's attribute is one of the allowed values.N)getattrrZUnpermittedComponentError)Zallowed_valuesrQ attributevaluerrrrPs  rPcs0tfdd|D}|rtjg|RdS)z;Assert that all required components are present in the URI.csg|] }t|dur|qS)N)r\r;rQrrr6s z4ensure_required_components_exist..N)sortedrZMissingComponentError)rQrZmissing_componentsrr_rrNs rNcCs(|r |duo ||S|dup||S)a Determine if a value is valid based on the provided matcher. :param str value: Value to validate. :param matcher: Compiled regular expression to use to validate the value. :param require: Whether or not the value is required. N)match)r^Zmatcherrequirerrris_valids rcNFcCs(t|tj|}|r|durt||S|S)anDetermine if the authority string is valid. :param str authority: The authority to validate. :param str host: (optional) The host portion of the authority to validate. :param bool require: (optional) Specify if authority must not be None. :returns: ``True`` if valid, ``False`` otherwise :rtype: bool N)rcrZSUBAUTHORITY_MATCHER host_is_valid) authorityr rb validatedrrrauthority_is_valid!s  rgcCsZt|tj|}|r|durtj|rt|S|r+|dur+tj|r+tj|duS|S)aDetermine if the host string is valid. :param str host: The host to validate. :param bool require: (optional) Specify if host must not be None. :returns: ``True`` if valid, ``False`` otherwise :rtype: bool N)rcrZ HOST_MATCHERZ IPv4_MATCHERravalid_ipv4_host_addressZ IPv6_MATCHERZIPv6_NO_RFC4007_MATCHER)r rbrfrrrrd5s  rdcCt|tj|S)a+Determine if the scheme is valid. :param str scheme: The scheme string to validate. :param bool require: (optional) Set to ``True`` to require the presence of a scheme. :returns: ``True`` if the scheme is valid. ``False`` otherwise. :rtype: bool )rcrZSCHEME_MATCHER)rrbrrrscheme_is_validI rjcCri)a+Determine if the path component is valid. :param str path: The path string to validate. :param bool require: (optional) Set to ``True`` to require the presence of a path. :returns: ``True`` if the path is valid. ``False`` otherwise. :rtype: bool )rcrZ PATH_MATCHER)r rbrrr path_is_validXrkrlcCri)a0Determine if the query component is valid. :param str query: The query string to validate. :param bool require: (optional) Set to ``True`` to require the presence of a query. :returns: ``True`` if the query is valid. ``False`` otherwise. :rtype: bool )rcrZ QUERY_MATCHER)r rbrrrquery_is_validgrkrmcCri)a?Determine if the fragment component is valid. :param str fragment: The fragment string to validate. :param bool require: (optional) Set to ``True`` to require the presence of a fragment. :returns: ``True`` if the fragment is valid. ``False`` otherwise. :rtype: bool )rcrZFRAGMENT_MATCHER)r rbrrrfragment_is_validvrkrncCstdd|dDS)z4Determine if the given host is a valid IPv4 address.cSs,g|]}dt|ddkodknqS)r&r#r$)r()r4byterrrr6s,z+valid_ipv4_host_address...)allrY)r rrrrhsrh)rr r r )rr r cCsz|}Wn tjyYdSw|dkrt|dS|dkr"dSzt|d}Wn ty4YdSwd|ko>dkSS)z4Determine if the userinfo, host, and port are valid.Fr r Tr&r')Zauthority_inforZInvalidAuthorityrdr( TypeError)rQr<Zsubauthority_dictr rrrsubauthority_component_is_valids   rtcCsjtg}|D]!}|tvrt||s||qt|}|t||s'||q|r3tj|g|RdS)z0Assert that all components are valid in the URI.N)r_SUBAUTHORITY_VALIDATORSrtr_COMPONENT_VALIDATORSr\rZInvalidComponentsError)rQrZinvalid_componentsr< validatorrrrrOs   rO)NF)F)rVrrrobjectrrLrPrNrcrgrdrjrlrmrnrhrvrrurtrOrrrrs2   Y