o i@sdZddlZddlZddlZddlZddlmZddlmZmZzddl m Z Wn e y3dZ Ynwddl m Z ddlmZddlmZmZmZmZmZmZmZmZmZmZmZmZdd lmZdd l m!Z!dd l"m#Z#dd l$m%Z%dd l&m'Z'GdddZ(Gddde'Z)Gddde'Z*Gddde%e'Z+Gddde'Z,ddZ-ddZ.Gddde'Z/ee ddd d!Gd"d#d#Z0Gd$d%d%Z1ee dd&d dd'd2d(d)Z2Gd*d+d+e'Z3Gd,d-d-e'Z4Gd.d/d/e'Z5Gd0d1d1e'Z6dS)3zI 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@ eZdZdZddZddZdS)_MockDeprecatedAttributezq Mock of L{twisted.python.deprecate._DeprecatedAttribute}. @ivar value: The value of the attribute. cC ||_dSNvalueselfrr!hC:\Users\psant\Downloads\PAF backend\school\venv\Lib\site-packages\twisted/python/test/test_deprecate.py__init__8 z!_MockDeprecatedAttribute.__init__cC|jS)z$ Get a known value. Nrr r!r!r"get;sz_MockDeprecatedAttribute.getN)__name__ __module__ __qualname____doc__r#r'r!r!r!r"r1s rc@s@eZdZdZddZddZddZdd Zd d Zd d Z 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. cKs2td}|D] \}}t|||q t|S)z Create a temporary module proxy object. @param **kw: Attributes to initialise on the temporary module object @rtype: L{twistd.python.deprecate._ModuleProxy} fooN)types ModuleTypeitemssetattrrZ _ModuleProxy)r attrsmodkeyrr!r!r" _makeProxyIs  zModuleProxyTests._makeProxycCs.|jdd}||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. Zhello)SOME_ATTRIBUTEZDOES_NOT_EXISTN)r5assertIsr6 assertRaisesAttributeErrorgetattrr proxyr!r!r"test_getattrPassthroughVs z(ModuleProxyTests.test_getattrPassthroughcCs2|}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*r-N)r5object__getattribute__r assertEqualr-)r r<r>r!r!r"test_getattrIntercept`s  z&ModuleProxyTests.test_getattrInterceptcCs,|}|tt|d|tt|ddS)z Private attributes of L{twisted.python.deprecate._ModuleProxy} are inaccessible when regular attribute access is used. _moduler>N)r5r8r9r:r;r!r!r"test_privateAttributesksz'ModuleProxyTests.test_privateAttributescCs4|}d|_|t|dd||jddS)z Setting attributes on L{twisted.python.deprecate._ModuleProxy} proxies them through to the wrapped module. rDN)r5rDassertNotEqualr@rArBr;r!r!r" test_setattrtszModuleProxyTests.test_setattrcCs<|}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. rDN)r5r@rArBreprtyper()r r<Z realModuler!r!r" test_repr~s (zModuleProxyTests.test_reprN) r(r)r*r+r5r=rCrErHrMr!r!r!r"r,Bs    r,c@s8eZdZdZddZddZddZdd Zd d Zd S) DeprecatedAttributeTestsz Tests for L{twisted.python.deprecate._DeprecatedAttribute} and L{twisted.python.deprecate.deprecatedModuleAttribute}, which issue warnings for deprecated module-level attributes. cCstj|_tj|_td|_dS)Nz.foo)rversionmessager(_testModuleNamer&r!r!r"setUpszDeprecatedAttributeTests.setUpcCs"ttjd|tjtdtjS)zJ Create the warning string used by deprecated attributes. .z: N)r rr(rOrrP)r attrr!r!r"_getWarningStrings   z*DeprecatedAttributeTests._getWarningStringcsd}tt|dtt||j|j|j|fdd}|||j g}| |ddt ||dd| ||t |dd S) 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. ZANOTHER_DEPRECATED_ATTRIBUTEr?cs dSr)r'r!rTr!r" addStackLevels zNDeprecatedAttributeTests.test_deprecatedAttributeHelper..addStackLevelrcategoryrPrFN)r1rrZ_DeprecatedAttributerOrPrBr( flushWarningstest_deprecatedAttributeHelperr7DeprecationWarningrUlen)r namerW warningsShownr!rVr"rZs   z7DeprecatedAttributeTests.test_deprecatedAttributeHelpercCstj||jg}|t|dd}tt|||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. rZDEPRECATED_ATTRIBUTErFrXrPN) rZANOTHER_ATTRIBUTErYtest_deprecatedAttributerBr\r:r7r[rU)r r^r]r!r!r"r_s z1DeprecatedAttributeTests.test_deprecatedAttributecCstdtj|j<}|tjj|jt|ddt|ddt t ddddd |jdtj|j}| ||t t ddddd |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. r-firstrFsecondTwistedrrPN) r.r/sysmodulesrQ addCleanuppopr1rZdeprecatedModuleAttributerrGr7)r r3r<r!r!r"test_wrappedModules    z+DeprecatedAttributeTests.test_wrappedModuleN) r(r)r*r+rRrUrZr_rir!r!r!r"rNs  rNc@s<eZdZdZdZddZddZddZd d Zd d Z d S)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') cs^fddt|d}|||}||jdgtj|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. csji}|D],\}}||}t|tr|||<||qt|tr/|||||<qtd|S)Nz(only strings and dicts allowed as values)r0child isinstancebytes setContentdictZcreateDirectory ValueError)ZpathobjZdirdictZpathdictr4rrk makeSomeFilesr!r"rrs    zAImportedModuleAttributeTests.pathEntryTree..makeSomeFilesutf-8N) rmktempencodemakedirsZreplaceSysPathpathdecodereZreplaceSysModulesrfcopy)r treebaseresultr!rqr" pathEntryTrees  z*ImportedModuleAttributeTests.pathEntryTreecCs(|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}. spackagers)s __init__.py module.pyrN)r} _packageInitru)r pathsr!r!r"simpleModuleEntrys  z.ImportedModuleAttributeTests.simpleModuleEntrycCsnddlm}|t|jd|||jg}|t|d||ddd||ddt dS) zB Verification logic for L{test_deprecatedModule}. rmodulersrFrPz7package.module was deprecated in Package 1.2.3: messagerXN) packagerrBr__file__rurYcheckOneWarningr\r[)r Z modulePathrZemittedr!r!r"r.s  z,ImportedModuleAttributeTests.checkOneWarningcCs||dS)z If L{deprecatedModuleAttribute} is used to deprecate a module attribute of a package, only one deprecation warning is emitted when the deprecated module is imported. N)rrr&r!r!r"test_deprecatedModule=sz2ImportedModuleAttributeTests.test_deprecatedModulecCs8|}||||tdD]}||qdS)z If L{deprecatedModuleAttribute} is used to deprecate a module attribute of a package, only one deprecation warning is emitted when the deprecated module is subsequently imported. rbN)rrrange)r mpxr!r!r""test_deprecatedModuleMultipleTimesEs     z?ImportedModuleAttributeTests.test_deprecatedModuleMultipleTimesN) r(r)r*r+rr}rrrrr!r!r!r"rjs& rjc@sPeZdZdZddZddZddZdd Zd d Zd d Z ddZ ddZ dS)WarnAboutFunctionTestsz Tests for L{twisted.python.deprecate.warnAboutFunction} which allows the callers of a function to issue a C{DeprecationWarning} about that function. cst|d|_|j|jdd|jdd|jdd|jj}tj d|| tjj |tj | fd d trW|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") rcstjtjfSr)rerfclearupdater!rfr!r"sz.WarnAboutFunctionTests.setUp..N)rrtrkrrvrnparentrwreinsertrgremoverfryrZ isWindowsrY)r Z packagePathr!rr"rR`s"      zWarnAboutFunctionTests.setUpcCsndd}t|d|}t}|dr|dd}|t|ddt|||dd ddS) 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. cSdSrr!r!r!r!r"aFuncz2WarnAboutFunctionTests.test_warning..aFunczA Warning Messagez.pycNrfilenamerP) rZwarnAboutFunctionrYrlowerendswithassertSamePathrrB)r rr^rr!r!r" test_warnings  z#WarnAboutFunctionTests.test_warningcCddlm}||}|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. rrrrstwisted_private_helperrlineno rPA Warning StringrFN) rrcallTestFunctionrYrrrursiblingrkrBr\r rr^r!r!r"test_warningLineNumbers z-WarnAboutFunctionTests.test_warningLineNumbercCr) 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)pep626rrsrs pep626.pyrrPrrFN) rrrrYrrrurrrkrBr\)r rr^r!r!r"'test_warningLineNumberDisFindlinestartss z>WarnAboutFunctionTests.test_warningLineNumberDisFindlinestartscCs*|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) assertTruerrw)r r`rar!r!r"rs  z%WarnAboutFunctionTests.assertSamePathcCsddlm}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_helperrrsrrrrPrrFN)rrrerfr(rZmoveTorrrrgrhrrYZ testFunctionrrurkrrBr\)r rr^Z warnedPathZ expectedPathr!r!r"test_renamedFiles&     z'WarnAboutFunctionTests.test_renamedFilecCsJtjdd=tjdddddlm}||}|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) warningsfiltersfilterwarningsrrrrYrBr\rr!r!r"test_filteredWarning s  z+WarnAboutFunctionTests.test_filteredWarningcCstjdd=tjdddddlm}|||}|t|d|dd}|dd }|dd }|dd }t ||||}| | 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. NrrrrrrFrPrXrrz=module.py:9: DeprecationWarning: A Warning String return a zUnexpected warning string: ) rrrrrrrYrBr\ formatwarningrr)r rr^rPrXrrmsgr!r!r"test_filteredOnceWarnings$      z/WarnAboutFunctionTests.test_filteredOnceWarningN) r(r)r*r+rRrrrrrrrr!r!r!r"rZs=& rcCdS)zK Do nothing. This is used to test the deprecation decorators. Nr!r!r!r!r" dummyCallable@rcCr)z[ Do nothing. This is used to test the replacement parameter to L{deprecated}. Nr!r!r!r!r"dummyReplacementMethodHrrc@sTeZdZddZddZddZddZd d Zd d Zd dZ ddZ ddZ dS)DeprecationWarningsTestscCs,tdddd}|t|j|dtfdS)z L{getDeprecationWarningString} returns a string that tells us that a callable was deprecated at a certain released version of Twisted. rcrdrz\%s.DeprecationWarningsTests.test_getDeprecationWarningString was deprecated in Twisted 8.0.0N)rrBr test_getDeprecationWarningStringr(r rOr!r!r"rQs z9DeprecationWarningsTests.test_getDeprecationWarningStringcCs6tdddd}td}|t|j||dtfdS)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. rcrdrz: This is a messagezo%s.DeprecationWarningsTests.test_getDeprecationWarningString was deprecated in Twisted 8.0.0: This is a messageN)rrrBrrr()r rOformatr!r!r"*test_getDeprecationWarningStringWithFormat]szCDeprecationWarningsTests.test_getDeprecationWarningStringWithFormatcstdddd}t|tfdd}tdd6}td|||djt|t|dj t t|||dj d t d Wd d S1sQwYd S) zK Decorating a callable with L{deprecated} emits a warning. rcrdrcs dSrr!r!dummyr!r"rWtr$zJDeprecationWarningsTests.test_deprecateEmitsWarning..addStackLevelTrecordalwayscoN)rrrrrrBrXr[strrPrrrstripr)r rOrWZcaughtr!rr"test_deprecateEmitsWarningms     "z3DeprecationWarningsTests.test_deprecateEmitsWarningcCsBtdddd}t|t}|tj|j|ttt|dS)zK The decorated function has the same name as the original. rcrdrN)rrrrBr(fullyQualifiedNamer rOrr!r!r"test_deprecatedPreservesNames z5DeprecationWarningsTests.test_deprecatedPreservesNamecCs$tdddd}|dt|ddS)zr L{_getDeprecationDocstring} returns a note about the deprecation to go into a docstring. rcrdrzDeprecated in Twisted 8.0.0.N)rrBr rr!r!r"test_getDeprecationDocstrings z5DeprecationWarningsTests.test_getDeprecationDocstringcCsFdd}tdddd}t||}t|t|d||j|jdS)zv The docstring of the deprecated function is appended with information about the deprecation. cSr)zc Do nothing. This is used to test the deprecation decorators. Nr!r!r!r!r"localDummyCallablerzTDeprecationWarningsTests.test_deprecatedUpdatesDocstring..localDummyCallablercrdrrN)rrr r rBr+)r rrOrr!r!r"test_deprecatedUpdatesDocstrings  z8DeprecationWarningsTests.test_deprecatedUpdatesDocstringcCs,tdddd}t|t}|||jdS)zt Deprecating a function adds version information to the decorated version of that function. rcrdrN)rrrrBdeprecatedVersionrr!r!r"test_versionMetadatas z-DeprecationWarningsTests.test_versionMetadatacCs:tdddd}t|j|dd}||dt|jfdS)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. rcrdrsomething.foobar replacementzG%s was deprecated in Twisted 8.0.0; please use something.foobar insteadN)rrrrBrr rOZ warningStringr!r!r"+test_getDeprecationWarningStringReplacements zDDeprecationWarningsTests.test_getDeprecationWarningStringReplacementcCs<tdddd}t|j|td}||dt|jtfdS)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. rcrdrrzP%s was deprecated in Twisted 8.0.0; please use %s.dummyReplacementMethod insteadN)rrrrrBrr(rr!r!r"7test_getDeprecationWarningStringReplacementWithCallables zPDeprecationWarningsTests.test_getDeprecationWarningStringReplacementWithCallableN) r(r)r*rrrrrrrrrr!r!r!r"rPs    rrcrFrbc@seZdZdZdS)DeprecatedClasszJ Class which is entirely deprecated without having a replacement. N)r(r)r*r+r!r!r!r"rsrc@s<eZdZdZdZeeddddddZejd dZdS) ClassWithDeprecatedPropertyz2 Class with a single deprecated property. NrcrFrbrcCr%)zC Getter docstring. @return: The property. N_someProtectedValuer&r!r!r" somePropertysz(ClassWithDeprecatedProperty.somePropertycCs ||_dS)z# Setter docstring. Nrrr!r!r"rs ) r(r)r*r+rrrrsetterr!r!r!r"rs rr-cCr)z7 Function with a deprecated keyword parameter. Nr!)abcr-barr!r!r"functionWithDeprecatedParameterrrc@sHeZdZdZddZddZddZdd Zd d Zd d Z ddZ dS)DeprecatedDecoratorTestsz* Tests for deprecated decorators. cCs ||dd|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} cSsg|] }|r|qSr!)strip).0rr!r!r" sz.N)rBr+ splitlines)r targetexpectedr!r!r"assertDocstrings z(DeprecatedDecoratorTests.assertDocstringcCs~t}|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.rcrFrbrktwisted.python.test.test_deprecate.ClassWithDeprecatedProperty.someProperty was deprecated in Twisted 1.2.3rrXrPN) rrrrrrYtest_propertyGetterrBr\r[)r objrPrr!r!r"rsz,DeprecatedDecoratorTests.test_propertyGettercCsnt}t}||_|||jd}||jg}|dt||t |dd|||dddS)z} When L{deprecatedProperty} is used on a C{property}, setter accesses raise a L{DeprecationWarning}. rrFrrXrPN) r@rrr7rrYtest_propertySetterrBr\r[)r ZnewValuerrPrr!r!r"r4sz,DeprecatedDecoratorTests.test_propertySettercCstt|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.rrcrFrbrzRtwisted.python.test.test_deprecate.DeprecatedClass was deprecated in Twisted 1.2.3rrXrPN) rrrrrY test_classrBr\r[)r rPrr!r!r"rHsz#DeprecatedDecoratorTests.test_classcCs.tdddd}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. rcrdrrz Do nothing. This is used to test the deprecation decorators. Deprecated in Twisted 8.0.0; please use something.foobar instead. N)rrrrBr+rr!r!r"test_deprecatedReplacementcs z3DeprecatedDecoratorTests.test_deprecatedReplacementcCs:tdddd}t|td}|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. rcrdrrz Do nothing. This is used to test the deprecation decorators. Deprecated in Twisted 8.0.0; please use {}.dummyReplacementMethod instead. N)rrrrrBr+rr()r rO decoratorrr!r!r"&test_deprecatedReplacementWithCallablevs z?DeprecatedDecoratorTests.test_deprecatedReplacementWithCallablecCsd}tdd{}tdtdd||gtddd||gtdddd |t|d ||d jt|t|d j|| tddd d ||gtdddd|t|d ||d jt|t|d j|WddS1swYdS)NzzThe 'foo' parameter to twisted.python.test.test_deprecate.functionWithDeprecatedParameter was deprecated in Twisted 19.2.0Trr ()r-rFr2)r) rrrrBr\rXr[rrPr)r rPwsr!r!r"test_deprecatedKeywordParameters(      "z8DeprecatedDecoratorTests.test_deprecatedKeywordParameterN) r(r)r*r+rrrrrrrr!r!r!r"rs  rc@s(eZdZdZddZddZddZdS) AppendToDocstringTestszk Test the _appendToDocstring function. _appendToDocstring is used to add text to a docstring. cCs$dd}t|d|d|jdS)zP Appending to an empty docstring simply replaces the docstring. cSrrr!r!r!r!r" noDocstringrzGAppendToDocstringTests.test_appendToEmptyDocstring..noDocstringAppended text.Nr rBr+)r rr!r!r"test_appendToEmptyDocstrings z2AppendToDocstringTests.test_appendToEmptyDocstringcCs>dd}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. cSr);This doesn't comply with standards, but is here for a test.Nr!r!r!r!r"singleLineDocstringrzTAppendToDocstringTests.test_appendToSingleLineDocstring..singleLineDocstringr)rrr N)r rBr+rrr)r rr!r!r" test_appendToSingleLineDocstrings z7AppendToDocstringTests.test_appendToSingleLineDocstringcCs$dd}t|d|d|jdS)z Appending to a multi-line docstring places the messade on a new line, with a blank line separating it from the rest of the docstring. Because we have multiple lines, we have enough information to do indentation. cSr)z9 This is a multi-line docstring. Nr!r!r!r!r"multiLineDocstringrzRAppendToDocstringTests.test_appendToMultilineDocstring..multiLineDocstringrz1 This is a multi-line docstring. Appended text. Nr)r rr!r!r"test_appendToMultilineDocstrings  z6AppendToDocstringTests.test_appendToMultilineDocstringN)r(r)r*r+rrrr!r!r!r"rs  rc@sheZdZdZddZddZddZdd Zd d Zd d Z ddZ ddZ ddZ ddZ ddZdS)MutualArgumentExclusionTestsz2 Tests for L{mutuallyExclusiveArguments}. cOs0ttddrtt|||Stt|||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)r:inspectrr r getargspecr funcargskwr!r!r" checkPasseds z(MutualArgumentExclusionTests.checkPassedcCs*dd}|||ddtddddS)z` L{passed} identifies the arguments passed by a simple positional test. cSrrr!rrr!r!r"r rzGMutualArgumentExclusionTests.test_passed_simplePositional..funcrFrbrNrBrror rr!r!r"test_passed_simplePositionals"z9MutualArgumentExclusionTests.test_passed_simplePositionalcCs"dd}|t|j|ddddS)z[ L{passed} raises a L{TypeError} if too many arguments are passed. cSrrr!rr!r!r"rrzBMutualArgumentExclusionTests.test_passed_tooManyArgs..funcrFrbrNr8 TypeErrorrrr!r!r"test_passed_tooManyArgsz4MutualArgumentExclusionTests.test_passed_tooManyArgscC"dd}|jt|j|ddddS)zs L{passed} raises a L{TypeError} if a argument is passed both positionally and by keyword. cSrrr!rr!r!r"r rzHMutualArgumentExclusionTests.test_passed_doublePassKeyword..funcrFrbrNrrr!r!r"test_passed_doublePassKeywordrz:MutualArgumentExclusionTests.test_passed_doublePassKeywordcCr)z L{passed} raises a L{TypeError} if a keyword argument not present in the function's declaration is passed. cSrrr!rr!r!r"r+rzIMutualArgumentExclusionTests.test_passed_unspecifiedKeyword..funcrFrb)zNrrr!r!r"test_passed_unspecifiedKeyword%rz;MutualArgumentExclusionTests.test_passed_unspecifiedKeywordcCs,dd}|||dddtddddS) z| L{passed} places additional positional arguments into a tuple under the name of the star argument. cWrrr!rr!r!r"r6rz;MutualArgumentExclusionTests.test_passed_star..funcrFrbr)rbrrNrrr!r!r"test_passed_star0s$z-MutualArgumentExclusionTests.test_passed_starc Cs:dd}||j|dddddtdtdddddd S) zn Additional keyword arguments are passed as a dict to the star star keyword argument. c[rrr!rr!r!r"rArz?MutualArgumentExclusionTests.test_passed_starStar..funcrFrbr)ryrrNrrr!r!r"test_passed_starStar;s&z1MutualArgumentExclusionTests.test_passed_starStarcCs2d dd}||j|ddddtddddd S) zp The results of L{passed} only include arguments explicitly passed, not default values. rFrbrcSrrr!rrrder!r!r"rNrzFMutualArgumentExclusionTests.test_passed_noDefaultValues..func)r%)rrr%NrFrbrrrr!r!r"test_passed_noDefaultValuesHs (z8MutualArgumentExclusionTests.test_passed_noDefaultValuescCsTtdgddd}||ddd||ddd d ||ddd d d d S)z L{mutuallyExclusiveArguments} does not interfere in its decoratee's operation, either its receipt of arguments or its return value. rrr cSs||||Srr!)rr!rrr!r!r"rZszMMutualArgumentExclusionTests.test_mutualExclusionPrimeDirective..funcrFrbrr&r Nrr )r rBrr!r!r""test_mutualExclusionPrimeDirectiveSs  z?MutualArgumentExclusionTests.test_mutualExclusionPrimeDirectivecCs.tddggd dd}|jt|ddddS) z L{mutuallyExclusiveArguments} raises a L{TypeError}n if its decoratee is passed a pair of mutually exclusive arguments. rrrr cSs||Srr!rr!r!r"rhszPMutualArgumentExclusionTests.test_mutualExclusionExcludesByKeyword..funcrNr,)r r8rrr!r!r"%test_mutualExclusionExcludesByKeywordbs  zBMutualArgumentExclusionTests.test_mutualExclusionExcludesByKeywordcCsnGddd}Gddd}dd}|ddt|j}|}|d d |d <||}|tt|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}. c@eZdZddZdS)zMMutualArgumentExclusionTests.test_invalidParameterType..FakeSignaturecSrr) parameters)r r0r!r!r"r#vr$zVMutualArgumentExclusionTests.test_invalidParameterType..FakeSignature.__init__Nr(r)r*r#r!r!r!r" FakeSignatureu r2c@r/)zMMutualArgumentExclusionTests.test_invalidParameterType..FakeParametercSs||_||_dSr)r]kind)r r]r4r!r!r"r#zs zVMutualArgumentExclusionTests.test_invalidParameterType..FakeParameter.__init__Nr1r!r!r!r" FakeParameteryr3r5cSrrr!rr!r!r"r~rzDMutualArgumentExclusionTests.test_invalidParameterType..funcrFrbZfakerrFrbN)r r r0ryr8rr)r r2r5rr0ZdummyParametersZfakeSigr!r!r"test_invalidParameterTypens  z6MutualArgumentExclusionTests.test_invalidParameterTypeN)r(r)r*r+rrrrrrr"r(r-r.r7r!r!r!r"r s        r c@r)KeywordOnlyTestsz, Keyword only arguments (PEP 3102). cOstt|||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} N)rr r r r!r!r"rszKeywordOnlyTests.checkPassedc Csdddd}dddd}|||ddd td dd ||j|ddd d dtd d d ||j|ddd ddd d tdd ddd d|jt|j|ddd ddddS)z` Keyword only arguments follow varargs. They are specified in PEP 3102. Tr*cWr)zM b is a keyword-only argument, with a default value. Nr!)rrr!r!r"func1rz6KeywordOnlyTests.test_passedKeywordOnly..func1cWr)zd b, c, d, e are keyword-only arguments. b has a default value. Nr!)rrr$r%rr!r!r"func2rz6KeywordOnlyTests.test_passedKeywordOnly..func2rFrbrr'rF)rrr$r%r6r#)rrr$N)rBrror8r)r r9r:r!r!r"test_passedKeywordOnlys  z'KeywordOnlyTests.test_passedKeywordOnlyN)r(r)r*r+rr;r!r!r!r"r8s r8r')7r+r rer.ros.pathrrr importlibr ImportError incrementalrZtwisted.pythonrZtwisted.python.deprecaterr r rr r r rrrrrrZtwisted.python.filepathrZtwisted.python.runtimerZtwisted.python.testrZ#twisted.python.test.modules_helpersrZtwisted.trial.unittestrrr,rNrjrrrrrrrrrr r8r!r!r!r"sR    8     Gbog  *@!