U ʼb6@sdZddlmZddlmZddlmZGdddeZddZd d Zd d Z d dZ d'ddZ d(ddZ d)ddZ d*ddZd+ddZd,ddZddZe eeedZed d!d"gZd#d$Zd%d&ZdS)-z3Module containing the validation logic for rfc3986.) exceptions)misc) normalizersc@sneZdZdZedddddddgZd d Zd d Zd dZddZ ddZ ddZ 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.TF)rrrr r r r N)setallowed_schemes allowed_hosts allowed_portsallow_passwordrequired_componentscopyvalidated_componentsselfr6/tmp/pip-unpacked-wheel-9bk_1qnx/rfc3986/validators.py__init__4s zValidator.__init__cGs |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_schemesEs zValidator.allow_schemescGs |D]}|jt|q|S)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)rhostsrrrr allow_hostsUs zValidator.allow_hostscGs>|D]4}t|dd}d|kr(dkrnq|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_portscCs d|_|S)zAllow passwords to be present in the URI. .. versionadded:: 1.0 :returns: The validator instance. :rtype: Validator Trrrrrallow_use_of_passwordws zValidator.allow_use_of_passwordcCs d|_|S)zPrevent passwords from being included in the URI. .. versionadded:: 1.0 :returns: The validator instance. :rtype: Validator Fr'rrrrforbid_use_of_passwords z Validator.forbid_use_of_passwordcGsJdd|D}|D]}||jkrtd|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 cSsg|] }|qSrlower.0crrr sz/Validator.check_validity_of.."{}" is not a valid componentcSsi|] }|dqSTrr- componentrrr sz/Validator.check_validity_of..)COMPONENT_NAMES ValueErrorformatrupdater componentsr3rrrcheck_validity_ofs  zValidator.check_validity_ofcGsJdd|D}|D]}||jkrtd|q|jdd|D|S)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 cSsg|] }|qSrr*r,rrrr/sz1Validator.require_presence_of..r0cSsi|] }|dqSr1rr2rrrr4sz1Validator.require_presence_of..)r5r6r7rr8r9rrrrequire_presence_ofs  zValidator.require_presence_ofcCs|jst|dd|jD}dd|jD}|rDt|||rRt||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. cSsg|]\}}|r|qSrrr-r3requiredrrrr/sz&Validator.validate..cSsg|]\}}|r|qSrrr=rrrr/srrr N) rcheck_passwordritemsr ensure_required_components_existensure_components_are_valid ensure_one_ofrrr)rurirrrrrvalidates  zValidator.validateN)__name__ __module__ __qualname____doc__ frozensetr5rrrr&r(r)r;r<rErrrrrs  rcCs8|j}|sdS|dd}t|dkr*dSt|dS)z4Assert that there is no password present in the uri.N:r)rsplitlenrZPasswordForbidden)rDr credentialsrrrr?s  r?cCs0t||}|dk r,|r,||kr,t|||dS)z=Assert that the uri's attribute is one of the allowed values.N)getattrrZUnpermittedComponentError)Zallowed_valuesrD attributevaluerrrrCs rCcs.tfdd|D}|r*tjf|dS)z;Assert that all required components are present in the URI.csg|]}t|dkr|qS)N)rOr2rDrrr/sz4ensure_required_components_exist..N)sortedrZMissingComponentError)rDrZmissing_componentsrrRrrAs rAcCs(|r|dk o||S|dkp&||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)rQmatcherrequirerrris_valids rWNFcCs(t|tj|}|r$|dk r$t||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)rWrZSUBAUTHORITY_MATCHER host_is_valid) authorityrrV validatedrrrauthority_is_valid!s  r[cCsZt|tj|}|r.|dk r.tj|r.t|S|rV|dk rVtj|rVtj|dk S|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)rWrZ HOST_MATCHERZ IPv4_MATCHERrTvalid_ipv4_host_addressZ IPv6_MATCHERZIPv6_NO_RFC4007_MATCHER)rrVrZrrrrX5s rXcCst|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 )rWrZSCHEME_MATCHER)rrVrrrscheme_is_validIs r]cCst|tj|S)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 )rWrZ PATH_MATCHER)r rVrrr path_is_validXs r^cCst|tj|S)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 )rWrZ QUERY_MATCHER)r rVrrrquery_is_validgs r_cCst|tj|S)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 )rWrZFRAGMENT_MATCHER)r rVrrrfragment_is_validvs r`cCstdd|dDS)z4Determine if the given host is a valid IPv4 address.cSs,g|]$}dt|ddko"dknqS)r#r r!)r%)r-byterrrr/sz+valid_ipv4_host_address...)allrL)rrrrr\sr\)rr r r rrr cCsz |}Wntjk r$YdSX|dkr:t|dS|dkrFdSzt|d}Wntk rlYdSXd|kodkSS)z4Determine if the userinfo, host, and port are valid.Frr Tr#r$)Zauthority_inforZInvalidAuthorityrXr% TypeError)rDr3Zsubauthority_dictr rrrsubauthority_component_is_valids  rfcCshtg}|D]B}|tkr.t||s ||q t|}|t||s ||q |rdtj|f|dS)z0Assert that all components are valid in the URI.N)r _SUBAUTHORITY_VALIDATORSrfr_COMPONENT_VALIDATORSrOrZInvalidComponentsError)rDrZinvalid_componentsr3Z validatorrrrrBs   rB)NF)F)F)F)F)F)rIrrrobjectrr?rCrArWr[rXr]r^r_r`r\rhr rgrfrBrrrrs0   Y