tfxudZddlmZddlmZddlmZddlmZddl m Z dZ d Z gd Z d ZGd d eZGddeZGddeZdS)z" Tests for L{twisted.python.url}. ) annotations)Iterable)Protocol)SynchronousTestCaseURL*http://www.foo.com/a/nice/path/?zot=23&zuthttp://a/b/c/d;p?q)()ghttp://a/b/c/g)z./gr )zg/http://a/b/c/g/)z/g http://a/g)z//gzhttp://g)z?yzhttp://a/b/c/d;p?y)zg?yzhttp://a/b/c/g?y)z#szhttp://a/b/c/d;p?q#s)zg#szhttp://a/b/c/g#s)zg?y#szhttp://a/b/c/g?y#s)z;xzhttp://a/b/c/;x)zg;xzhttp://a/b/c/g;x)zg;x?y#szhttp://a/b/c/g;x?y#s)r ). http://a/b/c/)z./r).. http://a/b/)z../r)z../g http://a/b/g)z../.. http://a/)z../../r)z../../gr)z ../../../gr)z ../../../../gr)z/./gr)z/../gr)zg.zhttp://a/b/c/g.)z.gzhttp://a/b/c/.g)zg..zhttp://a/b/c/g..)z..gzhttp://a/b/c/..g)z./../gr)z./g/.r)zg/./hzhttp://a/b/c/g/h)zg/../hzhttp://a/b/c/h)z g;x=1/./yzhttp://a/b/c/g;x=1/y)z g;x=1/../yzhttp://a/b/c/y)zg?y/./xzhttp://a/b/c/g?y/./x)zg?y/../xzhttp://a/b/c/g?y/../x)zg#s/./xzhttp://a/b/c/g#s/./x)zg#s/../xzhttp://a/b/c/g#s/../xc@dd|DS)Nrc3:K|]}dt|zVdS)z%%%02XN)ord).0cs [/var/www/surfInsights/venv3-11/lib/python3.11/site-packages/twisted/python/test/test_url.py z..Ls-==a3q66 1======)join)ss rr!Ls!==1=====rc&eZdZeddZdS) _HasExceptionreturn BaseExceptioncdS)Nselfs r exceptionz_HasException.exceptionPs rN)r$r%)__name__ __module__ __qualname__propertyr*r'rrr#r#Os2    X   rr#cveZdZdZd?dZ d@dAdZdBdZdBdZdBdZdBdZ dBdZ dBdZ dBdZ dBdZ dBdZdBdZdBdZdBdZdBd ZdBd!ZdBd"ZdBd#ZdBd$ZdBd%ZdBd&ZdBd'ZdBd(ZdBd)ZdBd*ZdBd+ZdBd,ZdBd-ZdBd.Z dBd/Z!dBd0Z"dBd1Z#dBd2Z$dBd3Z%dBd4Z&dBd5Z'dBd6Z(dBd7Z)dBd8Z*dBd9Z+dBd:Z,dBd;Z-dBd<Z.dBd=Z/d>S)CTestURLz Tests for L{URL}. ur r$Nonec`||jtt|||jtt||jD]+}||tt|,|jD]h\}}||tt|||dupt|tt|i||j tt|dS)zl The given L{URL}'s components should be L{unicode}. @param u: The L{URL} to test. N) assertIsInstanceschemestrreprhostpathquery assertTrue isinstancefragment)r)r1segkvs rassertUnicodedzTestURL.assertUnicodedZs ahT!WW555 afc4773336 5 5C  ! !#sDGG 4 4 4 4G F FDAq  ! !!S$q'' 2 2 2 OOAI;As););T!WW E E E E aj#tAww77777rrr5r6r8r9 Iterable[str]r: Iterable[tuple[str, str | None]]r=port int | Noneuserinfoc |j|j|j|j|j|j|jf} ||t|t||||jf} || | dS)a The given L{URL} should have the given components. @param u: The actual L{URL} to examine. @param scheme: The expected scheme. @param host: The expected host. @param path: The expected path. @param query: The expected query. @param fragment: The expected fragment. @param port: The expected port. @param userinfo: The expected userinfo. N) r5r8r9r:r=rDrFtuple assertEqual) r)r1r5r8r9r:r=rDrFactualexpecteds r assertURLzTestURL.assertURLisd<(AFAFAGQZTD%++uU||XtQZX *****rc d fd }|tdd|tddgg|tddggddS) z@ L{URL} should have appropriate default values. r1r r$r2c j||ddggddddS)NhttprP)rArL)r1r)s rcheckz(TestURL.test_initDefaults..checks=    " " " NN1fb"b"b" = = = = =rrOrNr1r r$r2r)r)rQs` rtest_initDefaultszTestURL.test_initDefaultss  > > > > > > c&"oo c&"b"%%&&& c&"b"b))*****rc tdddgddgd}||||dddgddgdd|tdd d gd gd dd d gd gd d dS)z= L{URL} should accept L{unicode} parameters. r hpr?r@)r?NfNrOàé)uλuπu⊥rPr rArLr)r1s r test_initzTestURL.test_inits S3%*k!:C @ @ A q#sSEJ +Dc4PPP  +?*@( K K   H ! "       rc tdddgddgd}||||dddgddgdddS)zN L{URL} should accept (and not interpret) percent characters. r z%68z%70)%6Bz%76)r_Nz%66Nr[r\s rtest_initPercentzTestURL.test_initPercentsj UUGnm%De L L A  sEE7^]$CUD     rc |ttdddgddgddtd d S) z L{URL.__repr__} will display the canonical form of the URL, wrapped in a L{URL.fromText} invocation, so that it is C{eval}-able but still easy to read. rOfoobar)bazNrWfrob)r5r8r9r:r=zURL.from_text({})zhttp://foo/bar?baz&k=v#frobN)rIr7r formatr(s r test_reprzTestURL.test_reprsw  !(*5#    & &t,I'J'J K K rctjt}|t|dS)zb Round-tripping L{URL.fromText} with C{str} results in an equivalent URL. N)r fromTexttheurlrIasTextr)urlpaths r test_fromTextzTestURL.test_fromTexts9 ,v&& !1!122222rcd}|D]>}tj|}|||?dS)z> L{URL.asText} should invert L{URL.fromText}. )zhttp://localhosthttp://localhost/zhttp://localhost/foozhttp://localhost/foo/zhttp://localhost/foo!!bar/zhttp://localhost/foo%20bar/zhttp://localhost/foo%2Fbar/zhttp://localhost/foo?nzhttp://localhost/foo?n=vzhttp://localhost/foo?n=/a/bz%http://example.com/foo!@$bar?b!@z=123z$http://localhost/asd?a=asd%20sdf/345z6http://(%2525)/(%2525)?(%2525)&(%2525)=(%2525)#(%2525)z OOH % % , , . .   >,w''  9 OOH % % , , . .     rctjt}|d|d|d|d|d|d|d|d|d |d tjd }|d |d tjd}||dddS)z L{URL.click} interprets the given string as a relative URI-reference and returns a new L{URL} interpreting C{self} as the base absolute URI. r rz$http://www.foo.com/a/nice/path/clickclickzhttp://www.foo.com/clickz/clickz$http://www.foo.com/a/nice/path/?burpz?burpz//foobarzhttp://www.foo.com/foobarzhttp://www.foo.com/me/noqueryz!http://www.foo.com/me/17?spam=158z/me/17?spam=158zhttp://localhost/foo?abc=defzhttp://www.python.orgN)r rirjrIrrk assertNotIn)r)rmr1s r test_clickzTestURL.test_click<s ,v&&  8'--:K:K:R:R:T:T     2GMM'4J4J4Q4Q4S4S    3W]]85L5L5S5S5U5UVVV  2GMM'4J4J4Q4Q4S4S     &ABBIIKK   L8 9 9  /9J1K1K1R1R1T1T   L7 8 8  GG+ , , 3 3 5 57N     rctjt}tD]@\}}||||AdS)zQ L{URL.click} should correctly resolve the examples in RFC 3986. N)r rirelativeLinkBaseForRFC3986relativeLinkTestsForRFC3986rIrrk)r)baserefrKs rtest_clickRFC3986zTestURL.test_clickRFC3986dsd|6778 A AMC   TZZ__3355x @ @ @ @ A Arctjt}|t|jd|t|jddS)zM L{URL.click} should not accept schemes with relative paths. zg:hzhttp:hN)r rir assertRaisesNotImplementedErrorr)r)rs rtest_clickSchemeRelPathzTestURL.test_clickSchemeRelPathlsP|677 -tz5AAA -tz8DDDDDrc tjd}|||j|j|j|j|j|j ||||dS)zf Verify that L{URL.replace} doesn't change any of the arguments it is passed. zhttps://x:1/y?z=1#AN) r rirIreplacer5r8r9r:r=rDrls rtest_cloneUnchangedzTestURL.test_cloneUnchangedts ,455  OO          **G44444rcRgdgdgdgdgdgdgdgdgd gd gd gd gd g }|D]z\}}}tj||}|||d|t |||{dS)zd L{URL.click} collapses C{.} and C{..} according to RFC 3986 section 5.2.4. )rprrp)rprrp)http://localhost/a/b/crzhttp://localhost/a/b/)rrzhttp://localhost/a/)rz./d/ezhttp://localhost/a/b/d/e)r../d/ehttp://localhost/a/d/e)rz/./d/ehttp://localhost/d/e)rz/../d/er)zhttp://localhost/a/b/c/z ../../d/e/zhttp://localhost/a/d/e/)zhttp://localhost/a/./crr)zhttp://localhost/a/./c/rr)zhttp://localhost/a/b/c/dz ./e/../f/../gzhttp://localhost/a/b/c/g)rzd//ezhttp://localhost/a/b/d//ez1{start}.click({click}) => {actual} not {expected})startrrJrKN)r rirrkrIrfr7)r)rqrrrKrJs rtest_clickCollapsezTestURL.test_clickCollapses < ; ; < < < D D D C C C K K K J J J H H H I I I P P P H H H K K K U U U K K K ',   "E5(\%((..u55<<>>F   CJJu++!% K      rc2|dtjddd|dtdddtjt }|d|d |d |d d |d |d d d |d|d d d |d|d d dddS)z3 L{URL.add} adds query parameters. z'http://www.foo.com/a/nice/path/?foo=barzhttp://www.foo.com/a/nice/path/rbrczhttp://www.foo.com/?foo=barrrz/http://www.foo.com/a/nice/path/?zot=23&zut&burpburpz3http://www.foo.com/a/nice/path/?zot=23&zut&burp=xxxxxxz8http://www.foo.com/a/nice/path/?zot=23&zut&burp=xxx&zingzingz8http://www.foo.com/a/nice/path/?zot=23&zut&zing&burp=xxxz:http://www.foo.com/a/nice/path/?zot=23&zut&burp=xxx&zot=32zot32N)rIr riaddrkrjrls r test_queryAddzTestURL.test_queryAdds  5 L: ; ; ? ?u M M T T V V     ) ] # # # ' 'u 5 5 < < > >   ,v&&  = KK   & & ( (     A KK & & - - / /     F KK & & * *6 2 2 9 9 ; ;    F KK   # #FE 2 2 9 9 ; ;    H KK & & * *5$ 7 7 > > @ @     rctjt}|d|dd|d|ddd|d|dddddS) z? L{URL.set} replaces query parameters by name. z*http://www.foo.com/a/nice/path/?zot=32&zutrrz0http://www.foo.com/a/nice/path/?zot&zut=itworkedzutitworkedrN)r rirjrIsetrkrrls r test_querySetzTestURL.test_querySets,v&&  8 KKt $ $ + + - -    > KK   " "5* 5 5 < < > >    8 KKu % % ) )% 6 6 = = ? ?     rctjd}||dtjddS)zK L{URL.remove} removes all instances of a query parameter. z*https://example.com/a/b/?foo=1&bar=2&foo=3rbzhttps://example.com/a/b/?bar=2N)r rirIremover)urls rtest_queryRemovezTestURL.test_queryRemovesRlGHH  JJu  s|,LMM     rcn|tddS)zG An empty L{URL} should serialize as the empty string. rN)rIr rkr(s r test_emptyzTestURL.test_emptys, ,,,,,rcxtdg}||ddS)zP An L{URL} with query text should serialize as just query text. helloworldr:z ?hello=worldN)r rIrkr\s rtest_justQueryTextzTestURL.test_justQueryTexts< )* + + + ^44444rcZtjd}|||dS)z2 L{URL} compares equal to itself. rpNr rirIr\s rtest_identicalEqualzTestURL.test_identicalEquals0 L, - - Arctjd}tjd}|||dS)zG URLs with equivalent components should compare equal. rpNrr)u1u2s rtest_similarEqualzTestURL.test_similarEquals@\- . . \- . . R     rctjd}tjd}|||k|d||||dS)z| L{URL}s that refer to different resources are both unequal (C{!=}) and also not equal (not C{==}). http://localhost/ahttp://localhost/b != N)r ri assertFalservrs rtest_differentNotEqualzTestURL.test_differentNotEqualsh \. / / \. / / rb#6#6#6#6777 B#####rctjd}||dkd||tkd||d||tdS)z= L{URL} is not equal (C{==}) to other types. rp*zURL must not equal a number.zURL must not equal an object.N)r rirobjectrvr\s rtest_otherTypesNotEqualzTestURL.test_otherTypesNotEquals L, - - b"@AAA fhh(GHHH Ar""" Avxx(((((rchtjd}|||kd|zdS)zJ Identical L{URL}s are not unequal (C{!=}) to each other. rpz %r == itselfNr rirr\s rtest_identicalNotUnequalz TestURL.test_identicalNotUnequals9 L, - - a!!344444rctjd}tjd}|||k|d|dS)zU Structurally similar L{URL}s are not unequal (C{!=}) to each other. rp == Nrrs rtest_similarNotUnequalzTestURL.test_similarNotUnequal!sR\- . . \- . . rb#6#6#6#677777rctjd}tjd}|||k|d|dS)zS Structurally different L{URL}s are unequal (C{!=}) to each other. rrrN)r rir;rs rtest_differentUnequalzTestURL.test_differentUnequal)sP\. / / \. / / bR"5"5r"5"566666rctjd}||dkd||tkddS)z; L{URL} is unequal (C{!=}) to other types. rprzURL must differ from a number.z"URL must be differ from an object.N)r rir;rr\s rtest_otherTypesUnequalzTestURL.test_otherTypesUnequal1sP L, - - R!ABBB VXX 'KLLLLLrcd}tj|}|}||jd||jdd|||d}|}||||d|dS)z L{URL.asURI} produces an URI which converts any URI unicode encoding into pure US-ASCII and returns a new L{URL}. http://é.com/é?á=í#úué.comrué.http://xn--9ca.com/%C3%A9?%C3%A1=%C3%AD#%C3%BArN)r riasURIrIr8r9rk)r)unicodeyiriuri expectedURI actualURIs r test_asURIzTestURL.test_asURI9s  B l8$$iikk #LMMM  HQKM    x000F JJLL  KI1T1T[1T1TUUUUUrcd}tj|}|}||jd||jdd|||d}|}||||d|dS)z L{URL.asIRI} decodes any percent-encoded text in the URI, making it more suitable for reading by humans, and returns a new L{URL}. rz xn--9ca.comrz%C3%A9uhttp://é.com/é?á=í#úrN)r riasIRIrIr8r9rk)r)asciiishrr expectedIRI actualIRIs r test_asIRIzTestURL.test_asIRIPs Dl8$$iikk =111 !h/// x000 3 JJLL  KI1T1T[1T1TUUUUUrcd}tj|}|}d}|}||||d|dS)z Bad UTF-8 in a path segment, query parameter, or fragment results in that portion of the URI remaining percent-encoded in the IRI. z http://xn--9ca.com/%00%FF/%C3%A9uhttp://é.com/%00%FF/érN)r rirrkrI)r) urlWithBinaryrrrrs rtest_badUTF8AsIRIzTestURL.test_badUTF8AsIRIesj ; l=))iikk 2  JJLL  KI1T1T[1T1TUUUUUrcd}tj|}|}|||dS)zT A L{URL} composed of non-ASCII text will result in non-ASCII text. rN)r rirrIrk)r)rralsoIRIs rtest_alreadyIRIAsIRIzTestURL.test_alreadyIRIAsIRIusQ  B l8$$))++ ))844444rcd}tj|}|}|||dS)zH A L{URL} composed of encoded text will remain encoded. rN)r rirrkrI)r)rrrs rtest_alreadyURIAsURIzTestURL.test_alreadyURIAsURIsNG l;''IIKK&&((  K00000rctjd}||dd||dd||jd||jd||d||d d d S) zz L{URL.fromText} will parse the C{userinfo} portion of the URI separately from the host and port. z??? :...  JJLLL     KKK , , 3 3 5 5 =     rctjd}||jd||ddS)zI L{URL.fromText} parses custom port numbers as integers. zhttp://www.example.com:8080/iN)r rirIrDrk)r)portURLs r test_portTextzTestURL.test_portTextsS,=>> t,,, ))+IJJJJJrcz|tjdddS)a Although L{URL} instances are mainly for dealing with HTTP, other schemes (such as C{mailto:}) should work as well. For example, L{URL.fromText}/L{URL.asText} round-trips cleanly for a C{mailto:} URL representing an email address. zmailto:user@example.comN)rIr rirkr(s r test_mailtozTestURL.test_mailtosC  L2 3 3 : : < <>W     rcbtddgg}||jddS)z When a L{URL} is created with a C{query} argument, the C{query} argument is converted into an N-tuple of 2-tuples. alphabetar))rrN)r rIr:rs rtest_queryIterablezTestURL.test_queryIterables; '6*+,,, $899999rc`tddg}||jddS)zr When a L{URL} is created with a C{path} argument, the C{path} is converted into a tuple. rrr9rN)r rIr9rs rtest_pathIterablezTestURL.test_pathIterables8 )*** #566666rcGddtturdnd}d"fd |fd#fd }|d|d|d|dd|d|ddt5}t gdddn #1swxYwY||dt5}t dfgdddn #1swxYwY||dzdt5}t dfgdddn #1swxYwY||dt5t gdddn #1swxYwYt 5t dgdddn #1swxYwYt 5t dgdddn #1swxYwYt jd }t5}|dddn #1swxYwY||dt5}|dddn #1swxYwY||dt5}| dddn #1swxYwY||d!dS)$a Passing an argument of the wrong type to any of the constructor arguments of L{URL} will raise a descriptive L{TypeError}. L{URL} typechecks very aggressively to ensure that its constitutent parts are all properly immutable and to prevent confusing errors when bad data crops up in a method call long after the code that called the constructor is off the stack. ceZdZddZddZdS)1TestURL.test_invalidArguments..Unexpectedr$r6cdS)Nwrongr'r(s r__str__z9TestURL.test_invalidArguments..Unexpected.__str__swrcdS)N r'r(s r__repr__z:TestURL.test_invalidArguments..Unexpected.__repr__s%~rN)r$r6)r+r,r-r r r'rr Unexpectedrs<     & & & & & &rr unicoder6raisedr# expectationnamer$r2ct|jd||ddS)Nzexpected {} for {}, got {}r )rIr6r*rf)rrrr)s r assertRaisedz3TestURL.test_invalidArguments..assertRaisedsH   F$%%,33K~VV     rparamct5}tdi|idddn #1swxYwY|||dS)Nr')r TypeErrorr )rrrr rr)s rrQz,TestURL.test_invalidArguments..checks""9-- -,,ujjll+,,, - - - - - - - - - - - - - - - Le 4 4 4 4 4s?AAr5r8r=rboolrFrDzint or NoneTyperNz path segmentrz or NoneTypezquery parameter valuevaluezquery parameter name)r?r@vv)r?zhttps://valid.example.com/z relative URL)rr#rr6rr6r$r2)rr6rr6r$r2) bytesr6rrr ValueErrorrir|rr)r)defaultExpectationrQrrr rs` @@rtest_invalidArgumentszTestURL.test_invalidArgumentssB & & & & & & & &+03,,YYE       2D 5 5 5 5 5 5 5 5 5 h f  j h j f'(((   y ) ) V JLL                     V/@@@   y ) ) V ZZ\\*                     &79P     y ) ) V Z\\7+                     V/1GHHH  y ) ) & & zz||n % % % % & & & & & & & & & & & & & & &   z * * * * '( ) ) ) ) * * * * * * * * * * * * * * *   z * *  vh                   l788   y ) ) $V IIjjll # # # $ $ $ $ $ $ $ $ $ $ $ $ $ $ $ V/@@@   y ) ) &V KK % % % & & & & & & & & & & & & & & & V/@@@   y ) ) $V IIjjll # # # $ $ $ $ $ $ $ $ $ $ $ $ $ $ $ V/@@@@@sB77B;>B;)DDDE..E25E2 GG  G +H  H H .I  IIJ//J36J3!L  LL=M''M+.M+c|t5}tddddn #1swxYwY|t |jdtddS)z Technically, L{str} (or L{unicode}, as appropriate) is iterable, but C{URL(path="foo")} resulting in C{URL.fromText("f/o/o")} is never what you want. rbrNz+expected iterable of text for path, not: {})rrr rIr6r*rfr7)r)rs r!test_technicallyTextIsIterableButz)TestURL.test_technicallyTextIsIterableButs   y ) ) V UOOOO                  ! ! 9 @ @e M M     s 8<<NrR)r)r1r r5r6r8r6r9rBr:rCr=r6rDrErFr6r$r2r$r2)0r+r,r-__doc__rArLrSr]r`rgrnrtrwryr}rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr'rrr0r0Us 8 8 8 80 + + + + +D + + + +    $        &3333++++0             .    DDDD    $& & & & PAAAAEEEE5555&B" " " " H    *    ---- 5555!!!!$$$$))))555588887777MMMMVVVV.VVVV*VVVV 5 5 5 51111    (KKKK     ::::7777OAOAOAOAb       rr0ceZdZdZddZdS)URLDeprecationTestsz. L{twisted.python.url} is deprecated. r$r2cddlm}|||jg}|dt ||d|dddS)zK L{twisted.python.url} is deprecated since Twisted 17.5.0. r)rz\twisted.python.url was deprecated in Twisted 17.5.0: Please use hyperlink from PyPI instead.messageN)twisted.pythonr flushWarningstest_urlDeprecationrIlen)r)r warningsShowns rr)z'URLDeprecationTests.test_urlDeprecation)s '&&&&& **D,D+EFF  C ../// ; ! Y '      rNr )r+r,r-r!r)r'rrr#r#$s2      rr#N)r! __future__rtypingrtyping_extensionsrtwisted.trial.unittestrrr rjrr _percentencr#r0r#r'rrr1s( #"""""&&&&&&666666 52444n>=      H   L  L  L  L  L  !L  L  L  ^     -     r