+ jlRt^RIt^RIt^RIt^RIt^RIHt^RIHtHt^RI H t ^RI H t ^RIHt^RIHtHtHtHtHtHtHtHtHtHtHtHt^RIHt^R I H!t!^R I"H#t#^R I$H%t%^R I&H't'!R R4t(!RR]'4t)!RR]'4t*!RR]%]'4t+!RR]'4t,Rt-Rt.!RR]'4t/]!] !R^^^44!RR44t0!RR4t1]!] !R^^^4R 4R*R!l4t2!R"R#]'4t3!R$R%]'4t4!R&R']'4t5!R(R)]'4t6R# ] dRt EL i;i)+zI Tests for Twisted's deprecation framework, L{twisted.python.deprecate}. N)normcase)catch_warnings simplefilter)invalidate_caches)Version) deprecate) DEPRECATION_WARNING_FORMAT_appendToDocstring_fullyQualifiedName_getDeprecationDocstring_getDeprecationWarningString_mutuallyExclusiveArguments_passedArgSpec_passedSignature deprecateddeprecatedKeywordParameterdeprecatedPropertygetDeprecationWarningString)FilePath)platform)deprecatedattributes)TwistedModulesMixin)SynchronousTestCasec0a]tRt^1toRtRtRtRtVtR#)_MockDeprecatedAttributeze Mock of L{twisted.python.deprecate._DeprecatedAttribute}. @ivar value: The value of the attribute. cWnR#Nvalueselfrs&&D/usr/lib/python3/dist-packages/twisted/python/test/test_deprecate.py__init__!_MockDeprecatedAttribute.__init__8s c VP#)z Get a known value. rr s&r!get_MockDeprecatedAttribute.get;szzr$rN) __name__ __module__ __qualname____firstlineno____doc__r"r'__static_attributes____classdictcell__ __classdict__s@r!rr1s r$rcHa]tRt^BtoRtRtRtRtRtRt Rt Rt Vt R #) ModuleProxyTestsz Tests for L{twisted.python.deprecate._ModuleProxy}, which proxies access to module-level attributes, intercepting access to deprecated attributes and passing through access to normal attributes. c \P!R4pVP4Fwr4\W#V4K \P !V4#)z Create a temporary module proxy object. @param **kw: Attributes to initialise on the temporary module object @rtype: L{twistd.python.deprecate._ModuleProxy} foo)types ModuleTypeitemssetattrr _ModuleProxy)r attrsmodkeyrs&, r! _makeProxyModuleProxyTests._makeProxyIsAu%++-JC Ce $(%%c**r$c VPRR7pVPVPR4VP\\ VR4R#)z Getting a normal attribute on a L{twisted.python.deprecate._ModuleProxy} retrieves the underlying attribute's value, and raises C{AttributeError} if a non-existent attribute is accessed. hello)SOME_ATTRIBUTEDOES_NOT_EXISTN)r>assertIsrB assertRaisesAttributeErrorgetattrr proxys& r!test_getattrPassthrough(ModuleProxyTests.test_getattrPassthroughVs= w7 e**G4 .'5:JKr$c VP4p\PVR4p\^*4VR&VP VP ^*4R#)z Getting an attribute marked as being deprecated on L{twisted.python.deprecate._ModuleProxy} results in calling the deprecated wrapper's C{get} method. _deprecatedAttributesr5N)r>object__getattribute__r assertEqualr5)r rIrMs& r!test_getattrIntercept&ModuleProxyTests.test_getattrIntercept`sH ! & 7 7?V W'?'Ce$ B'r$c VP4pVP\\VR4VP\\VR4R#)zx Private attributes of L{twisted.python.deprecate._ModuleProxy} are inaccessible when regular attribute access is used. _modulerMN)r>rErFrGrHs& r!test_privateAttributes'ModuleProxyTests.test_privateAttributesks9 ! .'5)D .'5:QRr$c VP4p^VnVP\P VR4^4VP VP^4R#)zl Setting attributes on L{twisted.python.deprecate._ModuleProxy} proxies them through to the wrapped module. rTN)r>rTassertNotEqualrNrOrPrHs& r! test_setattrModuleProxyTests.test_setattrtsH !  F33E9EqI *r$c VP4p\PVR4pVP\ V4R\ V4P RV: R24R#)z L{twisted.python.deprecated._ModuleProxy.__repr__} produces a string containing the proxy type and a representation of the wrapped module object. rTN)r>rNrOrPreprtyper))r rI realModules& r! test_reprModuleProxyTests.test_repr~sQ !,,UI>  e$u+*>*>)?x ~UV&WXr$N) r)r*r+r,r-r>rJrQrUrYrar.r/r0s@r!r3r3Bs1 +L (S+YYr$r3cBa]tRt^toRtRtRtRtRtRt Rt Vt R#) DeprecatedAttributeTestsz Tests for L{twisted.python.deprecate._DeprecatedAttribute} and L{twisted.python.deprecate.deprecatedModuleAttribute}, which issue warnings for deprecated module-level attributes. c~\PVn\PVn\R,VnR#)z.fooN)rversionmessager)_testModuleNamer&s&r!setUpDeprecatedAttributeTests.setUps)+33 +33 '&0r$c \\PR,V,\P\R,\P ,4#)z: Create the warning string used by deprecated attributes. .z: )r rr)rgrrh)r attrs&&r!_getWarningString*DeprecatedAttributeTests._getWarningStringsA, ) )C /$ 6 ( ( & -0D0L0L L  r$c aRp\\V^*4\P!\WPVP 4oVP SPV4V3RlpV!4VPVP.4pVPV^,R,\4VP V^,R,VPV44VP \V4^4R#)z L{twisted.python.deprecate._DeprecatedAttribute} correctly sets its __name__ to match that of the deprecated attribute and emits a warning when the original attribute value is accessed. ANOTHER_DEPRECATED_ATTRIBUTEc(<SP4R#r)r')rnsr! addStackLevelNDeprecatedAttributeTests.test_deprecatedAttributeHelper..addStackLevels HHJr$categoryrhN)r9rr_DeprecatedAttributergrhrPr) flushWarningstest_deprecatedAttributeHelperrDDeprecationWarningrolen)r namert warningsShownrns& @r!ry7DeprecatedAttributeTests.test_deprecatedAttributeHelpers .$dB/-- $ dll  -  **D,O,O+PQ  mA&z24FG q))4d6L6LT6RS ]+Q/r$c \PVPVP.4pVP \ V4^4Rp\ \V4VPVP.4pVP \ V4^4VPV^,R,\4VP V^,R,VPV44R#)z L{twisted.python.deprecate.deprecatedModuleAttribute} wraps a module-level attribute in an object that emits a deprecation warning when it is accessed the first time only, while leaving other unrelated attributes alone. DEPRECATED_ATTRIBUTErvrhN) rANOTHER_ATTRIBUTErxtest_deprecatedAttributerPr{rGrDrzro)r r}r|s& r!r1DeprecatedAttributeTests.test_deprecatedAttributes ..**D,I,I+JK  ]+Q/% $d+**D,I,I+JK  ]+Q/ mA&z24FG q))4d6L6LT6RSr$c \P!R4;\PVP&pVP \PP VP4\VR^4\VR^4\P!\R^^^4RVPR4\PVP,pVPW!4\P!\R^^^4RVPR4VPV\PVP,4R#)z Deprecating an attribute in a module replaces and wraps that module instance, in C{sys.modules}, with a L{twisted.python.deprecate._ModuleProxy} instance but only if it hasn't already been wrapped. r5firstsecondTwistedrhN) r6r7sysmodulesri addCleanuppopr9rdeprecatedModuleAttributerrXrD)r r<rIs& r!test_wrappedModule+DeprecatedAttributeTests.test_wrappedModules382B2B52II D(()C  )=)=>Wa Xq!++ Iq!Q 'D4H4H'  D001 E'++ Iq!Q 'D4H4H(  eS[[)=)=>?r$)rirhrgN) r)r*r+r,r-rjroryrrr.r/r0s@r!reres+ 1  04T.@@r$recFa]tRt^toRtRtRtRtRtRt Rt Rt Vt R #) ImportedModuleAttributeTestszU Tests for L{deprecatedModuleAttribute} which involve loading a module via 'import'. zfrom twisted.python.deprecate import deprecatedModuleAttribute from incremental import Version deprecatedModuleAttribute( Version('Package', 1, 2, 3), 'message', __name__, 'module') c naV3Rlo\VP4PR44pVP4S!W!4pVP VP P R4.\P ,4VP\PP44V#)a Create some files in a hierarchy, based on a dictionary describing those files. The resulting hierarchy will be placed onto sys.path for the duration of the test. @param tree: A dictionary representing a directory structure. Keys are strings, representing filenames, dictionary values represent directories, string values represent file contents. @return: another dictionary similar to the input, with file content strings replaced with L{FilePath} objects pointing at where those contents are now stored. c0</pVP4F~wr4VPV4p\V\4'dWRV&VP V4KC\V\ 4'dVP 4S!WT4W#&Ku\R4h V#)z(only strings and dicts allowed as values)r8child isinstancebytes setContentdictcreateDirectory ValueError)pathobjdirdictpathdictr=rr makeSomeFiless&& r!rAImportedModuleAttributeTests.pathEntryTree..makeSomeFilessH%mmo  c*eU++$)SM$$U+t,,))+$1%$?HM$%OPP.Or$utf-8) rmktempencodemakedirsreplaceSysPathpathdecoderreplaceSysModulesrcopy)r treebaseresultrs&& @r! pathEntryTree*ImportedModuleAttributeTests.pathEntryTrees  ,,W56 t* TYY--g67#((BC s{{//12 r$c VPRRVPPR4RR//4pVR,R,#)z Add a sample module and package to the path, returning a L{FilePath} pointing at the module which will be loadable as C{package.module}. spackages __init__.pyr module.pyr$)r _packageInitr)r pathss& r!simpleModuleEntry.ImportedModuleAttributeTests.simpleModuleEntrysN """D$5$5$<$.WarnAboutFunctionTests.setUp..s&!2!2!4ckk6H6H6Q Rr$N)rrrrrrparentrrinsertrremoverrr isWindowsrx)r packagePathrs& @r!rjWarnAboutFunctionTests.setUp`s  .445MN   =)44S9 ;'22  " ;'22  0ll))+00  ;' 5++""$ RS          r$c ^Rp\P!VR4VP4p\pVP 4P R4'dVRRpVP \V^,R,4\V44VPV^,R,R4R#)z L{deprecate.warnAboutFunction} emits a warning the file and line number of which point to the beginning of the implementation of the function passed to it. cR#rrcrcr$r!aFunc2WarnAboutFunctionTests.test_warning..aFunc r$zA Warning Messagez.pycNfilenamerh) rwarnAboutFunctionrxrlowerendswithassertSamePathrrP)r rr}rs& r! test_warning#WarnAboutFunctionTests.test_warnings  ##E+>?**,  >>  $ $V , ,}H H]1%5j%ABHXDVW q))46IJr$c ^RIHpVP4VP4pVP \ V^,R,P R44VPPR4PR44VPV^,R,^ 4VPV^,R,R4VP\V4^4R #) z L{deprecate.warnAboutFunction} emits a C{DeprecationWarning} with the number of a line within the implementation of the function passed to it. rrrtwisted_private_helperrlinenorhA Warning StringN) rrcallTestFunctionrxrrrrsiblingrrPr{r rr}s& r!test_warningLineNumber-WarnAboutFunctionTests.test_warningLineNumbers 2!**,   ]1%j188A B LL !: ; A A, O q)(3Q7 q))46HI ]+Q/r$c ^RIHpVP4VP4pVP \ V^,R,P R44VPPR4PR44VPV^,R,^4VPV^,R,R4VP\V4^4R #) z L{deprecate.warnAboutFunction} emits a C{DeprecationWarning} with the number of a line within the implementation handling the case in which dis.findlinestarts returns the lines in random order. )pep626rrrs pep626.pyrrhrN) rrrrxrrrrrrrPr{)r rr}s& r!'test_warningLineNumberDisFindlinestarts>WarnAboutFunctionTests.test_warningLineNumberDisFindlinestartss 2!**,   ]1%j188A B LL !: ; A A, O q)(3R8 q))46HI ]+Q/r$c VP\VP4\VP48HV: RV: 24R#)z Assert that the two paths are the same, considering case normalization appropriate for the current platform. @type first: L{FilePath} @type second: L{FilePath} @raise C{self.failureType}: If the paths are not the same. z != N) assertTruerr)r rrs&&&r!r%WarnAboutFunctionTests.assertSamePaths8  UZZ HV[[$9 9itF: & r$c ^RIHp\PR\PVPVP P VP PR44\'d \4^RI HpVP\PPR4VP\PPVP4VP4VPVP.4p\V^,R,P!R44pVP PR4P#R4pVP%W44VP'V^,R,^ 4VP'V^,R ,R 4VP'\)V4^4R #) z Even if the implementation of a deprecated function is moved around on the filesystem, the line number in the warning emitted by L{deprecate.warnAboutFunction} points to a line in the implementation of the deprecated function. rrstwisted_renamed_helpertwisted_renamed_helperrrrrrhrN)rrrrr)rmoveTorrrrrrrx testFunctionrrrrrPr{)r rr} warnedPath expectedPaths& r!test_renamedFile'WarnAboutFunctionTests.test_renamedFilesO 2 KK0 1 KK ( DLL001JKL     2  )AB  9!**F,?,?+@A mA.z:AA'JK ||++,EFLL   J5 q)(3Q7 q))46HI ]+Q/r$c \PR\P!RRR7^RIHpVP 4VP 4pVP\V4^4R#)z L{deprecate.warnAboutFunction} emits a warning that will be filtered if L{warnings.filterwarning} is called with the module name of the deprecated function. NNNignoreractionrrN) warningsfiltersfilterwarningsrrrrxrPr{rs& r!test_filteredWarning+WarnAboutFunctionTests.test_filteredWarning sU   Q x8PQ1!**,  ]+Q/r$c \PR\P!RRR7^RIHpVP 4VP 4VP 4pVP\V4^4V^,R,pV^,R,pV^,R,pV^,R ,p\P!W4WV4pVPVPR 4R V: 24R #) z L{deprecate.warnAboutFunction} emits a warning that will be filtered once if L{warnings.filterwarning} is called with the module name of the deprecated function and an action of once. rrrrrrhrvrrz=module.py:9: DeprecationWarning: A Warning String return a zUnexpected warning string: N) rrrrrrrxrPr{ formatwarningrr)r rr}rhrvrrmsgs& r!test_filteredOnceWarning/WarnAboutFunctionTests.test_filteredOnceWarnings   Q x8PQ1!!**,  ]+Q/"9- #J/ #J/q!(+$$WI  LLT *# 1  r$)rN)r)r*r+r,r-rjrrrrrrrr.r/r0s@r!rrZs: ;!zK$0&0(  $0L0(  r$rcR#z? Do nothing. This is used to test the deprecation decorators. Nrcrcr$r! dummyCallabler @r$cR#)zO Do nothing. This is used to test the replacement parameter to L{deprecated}. Nrcrcr$r!dummyReplacementMethodr Hr r$cVa]tRtRtoRtRtRtRtRtRt Rt R t R t R t VtR #) DeprecationWarningsTestsiPc ~\R^^^4pVP\VPV4\: R24R#)z L{getDeprecationWarningString} returns a string that tells us that a callable was deprecated at a certain released version of Twisted. rzZ.DeprecationWarningsTests.test_getDeprecationWarningString was deprecated in Twisted 8.0.0N)rrPr test_getDeprecationWarningStringr)r rgs& r!r9DeprecationWarningsTests.test_getDeprecationWarningStringQs: )Q1-  '(M(Mw W19 < r$c \R^^^4p\R,pVP\VPW4\ : R24R#)z L{getDeprecationWarningString} returns a string that tells us that a callable was deprecated at a certain released version of Twisted, with a message containing additional information about the deprecation. rz: This is a messagezm.DeprecationWarningsTests.test_getDeprecationWarningString was deprecated in Twisted 8.0.0: This is a messageN)rrrPrrr))r rgformats& r!*test_getDeprecationWarningStringWithFormatCDeprecationWarningsTests.test_getDeprecationWarningStringWithFormat]sM )Q1-+.CC  '55w AI K  r$c  ,a\R^^^4p\V4!\4oV3Rlp\RR7;_uu_4p\ R4V!4VP V^,P \4VP \V^,P4\\V44VP V^,PPR4\PR44RRR4R# +'giR#;i)z; Decorating a callable with L{deprecated} emits a warning. rc<S!4R#rrc)dummysr!rtJDeprecationWarningsTests.test_deprecateEmitsWarning..addStackLevelts Gr$TrecordalwayscoN)rrr rrrPrvrzstrrhrrrstripr)r rgrtcaughtrs& @r!test_deprecateEmitsWarning3DeprecationWarningsTests.test_deprecateEmitsWarningms)Q1-7#M2 4 ( (F  " O   VAY//1C D   F1I%%&+M7C    VAY//66tS T) ( ( (s B9D D c \R^^^4p\V4!\4pVP\PVP4VP\ \4\ V44R#)z; The decorated function has the same name as the original. rN)rrr rPr)fullyQualifiedNamer rgrs& r!test_deprecatedPreservesName5DeprecationWarningsTests.test_deprecatedPreservesNamesY)Q1-7#M2 //@ +M:.localDummyCallabler r$rr+N)rrr r rPr-)r r0rgrs& r!test_deprecatedUpdatesDocstring8DeprecationWarningsTests.test_deprecatedUpdatesDocstringsX  )Q1-7#$67-/GQS/TU +33U]]Cr$c \R^^^4p\V4!\4pVPWP4R#)z\ Deprecating a function adds version information to the decorated version of that function. rN)rrr rPdeprecatedVersionr's& r!test_versionMetadata-DeprecationWarningsTests.test_versionMetadatas7 )Q1-7#M2 "9"9:r$c \R^^^4p\VPVRR7pVPV\ VP4: R24R#)z L{getDeprecationWarningString} takes an additional replacement parameter that can be used to add information to the deprecation. If the replacement parameter is a string, it will be interpolated directly into the result. rsomething.foobar replacementzE was deprecated in Twisted 8.0.0; please use something.foobar insteadN)rrrrPr&r rg warningStrings& r!+test_getDeprecationWarningStringReplacementDDeprecationWarningsTests.test_getDeprecationWarningStringReplacementsT)Q1-3  1 1 *  +D,Q,QR U r$c \R^^^4p\VPV\R7pVP V\ VP4: R\ : R24R#)z L{getDeprecationWarningString} takes an additional replacement parameter that can be used to add information to the deprecation. If the replacement parameter is a callable, its fully qualified name will be interpolated into the result. rr:z- was deprecated in Twisted 8.0.0; please use z.dummyReplacementMethod insteadN)rrrr rPr&r)r<s& r!7test_getDeprecationWarningStringReplacementWithCallablePDeprecationWarningsTests.test_getDeprecationWarningStringReplacementWithCallablesX)Q1-3  1 1 .  "$"G"GH( T r$rcN)r)r*r+r,rrr#r(r,r2r6r>rAr.r/r0s@r!rrPs:   U*W D(; &  r$rrc]tRtRtRtRtR#)DeprecatedClassizB Class which is entirely deprecated without having a replacement. rcN)r)r*r+r,r-r.rcr$r!rDrDsr$rDcza]tRtRtoRtRt]!]!R^^^44R4t]PR4tRt Vt R#)ClassWithDeprecatedPropertyiz* Class with a single deprecated property. Nrc VP#)z+ Getter docstring. @return: The property. _someProtectedValuer&s&r! someProperty(ClassWithDeprecatedProperty.somePropertys'''r$c WnR#)z Setter docstring. NrHrs&&r!rJrKs $) r$rH) r)r*r+r,r-rIrrrJsetterr.r/r0s@r!rFrFsN 1a34(5())r$rFr5cR#)z/ Function with a deprecated keyword parameter. Nrc)abcr5bars&&&&&r!functionWithDeprecatedParameterrSr r$cNa]tRtRtoRtRtRtRtRtRt Rt R t R t Vt R #) DeprecatedDecoratorTestsiz" Tests for deprecated decorators. c TPY!PP4Uu.uF*q3P4'gKVP4NK, up4R#uupi)a Check that C{target} object has the C{expected} docstring lines. @param target: Object which is checked. @type target: C{anything} @param expected: List of lines, ignoring empty lines or leading or trailing spaces. @type expected: L{list} or L{str} N)rPr- splitlinesstrip)r targetexpectedrs&&& r!assertDocstring(DeprecatedDecoratorTests.assertDocstringsD  ..*C*C*ES*EQyqwwy*ES Ss A! A! c \4pVPVP\P.RO4\R^^^4\PnRpVP VP .4pVP^\V44VP\V^,R,4VPW#^,R,4R#)z When L{deprecatedProperty} is used on a C{property}, accesses raise a L{DeprecationWarning} and getter docstring is updated to inform the version in which it was deprecated. C{deprecatedVersion} attribute is also set to inform the deprecation version. rktwisted.python.test.test_deprecate.ClassWithDeprecatedProperty.someProperty was deprecated in Twisted 1.2.3rvrhN)zGetter docstring.z@return: The property.Deprecated in Twisted 1.2.3.) rFrJr[rr5rxtest_propertyGetterrPr{rz)r objrhrs& r!r`,DeprecatedDecoratorTests.test_propertyGetters*+   ' 4 4  FM q!QF #00B  ; %%t'?'?&@A CM* +Xa[-DE 1+i"89r$c h\4p\4pWnVPWP4RpVP VP .4pVP^\V44VP\V^,R,4VPW4^,R,4R#)ze When L{deprecatedProperty} is used on a C{property}, setter accesses raise a L{DeprecationWarning}. r^rvrhN) rNrFrJrDrIrxtest_propertySetterrPr{rz)r newValuerarhrs& r!rd,DeprecatedDecoratorTests.test_propertySetter4s 8)+# h 7 78 ; %%t'?'?&@A CM* +Xa[-DE 1+i"89r$c p\4VP\RR.4\R^^^4\nRpVP VP .4pVP ^\V44VP \V^,R,4VP W^,R,4R#)z When L{deprecated} is used on a class, instantiations raise a L{DeprecationWarning} and class's docstring is updated to inform the version in which it was deprecated. C{deprecatedVersion} attribute is also set to inform the deprecation version. z@Class which is entirely deprecated without having a replacement.r_rzRtwisted.python.test.test_deprecate.DeprecatedClass was deprecated in Twisted 1.2.3rvrhN) rDr[rr5rx test_classrPr{rz)r rhrs& r!rh#DeprecatedDecoratorTests.test_classHs   V.  -4Iq!Q,G) . %%t&78 CM* +Xa[-DE 1+i"89r$c \R^^^4p\VR4!\4pVPVPR4R#)z L{deprecated} takes an additional replacement parameter that can be used to indicate the new, non-deprecated method developers should use. If the replacement parameter is a string, it will be interpolated directly into the warning message. rr9z Do nothing. This is used to test the deprecation decorators. Deprecated in Twisted 8.0.0; please use something.foobar instead. N)rrr rPr-r's& r!test_deprecatedReplacement3DeprecatedDecoratorTests.test_deprecatedReplacementcs@)Q1-7$67 F  MM  r$c \R^^^4p\V\R7pV!\4pVP VP RP \44R#)a L{deprecated} takes an additional replacement parameter that can be used to indicate the new, non-deprecated method developers should use. If the replacement parameter is a callable, its fully qualified name will be interpolated into the warning message. rr:z Do nothing. This is used to test the deprecation decorators. Deprecated in Twisted 8.0.0; please use {}.dummyReplacementMethod instead. N)rrr r rPr-rr))r rg decoratorrs& r!&test_deprecatedReplacementWithCallable?DeprecatedDecoratorTests.test_deprecatedReplacementWithCallablevsQ)Q1-w4JK -(  MM 34:6(3C  r$cLRp\RR7;_uu_4p\R4\^ ^4VPV.4\^ ^^4VPV.4\^ ^^(R7VP\ V4^4VPV^,P \ 4VP\V^,P4V4VP4\^ ^^2R7VPV.4\^ ^^^(4VP\ V4^4VPV^,P \ 4VP\V^,P4V4RRR4R# +'giR#;i)zzThe 'foo' parameter to twisted.python.test.test_deprecate.functionWithDeprecatedParameter was deprecated in Twisted 19.2.0Trr)r5)rRN) rrrSrPr{rvrzr rhr)r rhwss& r!test_deprecatedKeywordParameter8DeprecatedDecoratorTests.test_deprecatedKeywordParameters; / 4 ( (B  " +B 3   R $ +BB 7   R $ +B ;   SWa (   RU^^-? @   SA/ 9 HHJ +B ;   R $ +BB ;   SWa (   RU^^-? @   SA/ 9+) ( ( (s E1F F# rcN)r)r*r+r,r-r[r`rdrhrkrorsr.r/r0s@r!rUrUs3  :@:(:6 & &::r$rUc6a]tRtRtoRtRtRtRtRtVt R#)AppendToDocstringTestsiz_ Test the _appendToDocstring function. _appendToDocstring is used to add text to a docstring. c \Rp\VR4VPRVP4R#)z@ Appending to an empty docstring simply replaces the docstring. cR#rrcrcr$r! noDocstringGAppendToDocstringTests.test_appendToEmptyDocstring..noDocstringrr$Appended text.Nr rPr-)r rys& r!test_appendToEmptyDocstring2AppendToDocstringTests.test_appendToEmptyDocstrings+   ;(89 );+>+>?r$c Rp\VR4VP.ROVPP44VP VPP R44R#)aV Appending to a single line docstring places the message on a new line, with a blank line separating it from the rest of the docstring. The docstring ends with a newline, conforming to Twisted and PEP 8 standards. Unfortunately, the indentation is incorrect, since the existing docstring doesn't have enough info to help us indent properly. cR#);This doesn't comply with standards, but is here for a test.Nrcrcr$r!singleLineDocstringTAppendToDocstringTests.test_appendToSingleLineDocstring..singleLineDocstringr r$r{ N)rr+r{)r rPr-rWrr)r rs& r! test_appendToSingleLineDocstring7AppendToDocstringTests.test_appendToSingleLineDocstrings] N .0@A   ' ' 2 2 4   +33<.multiLineDocstringr r$r{z1 This is a multi-line docstring. Appended text. Nr|)r rs& r!test_appendToMultilineDocstring6AppendToDocstringTests.test_appendToMultilineDocstrings/  -/?@  L  & & r$rcN) r)r*r+r,r-r}rrr.r/r0s@r!rvrvs  @D2  r$rvcfa]tRtRtoRtRtRtRtRtRt Rt R t R t R t R tR tRtVtR#)MutualArgumentExclusionTestsiz* Tests for L{mutuallyExclusiveArguments}. c \\RR4'd!\\P!V4W#4#\ \P !V4W#4#)a Test an invocation of L{passed} with the given function, arguments, and keyword arguments. @param func: A function whose argspec will be inspected. @type func: A callable. @param args: The arguments which could be passed to C{func}. @param kw: The keyword arguments which could be passed to C{func}. @return: L{_passedSignature} or L{_passedArgSpec}'s return value @rtype: L{dict} signatureN)rGinspectrrr getargspecr funcargskws&&*,r! checkPassed(MutualArgumentExclusionTests.checkPassedsE 7K . .#G$5$5d$;TF F"'"4"4T":DE Er$c hRpVPVPV^^4\^^R74R#)zH L{passed} identifies the arguments passed by a simple positional test. cR#rrcrOrPs&&r!rGMutualArgumentExclusionTests.test_passed_simplePositional..func rr$rNrPrrr rs& r!test_passed_simplePositional9MutualArgumentExclusionTests.test_passed_simplePositionals.   ))$15ta1~Fr$c TRpVP\VPV^^^4R#)zC L{passed} raises a L{TypeError} if too many arguments are passed. cR#rrcrs&&r!rBMutualArgumentExclusionTests.test_passed_tooManyArgs..funcrr$NrE TypeErrorrrs& r!test_passed_tooManyArgs4MutualArgumentExclusionTests.test_passed_tooManyArgss'   )T%5%5tQ1Er$c TRpVP\VPV^^R7R#)z[ L{passed} raises a L{TypeError} if a argument is passed both positionally and by keyword. cR#rrcrOs&r!rHMutualArgumentExclusionTests.test_passed_doublePassKeyword..func rr$rNrrs& r!test_passed_doublePassKeyword:MutualArgumentExclusionTests.test_passed_doublePassKeyword(   )T%5%5tQ!Dr$c TRpVP\VPV^^R7R#)zl L{passed} raises a L{TypeError} if a keyword argument not present in the function's declaration is passed. cR#rrcrs&r!rIMutualArgumentExclusionTests.test_passed_unspecifiedKeyword..func+rr$)zNrrs& r!test_passed_unspecifiedKeyword;MutualArgumentExclusionTests.test_passed_unspecifiedKeyword%rr$c jRpVPVPV^^^4\^RR74R#)zd L{passed} places additional positional arguments into a tuple under the name of the star argument. cR#rrcrs&*r!r;MutualArgumentExclusionTests.test_passed_star..func6rr$rN)rrs& r!test_passed_star-MutualArgumentExclusionTests.test_passed_star0s1   ))$1a8$f:MNr$c  RpVPVPV^^^^R7\^\^^^R7R74R#)zV Additional keyword arguments are passed as a dict to the star star keyword argument. cR#rrcrs&,r!r?MutualArgumentExclusionTests.test_passed_starStar..funcArr$)ryrrNrrs& r!test_passed_starStar1MutualArgumentExclusionTests.test_passed_starStar;sC      T1Q!  4dQ$aSTBU6V r$c  rRRlpVPVPV^^^R7\^^^R74R#)zX The results of L{passed} only include arguments explicitly passed, not default values. cR#rrcrOrPrQdes&&&&&r!rFMutualArgumentExclusionTests.test_passed_noDefaultValues..funcNrr$)r)rOrPrNrrrrs& r!test_passed_noDefaultValues8MutualArgumentExclusionTests.test_passed_noDefaultValuesHs6   ))$1):D1Q.funcZs519q= r$rPNrr)r rPrs& r!"test_mutualExclusionPrimeDirective?MutualArgumentExclusionTests.test_mutualExclusionPrimeDirectiveSse %j\ 2 ! 3 ! aR( aA+ aa"-r$c d\RR..4RRl4pVP\V^^R7R#)zy L{mutuallyExclusiveArguments} raises a L{TypeError}n if its decoratee is passed a pair of mutually exclusive arguments. rOrPcW,#rrcrs&&r!rPMutualArgumentExclusionTests.test_mutualExclusionExcludesByKeyword..funchs 5Lr$rNr)r rErrs& r!%test_mutualExclusionExcludesByKeywordBMutualArgumentExclusionTests.test_mutualExclusionExcludesByKeywordbs: %sCj\ 2  3  )TQ!4r$c !RR4p!RR4pRpV!^^4\P!V4PpVP4pV!RR4VR&V!V4pVP \ \ VR /4R#) z Create a fake signature with an invalid parameter type to test error handling. The valid parameter types are specified in L{inspect.Parameter}. c&a]tRtRtoRtRtVtR#)MMutualArgumentExclusionTests.test_invalidParameterType..FakeSignatureiucWnR#r parameters)r rs&&r!r"VMutualArgumentExclusionTests.test_invalidParameterType..FakeSignature.__init__vs",r$rNr)r*r+r,r"r.r/r0s@r! FakeSignaturerus - -r$rc&a]tRtRtoRtRtVtR#)MMutualArgumentExclusionTests.test_invalidParameterType..FakeParameteriycWnW nR#r)r|kind)r r|rs&&&r!r"VMutualArgumentExclusionTests.test_invalidParameterType..FakeParameter.__init__zs   r$)rr|Nrr0s@r! FakeParameterrys ! !r$rcR#rrcrs&&r!rDMutualArgumentExclusionTests.test_invalidParameterType..func~rr$fakerQNrr)rrrrrErr)r rrrrdummyParametersfakeSigs& r!test_invalidParameterType6MutualArgumentExclusionTests.test_invalidParameterTypensz - - ! !   Q &&t,77 $//+,VV<0 )%5wKr$rcN)r)r*r+r,r-rrrrrrrrrrrr.r/r0s@r!rrsOF, G F E E O   Q . 5LLr$rc0a]tRtRtoRtRtRtRtVtR#)KeywordOnlyTestsiz$ Keyword only arguments (PEP 3102). c B\\P!V4W#4#)ah Test an invocation of L{passed} with the given function, arguments, and keyword arguments. @param func: A function whose argspec to pass to L{_passed}. @type func: A callable. @param args: The arguments which could be passed to L{func}. @param kw: The keyword arguments which could be passed to L{func}. @return: L{_passed}'s return value @rtype: L{dict} )rrrrs&&*,r!rKeywordOnlyTests.checkPasseds  1 1$ 7BBr$c  RR/RlpRR/RlpVPVPV^^^4\R RR74VPVPV^^^RR7\R RR74VPVPV^^R^^^R7\R R^^^R 74VP\VPV^^R^^R 7R #)zH Keyword only arguments follow varargs. They are specified in PEP 3102. rPTcR#)z5 b is a keyword-only argument, with a default value. Nrc)rPrOs$*r!func16KeywordOnlyTests.test_passedKeywordOnly..func1r r$cR#)z@ b, c, d, e are keyword-only arguments. b has a default value. Nrc)rPrQrrrOs$$$$*r!func26KeywordOnlyTests.test_passedKeywordOnly..func2r r$rFr)rPrQrrr)rPrQrNrr)rPrrrEr)r rrs& r!test_passedKeywordOnly'KeywordOnlyTests.test_passedKeywordOnlys       ))%Aq94)t;TU    UAq!u  5ti57Q     UAqEQ!q  A 6Ua1 2  )T%5%5uaeqTUVr$rcN) r)r*r+r,r-rrr.r/r0s@r!rrsC"WWr$rr)7r-rrr6ros.pathrrr importlibr ImportError incrementalrtwisted.pythonrtwisted.python.deprecaterr r r&r r r rrrrrrtwisted.python.filepathrtwisted.python.runtimertwisted.python.testr#twisted.python.test.modules_helpersrtwisted.trial.unittestrrr3rerrr r rrDrFrSrUrvrrrcr$r!rso  1+ $    -+4C6"DY*DYN_@2_@Dl%#68Kl%^c 0c LG 2G T GIq!Q '() ))0GIr1a8%@A f:2f:R= 0= @]L#6]L@/W*/Wo#sD&& D32D3