U P|jxu(@sdZddlmZddlmZddlmZddlmZddl m Z dZ d Z d d d d ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1g(Z d2d3ZGd4d5d5eZGd6d7d7eZGd8d9d9eZd:S);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/../xcCsddd|DS)Nrcss|]}dt|VqdS)z%%%02XN)ord).0cr@/tmp/pip-unpacked-wheel-audpp6lv/twisted/python/test/test_url.py Lsz..)join)srrrLrc@seZdZeddddZdS) _HasException BaseExceptionreturncCsdSNrselfrrr exceptionPsz_HasException.exceptionN)__name__ __module__ __qualname__propertyr'rrrrr Osr c @seZdZdZdddddZdedddd d dd ddd d dZddddZddddZddddZddddZ ddddZ ddddZ ddddZ ddddZ ddd d!Zddd"d#Zddd$d%Zddd&d'Zddd(d)Zddd*d+Zddd,d-Zddd.d/Zddd0d1Zddd2d3Zddd4d5Zddd6d7Zddd8d9Zddd:d;Zdddd?Zddd@dAZdddBdCZdddDdEZ dddFdGZ!dddHdIZ"dddJdKZ#dddLdMZ$dddNdOZ%dddPdQZ&dddRdSZ'dddTdUZ(dddVdWZ)dddXdYZ*dddZd[Z+ddd\d]Z,ddd^d_Z-ddd`daZ.dddbdcZ/ddS)fTestURLz Tests for L{URL}. rNoneur#cCs||jtt|||jtt||jD]}||tt|q.|jD]8\}}||tt|||dkpzt|tt|qL||j tt|dS)zl The given L{URL}'s components should be L{unicode}. @param u: The L{URL} to test. N) ZassertIsInstanceschemestrreprhostpathquery assertTrue isinstancefragment)r&r/segkvrrrassertUnicodedZs  zTestURL.assertUnicodedrr1z Iterable[str]z Iterable[tuple[str, str | None]]z int | None) r/r0r3r4r5r8portuserinfor#c CsL|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) r0r3r4r5r8r=r>tuple assertEqual) r&r/r0r3r4r5r8r=r>actualexpectedrrr assertURLis zTestURL.assertURLr"csLdddfdd }|tdd|tddgg|tddggddS) z@ L{URL} should have appropriate default values. rr-r.c s&||ddggddddS)NhttprP)r<rC)r/r%rrchecks z(TestURL.test_initDefaults..checkrDrNr)r&rFrr%rtest_initDefaultsszTestURL.test_initDefaultsc Csjtdddgddgd}||||dddgddgdd|tdd d gd gd dd d gd gd d dS)z= L{URL} should accept L{unicode} parameters. rhpr:r;)r:NfNrDàé)uλuπu⊥rErr<rCr&r/rrr test_inits zTestURL.test_initc Cs@tdddgddgd}||||dddgddgdddS)zN L{URL} should accept (and not interpret) percent characters. rz%68z%70)%6Bz%76)rQNz%66NrNrOrrrtest_initPercents zTestURL.test_initPercentc Cs2|ttdddgddgdddtd 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. rDfoobar)ZbazNrJZfrob)r0r3r4r5r8zURL.from_text({})zhttp://foo/bar?baz&k=v#frobN)r@r2rformatr%rrr test_reprs zTestURL.test_reprcCstt}|t|dS)zb Round-tripping L{URL.fromText} with C{str} results in an equivalent URL. N)rfromTexttheurlr@asTextr&urlpathrrr test_fromTexts zTestURL.test_fromTextcCs,d}|D]}t|}|||qdS)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\}}}t||}|||dj|t|||dqpdS)zd L{URL.click} collapses C{.} and C{..} according to RFC 3986 section 5.2.4. r]rrzhttp://localhost/a/b/czhttp://localhost/a/b/zhttp://localhost/a/z./d/ezhttp://localhost/a/b/d/ez../d/ezhttp://localhost/a/d/ez/./d/ezhttp://localhost/d/ez/../d/ezhttp://localhost/a/b/c/z ../../d/e/zhttp://localhost/a/d/e/zhttp://localhost/a/./czhttp://localhost/a/./c/zhttp://localhost/a/b/c/dz ./e/../f/../gzhttp://localhost/a/b/c/gzd//ezhttp://localhost/a/b/d//ez1{start}.click({click}) => {actual} not {expected})startrprArBN)rrWrprYr@rUr2)r&r^r|rprBrArrrtest_clickCollapses4zTestURL.test_clickCollapsecCs|dtddd|dtddddtt}|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/rSrTzhttp://www.foo.com/?foo=barrjrkz/http://www.foo.com/a/nice/path/?zot=23&zut&burpZburpz3http://www.foo.com/a/nice/path/?zot=23&zut&burp=xxxxxxz8http://www.foo.com/a/nice/path/?zot=23&zut&burp=xxx&zingZzingz8http://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)r@rrWaddrYrXrZrrr test_queryAdds:  zTestURL.test_queryAddcCsdtt}|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=itworkedZzutZitworkedr~N)rrWrXr@setrYrrZrrr test_querySets zTestURL.test_querySetcCs&td}||dtddS)zK L{URL.remove} removes all instances of a query parameter. z*https://example.com/a/b/?foo=1&bar=2&foo=3rSzhttps://example.com/a/b/?bar=2N)rrWr@remover&urlrrrtest_queryRemoves  zTestURL.test_queryRemovecCs|tddS)zG An empty L{URL} should serialize as the empty string. rN)r@rrYr%rrr test_emptyszTestURL.test_emptycCs tdgd}||ddS)zP An L{URL} with query text should serialize as just query text. helloworldr5z ?hello=worldN)rr@rYrOrrrtest_justQueryTexts zTestURL.test_justQueryTextcCstd}|||dS)z2 L{URL} compares equal to itself. r]NrrWr@rOrrrtest_identicalEquals zTestURL.test_identicalEqualcCs$td}td}|||dS)zG URLs with equivalent components should compare equal. r]Nrr&u1u2rrrtest_similarEquals  zTestURL.test_similarEqualcCs>td}td}|||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)rrW assertFalserbrrrrtest_differentNotEquals  zTestURL.test_differentNotEqualcCsJtd}||dkd||tkd||d||tdS)z= L{URL} is not equal (C{==}) to other types. r]*zURL must not equal a number.zURL must not equal an object.N)rrWrobjectrbrOrrrtest_otherTypesNotEquals   zTestURL.test_otherTypesNotEqualcCs"td}|||kd|dS)zJ Identical L{URL}s are not unequal (C{!=}) to each other. r]z %r == itselfNrrWrrOrrrtest_identicalNotUnequals z TestURL.test_identicalNotUnequalcCs2td}td}|||k|d|dS)zU Structurally similar L{URL}s are not unequal (C{!=}) to each other. r] == Nrrrrrtest_similarNotUnequal!s  zTestURL.test_similarNotUnequalcCs2td}td}|||k|d|dS)zS Structurally different L{URL}s are unequal (C{!=}) to each other. rrrN)rrWr6rrrrtest_differentUnequal)s  zTestURL.test_differentUnequalcCs0td}||dkd||tkddS)z; L{URL} is unequal (C{!=}) to other types. r]rzURL must differ from a number.z"URL must be differ from an object.N)rrWr6rrOrrrtest_otherTypesUnequal1s zTestURL.test_otherTypesUnequalcCsnd}t|}|}||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)rrWasURIr@r3r4rY)r&unicodeyiriuri expectedURI actualURIrrr test_asURI9s zTestURL.test_asURIcCsnd}t|}|}||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)rrWasIRIr@r3r4rY)r&Zasciiishrr expectedIRI actualIRIrrr test_asIRIPs zTestURL.test_asIRIcCs>d}t|}|}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)rrWrrYr@)r&Z urlWithBinaryrrrrrrrtest_badUTF8AsIRIes zTestURL.test_badUTF8AsIRIcCs*d}t|}|}|||dS)zT A L{URL} composed of non-ASCII text will result in non-ASCII text. rN)rrWrr@rY)r&rrZalsoIRIrrrtest_alreadyIRIAsIRIus  zTestURL.test_alreadyIRIAsIRIcCs*d}t|}|}|||dS)zH A L{URL} composed of encoded text will remain encoded. rN)rrWrrYr@)r&rrrrrrtest_alreadyURIAsURIs  zTestURL.test_alreadyURIAsURIcCsvtd}||dd||dd||jd||jd||d||jdd d d S) zz L{URL.fromText} will parse the C{userinfo} portion of the URI separately from the host and port. zz/http://someuser@example.com/some-segment@ignoreN)rrWr@ authorityr>userrYrzrrrr test_userinfoszTestURL.test_userinfocCs,td}||jd||ddS)zI L{URL.fromText} parses custom port numbers as integers. zhttp://www.example.com:8080/iN)rrWr@r=rY)r&ZportURLrrr test_portTexts zTestURL.test_portTextcCs|tdddS)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)r@rrWrYr%rrr test_mailtos zTestURL.test_mailtocCs"tddggd}||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)rr@r5rrrrtest_queryIterableszTestURL.test_queryIterablecCs tddgd}||jddS)zr When a L{URL} is created with a C{path} argument, the C{path} is converted into a tuple. rrr4rN)rr@r4rrrrtest_pathIterableszTestURL.test_pathIterablec s$Gdddttkrdnd}dddddfdd |fdddd fd d }|d |d|d|dd|d|ddt}tgdW5QRX||dt}tdfgdW5QRX||ddt}tdfgdW5QRX||dttgdW5QRXttdgdW5QRXttdgdW5QRXtd}t}|W5QRX||dt}|W5QRX||dt}| W5QRX||d d!S)"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. c@s(eZdZddddZddddZdS)z1TestURL.test_invalidArguments..Unexpectedr1r"cSsdS)NZwrongrr%rrr__str__sz9TestURL.test_invalidArguments..Unexpected.__str__cSsdS)N rr%rrr__repr__sz:TestURL.test_invalidArguments..Unexpected.__repr__N)r(r)r*rrrrrr Unexpectedsrunicoder1r r-)raised expectationnamer#cs t|jd||ddS)Nzexpected {} for {}, got {}r)r@r1r'rU)rrrr%rr assertRaiseds z3TestURL.test_invalidArguments..assertRaised)paramrr#c s6t}tf|iW5QRX|||dSr$)rw TypeErrorr)rrrrrr&rrrFs z,TestURL.test_invalidArguments..checkr0r3r8rlboolr>r=zint or NoneTyperz path segmentrrz or NoneTypezquery parameter valuevaluezquery parameter name)r:r;vv)r:zhttps://valid.example.com/z relative URLN) bytesr1rwrr ValueErrorrWrernrp)r&ZdefaultExpectationrFrrrrrtest_invalidArgumentss`                 zTestURL.test_invalidArgumentsc Cs@|t}tddW5QRX|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. rSrz+expected iterable of text for path, not: {}N)rwrrr@r1r'rUr2)r&rrrr!test_technicallyTextIsIterableButs   z)TestURL.test_technicallyTextIsIterableButN)r)0r(r)r*__doc__r<rCrGrPrRrVr\rarcrdrfrirmrorqrvryr{r}rrrrrrrrrrrrrrrrrrrrrrrrrrrrrr,Us\ "     (!$      Qr,c@seZdZdZddddZdS)URLDeprecationTestsz. L{twisted.python.url} is deprecated. r-r"cCsFddlm}|||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)Ztwisted.pythonrZ flushWarningstest_urlDeprecationr@len)r&rZ warningsShownrrrr)s  z'URLDeprecationTests.test_urlDeprecationN)r(r)r*rrrrrrr$srN)r __future__rtypingrZtyping_extensionsrZtwisted.trial.unittestrrrrXrrrsZ _percentencr r,rrrrrsr     7T