o Dh6@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_componentsselfrM/var/www/html/env_mimamsha/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 )raddrnormalize_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_hostsUr zValidator.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)rportsr port_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_passwordr0z 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|]}|dqSTrr7 componentrrr z/Validator.check_validity_of..)COMPONENT_NAMES ValueErrorformatrupdater componentsr?rrrcheck_validity_of  zValidator.check_validity_ofcGr2)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 cSr3rr4r6rrrr9r:z1Validator.require_presence_of..r;cSr<r=rr>rrrr@rAz1Validator.require_presence_of..)rBrCrDrrErFrrrrequire_presence_ofrIzValidator.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|qSrrr7r?requiredrrrr9 z&Validator.validate..cSrKrrrLrrrr9rNrr r N) rcheck_passwordritemsr ensure_required_components_existensure_components_are_valid ensure_one_ofrrr)rurirrrrrvalidates  zValidator.validateN)__name__ __module__ __qualname____doc__ frozensetrBrrr#r,r/r1rHrJrUrrrrrs   rcCs4|j}|sdS|dd}t|dkrdSt|)z4Assert that there is no password present in the uri.N:r)rsplitlenrPasswordForbidden)rTr credentialsrrrrOs   rOcCs8t||}|dur|r||vrt|||dSdSdS)z=Assert that the uri's attribute is one of the allowed values.N)getattrrUnpermittedComponentError)allowed_valuesrT attributevaluerrrrSs  rScs0tfdd|D}|rtjg|RdS)z;Assert that all required components are present in the URI.csg|] }t|dur|qS)N)r`r>rTrrr9s z4ensure_required_components_exist..N)sortedrMissingComponentError)rTrmissing_componentsrrerrQs rQcCs(|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)rdmatcherrequirerrris_valids rlNFcCs(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)rlrSUBAUTHORITY_MATCHER host_is_valid) authorityr rk validatedrrrauthority_is_valid!s  rqcCsZt|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)rlr HOST_MATCHER IPv4_MATCHERrivalid_ipv4_host_address IPv6_MATCHERIPv6_NO_RFC4007_MATCHER)r rkrprrrrn5s  rncCt|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 )rlrSCHEME_MATCHER)rrkrrrscheme_is_validI rycCrw)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 )rlr PATH_MATCHER)r rkrrr path_is_validXrzr|cCrw)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 )rlr QUERY_MATCHER)r rkrrrquery_is_validgrzr~cCrw)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 )rlrFRAGMENT_MATCHER)r rkrrrfragment_is_validvrzrcCstdd|dDS)z4Determine if the given host is a valid IPv4 address.cSs,g|]}dt|ddkodknqS)r'r$r%)r))r7byterrrr9s,z+valid_ipv4_host_address...)allr\)r rrrrtsrt)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()authority_inforInvalidAuthorityrnr) TypeError)rTr?subauthority_dictr rrrsubauthority_component_is_valids   rcCsjtg}|D]!}|tvrt||s||qt|}|t||s'||q|r3tj|g|RdS)z0Assert that all components are valid in the URI.N)r_SUBAUTHORITY_VALIDATORSrr_COMPONENT_VALIDATORSr`rInvalidComponentsError)rTrinvalid_componentsr? validatorrrrrRs   rR)NF)F)rYrrrobjectrrOrSrQrlrqrnryr|r~rrtrrrrrRrrrrs2   Y