U lj@sdZddlZddlZddlZddlZddlmZddlmZmZzddl m Z Wne k rhdZ YnXddl 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@s eZdZdZddZddZdS)_MockDeprecatedAttributezq Mock of L{twisted.python.deprecate._DeprecatedAttribute}. @ivar value: The value of the attribute. cCs ||_dSNvalueselfrrF/tmp/pip-unpacked-wheel-aghyhbke/twisted/python/test/test_deprecate.py__init__8sz!_MockDeprecatedAttribute.__init__cCs|jS)z$ Get a known value. rrrrr get;sz_MockDeprecatedAttribute.getN)__name__ __module__ __qualname____doc__r!r#rrrr r1src@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|||qt|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 ModuleTypeitemssetattrrZ _ModuleProxy)rattrsmodkeyrrrr _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)r1assertIsr2 assertRaisesAttributeErrorgetattrrproxyrrr 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)r1object__getattribute__r assertEqualr))rr8r:rrr 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)r1r4r5r6r7rrr 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. r@N)r1r@assertNotEqualr<r=r>r7rrr 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. r@N)r1r<r=r>reprtyper$)rr8Z realModulerrr test_repr~s zModuleProxyTests.test_reprN) r$r%r&r'r1r9r?rArDrIrrrr 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"rrr setUpszDeprecatedAttributeTests.setUpcCs"ttjd|tjtdtjS)zJ Create the warning string used by deprecated attributes. .z: )r rr$rKrrL)rattrrrr _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#rrPrr addStackLevelszNDeprecatedAttributeTests.test_deprecatedAttributeHelper..addStackLevelrcategoryrLrBN)r-rrZ_DeprecatedAttributerKrLr>r$ flushWarningstest_deprecatedAttributeHelperr3DeprecationWarningrQlen)rnamerS warningsShownrrRr rVs  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_ATTRIBUTErBrTrLN) rZANOTHER_ATTRIBUTErUtest_deprecatedAttributer>rXr6r3rWrQ)rrZrYrrr 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)firstrBsecondTwistedrrLN) r*r+sysmodulesrM addCleanuppopr-rZdeprecatedModuleAttributerrCr3)rr/r8rrr test_wrappedModules&      z+DeprecatedAttributeTests.test_wrappedModuleN) r$r%r&r'rNrQrVr[rerrrr rJs  rJc@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. csli}|D]Z\}}||}t|tr<|||<||q t|tr^|||||<q tdq |S)Nz(only strings and dicts allowed as values)r,child isinstancebytes setContentdictZcreateDirectory ValueError)pathobjZdirdictZpathdictr0rrg makeSomeFilesrr ros     zAImportedModuleAttributeTests.pathEntryTree..makeSomeFilesutf-8) rmktempencodemakedirsZreplaceSysPathpathdecoderaZreplaceSysModulesrbcopy)rtreebaseresultrrnr 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}. spackagerp)s __init__.py module.pyr|)rz _packageInitrr)rpathsrrr simpleModuleEntrys z.ImportedModuleAttributeTests.simpleModuleEntrycCsnddlm}|t|jd|||jg}|t|d||ddd||ddt dS) zB Verification logic for L{test_deprecatedModule}. rmodulerprBrLz7package.module was deprecated in Package 1.2.3: messagerTN) packagerr>r__file__rrrUcheckOneWarningrXrW)rZ modulePathrZemittedrrr 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"rrr test_deprecatedModule=sz2ImportedModuleAttributeTests.test_deprecatedModulecCs8|}||||tdD]}||q$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 subsequently imported. r^N)rrrange)rmpxrrr "test_deprecatedModuleMultipleTimesEs    z?ImportedModuleAttributeTests.test_deprecatedModuleMultipleTimesN) r$r%r&r'r}rzrrrrrrrr rfs&rfc@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 tr|d 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)rarbclearupdaterrbrr r{z.WarnAboutFunctionTests.setUp..N)rrqrgrrsrjparentrtrainsertrcremoverbrvrZ isWindowsrU)rZ packagePathrrr rN`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. cSsdSrrrrrr aFuncsz2WarnAboutFunctionTests.test_warning..aFunczA Warning Messagez.pycNrfilenamerL) rZwarnAboutFunctionrUrlowerendswithassertSamePathrr>)rrrZrrrr test_warnings  z#WarnAboutFunctionTests.test_warningcCsddlm}||}|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. rrrrptwisted_private_helperr|lineno rLA Warning StringrBN) rrcallTestFunctionrUrrrrrsiblingrgr>rXrrrZrrr test_warningLineNumbers z-WarnAboutFunctionTests.test_warningLineNumbercCsddlm}||}|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)pep626rrprs pep626.pyrrLrrBN) rrrrUrrrrrrrgr>rX)rrrZrrr '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) assertTruerrt)rr\r]rrr rs  z%WarnAboutFunctionTests.assertSamePathcCsddlm}tjd=tj|j=|j|jdtrrX)rrrZZ warnedPathZ expectedPathrrr 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) warningsfiltersfilterwarningsrrrrUr>rXrrrr 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. NrrrrrrBrLrTrrz=module.py:9: DeprecationWarning: A Warning String return a zUnexpected warning string: ) rrrrrrrUr>rX formatwarningrr)rrrZrLrTrrmsgrrr test_filteredOnceWarnings$      z/WarnAboutFunctionTests.test_filteredOnceWarningN) r$r%r&r'rNrrrrrrrrrrr rZs=&rcCsdS)zK Do nothing. This is used to test the deprecation decorators. Nrrrrr dummyCallable@srcCsdS)z[ Do nothing. This is used to test the replacement parameter to L{deprecated}. Nrrrrr dummyReplacementMethodHsrc@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. r_r`rz\%s.DeprecationWarningsTests.test_getDeprecationWarningString was deprecated in Twisted 8.0.0N)rr>r test_getDeprecationWarningStringr$rrKrrr 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. r_r`rz: This is a messagezo%s.DeprecationWarningsTests.test_getDeprecationWarningString was deprecated in Twisted 8.0.0: This is a messageN)rrr>rrr$)rrKformatrrr *test_getDeprecationWarningStringWithFormat]szCDeprecationWarningsTests.test_getDeprecationWarningStringWithFormatc stdddd}t|tfdd}tdd`}td|||djt|t|dj t t|||dj d t d W5QRXd S) zK Decorating a callable with L{deprecated} emits a warning. r_r`rcs dSrrrdummyrr rStszJDeprecationWarningsTests.test_deprecateEmitsWarning..addStackLevelTrecordalwayscoN)rrrrrr>rTrWstrrLrrrstripr)rrKrSZcaughtrrr test_deprecateEmitsWarningms    z3DeprecationWarningsTests.test_deprecateEmitsWarningcCsBtdddd}t|t}|tj|j|ttt|dS)zK The decorated function has the same name as the original. r_r`rN)rrrr>r$fullyQualifiedNamerrKrrrr test_deprecatedPreservesNames z5DeprecationWarningsTests.test_deprecatedPreservesNamecCs$tdddd}|dt|ddS)zr L{_getDeprecationDocstring} returns a note about the deprecation to go into a docstring. r_r`rzDeprecated in Twisted 8.0.0.N)rr>r rrrr 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. cSsdS)zc Do nothing. This is used to test the deprecation decorators. Nrrrrr localDummyCallableszTDeprecationWarningsTests.test_deprecatedUpdatesDocstring..localDummyCallabler_r`rrN)rrr r r>r')rrrKrrrr test_deprecatedUpdatesDocstrings  z8DeprecationWarningsTests.test_deprecatedUpdatesDocstringcCs,tdddd}t|t}|||jdS)zt Deprecating a function adds version information to the decorated version of that function. r_r`rN)rrrr>deprecatedVersionrrrr 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. r_r`rsomething.foobar replacementzG%s was deprecated in Twisted 8.0.0; please use something.foobar insteadN)rrrr>rrrKZ warningStringrrr +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. r_r`rrzP%s was deprecated in Twisted 8.0.0; please use %s.dummyReplacementMethod insteadN)rrrrr>rr$rrrr 7test_getDeprecationWarningStringReplacementWithCallables zPDeprecationWarningsTests.test_getDeprecationWarningStringReplacementWithCallableN) r$r%r&rrrrrrrrrrrrr rPs    rr_rBr^c@seZdZdZdS)DeprecatedClasszJ Class which is entirely deprecated without having a replacement. N)r$r%r&r'rrrr rsrc@s<eZdZdZdZeeddddddZejd dZdS) ClassWithDeprecatedPropertyz2 Class with a single deprecated property. Nr_rBr^rcCs|jS)zC Getter docstring. @return: The property. _someProtectedValuer"rrr somePropertysz(ClassWithDeprecatedProperty.somePropertycCs ||_dS)z# Setter docstring. Nrrrrr rs) r$r%r&r'rrrrsetterrrrr rs  rr)cCsdS)z7 Function with a deprecated keyword parameter. Nr)abcr)barrrr functionWithDeprecatedParametersrc@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).0rrrr sz.N)r>r' splitlines)rtargetexpectedrrr assertDocstrings z(DeprecatedDecoratorTests.assertDocstringcCst}|j|tjdddgtddddtj_d}||jg}|dt||t |d d |||d d 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.r_rBr^rktwisted.python.test.test_deprecate.ClassWithDeprecatedProperty.someProperty was deprecated in Twisted 1.2.3rrTrLN) rrrrrrUtest_propertyGetterr>rXrW)robjrLrrrr rs*z,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}. rrBrrTrLN) r<rrr3rrUtest_propertySetterr>rXrW)rZnewValuerrLrrrr 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.rr_rBr^rzRtwisted.python.test.test_deprecate.DeprecatedClass was deprecated in Twisted 1.2.3rrTrLN) rrrrrU test_classr>rXrW)rrLrrrr 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. r_r`rrz Do nothing. This is used to test the deprecation decorators. Deprecated in Twisted 8.0.0; please use something.foobar instead. N)rrrr>r'rrrr 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. r_r`rrz Do nothing. This is used to test the deprecation decorators. Deprecated in Twisted 8.0.0; please use {}.dummyReplacementMethod instead. N)rrrrr>r'rr$)rrK decoratorrrrr &test_deprecatedReplacementWithCallablevs z?DeprecatedDecoratorTests.test_deprecatedReplacementWithCallablec Csd}tdd}tdtdd||gtddd||gtdddd |t|d ||d jt|t|d j|| tddd d ||gtdddd|t|d ||d jt|t|d j|W5QRXdS)NzzThe 'foo' parameter to twisted.python.test.test_deprecate.functionWithDeprecatedParameter was deprecated in Twisted 19.2.0Trr ()r)rBr2)r) rrrr>rXrTrWrrLr)rrLwsrrr test_deprecatedKeywordParameters&      z8DeprecatedDecoratorTests.test_deprecatedKeywordParameterN) r$r%r&r'rrrrrrrrrrr 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. cSsdSrrrrrr noDocstringszGAppendToDocstringTests.test_appendToEmptyDocstring..noDocstringAppended text.Nr r>r')rrrrr test_appendToEmptyDocstrings z2AppendToDocstringTests.test_appendToEmptyDocstringcCs@dd}t|d|dddg|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. cSsdS);This doesn't comply with standards, but is here for a test.Nrrrrr singleLineDocstringszTAppendToDocstringTests.test_appendToSingleLineDocstring..singleLineDocstringrrr N)r r>r'rrr)rrrrr 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. cSsdS)z9 This is a multi-line docstring. Nrrrrr multiLineDocstringszRAppendToDocstringTests.test_appendToMultilineDocstring..multiLineDocstringrz1 This is a multi-line docstring. Appended text. Nr)rrrrr test_appendToMultilineDocstrings  z6AppendToDocstringTests.test_appendToMultilineDocstringN)r$r%r&r'rrrrrrr rs rc@sheZdZdZddZddZddZdd Zd d Zd d Z ddZ ddZ ddZ ddZ ddZdS)MutualArgumentExclusionTestsz2 Tests for L{mutuallyExclusiveArguments}. cOs4ttddrtt|||Stt|||SdS)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)r6inspectrrr getargspecrfuncargskwrrr checkPasseds z(MutualArgumentExclusionTests.checkPassedcCs*dd}|||ddtddddS)z` L{passed} identifies the arguments passed by a simple positional test. cSsdSrrrrrrr r szGMutualArgumentExclusionTests.test_passed_simplePositional..funcrBr^r Nr>r rkrrrrr test_passed_simplePositionalsz9MutualArgumentExclusionTests.test_passed_simplePositionalcCs"dd}|t|j|ddddS)z[ L{passed} raises a L{TypeError} if too many arguments are passed. cSsdSrrr rrr rszBMutualArgumentExclusionTests.test_passed_tooManyArgs..funcrBr^rNr4 TypeErrorr r rrr test_passed_tooManyArgssz4MutualArgumentExclusionTests.test_passed_tooManyArgscCs"dd}|jt|j|ddddS)zs L{passed} raises a L{TypeError} if a argument is passed both positionally and by keyword. cSsdSrrrrrr r szHMutualArgumentExclusionTests.test_passed_doublePassKeyword..funcrBr^rNrr rrr test_passed_doublePassKeywordsz:MutualArgumentExclusionTests.test_passed_doublePassKeywordcCs"dd}|jt|j|ddddS)z L{passed} raises a L{TypeError} if a keyword argument not present in the function's declaration is passed. cSsdSrrrrrr r+szIMutualArgumentExclusionTests.test_passed_unspecifiedKeyword..funcrBr^)zNrr rrr test_passed_unspecifiedKeyword%sz;MutualArgumentExclusionTests.test_passed_unspecifiedKeywordcCs,dd}|||dddtddddS) z| L{passed} places additional positional arguments into a tuple under the name of the star argument. cWsdSrrr rrr r6sz;MutualArgumentExclusionTests.test_passed_star..funcrBr^r)r^rr Nr r rrr test_passed_star0sz-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[sdSrrr rrr rAsz?MutualArgumentExclusionTests.test_passed_starStar..funcrBr^r)ryrr Nr r rrr 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. rBr^rcSsdSrrrrrderrr rNszFMutualArgumentExclusionTests.test_passed_noDefaultValues..func)r)rrrN)rBr^rr r rrr 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. r rrcSs||||Srr)rrrrrrr rZszMMutualArgumentExclusionTests.test_mutualExclusionPrimeDirective..funcrBr^rrr N)rr)r r>r rrr "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. rrrrcSs||Srrr rrr rhszPMutualArgumentExclusionTests.test_mutualExclusionExcludesByKeyword..funcr N)rr)r r4rr rrr %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@seZdZddZdS)zMMutualArgumentExclusionTests.test_invalidParameterType..FakeSignaturecSs ||_dSr) parameters)rr#rrr r!vszVMutualArgumentExclusionTests.test_invalidParameterType..FakeSignature.__init__Nr$r%r&r!rrrr FakeSignatureusr%c@seZdZddZdS)zMMutualArgumentExclusionTests.test_invalidParameterType..FakeParametercSs||_||_dSr)rYkind)rrYr&rrr r!zszVMutualArgumentExclusionTests.test_invalidParameterType..FakeParameter.__init__Nr$rrrr FakeParameterysr'cSsdSrrr rrr r~szDMutualArgumentExclusionTests.test_invalidParameterType..funcrBr^ZfakerrBr^N)rrr#rvr4rr)rr%r'rr#ZdummyParametersZfakeSigrrr test_invalidParameterTypens  z6MutualArgumentExclusionTests.test_invalidParameterTypeN)r$r%r&r'r r rrrrrrr!r"r)rrrr rs        rc@s eZdZdZddZddZdS)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} )rrrrrrr r szKeywordOnlyTests.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. TrcWsdS)zM b is a keyword-only argument, with a default value. Nr)rrrrr func1sz6KeywordOnlyTests.test_passedKeywordOnly..func1cWsdS)zd b, c, d, e are keyword-only arguments. b has a default value. Nr)rrrrrrrr func2sz6KeywordOnlyTests.test_passedKeywordOnly..func2rBr^r)rBr^rr F)rrrrr(r)rrrN)r>r rkr4r)rr+r,rrr test_passedKeywordOnlys  z'KeywordOnlyTests.test_passedKeywordOnlyN)r$r%r&r'r r-rrrr r*sr*)rBr^r)7r'rrar*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(rJrfrrrrrrrrrrr*rrrr sN    8     Gbog  *@!