+ Dfje Rt^RIt^RIt^RIt^RIt^RIt^RIt^RIt^RIH t ^RI H t ^RI Ht^RIHtHt^RIHtHt^RIHt^RIHt^R IHt^R IHt^R IHtHtH t H!t!^R I"H#t#^R I$H%t%^RI&H't'^RI(H)t)!RR]4t*!RR]4t+!RR]4t,!RR]4t-!RR]4t.!RR]4t/!RR]4t0!RR]4t1!R R!]4t2!R"R#]4t3!R$R%]4t4R#)&z" Tests for L{twisted.web.static}. N)BytesIO)skipIf) verifyObject)abstract interfaces)compatlog) networkString)FilePath)platform)TestCase)httpresourcescriptstatic)FOUND)UnsupportedMethod_render) DummyRequestc0a]tRt^ toRtRtRtRtVtR#)StaticDataTestsz Tests for L{Data}. c aa\P!RR4p\R.4oRSn\ VS4pVV3RlpVP V4V#)zF L{Data.render} returns an empty response body for a I{HEAD} request. foobarHEADc^<SPRPSP4R4R#N assertEqualjoinwrittenignoredrequestselfs&>/usr/lib/python3/dist-packages/twisted/web/test/test_static.py cbRendered4StaticDataTests.test_headRequest..cbRendered.   SXXgoo6 {{66*u%  +T[['BrN) __name__ __module__ __qualname____firstlineno____doc__r1r7__static_attributes____classdictcell__ __classdict__s@r(rr s CCrrca]tRt^?toRtRtRtRtRtRt Rt Rt R t R t ]!]P !4R 4R 4tR tRtRtRtRt]!]P0!4P34R!9RP5]P0!444R4tRtRtRtRtRt Rt!Rt"Rt#Rt$Rt%Rt&Rt'Vt(R #)"StaticFileTestsz* Tests for the basic behavior of L{File}. c\W4#Nr)r'rr&s&&&r(rStaticFileTests._renderDs x))rc 8\P!RR7;_uu_4p\P!VP 4^R7pVP VP R.4RRR4VP \X4^4R# +'giL-;i)z Passing C{1} as the value to L{File}'s C{ignoredExts} argument issues a warning and sets the ignored extensions to the wildcard C{"*"}. Trecord ignoredExts*Nwarningscatch_warningsrFilemktempr!rLlenr'caughtWarningsfiles& r(test_ignoredExtTrue#StaticFileTests.test_ignoredExtTrueGsj  $ $D 1 1^;;t{{}!.cbRendered   W113 7r r rRmakedirsrrQrbrrgetChildForRequestrr.r'baserVchildr0r)r&sf @r( test_notFoundStaticFileTests.test_notFoundwsv  & {{499% {+++D': LL ( 8 j!rc h\VP44pVP4\P!VP 4p\ R.4p\P!W#4pVPV\P4VPVP VP 4R#)zj The C{''} child of a L{File} which corresponds to a directory in the filesystem is a L{DirectoryLister}. rN) r rRrnrrQrbrrroassertIsInstanceDirectoryListerr!r'rqrVr&rrs& r(test_emptyChildStaticFileTests.test_emptyChildsy  & {{499%u%++D: eV%;%;< TYY/rc Z\VP44P4pVP4VP R4P R4P 4\P!VP4p\R.4p\P!W#4pVPV\P4\P !VP4pVP#VPV4VP%V4pVPV\&4R#)z The C{u''} child of a L{File} which corresponds to a directory whose path is text is a L{DirectoryLister} that renders to a binary listing. @see: U{https://twistedmatrix.com/trac/ticket/9438} z text-filewrN)r rR asTextModernrropencloserrQrbrrrorvrwr nativeStringr!r6bytes)r'textBasetextFiler&rr nativePathresponses& r(test_emptyChildUnicodeParent,StaticFileTests.test_emptyChildUnicodeParentsDKKM*557{#((-335;;x}}-u%++H> eV%;%;<((7  Z0<<( h.rc 6aa\SP44pVP4\P!VP 4p\ R.4o\P!VS4pSPVS4pVV3RlpVPV4V#)z If a request is made which encounters a L{File} before a final segment which cannot be looked up in the filesystem due to security considerations, a not found response is sent. s..c@<SPSPR4R#rgrir$s&r(r)BStaticFileTests.test_securityViolationNotFound..cbRenderedrlrrmrpsf @r(test_securityViolationNotFound.StaticFileTests.test_securityViolationNotFoundsv  & {{499%w'++D': LL ( 8 j!rz(Cannot remove read permission on Windowsc daa\SP44pVPR4SPVPR4VP ^4\ P !VP4p\R.4oSPVS4pVV3RlpVPV4V#)z If the file in the filesystem which would satisfy a request cannot be read, L{File.render} sets the HTTP response code to I{FORBIDDEN}. ric@<SPSPR4R#)iNrir$s&r(r):StaticFileTests.test_forbiddenResource..cbRenderedrlr) r rRra addCleanupchmodrrQrbrrr.)r'rqrVr0r)r&sf @r(test_forbiddenResource&StaticFileTests.test_forbiddenResources  &   E* 1 {{499%u% LLw ' 8 j!rc aaSP4p\V\4'dVPR4p\ V4pVP 4\ P!VP4p\R.4o\P!VS4pSPVS4pVV3RlpVPV4V#)zk A request whose path cannot be decoded as UTF-8 receives a not found response, and the failure is logged. asciic<SPSPR4SP\SP\44^4R#rg)r!rjrSflushLoggedErrorsUnicodeDecodeErrorr$s&r(r)8StaticFileTests.test_undecodablePath..cbRendereds:   W113 7   S!7!78J!KLa Pr)rR isinstancerdecoder rnrrQrbrrrorr.)r'rbrqrVrrr0r)r&sf @r(test_undecodablePath$StaticFileTests.test_undecodablePaths {{} dE " ";;w'D~ {{499%y)++D': LL ( Q j!rc VP\P!R4P\P 4R#)z> L{File.forbidden} defaults to L{resource.ForbiddenResource}. .N)rvrrQ forbiddenrForbiddenResourcer's&r(test_forbiddenResource_default.StaticFileTests.test_forbiddenResource_defaults) fkk$/998;U;UVrc faa\VP44pVPR4RoRp!V3RlR\P4o!V3RlR\ P 4pV!VP4pW$n\R.4pVPV4pVPSV4R#) zj The resource rendered for forbidden requests is stored as a class member so that users can customize it. rscustom-forbidden-responsec6\\PR4h)r)OSErrorerrnoEACCESr9rr(failingOpenForReadingOStaticFileTests.test_forbiddenResource_customize..failingOpenForReadings%,,+ +rc.<a]tRtRtoV3RltRtVtR#)QStaticFileTests.test_forbiddenResource_customize..CustomForbiddenResourceic<S#rFr9r'r&markerResponses&&r(r6XStaticFileTests.test_forbiddenResource_customize..CustomForbiddenResource.render  %%rr9Nr:r;r<r=r6r?r@rBrs@r(CustomForbiddenResourcer & &rrc(<]tRtRtZ!4tRtR#)JStaticFileTests.test_forbiddenResource_customize..CustomStaticFilei r9N)r:r;r<r=rr?)rsr(CustomStaticFiler s /1IrrN) r rRrarResourcerrQrbopenForReadingrr6r!) r'rqrr fileResourcer&resultrrs & @@r( test_forbiddenResource_customize0StaticFileTests.test_forbiddenResource_customizes  & 5 , &h&7&7 & 2v{{ 2( 2 &;#u%$$W- 0rc aa\SP44pVP4VPR4P R4\ P !VP4pR.Vn\R.4o\P!VS4pSPVS4pVV3RlpVPV4V#)z If a request is made which encounters a L{File} before a final empty segment, a file in the L{File} instance's C{indexNames} list which exists in the path the L{File} was created with is served as the response to the request. foo.barbazrc<SPRPSP4R4SPSPP R4^,R4R#rrcontent-length3Nr!r"r#responseHeaders getRawHeadersr$s&r(r)3StaticFileTests.test_indexNames..cbRendered)J   SXXgoo6 ?   ''556GHKT r)r rRrnrrrarrQrb indexNamesrrrorr.rpsf @r(test_indexNamesStaticFileTests.test_indexNamess &  9((0{{499%$+u%++D': LL (  j!rc vaa\SP44pVP4VPR4P R4\ P !VP4p\R.4o\P!VS4pSPVS4pVV3RlpVPV4V#)z If a request is made which encounters a L{File} before a final segment which names a file in the path the L{File} was created with, that file is served as the response to the request. rrfoo.barc<SPRPSP4R4SPSPP R4^,R4R#rrr$s&r(r)3StaticFileTests.test_staticFile..cbRenderedBrr r rRrnrrrarrQrbrrrorr.rpsf @r(test_staticFileStaticFileTests.test_staticFile2s  &  9((0{{499% |,++D': LL (  j!rz>Cannot write unicode filenames with file system encoding of {}c aaaRpRo\SP44pVP4VPV4P S4\ P !VP4p\VPR4.4o\P!VS4pSPVS4pVVV3RlpVPV4V#)z` A request for a existing unicode file path encoded as UTF-8 returns the contents of that file. uῆscontentutf-8c <SPRPSP4S4SPSPP R4^,\ \ \S4444R#)rrN)r!r"r#rrr strrS)r%contentr&r's&r(r)BStaticFileTests.test_staticFileUnicodeFileName..cbRenderedbsY   SXXgoo6 @   ''556GHKc#g,/0 r)r rRrnrrrarrQrbrencoderrorr.) r'namerqrVrrr0r)rr&s f @@r(test_staticFileUnicodeFileName.StaticFileTests.test_staticFileUnicodeFileNameKs= &  4##G,{{499% G 456++D': LL (  j!rc \P!VP44p\R.4pVP RV4pVP W1P 4R#)zy A L{static.File} created for a directory which does not exist should return childNotFound from L{static.File.getChild}. rN)rrQrRrgetChildr! childNotFound)r' staticFiler&rrs& r(test_staticFileDeletedGetChild.StaticFileTests.test_staticFileDeletedGetChildlsJ [[/  |,##J8  8 89rc aaaa\P!SP44p\R.4o\R.4oSP VS4oSP VP S4pVVVV3RlpVP V4V#)zc A L{static.File} created for a file which does not exist should render its C{childNotFound} page. rc:<VVV3RlpSPV4S#)c<SPRPSP4RPSP44R#rr )r%r&request2r's&r(r)UStaticFileTests.test_staticFileDeletedRender..cbRendered2..cbRendereds/  '//!:CHHXEUEU.cbRendered2s X MM* %Hr)rrQrRrrrr.)r'rd2rr0r&rsf @@@r(test_staticFileDeletedRender,StaticFileTests.test_staticFileDeletedRendervst [[/  |, - LLW - \\*22H =   {# rc xaa\VP44pVPR4Ro!V3RlR\P4o!V3RlR\ P 4pV!VP4p\R.4pVPRV4pVPV4pVPSV4R#) z[ The resource rendered for child not found requests can be customize using a class member. rscustom-child-not-found-responsec.<a]tRtRtoV3RltRtVtR#)YStaticFileTests.test_getChildChildNotFound_customize..CustomChildNotFoundResourcerhc<S#rFr9rs&&r(r6`StaticFileTests.test_getChildChildNotFound_customize..CustomChildNotFoundResource.renderrrr9Nrrs@r(CustomChildNotFoundResourcerrrrc(<]tRtRtZ!4tRtR#)NStaticFileTests.test_getChildChildNotFound_customize..CustomStaticFileir9N)r:r;r<r=rr?)rsr(rrs 79Mrrs no-child.txtN) r rRrarrrrQrbrrr6r!) r'rqrrr&rrrrrs & @@r($test_getChildChildNotFound_customize4StaticFileTests.test_getChildChildNotFound_customizes  & ; &(*;*; & :v{{ :( 2 01%%ow?g& 0rc aa\SP44pVPR4\P!VP 4p\ R.4oRSn\VS4pVV3RlpVPV4V#)zL L{static.File.render} returns an empty response body for I{HEAD} requests. rrrc^<SPRPSP4R4R#rr r$s&r(r)4StaticFileTests.test_headRequest..cbRenderedr+r) r rRrarrQrbrr-rr.)r'rbrVr0r)r&sf @r(r1 StaticFileTests.test_headRequestsj  & {{499%u%  D' " = j!rc aa\SP44pVP4VPR4P R4\ P !VP4pR\P/Vn \R.4o\P!VS4pSPVS4pVV3RlpVPV4V#)z If a request is made which encounters a L{File} before a final segment which names a file with an extension which is in the L{File}'s C{processors} mapping, the processor associated with that extension is used to serve the response to the request. rsTfrom twisted.web.static import Data resource = Data(b'dynamic world', 'text/plain') .barrc<SPRPSP4R4SPSPP R4^,R4R#)rs dynamic worldrs13Nrr$s&r(r)3StaticFileTests.test_processors..cbRenderedsK   SXXgoo68H I   ''556GHKU r)r rRrnrrrarrQrbrResourceScript processorsrrrorr.rpsf @r(test_processorsStaticFileTests.test_processorss &  9(( A {{499%!6#8#89 |,++D': LL (  j!rc V\P!R4pVPVP.4VP R4VP R4VPVPRR.4\P!RRR7pVPVPRR.4R#)zy The list of ignored extensions can be set by passing a value to L{File.__init__} or by calling L{File.ignoreExt} later. rz.foor.bazrKN)rr)rrQr!rL ignoreExt)r'rVs& r(test_ignoreExtStaticFileTests.test_ignoreExts {{4  ))2. v v ))FF+;<{{4-=> ))FF+;} file in the path the L{File} was created with if such a file exists and the L{File} has been configured to ignore the I{} extension. rrzfoo.quuxrerKrc^<SPRPSP4R4R#)rrNr r$s&r(r)AStaticFileTests.test_ignoredExtensionsIgnored..cbRendereds   SXXgoo6 ?r)rrrpsf @r(test_ignoredExtensionsIgnored-StaticFileTests.test_ignoredExtensionsIgnoreds &  9((0 :)))4{{499)<x(++D': LL ( @ j!rc \VP44pVP4VPR4P4\P !VP 4p\R.4pRVn\P!W#4pVPVPWC44VPVP\4VPVP P#R4R.4R#)z A request for a path which is a directory but does not have a trailing slash will be redirected to a URL which does have a slash by L{File}. foldersfoldershttp://dummy/folder#baz?foo=barslocations http://dummy/folder/#baz?foo=barN)r rRrnrrrrQrbrurirrosuccessResultOfrr!rjrrrrxs& r(+test_directoryWithoutTrailingSlashRedirects;StaticFileTests.test_directoryWithoutTrailingSlashRedirectss  &  8%%'{{499% {+8 ++D: T\\%9: --u5   # # 1 1+ > 0 1 rc a\4o\VP44pVP4\P !VP 4pV3RlVnSV3#)z Create a L{File} that when opened for reading, returns a L{StringIO}. @return: 2-tuple of the opened "file" and the L{File}. @rtype: L{tuple} c<S#rFr9)fakeFilesr(;StaticFileTests._makeFilePathWithStringIO..sHr)StringIOr rRtouchrrQrbr~)r'rbrVrs& @r(_makeFilePathWithStringIO)StaticFileTests._makeFilePathWithStringIOsH: & {{499%$ ~rc VP4wr\R.4pRVnVP\ W#44VP RP VP4R4VPVP4R#)zU A HEAD request opens the file, gets the size, and then closes it after the request. rrrN) rrr-rrr!r"r# assertTrueclosedr'rrVr&s& r(test_HEADClosesFile#StaticFileTests.test_HEADClosesFilesg 779t$  WT34 '//2C8 (rc VP4wr\R.4pRVnRVnVP \ W#44VP RPVP4R4VPVP4R#)zA A GET request that is cached closes the file after the request. rsGETc"\P#rF)r CACHED)_s&r(r>StaticFileTests.test_cachedRequestClosesFile..1sDKKrrN) rrr-setLastModifiedrrr!r"r#r!r"r#s& r(test_cachedRequestClosesFile,StaticFileTests.test_cachedRequestClosesFile)so779t$"7 WT34 '//2C8 (rr9N)rmcbs))r:r;r<r=r>rrWr[r^r7rsryrrrr isWindowsrrrrrrsysgetfilesystemencodinglowerformatrrrrr1rr rrrr$r,r?r@rAs@r(rDrD?s* 1 1 1 C* 0/.* H   "LMN.0W 1662  !!#))+3DD fS..01   8:*10$< =0 *  ) ) )rrDca]tRtRtoRtRRltRtRtRtRt R t R t R t R t R tRtRtRtRtRtRtRtRtRtRtVtR#)StaticMakeProducerTestsi7z! Tests for L{File.makeProducer}. Nc \VP44pVPV4\P!VP 44pW5nW%nV#)z Make a L{static.File} resource that has C{content} for its content. @param content: The L{bytes} to use as the contents of the resource. @param type: Optional value for the content type of the resource. )r rRrarrQ _asBytesPathencodingtype)r'rr9r8fileNamers&&&& r(makeResourceWithContent/StaticMakeProducerTests.makeResourceWithContent<sIDKKM*G$;;x4467$ rc /pVPP4FEwr4VP4PR4'gK,V^,W#P4&KG V#)z Extract the content-* headers from the L{DummyRequest} C{request}. This returns the subset of C{request.outgoingHeaders} of headers that start with 'content-'. scontent-)rgetAllRawHeadersr2 startswith)r'r&contentHeaderskvs&& r(r@&StaticMakeProducerTests.contentHeadersJsU++<<>DAwwy##K00,-aDwwy)?rc VPR4p\.4pVP!4;_uu_4pVP!W#4pVP V\ P 4RRR4R# +'giR#;i)zX makeProducer when no Range header is set returns an instance of NoRangeStaticProducer. rN)r;rr makeProducerrvrNoRangeStaticProducer)r'rr&rVproducers& r(,test_noRangeHeaderGivesNoRangeStaticProducerDStaticMakeProducerTests.test_noRangeHeaderGivesNoRangeStaticProducerWsd //4r"  $ $ & &$,,W;H  ! !(F,H,H I' & & &s 3A33 B c "VPR4p\.4pVP!4;_uu_4pVP!W#4VP \ P VP4RRR4R# +'giR#;i)zX makeProducer when no Range header is set sets the responseCode on the request to 'OK'. rN)r;rrrEr!r OKrj)r'rr&rVs& r(test_noRangeHeaderSets200OK3StaticMakeProducerTests.test_noRangeHeaderSets200OKbsf //4r"  $ $ & &$  ! !' 0   TWWg&:&: ;' & & &s =A== B c  n^{pRpRpVPRV,W#R7p\.4pVP!4;_uu_4pVP!WV4VP R\ V4RRV3,R\ V4/VP V44R R R 4R # +'giR #;i) zW makeProducer when no Range header is set sets the Content-* headers for the response. text/plaingzipar9r8 content-typer%dcontent-encodingN)r;rrrEr!r r@)r'length contentTypecontentEncodingrr&rVs& r($test_noRangeHeaderSetsContentHeaders:K+L  MM/> :(9K  # #E{S    0. A3' & & &s C.E  E c F\.4pVPPRR4VPR4pVP!4;_uu_4pVP !W4pVP V\P4RRR4R# +'giR#;i)z makeProducer still returns an instance of L{SingleRangeStaticProducer} when the Range header requests multiple ranges, none of which are satisfiable. r\bytes=10-12,15-20ruNrrcs& r(Btest_multipleUnsatisfiableRangesReturnsMultipleRangeStaticProducerZStaticMakeProducerTests.test_multipleUnsatisfiableRangesReturnsMultipleRangeStaticProducer1s{ r"++H6JK//7  $ $ & &$,,W;H  ! !(F,N,N O' & & &rfc Z\.4pVPPRR4VPR4pVP!4;_uu_4pVP !W4VP \PVP4RRR4R# +'giR#;i)z makeProducer sets the response code of the request to of 'Requested Range Not Satisfiable' when the Range header requests multiple ranges, none of which are satisfiable. r\rruNryrjs& r(Btest_multipleUnsatisfiableRangesSets416ReqestedRangeNotSatisfiableZStaticMakeProducerTests.test_multipleUnsatisfiableRangesSets416ReqestedRangeNotSatisfiable>s r"++H6JK//7  $ $ & &$  ! !' 0   TAA7CWCW X' & & &rmc  \.4pVPPRR4RpVPPRR4VPRVR7pVP!4;_uu_4pVP !W4VP RRR R R R /VPV44R R R 4R # +'giR #;i)z makeProducer when the Range header requests multiple ranges, none of which are satisfiable, sets the Content-* headers appropriately. r\rtrOrrur~rrrprrSrNrrs& r(1test_multipleUnsatisfiableRangeSetsContentHeadersIStaticMakeProducerTests.test_multipleUnsatisfiableRangeSetsContentHeadersKs r"++HmD" ++H6JK//[/I  $ $ & &$  ! !' 0   %t$l#] ##G,  ' & & &s 2:B66 C c Z\.4pVPPRR4VPR4pVP!4;_uu_4pVP !W4VP \PVP4RRR4R# +'giR#;i)z makeProducer when the Range header requests multiple ranges, at least one of which matches, sets the response code to 'Partial Content'. r\sbytes=1-3,100-200r^Nrhrjs& r( test_oneSatisfiableRangeIsEnough8StaticMakeProducerTests.test_oneSatisfiableRangeIsEnough`s r"++H6JK// :  $ $ & &$  ! !' 0   T1173G3G H' & & &rmr9)NN)r:r;r<r=r>r;r@rHrLrYrdrkrqrvr{rrrrrrrrrr?r@rAs@r(r5r57s{   J <. N I0 N Y(( P I!BF P Y* I Irr5c0a]tRtRtoRtRtRtRtVtR#)StaticProducerTestsimz+ Tests for the abstract L{StaticProducer}. c \4p\P!RV4pVP4VP VP 4R#)z] L{StaticProducer.stopProducing} closes the file object the producer is producing data from. N)rrStaticProducer stopProducingr!r"r' fileObjectrGs& r(test_stopProducingClosesFile0StaticProducerTests.test_stopProducingClosesFilers; Z ((z:   ))*rc \4p\P!\.4V4pVP 4VP RVP 4R#)z L{StaticProducer.stopProducing} sets the request instance variable to None, which indicates to subclasses' resumeProducing methods that no more data should be produced. N)rrrrrassertIdenticalr&rs& r(#test_stopProducingSetsRequestToNone7StaticProducerTests.test_stopProducingSetsRequestToNone|sD Z ((b)9:F  T8#3#34rr9N) r:r;r<r=r>rrr?r@rAs@r(rrms+ 5 5rrc<a]tRtRtoRtRtRtRtRtRt Vt R#) NoRangeStaticProducerTestsiz% Tests for L{NoRangeStaticProducer}. c d\\P\P!RR44R#)z7 L{NoRangeStaticProducer} implements L{IPullProducer}. N)rr IPullProducerrrFrs&r(test_implementsIPullProducer7NoRangeStaticProducerTests.test_implementsIPullProducers" Z--v/K/KDRV/WXrc \.4pRp\P!V\V44pVP 4VP VRP VP44R#)z[ L{NoRangeStaticProducer.resumeProducing} writes content from the resource to the request. r^rN)rrrFrstartr!r"r#r'r&rrGs& r(#test_resumeProducingProducesContent>NoRangeStaticProducerTests.test_resumeProducingProducesContentsS r"//'9JK  #((7??";rrrrr?r@rAs@r(rrs$Y =4( / /rrc<a]tRtRtoRtRtRtRtRtRt Vt R#) SingleRangeStaticProducerTestsiz) Tests for L{SingleRangeStaticProducer}. c  h\\P\P!RRRR44R#)z; L{SingleRangeStaticProducer} implements L{IPullProducer}. N)rrrrrbrs&r(r;SingleRangeStaticProducerTests.test_implementsIPullProducers)   $ $  , ,T4t D rc \.4pRp\P!V\V4^^4pVP 4VP VR,RP VP44R#)z L{SingleRangeStaticProducer.resumeProducing} writes the given amount of content, starting at the given offset, from the resource to the request. r^:NrN)rrrbrrr!r"r#rs& r(rBSingleRangeStaticProducerTests.test_resumeProducingProducesContents] r"33GXg=NPQSTU  sxx'@Arc F\.4p\PPpRV,p\P !V\ V4^V^ ,4pVP4V^V^,W2^,V^ ,.pVPWQP4R#)z L{SingleRangeStaticProducer.start} writes at most C{abstract.FileDescriptor.bufferSize} bytes of content from the resource to the request at once. ruN) rrrrrrbrrr!r#rs& r(r@SingleRangeStaticProducerTests.test_resumeProducingBuffersOutputs r",,77 :%33 Xg&:?   A Q ' NZ"_ 5  ??3rc \.4pVP4p.pVPVP4\P !V\ R4^^4pVP4VPR.V4R#)zp L{SingleRangeStaticProducer.resumeProducing} calls finish() on the request after it is done producing content. r^N) rrr.rrrbrrr!rs& r(r8SingleRangeStaticProducerTests.test_finishCalledWhenDonesp r" --/ ""<#6#6733GXi=PRSUVW  $.rr9NrrAs@r(rrs$  B4* / /rrc<a]tRtRtoRtRtRtRtRtRt Vt R#) MultipleRangeStaticProducerTestsiz+ Tests for L{MultipleRangeStaticProducer}. c f\\P\P!RRR44R#)z= L{MultipleRangeStaticProducer} implements L{IPullProducer}. N)rrrrrrs&r(r=MultipleRangeStaticProducerTests.test_implementsIPullProducer s'   $ $  . .tT4 @ rc \.4pRp\P!V\V4RR.4pVP 4VP RRP VP44R#)z L{MultipleRangeStaticProducer.resumeProducing} writes the requested chunks of content from the resource to the request, with the supplied boundaries in between each chunk. r^s1bcd2frN)rr)2r)rrrrrr!r"r#rs& r(rDMultipleRangeStaticProducerTests.test_resumeProducingProducesContents] r"55 Xg&|(D   CHHW__$=>rc 4\.4pRp\P!V\V4.R O4p^ VnVP 4RVR,,R,VR,,VR,R,.pVP WAP4R#) aB L{MultipleRangeStaticProducer.start} writes about C{abstract.FileDescriptor.bufferSize} bytes of content from the resource to the request at once. To be specific about the 'about' above: it can write slightly more, for example in the case where the first boundary plus the first chunk is less than C{bufferSize} but first boundary plus the first chunk plus the second boundary is more, but this is unimportant as in practice the boundaries are fairly small. On the other side, it is important for performance to bundle up several small chunks into one call to request.write. rQbc:N:r N:rNNs01234567890123456789))rQrr)rr )rrr)rrrrrrr!r#)r'r&rrGrs& r(rBMultipleRangeStaticProducerTests.test_resumeProducingBuffersOutput#sr"#55 Xg&(S !  73< $ & 6 ENT !  ??3rc \.4pVP4p.pVPVP4\P !V\ R4R.4pVP4VPR.V4R#)zr L{MultipleRangeStaticProducer.resumeProducing} calls finish() on the request after it is done producing content. r^N)rrr) rrr.rrrrrr!rs& r(r:MultipleRangeStaticProducerTests.test_finishCalledWhenDone@sq r" --/ ""<#6#6755 Xi(;-   $.rr9NrrAs@r(rrs# ? 4://rrca]tRtRtoRtRtRtRtRtRt Rt R t R t R t R tR tRtRtRtRtRtRtRtRtRtRtRtVtR#) RangeTestsiRa Tests for I{Range-Header} support in L{twisted.web.static.File}. @type file: L{file} @ivar file: Temporary (binary) file containing the content to be served. @type resource: L{static.File} @ivar resource: A leaf web resource using C{file} as content. @type request: L{DummyRequest} @ivar request: A fake request, requesting C{resource}. @type catcher: L{list} @ivar catcher: List which gathers all log information. c \VP44pRVnVPVP4VP 4Vn\ P!VP P4Vn ^VPn \R.4Vn VP PVPn .Vn\P !VPP"4R#)z Create a temporary file with a fixed payload of 64 bytes. Create a resource for that file and create a request which will be for that resource. Each test can set a different range header to test different aspects of the implementation. s@uE7a0y0S﬷M6k{  мkYI oZbk&%݂q/AYrN)r rRpayloadrar~rVrrQrrisLeafrr&rcatcherr addObserverr)r'rbs& r(setUpRangeTests.setUpcs & *  %IIK  DIINN3   #SE* 99>>    ++,rc VPP4\P!VPP 4R#)z2 Clean up the resource file and the log observer. N)rVrrremoveObserverrrrs&r(tearDownRangeTests.tearDowns*  4<<../rc VPP4pVPVR,^,V4VPVP.RV: 24R#)zE Asserts that a given log message occurred with an expected message. messagezAn additional log occurred: N)rpopr!)r'rlogItems&& r( _assertLoggedRangeTests._assertLoggedsN,,""$ +A.9 r-I'+UVrc tVPPpVP\VR4VP\VR4VP\VR4VP\VR4VP\VR4VP\VR4VP\VR4R#) z_ L{File._parseRangeHeader} raises L{ValueError} when passed syntactically invalid byte ranges. sbytess unknown=1-2sbytes=3sbytes=-s bytes=foo-s bytes=-foos bytes=5-4N)r_parseRangeHeaderr5 ValueError)r'fs& r(test_invalidRangesRangeTests.test_invalidRangess MM + + *a2 *a8 *a4 *a4 *a7 *a7 *a6rc ^VPVPPR4R.4R#)zz A single bytes range without an explicit stop position is parsed into a two-tuple giving the start position and L{None}. sbytes=0-N)rNr!rr rs&r(test_rangeMissingStop RangeTests.test_rangeMissingStop% 88E {Src ^VPVPPR4R.4R#)zu A single bytes range without an explicit start position is parsed into a two-tuple of L{None} and the end position. sbytes=-3N)Nrrrs&r(test_rangeMissingStart!RangeTests.test_rangeMissingStartrrc ^VPVPPR4R.4R#)zl A single bytes range with explicit start and stop positions is parsed into a two-tuple of those positions. s bytes=2-5N)rrrrs&r( test_rangeRangeTests.test_ranges% 88FQrc VPVPPR4R.4VPVPPR4R.4VPVPPR4R.4VPVPPR4R.4VPVPPR4R.4VPVPPR4R.4R#) zy A single bytes range with whitespace in allowed places is parsed in the same way as it would be without the whitespace. s bytes=1-2 s bytes =1-2 s bytes= 1-2s bytes=1 -2s bytes=1- 2s bytes=1-2 Nrrrrs&r(test_rangeWithSpaceRangeTests.test_rangeWithSpaces 88H6(S 88H6(S 88G&R 88G&R 88G&R 88G&Rrc ^VPVPPR4R.4R#)z{ If there are multiple byte ranges but only one is non-null, the non-null range is parsed and its start and stop returned. sbytes=1-2, , , Nrrrs&r(test_nullRangeElements!RangeTests.test_nullRangeElementss)  MM + +,B CfX rc `VPVPPR4RR.4R#)zL If multiple byte ranges are specified their starts and stops are returned. s bytes=1-2,3-4Nr)rrrrs&r(test_multipleRangesRangeTests.test_multipleRangess,  MM + +,< =?O rc VPPPRR4VPP VP4VP \ RPVPP44^,4R#)zX A correct response to a range request is as long as the length of the requested range. r\s bytes=0-43rN) r&r`rarr6r!rSr"r#rs&r(test_bodyLengthRangeTests.test_bodyLengths\ ##00=I T\\* SXXdll&:&:; ?Y6A]aS!: &Y ?  ##009GW;WX T\\* 22D4H4HI88 6 LL ( ( 6 6 G J  %( ''1E1E(FQ YU41LD&1   ]4==+=+=>^@T U#O4 E   SZ +   SXq )   SY (A(A(C D   T\\!!e4d7m D 2 @sI c  FR ^(\VP4^ ,3.pRPVUUu.uFwr#\V RV 24NK upp4pVPP P RRV,4VPPVP4VPVPP\P4\P!RVPPP!R4^,4P#^4pVP%RPVPP&4V4pVP\V4\V44\)Wa4EFwpwr#VP\VPP*4VR,4VR ,wrp VP\-V4V4VP\-V 4\/W0PP14^, 44VP\-V 4VPP144VPVPW#^,VR ,4EK R #uuppi) z The response to a request for multiple bytes ranges is a MIME-ish multipart response, even when one of the ranged falls off the end of the resource. rIrJr\rKrLrSrr/r0r1NrM)rSrr"r r&r`rarr6r!rjr rirrrrr7rFr#rRr9rSminrTrUs & r(0test_multipleRangeRequestWithRangeOverlappingEnd;RangeTests.test_multipleRangeRequestWithRangeOverlappingEnd5s b#dll"3b"89: 995> ?Y6A]aS!: &Y ?  ##009GW;WX T\\* 22D4H4HI88 6 LL ( ( 6 6 G J  %( ''1E1E(FQ YU41LD&1   ]4==+=+=>^@T U#O4 E   SZ +   SXs1mm.G.G.IA.M'N O   SY (A(A(C D   T\\!!e4d7m D 2 @sJ c VPPPRR4VPP VP4VP RP VPP4VPR,4VP \RP VPP44^)4VP VPP\P4VP VPPPR4^,R4VP VPPPR4^,R4R #) z If the end byte position is omitted, then it is treated as if the length of the resource was specified by the end byte position. r\s bytes=23-r:NNrpsbytes 23-63/64rs41Nr&r`rarr6r!r"r#rrSrjr rirrrs&r(test_implicitEndRangeTests.test_implicitEndPs ##00<H T\\* $,,"6"67c9JK SXXdll&:&:;J T\\* 22DGG< $,,"6"67F  LL ( ( 6 67H I! L S&( ( rc  VPPPRR4VPP VP4VP VPP \P4VP RPVPP4R4VP VPPPR4^,R4VP VPPPR4^,\R\VP43,44R#) z If a range is unsatisfiable due to the start not being less than the length of the resource, the response is 416 (Requested range not satisfiable) and no data is written to the response body (RFC 2616, section 14.35.1). r\s bytes=67-108rrrrpz bytes */%dN)r&r`rarr6r!rjr rzr"r#rrr rSrrs&r(test_invalidStartBytePos#RangeTests.test_invalidStartBytePoss ##00?K T\\*  LL % %t'K'K  $,,"6"67=  LL ( ( 6 67H I! Ld   LL ( ( 6 67G H K ,#dll*;)== > r)rrVrr&rN)r:r;r<r=r>rrr rrrrrr!r$r'r+rFrZr^rcrfrlrorrrur?r@rAs@r(rrRs -80W78TTR S  B & DE4E6 $ & ( *    rrca]tRtRtoRtRtRtRtRtRt Rt R t R t R t R t]!]P"!4'*R 4R4tRtRtRtRtVtR#)DirectoryListerTestsiz& Tests for L{static.DirectoryLister}. c*\R.4pWnV#)r)rr)r'rr&s&& r(_requestDirectoryListerTests._requestsu% rc \VP44pVP4\P!VP 4pVP VPR44pVPRV4VPRV4R#)zU L{static.DirectoryLister} prints the request uri as header of the rendered content. rs"

Directory listing for foo

s(Directory listing for fooN r rRrnrrwrbr6rzrr'rblisterr/s& r(test_renderHeader&DirectoryListerTests.test_renderHeadersf  & '' 2}}T]]623 ;TB A4Hrc \VP44pVP4\P!VP 4pVP VPR44pVPRV4VPRV4R#)zG L{static.DirectoryLister} unquote the request uri before printing it. s foo%20bars&

Directory listing for foo bar

s,Directory listing for foo barNr}r~s& r(test_renderUnquoteHeader-DirectoryListerTests.test_renderUnquoteHeadersf & '' 2}}T]]<89 ?F EtLrc \VP44pVP4\P!VP 4pVP VPR44pVPRV4VPRV4R#)zT L{static.DirectoryLister} escape "&", "<" and ">" after unquoting the request uri. s foo%26bars*

Directory listing for foo&bar

s0Directory listing for foo&barNr}r~s& r(test_escapeHeader&DirectoryListerTests.test_escapeHeadersf  & '' 2}}T]]<89 CTJ I4Prc \VP44pVP4VPR4P R4VPR4P RR,4\ P !VP4pVPVPR44pRpVPWC4R#) zM L{static.DirectoryLister} is able to list all the files inside a directory. file1scontent1file2scontent2irs file1 8B [text/html] file2 7K [text/html] N) r rRrnrrrarrwrbr6rzrr'rbrr/r9s& r(test_renderFiles%DirectoryListerTests.test_renderFiless  &  7&&{3 7&&{T'9:'' 2}}T]]623   d!rc z\VP44pVP4VPR4P4VPR4P4\P !VP 4pVPVPR44pRpVPWC4R#)zS L{static.DirectoryLister} is able to list all the directories inside a directory. dir1zdir2 & 3rs dir1/ [Directory] dir2 & 3/ [Directory] N r rRrnrrrrwrbr6rzrrs& r(test_renderDirectories+DirectoryListerTests.test_renderDirectoriess  &  6##% :'')'' 2}}T]]623   d!rc \VP44pVP4VPR4P4VPR4P4VPR4P4\P !VP RR.R7pVPVPR44pRpVPWC4R#)zy L{static.DirectoryLister} takes an optional C{dirs} argument that filter out the list of directories and files printed. rdir2dir3)dirsrs dir1/ [Directory] dir3/ [Directory] Nrrs& r(test_renderFiltered(DirectoryListerTests.test_renderFiltered(s  &  6##% 6##% 6##%'' 8HI}}T]]623   d!rc  b\P!R4p\^4Uu.uFpRRRRRRRRRR/NK ppVPV4pVP \ V4^4VP V^,PR44VP V^,PR 44VP V^,PR44VP V^,PR 44VP V^,PR44R#uupi) z] L{static.DirectoryLister} gives an alternate class for each odd and even rows in the table. Nhrefrtextrr9r8zz)rrwr*_buildTableContentr!rSr!r?)r'rielementsrs& r(test_oddAndEven$DirectoryListerTests.test_oddAndEvenBs ''-1X RVRZ L  ++H5 Wq)  --.@AB  --.ABC  --.@AB  --.ABC  --.@AB sD,c @\VP44pVP4\P!VP 4pVP R4pVPV4VPVPPR4^,R4R#)zr L{static.DirectoryLister} produces a MIME-type that indicates that it is HTML, and includes its charset (UTF-8). rrSstext/html; charset=utf-8N) r rRrnrrwrbrzr6r!rr)r'rbrreqs& r(test_contentType%DirectoryListerTests.test_contentTypeUsu  & '' 2mmC  c     - -o >q A ' rc \VP44pVP4VPR4P R4VPR4P R4VPR4P R4VPR4P R4\ P !VP4pVP4R R R R R RRR/p\P!VPVR7pVPV4wrVVPV.4VPVRRRRRRRRRR/RRRRRRRRRR/RRRRRRRRRR/RRRRRRRRRR /.4R!#)"zT L{static.DirectoryLister} is able to detect mimetype and encoding of listed files. z file1.txtfile1zfile2.pyspythonz file3.conf.gzsconf compressedzfile4.diff.bz2sdiff compressedz.txtrOz.pyz text/pythonz.confztext/configurationz.diffz text/diff) contentTypesr8rrr5Brr9z [text/plain]6Bz [text/python]z[gzip]15Bz[text/configuration]z[bzip2]z [text/diff]N) r rRrnrrraoslistdirrbsortrrw_getFilesAndDirectoriesr!)r'rb directoryrrrfiless& r(test_mimeTypeAndEncodings.DirectoryListerTests.test_mimeTypeAndEncodingsds  &  ;**84 :)))4 ?#../AB #$//0BCJJtyy)  L = ) [  '' M44Y?  r"  KDKN JDJO OEO2  ,E,M -  rzNo symlink supportc \VP44pVP4VPR4pVP R4VP VPR44VP 4\P!VP4p\P!VP4pVP4VPV4wrVVPV.4VPV.4R#)z If on the file in the listing points to a broken symlink, it should not be returned by L{static.DirectoryLister._getFilesAndDirectories}. rrrN)r rRrnrrralinkToremoverrwrbrrrrr!)r'rbrrrrrs& r(test_brokenSymlink'DirectoryListerTests.test_brokenSymlinks  &  7# " TZZ() '' 2JJtyy) 44Y?  r" #rc 4aa\SP44pVP4\P!VP 4pSP R4o\P!VS4p\VS4pVV3RlpVPV4V#)z] Any child resource of L{static.DirectoryLister} renders an HTTP I{NOT FOUND} response code. rc\<SPSP\P4R#rF)r!rjr NOT_FOUNDr$s&r(r)>DirectoryListerTests.test_childrenNotFound..cbRendereds   W114>> Br) r rRrnrrwrbrzrrorr.)r'rbrrrrr)r&sf @r(test_childrenNotFound*DirectoryListerTests.test_childrenNotFoundsy  & '' 2--$++FG<( C :& rc \VP44p\P!VP4pVP \ V4RVP: R24VP \V4RVP: R24R#)zB L{static.DirectoryLister.__repr__} gives the path of the lister. zN)r rRrrwrbr!reprr)r'rbrs& r( test_reprDirectoryListerTests.test_reprsl &'' 2 f)=dii]!'LM V( ..z:DA ..}=wGrr9N)r:r;r<r=r>rzrrrrrrrrrrr _supportsSymlinksrrrrr?r@rAs@r(rxrxs I M Q"4"4"4C&  8 t **, ,.BC$D$&$M H HrrxcPa]tRtRtoRt]!4tRtRtRt Rt Rt Rt Vt R #) LoadMimeTypesTestsiz Tests for the MIME type loading routine. @cvar UNSET: A sentinel to signify that C{self.paths} has not been set by the mock init. c(VPVnR#rF)UNSETpathsrs&r(rLoadMimeTypesTests.setUps ZZ rc WnR#)z A mock L{mimetypes.init} that records the value of the passed C{paths} argument. @param paths: The paths that will be recorded. Nrr'rs&&r( _fakeInitLoadMimeTypesTests._fakeInits  rc \P!VPR7VPVPR4R#)z5 By default, L{None} is passed to C{mimetypes.init}. initNr loadMimeTypesrrrrs&r(test_defaultArgumentIsNone-LoadMimeTypesTests.test_defaultArgumentIsNones* $..1 TZZ.rc .ROp\P!WPR7VPVPV4R#)z9 Passed MIME type files are passed to C{mimetypes.init}. rN)xyzrrs& r(test_extraLocationsWork*LoadMimeTypesTests.test_extraLocationsWorks/ U8 TZZ/rc \\RR4'db\P!\P4pVP VP R,P\P4R#\P!\P4wpr4WBPR4,pVP V\P4R#)z* By default, C{mimetypes.init} is called. signatureNr) getattrinspectrrrassertIs parametersdefault mimetypesr getargspecindex)r'rargsr)defaults defaultInits& r(test_usesGlobalInitFunction.LoadMimeTypesTests.test_usesGlobalInitFunctions 7K . .))&*>*>?I MM)..v6>>  O#*#5#5f6J6J#K D!Q"::f#56K MM+y~~ 6rrN)r:r;r<r=r>objectrrrrrrr?r@rAs@r(rrs1 HE /0 7 7rrc&a]tRtRtoRtRtVtR#)StaticDeprecationTestsic ^RIHpV!\R.44VPVP.4pVP \ V4^4VP V^,R,R4R#)z/ L{twisted.web.static.addSlash} is deprecated. )addSlashrrzrrrrrr0rOiorrunittestrzope.interface.verifyrtwisted.internetrrtwisted.pythonrrtwisted.python.compatr twisted.python.filepathr twisted.python.runtimer twisted.trial.unittestr twisted.webr rrrtwisted.web._responsesrtwisted.web.serverrtwisted.web.test._utilrtwisted.web.test.requesthelperrrrDr5rrrrrrxrrr9rr(r s  ".1&/,++66(0*7ChC>u)hu)psIhsIl 5(569/9/x>/X>/BJ/xJ/Zo o d SH8SHl2727j X r