U 2ܟj.@sdZddlmZddlmZddlmZGdddejZGdddZ Gd d d e ejZ Gd d d e ejZ Gd dde ejZ dS)z) Tests L{twisted.web.client} helper APIs )urlparse)unittest)clientc@s eZdZdZddZddZdS) URLJoinTestsz' Tests for L{client._urljoin}. cCs@|tddd|tddd|tddddS)z L{client._urljoin} does not include a fragment identifier in the resulting URL if neither the base nor the new path include a fragment identifier. http://foo.com/bar/quuxshttp://foo.com/quuxshttp://foo.com/bar#s/quux#N assertEqualrZ_urljoinselfr C/tmp/pip-unpacked-wheel-4b529toj/twisted/web/test/test_webclient.pytest_noFragmentss   zURLJoinTests.test_noFragmentscCs@|tddd|tddd|tddddS)a L{client._urljoin} preserves the fragment identifier from either the new path or the base URL respectively, as specified in the HTTP 1.1 bis draft. @see: U{https://tools.ietf.org/html/draft-ietf-httpbis-p2-semantics-22#section-7.1.2} shttp://foo.com/bar#fragrshttp://foo.com/quux#fragrs /quux#frag2shttp://foo.com/quux#frag2Nrr r r r test_preserveFragments$s   z#URLJoinTests.test_preserveFragmentsN)__name__ __module__ __qualname____doc__rrr r r r rsrc@seZdZdZddZd$ddZddZd d Zd d Zd dZ ddZ ddZ ddZ ddZ ddZddZddZddZdd Zd!d"Zd#S)%URITestsa Abstract tests for L{twisted.web.client.URI}. Subclass this and L{unittest.TestCase}. Then provide a value for C{host} and C{uriHost}. @ivar host: A host specification for use in tests, must be L{bytes}. @ivar uriHost: The host specification in URI form, must be a L{bytes}. In most cases this is identical with C{host}. IPv6 address literals are an exception, according to RFC 3986 section 3.2.2, as they need to be enclosed in brackets. In this case this variable is different. cCsB||jt||jt||t|d||d|jS)a Replace the string "HOST" in C{template} with this test's host. Byte strings Python between (and including) versions 3.0 and 3.4 cannot be formatted using C{%} or C{format} so this does a simple replace. @type template: L{bytes} @param template: A string containing "HOST". @rtype: L{bytes} @return: A string where "HOST" has been replaced by C{self.host}. sHOST)assertIsInstancehostbytesuriHostZassertInreplace)r templater r r makeURIStringIs   zURITests.makeURIStringc Cs@||||||||| f|j|j|j|j|j|j|j|jfdS)aU Assert that all of a L{client.URI}'s components match the expected values. @param uri: U{client.URI} instance whose attributes will be checked for equality. @type scheme: L{bytes} @param scheme: URI scheme specifier. @type netloc: L{bytes} @param netloc: Network location component. @type host: L{bytes} @param host: Host name. @type port: L{int} @param port: Port number. @type path: L{bytes} @param path: Hierarchical path. @type params: L{bytes} @param params: Parameters for last path segment, defaults to C{b''}. @type query: L{bytes} @param query: Query string, defaults to C{b''}. @type fragment: L{bytes} @param fragment: Fragment identifier, defaults to C{b''}. N) r schemenetlocrportpathparamsqueryfragment) r urirrrrr r!r"r#r r r assertURIEquals]s"zURITests.assertURIEqualscCsdtj|d}|d|jtj|d}|d|jtj|d}|d|jdS)z L{client.URI.fromBytes} by default assumes port 80 for the I{http} scheme and 443 for the I{https} scheme. http://HOSTPs http://HOST: https://HOSTiNrURI fromBytesrr rr r$r r r test_parseDefaultPorts zURITests.test_parseDefaultPortcCsLtjj|ddd}|d|jtjj|ddd}|d|jdS)z L{client.URI.fromBytes} accepts a C{defaultPort} parameter that overrides the normal default port logic. r&)Z defaultPortr(Nr)r,r r r test_parseCustomDefaultPortsz$URITests.test_parseCustomDefaultPortcCsjtj|d}|d|j||j|j||jd|jtj|d}||j|jdS)zj Parsing a I{URI} splits the network location component into I{host} and I{port}. shttp://HOST:5144r.s:5144s http://HOST N) rr*r+rr rrrrr,r r r test_netlocHostPorts zURITests.test_netlocHostPortcCsD|d}tj|}|j|d|j|jddd|||dS)z/ Parse the path from a I{URI}. shttp://HOST/foo/barhttpr'/foo/barrrrrr N rrr*r+r%rrr toBytesr r$parsedr r r test_paths  zURITests.test_pathcCsD|d}tj|}|j|d|j|jddd|||dS)zL The path of a I{URI} that has no path is the empty string. r&r1r'rr3Nr4r6r r r test_noPaths  zURITests.test_noPathcCs0|d}|jtj|d|j|jddddS)zE The path of a I{URI} with an empty path is C{b'/'}. http://HOST/r1r'/r3N)rr%rr*r+rrr,r r r test_emptyPaths  zURITests.test_emptyPathc CsF|d}tj|}|j|d|j|jdddd|||dS)z8 Parse I{URI} parameters from a I{URI}. shttp://HOST/foo/bar;paramr1r'r2param)rrrrr r!Nr4r6r r r test_params   zURITests.test_paramc CsH|d}tj|}|j|d|j|jddddd|||dS) z7 Parse the query string from a I{URI}. s!http://HOST/foo/bar;param?a=1&b=2r1r'r2r=a=1&b=2)rrrrr r!r"Nr4r6r r r test_querys   zURITests.test_queryc CsJ|d}tj|}|j|d|j|jdddddd |||d S) z> Parse the fragment identifier from a I{URI}. s&http://HOST/foo/bar;param?a=1&b=2#fragr1r'r2r=r?sfrag)rrrrr r!r"r#Nr4r6r r r test_fragments   zURITests.test_fragmentcCs$tj|d}|d|jdS)zn L{client.URI.originForm} produces an absolute I{URI} path including the I{URI} path. shttp://HOST/foos/fooNrr*r+rr Z originFormr,r r r test_originFormszURITests.test_originFormcCs$tj|d}|d|jdS)z L{client.URI.originForm} produces an absolute I{URI} path including the I{URI} path, parameters and query string but excludes the fragment identifier. shttp://HOST/foo;param?a=1#frags/foo;param?a=1NrBr,r r r test_originFormComplex szURITests.test_originFormComplexcCs$tj|d}|d|jdS)zp L{client.URI.originForm} produces a path of C{b'/'} when the I{URI} specifies no path. r&r;NrBr,r r r test_originFormNoPath+szURITests.test_originFormNoPathcCs$tj|d}|d|jdS)zv L{client.URI.originForm} produces a path of C{b'/'} when the I{URI} specifies an empty path. r:r;NrBr,r r r test_originFormEmptyPath3sz!URITests.test_originFormEmptyPathcCsV|d}|d}t|tj|}||jt||j t||j tdS)z L{client.URI.fromBytes} parses the scheme, host, and path elements into L{bytes}, even when passed an URL which has previously been passed to L{urlparse} as a L{unicode} string. shttp://HOST/pathasciiN) rdecoderrr*r+rrrrr )r Z goodInputZbadInputr$r r r test_externalUnicodeInterference;s   z)URITests.test_externalUnicodeInterferenceN)rrr)rrrrrr%r-r/r0r8r9r<r>r@rArCrDrErFrIr r r r r:s( 0   rc@seZdZdZdZZdS)URITestsForHostnamez> Tests for L{twisted.web.client.URI} with host names. s example.comNrrrrrrr r r r rJJsrJc@seZdZdZdZZdS)URITestsForIPv4zG Tests for L{twisted.web.client.URI} with IPv4 host addresses. s 192.168.1.67NrKr r r r rLRsrLc@s eZdZdZdZdZddZdS)URITestsForIPv6z Tests for L{twisted.web.client.URI} with IPv6 host addresses. IPv6 addresses must always be surrounded by square braces in URIs. No attempt is made to test without. sfe80::20c:29ff:fea4:c60s[fe80::20c:29ff:fea4:c60]cCs<tjd}||jd||jd||ddS)z Brackets around IPv6 addresses are stripped in the host field. The host field is then exported with brackets in the output of L{client.URI.toBytes}. shttp://[::1]:80/index.htmls::1s[::1]:80N)rr*r+r rrr5r,r r r "test_hostBracketIPv6AddressLiterales z2URITestsForIPv6.test_hostBracketIPv6AddressLiteralN)rrrrrrrNr r r r rMZsrMN) r urllib.parserZ twisted.trialrZ twisted.webrZTestCaserrrJrLrMr r r r s   +