01i6SrSSKJr SSKJr SSKJr "SS\5rSrSrS r S r SS jr SS jr SSjr SSjrSSjrSSjrSr\ \\\S.r\"/SQ5rSrSrg )z3Module containing the validation logic for rfc3986.) exceptions)misc) normalizerscb\rSrSrSr\"/SQ5rSrSrSr Sr Sr S r S r S rS rS rg) Validatora?Object 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']) schemeuserinfohostportpathqueryfragmentc[5Ul[5Ul[5UlSUlSSSSSSSS.UlUR R 5Ulg)z#Initialize our default validations.TFr N)setallowed_schemes allowed_hosts allowed_portsallow_passwordrequired_componentscopyvalidated_componentsselfs L/home/james-whalen/.local/lib/python3.13/site-packages/rfc3986/validators.py__init__Validator.__init__4s`"u U U"$  %)$<$<$A$A$C!cvUH2nURR[R"U55 M4 U$)zRequire 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_schemesValidator.allow_schemesEs2F  $ $[%A%A&%I J rcvUH2nURR[R"U55 M4 U$)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 )rr!rnormalize_host)rhostsr s r allow_hostsValidator.allow_hostsUs2D    " ";#=#=d#C D rcUH;n[USS9nSUs=::aS::dMO M URRU5 M= U$)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_portsValidator.allow_portsesED4b)HH%%%""&&t, rcSUlU$)z~Allow passwords to be present in the URI. .. versionadded:: 1.0 :returns: The validator instance. :rtype: Validator Trrs rallow_use_of_passwordValidator.allow_use_of_passwordws# rcSUlU$)zPrevent passwords from being included in the URI. .. versionadded:: 1.0 :returns: The validator instance. :rtype: Validator Fr7rs rforbid_use_of_password Validator.forbid_use_of_passwords$ rcUVs/sHo"R5PM nnUH,nX0R;dM[SRU55e URR UVs0sHo3S_M sn5 U$s snfs snf)zCheck 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 ValueErrorformatrupdater componentsc components rcheck_validity_ofValidator.check_validity_ofs*44Aggi 4#I 4 44 3::9E$ !!((.8 9j_j 9  5 : B+ BcUVs/sHo"R5PM nnUH,nX0R;dM[SRU55e URR UVs0sHo3S_M sn5 U$s snfs snf)zRequire 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 r>T)r?r@rArBrrCrDs rrequire_presence_ofValidator.require_presence_ofs*44Aggi 4#I 4 44 3::9E$   ''.8 9j_j 9  5 :rJcUR(d [U5 URR5VVs/sHup#U(dMUPM nnnURR5VVs/sHup#U(dMUPM nnnU(a [ X5 U(a [ X5 [URUS5 [URUS5 [URUS5 gs snnfs snnf)a Check 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)rurirGrequiredrrs rvalidateValidator.validates&"" 3 (,'?'?'E'E'G 'G#  'G  (,'@'@'F'F'H 'H#  'H   ,S F  ' Bd**C:d((#v6d((#v6#  s C5 C51 C;C;)rrrrrrN)__name__ __module__ __qualname____firstlineno____doc__ frozensetr@rr$r)r4r8r;rHrLrV__static_attributes__rrrrsD4 KOD"  $  22'7rrcURnU(dgURSS5n[U5S::ag[R"U5e)z4Assert that there is no password present in the uri.N:r)r splitlenrPasswordForbidden)rTr credentialss rrOrOsB||H ..a(K ;1  & &s ++rcl[X5nUb&U(aX0;a[R"UUU5eggg)z=Assert that the uri's attribute is one of the allowed values.N)getattrrUnpermittedComponentError)allowed_valuesrT attributevalues rrSrSs@ C #E ^0K22     1L^rc [UVs/sHn[X5bMUPM sn5nU(a[R"U/UQ76egs snf)z;Assert that all required components are present in the URI.N)sortedrgrMissingComponentError)rTrrGmissing_componentss rrQrQsX1 0 s& 0 ..sH5GHH  s A A cU(aUSL=(a URU5$USL=(d URU5$)zDetermine 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)rkmatcherrequires ris_validrts:D 9W]]5%99 D= 0GMM%00rNcf[U[RU5nU(aUb [X5$U$)aBDetermine 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 )rtrSUBAUTHORITY_MATCHER host_is_valid) authorityr rs validateds rauthority_is_validrz!s1D$=$=wGIT%T++ rcL[U[RU5nU(a2Ub/[RR U5(a [ U5$U(aHUbE[R R U5(a![RR U5SL$U$)zDetermine 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)rtr HOST_MATCHER IPv4_MATCHERrqvalid_ipv4_host_address IPv6_MATCHERIPv6_NO_RFC4007_MATCHER)r rsrys rrwrw5st00':IT%$*;*;*A*A$*G*G&t,, t'D,=,=,C,CD,I,I++11$7tCC rc8[U[RU5$)aDetermine 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 )rtrSCHEME_MATCHER)r rss rscheme_is_validrIs FD// 99rc8[U[RU5$)aDetermine 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 )rtr PATH_MATCHER)rrss r path_is_validrXs D$++W 55rc8[U[RU5$)a Determine 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 )rtr QUERY_MATCHER)rrss rquery_is_validrgs E4--w 77rc8[U[RU5$)aDetermine 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 )rtrFRAGMENT_MATCHER)rrss rfragment_is_validrvs Hd33W ==rc [URS5Vs/sH nS[USS9s=:*=(a S:*Os PM" sn5$s snf)z4Determine if the given host is a valid IPv4 address..r/r,r-)allrbr1)r bytes rr~r~s= 4::c?K?4SB'..3.?K LLKs'A)r rrr)r r r cUR5nUS:Xa[US5$US:wag[ US5nSUs=:*=(a S:*$s $![Ra gf=f![ a gf=f)z4Determine if the userinfo, host, and port are valid.Fr r Tr/r0)authority_inforInvalidAuthorityrwr1 TypeError)rTrGsubauthority_dictr s rsubauthority_component_is_validrs..0 F.v677 f $V,-     #  & & s"AA+A('A(+ A87A8c&[/5nUHbnU[;a#[X5(dURU5 M0[UnU"[ X55(aMQURU5 Md U(a[ R"U/UQ76eg)z0Assert that all components are valid in the URI.N)r_SUBAUTHORITY_VALIDATORSrr!_COMPONENT_VALIDATORSrgrInvalidComponentsError)rTrinvalid_componentsrG validators rrRrRsR) 0 023BB"&&y1 ))4 011  " "9 -*//I6HIIr)NF)F)r\rrrobjectrrOrSrQrtrzrwrrrrr~rrrrrRr_rrrs:U7U7p,  I1"(( : 6 8 >M  ! ;<0Jr