֛hhSrSSKrSSKrSSKrSSKrSSKJr SSKJrJr SSK J r SSK J r SSKJr SSKJrJrJrJrJrJrJrJrJrJrJrJr SS KJr SS K J!r! SS K"J#r# SS K$J%r% SS K&J'r' "SS5r("SS\'5r)"SS\'5r*"SS\%\'5r+"SS\'5r,Sr-Sr."SS\'5r/\"\ "SSSS55"S S!55r0"S"S#5r1\"\ "SS$SS5S%5S/S&j5r2"S'S(\'5r3"S)S*\'5r4"S+S,\'5r5"S-S.\'5r6g!\ a Sr GNf=f)0zI 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)SynchronousTestCasec$\rSrSrSrSrSrSrg)_MockDeprecatedAttribute1ze Mock of L{twisted.python.deprecate._DeprecatedAttribute}. @ivar value: The value of the attribute. cXlgNvalueselfr s fC:\Users\psant\Downloads\Noiseback\school\venv\Lib\site-packages\twisted/python/test/test_deprecate.py__init__!_MockDeprecatedAttribute.__init__8s cUR$)z Get a known value. rr"s r#get_MockDeprecatedAttribute.get;szzr&rN)__name__ __module__ __qualname____firstlineno____doc__r$r)__static_attributes__r&r#rr1s r&rc<\rSrSrSrSrSrSrSrSr Sr S r g ) ModuleProxyTestsBz 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 [R"S5nUR5Hup4[X#U5 M [R "U5$)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"attrsmodkeyr s r# _makeProxyModuleProxyTests._makeProxyIsAu%++-JC Ce $(%%c**r&cURSS9nURURS5 UR[[ US5 g)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?assertIsrC assertRaisesAttributeErrorgetattrr"proxys r#test_getattrPassthrough(ModuleProxyTests.test_getattrPassthroughVs= w7 e**G4 .'5:JKr&cUR5n[RUS5n[S5US'UR UR S5 g)z Getting an attribute marked as being deprecated on L{twisted.python.deprecate._ModuleProxy} results in calling the deprecated wrapper's C{get} method. _deprecatedAttributes*r6N)r?object__getattribute__r assertEqualr6)r"rJrNs r#test_getattrIntercept&ModuleProxyTests.test_getattrIntercept`sH ! & 7 7?V W'?'Ce$ B'r&cUR5nUR[[US5 UR[[US5 g)zx Private attributes of L{twisted.python.deprecate._ModuleProxy} are inaccessible when regular attribute access is used. _modulerNN)r?rFrGrHrIs r#test_privateAttributes'ModuleProxyTests.test_privateAttributesks9 ! .'5)D .'5:QRr&cUR5nSUlUR[R US5S5 UR URS5 g)zl Setting attributes on L{twisted.python.deprecate._ModuleProxy} proxies them through to the wrapped module. rVN)r?rVassertNotEqualrPrQrRrIs r# test_setattrModuleProxyTests.test_setattrtsH !  F33E9EqI *r&cUR5n[RUS5nUR[ U5S[ U5R SU<S35 g)z L{twisted.python.deprecated._ModuleProxy.__repr__} produces a string containing the proxy type and a representation of the wrapped module object. rVN)r?rPrQrRreprtyper+)r"rJ realModules r# test_reprModuleProxyTests.test_repr~sQ !,,UI>  e$u+*>*>)?x ~UV&WXr&r1N) r+r,r-r.r/r?rKrSrWr\rdr0r1r&r#r3r3Bs( +L (S+Yr&r3c6\rSrSrSrSrSrSrSrSr Sr g ) DeprecatedAttributeTestsz Tests for L{twisted.python.deprecate._DeprecatedAttribute} and L{twisted.python.deprecate.deprecatedModuleAttribute}, which issue warnings for deprecated module-level attributes. ct[RUl[RUl[S-Ulg)Nz.foo)rversionmessager+_testModuleNamer(s r#setUpDeprecatedAttributeTests.setUps)+33 +33 '&0r&c[[RS-U-[R[S-[R -5$)z: Create the warning string used by deprecated attributes. .z: )r rr+rjr rk)r"attrs r#_getWarningString*DeprecatedAttributeTests._getWarningStringsA, ) )C /$ 6 ( ( & -0D0L0L L  r&c^Sn[[US5 [R"[XRUR 5mUR TRU5 U4SjnU"5 URUR/5nURUSS[5 UR USSURU55 UR [U5S5 g) 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_ATTRIBUTErOc&>TR5 gr)r))rqsr# addStackLevelNDeprecatedAttributeTests.test_deprecatedAttributeHelper..addStackLevels HHJr&rcategoryrkrZN)r:rr_DeprecatedAttributerjrkrRr+ flushWarningstest_deprecatedAttributeHelperrEDeprecationWarningrrlen)r"namerw warningsShownrqs @r#r|7DeprecatedAttributeTests.test_deprecatedAttributeHelpers .$dB/-- $ dll  -  **D,O,O+PQ  mA&z24FG q))4d6L6LT6RS ]+Q/r&c[R URUR/5nUR [ U5S5 Sn[ [U5 URUR/5nUR [ U5S5 URUSS[5 UR USSURU55 g)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. rDEPRECATED_ATTRIBUTErZryrkN) rANOTHER_ATTRIBUTEr{test_deprecatedAttributerRr~rHrEr}rr)r"rrs r#r1DeprecatedAttributeTests.test_deprecatedAttributes ..**D,I,I+JK  ]+Q/% $d+**D,I,I+JK  ]+Q/ mA&z24FG q))4d6L6LT6RSr&cx[R"S5=[RUR'nUR [RR UR5 [USS5 [USS5 [R"[SSSS5S URS5 [RURnURX!5 [R"[SSSS5S URS5 URU[RUR5 g ) 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. r6firstrZsecondTwistedrrkN) r7r8sysmodulesrl addCleanuppopr:rdeprecatedModuleAttributerr[rE)r"r=rJs r#test_wrappedModule+DeprecatedAttributeTests.test_wrappedModules382B2B52II D(()C  )=)=>Wa Xq!++ Iq!Q 'D4H4H'  D001 E'++ Iq!Q 'D4H4H(  eS[[)=)=>?r&)rlrkrjN) r+r,r-r.r/rmrrr|rrr0r1r&r#rgrgs" 1  04T.@r&rgc:\rSrSrSrSrSrSrSrSr Sr S r g ) 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') cf^U4Sjm[UR5RS55nUR5 T"X!5nUR UR R S5/[R -5 UR[RR55 U$)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. c,>0nUR5H|up4URU5n[U[5(aXRU'UR U5 MB[U[ 5(aUR 5 T"XT5X#'Ms[S5e U$)Nz(only strings and dicts allowed as values)r9child isinstancebytes setContentdictcreateDirectory ValueError)pathobjdirdictpathdictr>r r 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&cpURSURRS5SS.05nUSS$)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}. spackagerr&)s __init__.py module.pyr)r _packageInitr)r"pathss r#simpleModuleEntry.ImportedModuleAttributeTests.simpleModuleEntrysJ ""$($5$5$<$[RR5[RRT54$r)rrclearupdate)rsr#.WarnAboutFunctionTests.setUp..s&!2!2!4ckk6H6H6Q Rr&N)rrrrrrparentrrinsertrremoverrr isWindowsr{)r" packagePathrs @r#rmWarnAboutFunctionTests.setUp`s  .445MN   =)44S9 ;'22  " ;'22  0ll))+00  ;' 5++""$ RS          r&c:Sn[R"US5 UR5n[nUR 5R S5(aUSSnUR [USS5[U55 URUSSS5 g) 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. cgrr1r1r&r#aFunc2WarnAboutFunctionTests.test_warning..aFunc r&zA Warning Messagez.pycNrfilenamerk) rwarnAboutFunctionr{rlowerendswithassertSamePathrrR)r"rrrs r# test_warning#WarnAboutFunctionTests.test_warnings  ##E+>?**,  >>  $ $V , ,}H H]1%5j%ABHXDVW q))46IJr&cSSKJn UR5 UR5nUR [ USSR S55URRS5RS55 URUSSS5 URUSS S 5 UR[U5S 5 g ) z L{deprecate.warnAboutFunction} emits a C{DeprecationWarning} with the number of a line within the implementation of the function passed to it. rrrrtwisted_private_helperrlineno rkA Warning StringrZN) rrcallTestFunctionr{rrrrsiblingrrRr~r"rrs r#test_warningLineNumber-WarnAboutFunctionTests.test_warningLineNumbers 2!**,   ]1%j188A B LL !: ; A A, O q)(3Q7 q))46HI ]+Q/r&cSSKJn UR5 UR5nUR [ USSR S55URRS5RS55 URUSSS5 URUSS S 5 UR[U5S 5 g ) 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. r)pep626rrrs pep626.pyrrkrrZN) rrrr{rrrrrrrRr~)r"rrs r#'test_warningLineNumberDisFindlinestarts>WarnAboutFunctionTests.test_warningLineNumberDisFindlinestartss 2!**,   ]1%j188A B LL !: ; A A, O q)(3R8 q))46HI ]+Q/r&cUR[UR5[UR5:HU<SU<35 g)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&cfSSKJn [RS [RUR UR R UR RS55 [(a [5 SSK Jn UR[RRS5 UR[RRUR5 UR5 URUR/5n[USSR!S55nUR RS5R#S5nUR%X45 UR'USS S 5 UR'USS S 5 UR'[)U5S 5 g)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. rrrstwisted_renamed_helpertwisted_renamed_helperrrrrrrkrrZN)rrrrr+rmoveTorrrrrrr{ testFunctionrrrrrRr~)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[RSS2 [R"SSS9 SSKJn UR 5 UR 5nUR[U5S5 g)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. Nignoreractionrrr) warningsfiltersfilterwarningsrrrr{rRr~rs r#test_filteredWarning+WarnAboutFunctionTests.test_filteredWarning sU   Q x8PQ1!**,  ]+Q/r&c[RSS2 [R"SSS9 SSKJn UR 5 UR 5 UR 5nUR[U5S5 USSnUSS nUSS nUSS n[R"X4XV5nURURS 5S U<35 g)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. NrrrrrrZrkryrrz=module.py:9: DeprecationWarning: A Warning String return a zUnexpected warning string: ) rrrrrrr{rRr~ formatwarningrr)r"rrrkryrrmsgs r#test_filteredOnceWarning/WarnAboutFunctionTests.test_filteredOnceWarnings   Q x8PQ1!!**,  ]+Q/"9- #J/ #J/q!(+$$WI  LLT *# 1  r&)rN)r+r,r-r.r/rmrrrrrrr r0r1r&r#rrZs2 ;!zK$0&0(  $0L0( r&rcgz? Do nothing. This is used to test the deprecation decorators. Nr1r1r&r# dummyCallabler@r&cg)zO Do nothing. This is used to test the replacement parameter to L{deprecated}. Nr1r1r&r#dummyReplacementMethodrHrr&cJ\rSrSrSrSrSrSrSrSr Sr S r S r S r g ) DeprecationWarningsTestsiPc|[SSSS5nUR[URU5[<S35 g)z L{getDeprecationWarningString} returns a string that tells us that a callable was deprecated at a certain released version of Twisted. rrrzZ.DeprecationWarningsTests.test_getDeprecationWarningString was deprecated in Twisted 8.0.0N)rrRr test_getDeprecationWarningStringr+r"rjs r#r9DeprecationWarningsTests.test_getDeprecationWarningStringQs: )Q1-  '(M(Mw W19 < r&c[SSSS5n[S-nUR[URX5[ <S35 g)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. rrrz: This is a messagezm.DeprecationWarningsTests.test_getDeprecationWarningString was deprecated in Twisted 8.0.0: This is a messageN)rr rRrrr+)r"rjformats r#*test_getDeprecationWarningStringWithFormatCDeprecationWarningsTests.test_getDeprecationWarningStringWithFormat]sM )Q1-+.CC  '55w AI K  r&c^[SSSS5n[U5"[5mU4Sjn[SS9n[ S5 U"5 UR USR [5 UR [USR5[[U55 UR USRRS5[RS55 S S S 5 g !,(df  g =f) z; Decorating a callable with L{deprecated} emits a warning. rrrc>T"5 grr1)dummysr#rwJDeprecationWarningsTests.test_deprecateEmitsWarning..addStackLevelts Gr&TrecordalwayscoN)rrrrrrRryr}strrkrrrstripr)r"rjrwcaughtr!s @r#test_deprecateEmitsWarning3DeprecationWarningsTests.test_deprecateEmitsWarningms)Q1-7#M2 4 (F  " O   VAY//1C D   F1I%%&+M7C    VAY//66tS T) ( (s B-C** C8c[SSSS5n[U5"[5nUR[RUR5 UR[ [5[ U55 g)z; The decorated function has the same name as the original. rrrN)rrrrRr+fullyQualifiedNamer"rjr!s r#test_deprecatedPreservesName5DeprecationWarningsTests.test_deprecatedPreservesNamesY)Q1-7#M2 //@ +M:.localDummyCallablerr&rrrr2N)rrr r rRr/)r"r7rjr!s r#test_deprecatedUpdatesDocstring8DeprecationWarningsTests.test_deprecatedUpdatesDocstringsX  )Q1-7#$67-/GQS/TU +33U]]Cr&c[SSSS5n[U5"[5nURXR5 g)z\ Deprecating a function adds version information to the decorated version of that function. rrrN)rrrrRdeprecatedVersionr.s r#test_versionMetadata-DeprecationWarningsTests.test_versionMetadatas7 )Q1-7#M2 "9"9:r&c[SSSS5n[URUSS9nURU[ UR5<S35 g)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. rrrsomething.foobar replacementzE was deprecated in Twisted 8.0.0; please use something.foobar insteadN)rrrrRr-r"rj warningStrings r#+test_getDeprecationWarningStringReplacementDDeprecationWarningsTests.test_getDeprecationWarningStringReplacementsT)Q1-3  1 1 *  +D,Q,QR U r&c[SSSS5n[URU[S9nUR U[ UR5<S[ <S35 g)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. rrrrAz- was deprecated in Twisted 8.0.0; please use z.dummyReplacementMethod insteadN)rrrrrRr-r+rCs r#7test_getDeprecationWarningStringReplacementWithCallablePDeprecationWarningsTests.test_getDeprecationWarningStringReplacementWithCallablesX)Q1-3  1 1 .  "$"G"GH( T r&r1N)r+r,r-r.rrr*r/r3r9r=rErHr0r1r&r#rrPs2   U*W D(; & r&rrrZrc\rSrSrSrSrg)DeprecatedClassizB Class which is entirely deprecated without having a replacement. r1N)r+r,r-r.r/r0r1r&r#rLrLsr&rLcn\rSrSrSrSr\"\"SSSS55S5r\RS 5rS r g) ClassWithDeprecatedPropertyiz* Class with a single deprecated property. NrrZrrJcUR$)z+ Getter docstring. @return: The property. _someProtectedValuer(s r# someProperty(ClassWithDeprecatedProperty.somePropertys'''r&cXlg)z Setter docstring. NrPr!s r#rRrSs $) r&rP) r+r,r-r.r/rQrrrRsetterr0r1r&r#rNrNsK 1a34(5())r&rNr6cg)z/ Function with a deprecated keyword parameter. Nr1)abcr6bars r#functionWithDeprecatedParameterr\rr&cB\rSrSrSrSrSrSrSrSr Sr S r S r g ) DeprecatedDecoratorTestsiz" Tests for deprecated decorators. cURX!RR5Vs/sH)o3R5(dMUR5PM+ sn5 gs snf)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)rRr/ splitlinesstrip)r"targetexpectedrs r#assertDocstring(DeprecatedDecoratorTests.assertDocstringsD  ..*C*C*ES*EQyqwwy*ES Ss A A c[5nUR UR[R/SQ5 [SSSS5[RlSnUR UR /5nURS[U55 UR[USS5 URX#SS 5 g ) 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. )zGetter docstring.z@return: The property.Deprecated in Twisted 1.2.3.rrZrrJktwisted.python.test.test_deprecate.ClassWithDeprecatedProperty.someProperty was deprecated in Twisted 1.2.3rryrkN) rNrRrdrr<r{test_propertyGetterrRr~r})r"objrkrs r#ri,DeprecatedDecoratorTests.test_propertyGetters*+   ' 4 4  FM q!QF #00B  ; %%t'?'?&@A CM* +Xa[-DE 1+i"89r&cF[5n[5nXlURXR5 SnUR UR /5nURS[U55 UR[USS5 URX4SS5 g)ze When L{deprecatedProperty} is used on a C{property}, setter accesses raise a L{DeprecationWarning}. rhrZrryrkN) rPrNrRrErQr{test_propertySetterrRr~r})r"newValuerjrkrs r#rm,DeprecatedDecoratorTests.test_propertySetter4s 8)+# h 7 78 ; %%t'?'?&@A CM* +Xa[-DE 1+i"89r&cN[5 UR[SS/5 [SSSS5[lSnUR UR /5nUR S[U55 UR [USS 5 UR XSS 5 g ) 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.rgrrZrrJzRtwisted.python.test.test_deprecate.DeprecatedClass was deprecated in Twisted 1.2.3rryrkN) rLrdrr<r{ test_classrRr~r})r"rkrs r#rq#DeprecatedDecoratorTests.test_classHs   V.  -4Iq!Q,G) . %%t&78 CM* +Xa[-DE 1+i"89r&c[SSSS5n[US5"[5nURURS5 g)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. rrrr@z Do nothing. This is used to test the deprecation decorators. Deprecated in Twisted 8.0.0; please use something.foobar instead. N)rrrrRr/r.s r#test_deprecatedReplacement3DeprecatedDecoratorTests.test_deprecatedReplacementcs@)Q1-7$67 F  MM  r&c[SSSS5n[U[S9nU"[5nUR UR SR [55 g)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. rrrrAz Do nothing. This is used to test the deprecation decorators. Deprecated in Twisted 8.0.0; please use {}.dummyReplacementMethod instead. N)rrrrrRr/rr+)r"rj decoratorr!s r#&test_deprecatedReplacementWithCallable?DeprecatedDecoratorTests.test_deprecatedReplacementWithCallablevsQ)Q1-w4JK -(  MM 34:6(3C  r&cSn[SS9n[S5 [SS5 URU/5 [SSS5 URU/5 [SSSS 9 UR[ U5S 5 URUS R [ 5 UR[US R5U5 UR5 [SSS S 9 URU/5 [SSSS5 UR[ U5S 5 URUS R [ 5 UR[US R5U5 SSS5 g!,(df  g=f)NzzThe 'foo' parameter to twisted.python.test.test_deprecate.functionWithDeprecatedParameter was deprecated in Twisted 19.2.0Tr#r% ()r6rZr2)r[) rrr\rRr~ryr}r'rkr)r"rkwss r#test_deprecatedKeywordParameter8DeprecatedDecoratorTests.test_deprecatedKeywordParameters5 / 4 (B  " +B 3   R $ +BB 7   R $ +B ;   SWa (   RU^^-? @   SA/ 9 HHJ +B ;   R $ +BB ;   SWa (   RU^^-? @   SA/ 9+) ( (s EE00 E>r1N) r+r,r-r.r/rdrirmrqrtrxrr0r1r&r#r^r^s+  :@:(:6 & &:r&r^c*\rSrSrSrSrSrSrSrg)AppendToDocstringTestsiz_ Test the _appendToDocstring function. _appendToDocstring is used to add text to a docstring. cZSn[US5 URSUR5 g)z@ Appending to an empty docstring simply replaces the docstring. cgrr1r1r&r# noDocstringGAppendToDocstringTests.test_appendToEmptyDocstring..noDocstringrr&Appended text.Nr rRr/)r"rs r#test_appendToEmptyDocstring2AppendToDocstringTests.test_appendToEmptyDocstrings+   ;(89 );+>+>?r&cSn[US5 UR/SQURR55 UR URR S55 g)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. cg);This doesn't comply with standards, but is here for a test.Nr1r1r&r#singleLineDocstringTAppendToDocstringTests.test_appendToSingleLineDocstring..singleLineDocstringrr&r)rr2r N)r rRr/r`rr)r"rs r# test_appendToSingleLineDocstring7AppendToDocstringTests.test_appendToSingleLineDocstrings] N .0@A   ' ' 2 2 4   +33<.multiLineDocstringrr&rz1 This is a multi-line docstring. Appended text. Nr)r"rs r#test_appendToMultilineDocstring6AppendToDocstringTests.test_appendToMultilineDocstrings/  -/?@  L  & & r&r1N) r+r,r-r.r/rrrr0r1r&r#rrs @D2 r&rcZ\rSrSrSrSrSrSrSrSr Sr S r S r S r S rS rSrg)MutualArgumentExclusionTestsiz* Tests for L{mutuallyExclusiveArguments}. c[[SS5(a [[R"U5X#5$[ [R "U5X#5$)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)rHinspectrrr getargspecr"funcargskws r# checkPassed(MutualArgumentExclusionTests.checkPassedsE 7K . .#G$5$5d$;TF F"'"4"4T":DE Er&c`SnURURUSS5[SSS95 g)zH L{passed} identifies the arguments passed by a simple positional test. cgrr1rXrYs r#rGMutualArgumentExclusionTests.test_passed_simplePositional..func rr&rZrrNrRrrr"rs r#test_passed_simplePositional9MutualArgumentExclusionTests.test_passed_simplePositionals.   ))$15ta1~Fr&cRSnUR[URUSSS5 g)zC L{passed} raises a L{TypeError} if too many arguments are passed. cgrr1rs r#rBMutualArgumentExclusionTests.test_passed_tooManyArgs..funcrr&rZrrJNrF TypeErrorrrs r#test_passed_tooManyArgs4MutualArgumentExclusionTests.test_passed_tooManyArgss'   )T%5%5tQ1Er&cLSnUR[URUSSS9 g)z[ L{passed} raises a L{TypeError} if a argument is passed both positionally and by keyword. cgrr1rXs r#rHMutualArgumentExclusionTests.test_passed_doublePassKeyword..func rr&rZrrNrrs r#test_passed_doublePassKeyword:MutualArgumentExclusionTests.test_passed_doublePassKeyword(   )T%5%5tQ!Dr&cLSnUR[URUSSS9 g)zl L{passed} raises a L{TypeError} if a keyword argument not present in the function's declaration is passed. cgrr1rs r#rIMutualArgumentExclusionTests.test_passed_unspecifiedKeyword..func+rr&rZr)zNrrs r#test_passed_unspecifiedKeyword;MutualArgumentExclusionTests.test_passed_unspecifiedKeyword%rr&cbSnURURUSSS5[SSS95 g)zd L{passed} places additional positional arguments into a tuple under the name of the star argument. cgrr1rs r#r;MutualArgumentExclusionTests.test_passed_star..func6rr&rZrrJ)rrJrNrrs r#test_passed_star-MutualArgumentExclusionTests.test_passed_star0s1   ))$1a8$f:MNr&c rSnURURUSSSSS9[S[SSSS9S95 g) zV Additional keyword arguments are passed as a dict to the star star keyword argument. cgrr1rs r#r?MutualArgumentExclusionTests.test_passed_starStar..funcArr&rZrrJ)ryrrNrrs r#test_passed_starStar1MutualArgumentExclusionTests.test_passed_starStar;sC      T1Q!  4dQ$aSTBU6V r&c dSSjnURURUSSSS9[SSSS95 g) zX The results of L{passed} only include arguments explicitly passed, not default values. rZrcgrr1rXrYrZdes r#rFMutualArgumentExclusionTests.test_passed_noDefaultValues..funcNrr&)r)rXrYrNrZrrJrrs r#test_passed_noDefaultValues8MutualArgumentExclusionTests.test_passed_noDefaultValuesHs6   ))$1):D1Q.funcZs519q= r&rZrr{rrY NrJr)rrRrs r#"test_mutualExclusionPrimeDirective?MutualArgumentExclusionTests.test_mutualExclusionPrimeDirectiveSse %j\ 2 ! 3 ! aR( aA+ aa"-r&c\[SS//5SSj5nUR[USSS9 g) zy L{mutuallyExclusiveArguments} raises a L{TypeError}n if its decoratee is passed a pair of mutually exclusive arguments. rXrYrJrc X-$rr1rs r#rPMutualArgumentExclusionTests.test_mutualExclusionExcludesByKeyword..funchs 5Lr&rNr)rrFrrs r#%test_mutualExclusionExcludesByKeywordBMutualArgumentExclusionTests.test_mutualExclusionExcludesByKeywordbs: %sCj\ 2  3  )TQ!4r&c"SS5n"SS5nSnU"SS5 [R"U5RnUR5nU"SS5US 'U"U5nUR [ [ US 05 g ) 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\rSrSrSrSrg)MMutualArgumentExclusionTests.test_invalidParameterType..FakeSignatureiucXlgr parameters)r"rs r#r$VMutualArgumentExclusionTests.test_invalidParameterType..FakeSignature.__init__vs",r&rNr+r,r-r.r$r0r1r&r# FakeSignaturerus -r&rc\rSrSrSrSrg)MMutualArgumentExclusionTests.test_invalidParameterType..FakeParameteriycXlX lgr)rkind)r"rrs r#r$VMutualArgumentExclusionTests.test_invalidParameterType..FakeParameter.__init__zs   r&)rrNrr1r&r# FakeParameterrys !r&rcgrr1rs r#rDMutualArgumentExclusionTests.test_invalidParameterType..func~rr&rZrfakerZrZrN)rrrrrFrr)r"rrrrdummyParametersfakeSigs r#test_invalidParameterType6MutualArgumentExclusionTests.test_invalidParameterTypensz - - ! !   Q &&t,77 $//+,VV<0 )%5wKr&r1N)r+r,r-r.r/rrrrrrrrrrrr0r1r&r#rrsFF, G F E E O   Q . 5Lr&rc$\rSrSrSrSrSrSrg)KeywordOnlyTestsiz$ Keyword only arguments (PEP 3102). cB[[R"U5X#5$)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 vSS.SjnSS.SjnURURUSSS5[SSS 95 URURUSSSS S9[SS S 95 URURUSSS SSSS 9[S S SSSS 95 UR[URUSSS SSS9 g)zH Keyword only arguments follow varargs. They are specified in PEP 3102. Trcg)z5 b is a keyword-only argument, with a default value. Nr1)rYrXs r#func16KeywordOnlyTests.test_passedKeywordOnly..func1rr&cg)z@ b, c, d, e are keyword-only arguments. b has a default value. Nr1)rYrZrrrXs r#func26KeywordOnlyTests.test_passedKeywordOnly..func2rr&rZrrJrrF)rYrZrrrr)rYrZrN)rRrrrFr)r"rrs r#test_passedKeywordOnly'KeywordOnlyTests.test_passedKeywordOnlys     ))%Aq94)t;TU    UAq!u  5ti57Q     UAqEQ!q  A 6Ua1 2  )T%5%5uaeqTUVr&r1N)r+r,r-r.r/rr r0r1r&r#rrsC"Wr&rr)7r/rrr7ros.pathrrr importlibr ImportError incrementalrtwisted.pythonrtwisted.python.deprecater r r r-r r rrrrrrrtwisted.python.filepathrtwisted.python.runtimertwisted.python.testr#twisted.python.test.modules_helpersrtwisted.trial.unittestrrr3rgrrrrrrLrNr\r^rrrr1r&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%%D10D1