al5dZddlmZddlmZddlmZGddZdZdZd Zd Z dd Z dd Z ddZ ddZ ddZddZdZe e eedZhdZdZdZy )z3Module containing the validation logic for rfc3986.) exceptions)misc) normalizerscZeZdZdZegdZdZdZdZdZ dZ dZ d Z d Z d Zy ) 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']) schemeuserinfohostportpathqueryfragmentct|_t|_t|_d|_dddddddd|_|j j |_y)z#Initialize our default validations.TFrN)setallowed_schemes allowed_hosts allowed_portsallow_passwordrequired_componentscopyvalidated_componentsselfs 4/usr/lib/python3/dist-packages/rfc3986/validators.py__init__zValidator.__init__3s`"u U U"$  %)$<$<$A$A$C!cp|D]0}|jjtj|2|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)rschemesr s r allow_schemeszValidator.allow_schemesDs9 KF  $ $[%A%A&%I J K rcp|D]0}|jjtj|2|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)rhostsr s r allow_hostszValidator.allow_hostsTs9 ED    " ";#=#=d#C D E rc|D]9}t|d}d|cxkrdksn|jj|;|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_ints r allow_portszValidator.allow_portsdsG -D4b)HH%%""&&t, - rcd|_|S)zAllow passwords to be present in the URI. .. versionadded:: 1.0 :returns: The validator instance. :rtype: Validator Trrs rallow_use_of_passwordzValidator.allow_use_of_passwordvs# rcd|_|S)zPrevent passwords from being included in the URI. .. versionadded:: 1.0 :returns: The validator instance. :rtype: Validator Fr2rs rforbid_use_of_passwordz Validator.forbid_use_of_passwords$ rc|Dcgc]}|j}}|D]}||jvstd|d|jj |Dcic]}|dc}|Scc}wcc}w)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 "" is not a valid componentT)lowerCOMPONENT_NAMES ValueErrorrupdater componentsc components rcheck_validity_ofzValidator.check_validity_ofs*44Aaggi4 4# LI 4 44 1YK/I!JKK L !!((.8 9Y_ 9  5 : A. A3c|Dcgc]}|j}}|D]}||jvstd|d|jj |Dcic]}|dc}|Scc}wcc}w)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 r7r8T)r9r:r;rr<r=s rrequire_presence_ofzValidator.require_presence_ofs*44Aaggi4 4# LI 4 44 1YK/I!JKK L   ''.8 9Y_ 9  5 :rBc|js t||jjDcgc] \}}|r| }}}|jjDcgc] \}}|r| }}}|r t |||r t ||t|j|dt|j|dt|j|dycc}}wcc}}w)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. r r r N) rcheck_passwordritemsr ensure_required_components_existensure_components_are_valid ensure_one_ofrrr)rurir@requiredrrs rvalidatezValidator.validates&"" 3 (,'?'?'E'E'G # 8   (,'@'@'F'F'H # 8    ,S2E F  '-A Bd**C:d((#v6d((#v6#  s C#CN)__name__ __module__ __qualname____doc__ frozensetr:rr"r&r0r3r5rArDrMrrrrsD4 KOD"  $  ..'7rrc|j}|sy|jdd}t|dkrytj|)z4Assert that there is no password present in the uri.N:r)r splitlenrPasswordForbidden)rKr credentialss rrFrFsB||H ..a(K ;1  & &s ++rc^t||}||r||vrtj|||yyy)z=Assert that the uri's attribute is one of the allowed values.N)getattrrUnpermittedComponentError)allowed_valuesrK attributevalues rrJrJsD C #E ^^0K22     1L^rc^tfd|D}|rtjg|y)z;Assert that all required components are present in the URI.c3:K|]}t||yw)N)r[).0r@rKs r z3ensure_required_components_exist..s&   3 " *  sN)sortedrMissingComponentError)rKrmissing_componentss` rrHrHs< ,  ..sH5GHHrcb|r|duxr|j|S|duxs|j|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_matcherrequires ris_validrk s:D 9W]]5%99 D= 0GMM%00rNc\t|tj|}|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 )rkrSUBAUTHORITY_MATCHER host_is_valid) authorityr rj validateds rauthority_is_validrqs3D$=$=wGIT%T7++ rc t|tj|}|r,|*tjj |r t |S|rB|@tj j |r!tjj |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)rkr HOST_MATCHER IPv4_MATCHERrhvalid_ipv4_host_address IPv6_MATCHERIPv6_NO_RFC4007_MATCHER)r rjrps rrnrn.s{t00':IT%$*;*;*A*A$*G&t,, t'D,=,=,C,CD,I++11$7tCC rc8t|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 )rkrSCHEME_MATCHER)r rjs rscheme_is_validrzBs FD// 99rc8t|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 )rkr PATH_MATCHER)r rjs r path_is_validr}Qs D$++W 55rc8t|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 )rkr QUERY_MATCHER)rrjs rquery_is_validr`s E4--w 77rc8t|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 )rkrFRAGMENT_MATCHER)rrjs rfragment_is_validros Hd33W ==rc t|jdDcgc]}dt|dcxkxrdkncc}Scc}w)z4Determine if the given host is a valid IPv4 address..r+r(r))allrVr-)r bytes rruru~s6 4::c?K4SB'.3.K LLKs"A)r r rr>r r r c |j}|dk(rt|dS|dk7ry t |d}d|cxkxrdkScS#tj$rYywxYw#t $rYywxYw)z4Determine if the userinfo, host, and port are valid.Fr r Tr+r,)authority_inforInvalidAuthorityrnr- TypeError)rKr@subauthority_dictr s rsubauthority_component_is_validrs..0 F.v677 f $V,-    #  & & s"A A# A A # A/.A/ct}|D]U}|tvrt||s|j|)t|}|t ||rE|j|W|rt j|g|y)z0Assert that all components are valid in the URI.N)r_SUBAUTHORITY_VALIDATORSrr_COMPONENT_VALIDATORSr[rInvalidComponentsError)rKrinvalid_componentsr@ validators rrIrIs) . 0 023 B"&&y1 ))4 i01  " "9 - .//I6HIIr)NF)F)rQrrrrrFrJrHrkrqrnrzr}rrrurrrrIrSrrrs:Q7Q7h, I1"(( : 6 8 >M  ! 80Jr