tfdZddlZddlZddlZddlZddlmZddlmZmZ ddl m Z n #e $rdZ YnwxYwddl m Z ddlmZddlmZmZmZmZmZmZmZmZmZmZmZmZdd lmZdd l m!Z!dd l"m#Z#dd l$m%Z%dd l&m'Z'GddZ(Gdde'Z)Gdde'Z*Gdde%e'Z+Gdde'Z,dZ-dZ.Gdde'Z/ee ddddGd d!Z0Gd"d#Z1ee dd$ddd%d/d&Z2Gd'd(e'Z3Gd)d*e'Z4Gd+d,e'Z5Gd-d.e'Z6dS)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)SynchronousTestCaseceZdZdZdZdZdS)_MockDeprecatedAttributezq Mock of L{twisted.python.deprecate._DeprecatedAttribute}. @ivar value: The value of the attribute. c||_dSNvalueselfrs a/var/www/surfInsights/venv3-11/lib/python3.11/site-packages/twisted/python/test/test_deprecate.py__init__z!_MockDeprecatedAttribute.__init__8s  c|jS)z$ Get a known value. rr!s r"getz_MockDeprecatedAttribute.get;s zr$N)__name__ __module__ __qualname____doc__r#r'r$r"rr1s< r$rc6eZdZdZdZdZdZdZdZdZ dS) 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 tjd}|D]\}}t|||t j|S)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" _makeProxyzModuleProxyTests._makeProxyIsUu%%++-- % %JC Ce $ $ $ $%c***r$c|d}||jd|tt |ddS)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)r9assertIsr< assertRaisesAttributeErrorgetattrr!proxys r"test_getattrPassthroughz(ModuleProxyTests.test_getattrPassthroughVsO w77 e*G444 .'5:JKKKKKr$c|}t|d}td|d<||jddS)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*r0N)r9object__getattribute__r assertEqualr0)r!rCrFs r"test_getattrInterceptz&ModuleProxyTests.test_getattrIntercept`s[ !! & 7 7?V W W'?'C'Ce$ B'''''r$c|}|tt|d|tt|ddS)z Private attributes of L{twisted.python.deprecate._ModuleProxy} are inaccessible when regular attribute access is used. _modulerFN)r9r?r@rArBs r"test_privateAttributesz'ModuleProxyTests.test_privateAttributesksN !! .'5)DDD .'5:QRRRRRr$c|}d|_|t|dd||jddS)z Setting attributes on L{twisted.python.deprecate._ModuleProxy} proxies them through to the wrapped module. rMN)r9rMassertNotEqualrHrIrJrBs r" test_setattrzModuleProxyTests.test_setattrts^ !!  F33E9EEqIII *****r$c|}t|d}|t |dt |jd|ddS)z L{twisted.python.deprecated._ModuleProxy.__repr__} produces a string containing the proxy type and a representation of the wrapped module object. rMN)r9rHrIrJreprtyper()r!rC realModules r" test_reprzModuleProxyTests.test_repr~sg !!,,UI>>  e&W$u++*>&W&W &W&W&WXXXXXr$N) r(r)r*r+r9rDrKrNrRrYr,r$r"r.r.Bs + + +LLL ( ( (SSS+++YYYYYr$r.c0eZdZdZdZdZdZdZdZdS)DeprecatedAttributeTestsz Tests for L{twisted.python.deprecate._DeprecatedAttribute} and L{twisted.python.deprecate.deprecatedModuleAttribute}, which issue warnings for deprecated module-level attributes. chtj|_tj|_tdz|_dS)Nz.foo)rversionmessager(_testModuleNamer&s r"setUpzDeprecatedAttributeTests.setUps)+3 +3 '&0r$cttjdz|ztjtdztjzS)zJ Create the warning string used by deprecated attributes. .z: )r rr(r]r r^)r!attrs r"_getWarningStringz*DeprecatedAttributeTests._getWarningStrings=, )C /$ 6 ( & -0D0L L   r$c d}tt|dtjt||j|j|j|fd}|||j g}| |ddt||dd| ||t|ddS) 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_ATTRIBUTErGc0dSr)r')rcsr" addStackLevelzNDeprecatedAttributeTests.test_deprecatedAttributeHelper..addStackLevels HHJJJJJr$rcategoryr^rPN)r4rr_DeprecatedAttributer]r^rJr( flushWarningstest_deprecatedAttributeHelperr>DeprecationWarningrdlen)r!namerh warningsShownrcs @r"rlz7DeprecatedAttributeTests.test_deprecatedAttributeHelpers .$dB///- $ dl   ---       **D,O+PQQ  mA&z24FGGG q))4d6L6LT6R6RSSS ]++Q/////r$ctj||jg}|t |dd}t t|||jg}|t |d||ddt||dd| |dS)a 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_ATTRIBUTErPrir^N) rANOTHER_ATTRIBUTErktest_deprecatedAttributerJrnrAr>rmrd)r!rpros r"rtz1DeprecatedAttributeTests.test_deprecatedAttributes ..**D,I+JKK  ]++Q///% $d+++**D,I+JKK  ]++Q/// mA&z24FGGG q))4d6L6LT6R6RSSSSSr$cNtjdxtj|j<}|tjj|jt|ddt|ddtj tddddd |jdtj|j}| ||tj tddddd |jd| |tj|jd S) 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. r0firstrPsecondTwistedrr^N) r1r2sysmodulesr_ addCleanuppopr4rdeprecatedModuleAttributerrQr>)r!r7rCs r"test_wrappedModulez+DeprecatedAttributeTests.test_wrappedModules 382B52I2II D()C  )=>>>Wa   Xq!!!+ Iq!Q ' 'D4H'    D01 E3'''+ Iq!Q ' 'D4H(    eS[)=>?????r$N) r(r)r*r+r`rdrlrtrr,r$r"r[r[sq 111    0004TTT.@@@@@r$r[c4eZdZdZdZdZdZdZdZdZ dS) ImportedModuleAttributeTestsza 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') cfdt|d}|||}||jdgtjz|tj |S)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. cXi}|D]\}}||}t|tr|||<||Jt|t r$|||||<td|S)Nz(only strings and dicts allowed as values)r3child isinstancebytes setContentdictcreateDirectory ValueError)pathobjdirdictpathdictr8rr makeSomeFiless r"rzAImportedModuleAttributeTests.pathEntryTree..makeSomeFilessH%mmoo Q Q U c**eU++Q$)HSM$$U++++t,,Q))+++$1M%$?$?HSMM$%OPPPOr$utf-8) rmktempencodemakedirsreplaceSysPathpathdecoder{replaceSysModulesr|copy)r!treebaseresultrs @r" pathEntryTreez*ImportedModuleAttributeTests.pathEntryTrees      ,,W5566 tT** TY--g667#(BCCC s{//11222 r$c|d|jdddi}|ddS)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"simpleModuleEntryz.ImportedModuleAttributeTests.simpleModuleEntrysT ""$($5$<$t|d|_|j|jdd|jdd|jdd|jj}tj d|| tjj |tj | fd tjr|d Sd S) zY Create a file that will have known line numbers when emitting warnings. twisted_private_helperz __init__.pyr$z module.pys "A module string" from twisted.python import deprecate def testFunction(): "A doc string" a = 1 + 2 return a def callTestFunction(): b = testFunction() if b == 3: deprecate.warnAboutFunction(testFunction, "A Warning String") z pep626.pysQ "A module string" from twisted.python import deprecate def noop(): pass def testFunction(a=1, b=1): "A doc string" if a: if b: noop() else: pass def callTestFunction(): b = testFunction() if b is None: deprecate.warnAboutFunction(testFunction, "A Warning String") rc~tjtjfSr)r{r|clearupdate)r|sr"z.WarnAboutFunctionTests.setUp..s*!2!2!4!4ck6H6H6Q6Q Rr$N)rrrrrrparentrr{insertr}remover|rr isWindowsrk)r! packagePathr|s @r"r`zWarnAboutFunctionTests.setUp`si  ..445MNN   =))44S999 ;''22    " ;''22    0l))++0  ;''' 555+""$$ RRRRSSS     !     ! !r$cd}tj|d|}t}|dr |dd}|t|ddt|||ddddS) 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. cdSrr,r,r$r"aFuncz2WarnAboutFunctionTests.test_warning..aFunc Dr$zA Warning Messagez.pycNrfilenamer^) rwarnAboutFunctionrkrlowerendswithassertSamePathrrJ)r!rrprs r" test_warningz#WarnAboutFunctionTests.test_warnings    #E+>???**,,  >>   $ $V , , %}H H]1%5j%ABBHXDVDVWWW q))46IJJJJJr$c ddlm}||}|t |ddd|jd d| |ddd| |dd d | t|d d S) 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 r^A Warning StringrPN) rrcallTestFunctionrkrrrrsiblingrrJrnr!rrps r"test_warningLineNumberz-WarnAboutFunctionTests.test_warningLineNumbers 211111!!!**,,   ]1%j188AA B B L !: ; ; A A, O O   q)(3Q777 q))46HIII ]++Q/////r$c ddlm}||}|t |ddd|jd d| |ddd| |dd d | t|d d S) 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.pyrr^rrPN) rrrrkrrrrrrrJrn)r!rrps r"'test_warningLineNumberDisFindlinestartsz>WarnAboutFunctionTests.test_warningLineNumberDisFindlinestartss 211111!!!**,,   ]1%j188AA B B L !: ; ; A A, O O   q)(3R888 q))46HIII ]++Q/////r$c|t|jt|jk|d|dS)a 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!rvrws r"rz%WarnAboutFunctionTests.assertSamePathsQ  UZ HV[$9$9 9 & &F & &     r$cddlm}tjd=tj|j=|j|jdtrtddl m}| tjj d| tjj |j| | |jg}t|ddd}|jdd}|||||dd d ||dd d |t)|d dS)a  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_helperrrrrrr^rrPN)rrr{r|r(rmoveTorrrr}r~rrk testFunctionrrrrrJrn)r!rrp warnedPath expectedPaths r"test_renamedFilez'WarnAboutFunctionTests.test_renamedFiles 211111 K0 1 K ( DL001JKKLLL      211111  )ABBB  999!!!**F,?+@AA mA.z:AA'JJKK |++,EFFLL    J 555 q)(3Q777 q))46HIII ]++Q/////r$ctjdd=tjddddlm}||}|t|ddS)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) warningsfiltersfilterwarningsrrrrkrJrnrs r"test_filteredWarningz+WarnAboutFunctionTests.test_filteredWarning s  QQQ x8PQQQQ111111!!!**,,  ]++Q/////r$ctjdd=tjddddlm}|||}|t|d|dd}|dd }|dd }|dd }tj ||||}| | d d |dS)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. NrrrrrrPr^rirrz=module.py:9: DeprecationWarning: A Warning String return a zUnexpected warning string: ) rrrrrrrkrJrn formatwarningrr)r!rrpr^rirrmsgs r"test_filteredOnceWarningz/WarnAboutFunctionTests.test_filteredOnceWarnings"  QQQ x8PQQQQ111111!!!!!!**,,  ]++Q///"9- #J/ #J/q!(+$Wh&II  LLT   2# 1 1      r$N) r(r)r*r+r`rrrrrrrr,r$r"rrZs ;!;!;!zKKK$000&000(    $0$0$0L000(     r$rcdS)zK Do nothing. This is used to test the deprecation decorators. Nr,r,r$r" dummyCallabler@r$cdS)z[ Do nothing. This is used to test the replacement parameter to L{deprecated}. Nr,r,r$r"dummyReplacementMethodrHrr$cDeZdZdZdZdZdZdZdZdZ dZ d Z d S) DeprecationWarningsTestsctdddd}|t|j|tddS)z L{getDeprecationWarningString} returns a string that tells us that a callable was deprecated at a certain released version of Twisted. ryrzrzZ.DeprecationWarningsTests.test_getDeprecationWarningString was deprecated in Twisted 8.0.0N)rrJr test_getDeprecationWarningStringr(r!r]s r"rz9DeprecationWarningsTests.test_getDeprecationWarningStringQsU )Q1--  '(Mw W W19 <     r$ctdddd}tdz}|t|j||t ddS)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. ryrzrz: This is a messagezm.DeprecationWarningsTests.test_getDeprecationWarningString was deprecated in Twisted 8.0.0: This is a messageN)rr rJrrr()r!r]formats r"*test_getDeprecationWarningStringWithFormatzCDeprecationWarningsTests.test_getDeprecationWarningStringWithFormat]sl )Q1--+.CC  '5w  AI K      r$cZtdddd}t|tfd}td5}t d|||djt|t|dj tt|||dj dt dd d d d S#1swxYwYd S) zK Decorating a callable with L{deprecated} emits a warning. ryrzrcdSrr,)dummysr"rhzJDeprecationWarningsTests.test_deprecateEmitsWarning..addStackLevelts EGGGGGr$TrecordalwayscoN)rrrrrrJrirmstrr^rrrstripr)r!r]rhcaughtrs @r"test_deprecateEmitsWarningz3DeprecationWarningsTests.test_deprecateEmitsWarningmsv)Q1--# 7##M22     4 ( ( ( UF  " " " MOOO   VAY/1C D D D   F1I%&&+M7CC      VAY/66t<S>S T T T U U U U U U U U U U U U U U U U U UsC D  D$'D$ctdddd}t|t}|tj|j|t tt |dS)zK The decorated function has the same name as the original. ryrzrN)rrrrJr(fullyQualifiedNamer!r]rs r"test_deprecatedPreservesNamez5DeprecationWarningsTests.test_deprecatedPreservesNamesw)Q1--# 7##M22 /@@@ +M::.localDummyCallablerr$ryrzrrN)rrr r rJr+)r!r r]rs r"test_deprecatedUpdatesDocstringz8DeprecationWarningsTests.test_deprecatedUpdatesDocstrings}    )Q1--# 7##$677-/GQS/T/TUUU +3U]CCCCCr$ctdddd}t|t}|||jdS)zt Deprecating a function adds version information to the decorated version of that function. ryrzrN)rrrrJdeprecatedVersionrs r"test_versionMetadataz-DeprecationWarningsTests.test_versionMetadatasM )Q1--# 7##M22 %"9:::::r$ctdddd}t|j|d}||t |jddS)a 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. ryrzrsomething.foobar replacementzE was deprecated in Twisted 8.0.0; please use something.foobar insteadN)rrrrJrr!r] warningStrings r"+test_getDeprecationWarningStringReplacementzDDeprecationWarningsTests.test_getDeprecationWarningStringReplacementsx)Q1--3  1 *    +D,QRRRR U     r$ctdddd}t|j|t}||t |jdt ddS)a 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. ryrzrrz- was deprecated in Twisted 8.0.0; please use z.dummyReplacementMethod insteadN)rrrrrJrr(rs r"7test_getDeprecationWarningStringReplacementWithCallablezPDeprecationWarningsTests.test_getDeprecationWarningStringReplacementWithCallables)Q1--3  1 .    "$"GHHHH((( T     r$N) r(r)r*rrrrr r rrrr,r$r"rrPs       UUU*WWW   DDD(;;;   &     r$rryrPrxceZdZdZdS)DeprecatedClasszJ Class which is entirely deprecated without having a replacement. N)r(r)r*r+r,r$r"rrsr$rcveZdZdZdZeedddddZejdZdS) ClassWithDeprecatedPropertyz2 Class with a single deprecated property. NryrPrxrc|jS)zC Getter docstring. @return: The property. _someProtectedValuer&s r" somePropertyz(ClassWithDeprecatedProperty.somePropertys ''r$c||_dS)z# Setter docstring. Nr r s r"r"z(ClassWithDeprecatedProperty.somePropertys $)   r$) r(r)r*r+r!rrr"setterr,r$r"rrsz 1a3344((54()))))r$rr0cdS)z7 Function with a deprecated keyword parameter. Nr,)abcr0bars r"functionWithDeprecatedParameterr+rr$c<eZdZdZdZdZdZdZdZdZ dZ d S) DeprecatedDecoratorTestsz* Tests for deprecated decorators. ct||d|jDdS)a8 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} c^g|]*}||+Sr,)strip).0rs r" z.s-SSSQSqwwyySSSr$N)rJr+ splitlines)r!targetexpecteds r"assertDocstringz(DeprecatedDecoratorTests.assertDocstringsH  SS&.*C*C*E*ESSS     r$ct}|j|tjgdtddddtj_d}||jg}|dt||t|dd|||dd d S) a% 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.ryrPrxrktwisted.python.test.test_deprecate.ClassWithDeprecatedProperty.someProperty was deprecated in Twisted 1.2.3rrir^N) rr"r6rrrktest_propertyGetterrJrnrm)r!objr^rs r"r:z,DeprecatedDecoratorTests.test_propertyGetters*++   ' 4      FM q!QF F #0B  ; %%t'?&@AA CMM*** +Xa[-DEEE (1+i"899999r$ct}t}||_|||jd}||jg}|dt||t|dd|||dddS)z} When L{deprecatedProperty} is used on a C{property}, setter accesses raise a L{DeprecationWarning}. r9rPrrir^N) rHrr"r>r!rktest_propertySetterrJrnrm)r!newValuer;r^rs r"r=z,DeprecatedDecoratorTests.test_propertySetter4s 88)++# h 7888 ; %%t'?&@AA CMM*** +Xa[-DEEE (1+i"899999r$ct|tddgtddddt_d}||jg}|dt||t|dd |||dd d S) a 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.r8ryrPrxrzRtwisted.python.test.test_deprecate.DeprecatedClass was deprecated in Twisted 1.2.3rrir^N) rr6rrrk test_classrJrnrm)r!r^rs r"r@z#DeprecatedDecoratorTests.test_classHs   V.    -4Iq!Q,G,G) . %%t&788 CMM*** +Xa[-DEEE (1+i"899999r$ctdddd}t|dt}||jddS)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 string, it will be interpolated directly into the warning message. ryrzrrz Do nothing. This is used to test the deprecation decorators. Deprecated in Twisted 8.0.0; please use something.foobar instead. N)rrrrJr+rs r"test_deprecatedReplacementz3DeprecatedDecoratorTests.test_deprecatedReplacementcs])Q1--7 7$677 FF  M      r$ctdddd}t|t}|t}||jdtdS)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. ryrzrrz Do nothing. This is used to test the deprecation decorators. Deprecated in Twisted 8.0.0; please use {}.dummyReplacementMethod instead. N)rrrrrJr+rr()r!r] decoratorrs r"&test_deprecatedReplacementWithCallablez?DeprecatedDecoratorTests.test_deprecatedReplacementWithCallablevst)Q1--w4JKKK  -((  M 34:6(3C3C      r$cd}td5}tdtdd||gtddd||gtddd |t |d ||d jt |t|d j|| tddd ||gtdddd|t |d ||d jt |t|d j|ddddS#1swxYwYdS)NzzThe 'foo' parameter to twisted.python.test.test_deprecate.functionWithDeprecatedParameter was deprecated in Twisted 19.2.0Trr ()r0rPr2)r*) rrr+rJrnrirmrr^r)r!r^wss r"test_deprecatedKeywordParameterz8DeprecatedDecoratorTests.test_deprecatedKeywordParameters / 4 ( ( ( :B  " " " +B 3 3 3   R $ $ $ +BB 7 7 7   R $ $ $ +B ; ; ; ;   SWWa ( ( (   RU^-? @ @ @   SA// 9 9 9 HHJJJ +B ; ; ; ;   R $ $ $ +BB ; ; ;   SWWa ( ( (   RU^-? @ @ @   SA// 9 9 9+ : : : : : : : : : : : : : : : : : :sF+G  GGN) r(r)r*r+r6r:r=r@rBrErMr,r$r"r-r-s    :::@:::(:::6   &   &:::::r$r-c$eZdZdZdZdZdZdS)AppendToDocstringTestszk Test the _appendToDocstring function. _appendToDocstring is used to add text to a docstring. cbd}t|d|d|jdS)zP Appending to an empty docstring simply replaces the docstring. cdSrr,r,r$r" noDocstringzGAppendToDocstringTests.test_appendToEmptyDocstring..noDocstringrr$Appended text.Nr rJr+)r!rRs r"test_appendToEmptyDocstringz2AppendToDocstringTests.test_appendToEmptyDocstringsD     ;(8999 );+>?????r$cd}t|d|gd|j||jddS)a 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. cdS);This doesn't comply with standards, but is here for a test.Nr,r,r$r"singleLineDocstringzTAppendToDocstringTests.test_appendToSingleLineDocstring..singleLineDocstringrr$rS)rXrrS N)r rJr+r3rr)r!rYs r" test_appendToSingleLineDocstringz7AppendToDocstringTests.test_appendToSingleLineDocstrings N N N .0@AAA     ' 2 2 4 4     +3<.multiLineDocstringrr$rSz1 This is a multi-line docstring. Appended text. NrT)r!r^s r"test_appendToMultilineDocstringz6AppendToDocstringTests.test_appendToMultilineDocstringsP    -/?@@@  L  &     r$N)r(r)r*r+rUr[r_r,r$r"rOrOsQ @ @ @DDD2     r$rOcTeZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd S)MutualArgumentExclusionTestsz2 Tests for L{mutuallyExclusiveArguments}. cttddr#ttj|||St tj|||S)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)rAinspectrrcr getargspecr!funcargskws r" checkPassedz(MutualArgumentExclusionTests.checkPassedsU 7K . . F#G$5d$;$;T2FF F"'"4T":":D"EE Er$cd}|||ddtdddS)z` L{passed} identifies the arguments passed by a simple positional test. cdSrr,r'r(s r"rgzGMutualArgumentExclusionTests.test_passed_simplePositional..func rr$rPrxrmNrJrjrr!rgs r"test_passed_simplePositionalz9MutualArgumentExclusionTests.test_passed_simplePositionalsK     ))$155ta1~~~FFFFFr$cTd}|t|j|ddddS)z[ L{passed} raises a L{TypeError} if too many arguments are passed. cdSrr,rms r"rgzBMutualArgumentExclusionTests.test_passed_tooManyArgs..funcrr$rPrxrNr? TypeErrorrjros r"test_passed_tooManyArgsz4MutualArgumentExclusionTests.test_passed_tooManyArgss:     )T%5tQ1EEEEEr$cTd}|t|j|dddS)zs L{passed} raises a L{TypeError} if a argument is passed both positionally and by keyword. cdSrr,r's r"rgzHMutualArgumentExclusionTests.test_passed_doublePassKeyword..func rr$rPrxrxNrsros r"test_passed_doublePassKeywordz:MutualArgumentExclusionTests.test_passed_doublePassKeyword;     )T%5tQ!DDDDDr$cTd}|t|j|dddS)z L{passed} raises a L{TypeError} if a keyword argument not present in the function's declaration is passed. cdSrr,rxs r"rgzIMutualArgumentExclusionTests.test_passed_unspecifiedKeyword..func+rr$rPrx)zNrsros r"test_passed_unspecifiedKeywordz;MutualArgumentExclusionTests.test_passed_unspecifiedKeyword%rzr$cd}|||dddtdddS)z| L{passed} places additional positional arguments into a tuple under the name of the star argument. cdSrr,rms r"rgz;MutualArgumentExclusionTests.test_passed_star..func6rr$rPrxr)rxrrmNrnros r"test_passed_starz-MutualArgumentExclusionTests.test_passed_star0sP     ))$1a88$f:M:M:MNNNNNr$c d}|||ddddtdtddddS) zn Additional keyword arguments are passed as a dict to the star star keyword argument. cdSrr,rms r"rgz?MutualArgumentExclusionTests.test_passed_starStar..funcArr$rPrxr)ryr}rmNrnros r"test_passed_starStarz1MutualArgumentExclusionTests.test_passed_starStar;sp        T1Q!  4 4dQ$aSTBUBUBU6V6V6V     r$cd d}|||dddtddddS) zp The results of L{passed} only include arguments explicitly passed, not default values. rPrxrcdSrr,r'r(r)des r"rgzFMutualArgumentExclusionTests.test_passed_noDefaultValues..funcNrr$)r)r'r(rNrPrxrrnros r"test_passed_noDefaultValuesz8MutualArgumentExclusionTests.test_passed_noDefaultValuesHsZ      ))$1)::D1Q.funcZsq519q= r$rPrxrGrr( Nrr)rrJros r""test_mutualExclusionPrimeDirectivez?MutualArgumentExclusionTests.test_mutualExclusionPrimeDirectiveSs %j\ 2 2 ! ! ! 3 2 ! aR((( aA+++ aa"-----r$cztddggdd}|t|dddS) z L{mutuallyExclusiveArguments} raises a L{TypeError}n if its decoratee is passed a pair of mutually exclusive arguments. r'r(rrc ||zSrr,rms r"rgzPMutualArgumentExclusionTests.test_mutualExclusionExcludesByKeyword..funchs q5Lr$rmNr)rr?rtros r"%test_mutualExclusionExcludesByKeywordzBMutualArgumentExclusionTests.test_mutualExclusionExcludesByKeywordbsV %sCj\ 2 2    3 2  )TQ!44444r$c,Gdd}Gdd}d}|ddtj|j}|}|dd|d <||}|t t |d id S) z Create a fake signature with an invalid parameter type to test error handling. The valid parameter types are specified in L{inspect.Parameter}. ceZdZdZdS)MMutualArgumentExclusionTests.test_invalidParameterType..FakeSignaturec||_dSr) parameters)r!rs r"r#zVMutualArgumentExclusionTests.test_invalidParameterType..FakeSignature.__init__vs ",r$Nr(r)r*r#r,r$r" FakeSignaturerus# - - - - -r$rceZdZdZdS)MMutualArgumentExclusionTests.test_invalidParameterType..FakeParameterc"||_||_dSr)rokind)r!rors r"r#zVMutualArgumentExclusionTests.test_invalidParameterType..FakeParameter.__init__zs    r$Nrr,r$r" FakeParameterrys# ! ! ! ! !r$rcdSrr,rms r"rgzDMutualArgumentExclusionTests.test_invalidParameterType..func~rr$rPrxfaker)rPrxN)rdrcrrr?rtr)r!rrrgrdummyParametersfakeSigs r"test_invalidParameterTypez6MutualArgumentExclusionTests.test_invalidParameterTypens - - - - - - - - ! ! ! ! ! ! ! !     Q &t,,7 $//++,}VV<<-00 )%5wKKKKKr$N)r(r)r*r+rjrpruryr~rrrrrrr,r$r"rarasFFF, G G G F F F E E E E E E O O O     Q Q Q . . . 5 5 5LLLLLr$raceZdZdZdZdZdS)KeywordOnlyTestsz, Keyword only arguments (PEP 3102). cHttj|||S)a 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} )rrdrcrfs r"rjzKeywordOnlyTests.checkPasseds!  1$ 7 7rBBBr$c ddd}ddd}|||dddtdd |||dddd tdd |||ddd ddd td d ddd |t|j|ddd dddS)z` Keyword only arguments follow varargs. They are specified in PEP 3102. TrcdS)zM b is a keyword-only argument, with a default value. Nr,)r(r's r"func1z6KeywordOnlyTests.test_passedKeywordOnly..func1rr$cdS)zd b, c, d, e are keyword-only arguments. b has a default value. Nr,)r(r)rrr's r"func2z6KeywordOnlyTests.test_passedKeywordOnly..func2rr$rPrxrrrmF)r(r)rrrr)r(r)rN)rJrjrr?rt)r!rrs r"test_passedKeywordOnlyz'KeywordOnlyTests.test_passedKeywordOnlys;             ))%Aq994)t;T;T;TUUU    UAq!u  5 5ti57Q7Q7Q       UAqEQ!q  A A 6Ua1 2 2 2    )T%5uaeqTUVVVVVr$N)r(r)r*r+rjrr,r$r"rrsDCCC"WWWWWr$rr)7r+rdr{r1ros.pathrrr importlibr ImportError incrementalrtwisted.pythonrtwisted.python.deprecater r r rr r rrrrrrrtwisted.python.filepathrtwisted.python.runtimertwisted.python.testr#twisted.python.test.modules_helpersrtwisted.trial.unittestrrr.r[rrrrrrrr+r-rOrarr,r$r"rs  11111111+++++++ $$$$$$                            -,,,,,++++++444444CCCCCC666666"DYDYDYDYDY*DYDYDYN_@_@_@_@_@2_@_@_@Dl%l%l%l%l%#68Kl%l%l%^c c c c c 0c c c LG G G G G 2G G G T GGIq!Q ' '(()( ))))))))0GGIr1a88%@@A@ f:f:f:f:f:2f:f:f:R= = = = = 0= = = @]L]L]L]L]L#6]L]L]L@/W/W/W/W/W*/W/W/W/W/Ws )33