o b_@sdZddlZddlZddlmZddlmZddlmZm Z m Z m Z m Z ddl mZGdddZGd d d eZGd d d ZGd ddeZGdddeZGdddeZGdddeZGdddZGdddeZGdddZGdddeeZedefdddZGd d!d!eZGd"d#d#eZGd$d%d%eZGd&d'd'eZ Gd(d)d)eZ!Gd*d+d+eZ"Gd,d-d-eZ#dS).z6 Test cases for the L{twisted.python.reflect} module. N)deque)reflect)accumulateMethodsaddMethodNamesToDictfullyQualifiedNameprefixedMethodNamesprefixedMethods)SynchronousTestCasec@eZdZdZddZdS)Basez` A no-op class which can be used to verify the behavior of method-discovering APIs. cCdS)z9 A no-op method which can be discovered. Nselfr r ;/usr/lib/python3/dist-packages/twisted/test/test_reflect.pymethodz Base.methodN)__name__ __module__ __qualname____doc__rr r r rr s r c@eZdZdZdS)SubzF A subclass of a class with a method which can be discovered. N)rrrrr r r rr$rc@ eZdZdZddZddZdS)Separatez= A no-op class with methods with differing prefixes. cCr )zJ A no-op method which a matching prefix to be discovered. Nr rr r r good_method/rzSeparate.good_methodcCr )zO A no-op method with a mismatched prefix to not be discovered. Nr rr r r bad_method4rzSeparate.bad_methodN)rrrrrrr r r rr*s rc@s(eZdZdZddZddZddZdS) AccumulateMethodsTestszt Tests for L{accumulateMethods} which finds methods on a class hierarchy and adds them to a dictionary. cC*t}i}t|||d|ji|dS)z If x is and instance of Base and Base defines a method named method, L{accumulateMethods} adds an item to the given dictionary with C{"method"} as the key and a bound method object for Base.method value. rN)r r assertEqualrrxoutputr r r test_ownClass@s z$AccumulateMethodsTests.test_ownClasscCr)a If x is an instance of Sub and Sub is a subclass of Base and Base defines a method named method, L{accumulateMethods} adds an item to the given dictionary with C{"method"} as the key and a bound method object for Base.method as the value. rN)rrr rr!r r rtest_baseClassKs z%AccumulateMethodsTests.test_baseClasscCs,t}i}t||d|d|ji|dS)z If a prefix is given, L{accumulateMethods} limits its results to methods beginning with that prefix. Keys in the resulting dictionary also have the prefix removed from them. good_rN)rrr rr!r r r test_prefixWs z"AccumulateMethodsTests.test_prefixN)rrrrr$r%r'r r r rr:s  rc@r)PrefixedMethodsTestszr Tests for L{prefixedMethods} which finds methods on a class hierarchy and adds them to a dictionary. cCs"t}t|}||jg|dS)zc L{prefixedMethods} returns a list of the methods discovered on an object. N)r rr rr!r r rtest_onlyObjectisz$PrefixedMethodsTests.test_onlyObjectcCs$t}t|d}||jg|dS)zo If a prefix is given, L{prefixedMethods} returns only methods named with that prefix. r&N)rrr rr!r r rr'rs z PrefixedMethodsTests.test_prefixN)rrrrr)r'r r r rr(cs r(c@r)PrefixedMethodNamesTestsz+ Tests for L{prefixedMethodNames}. cCs|dgttddS)z L{prefixedMethodNames} returns a list including methods with the given prefix defined on the class passed to it. rr&N)r rrrr r r test_methodsz$PrefixedMethodNamesTests.test_methodcCs(Gdddt}|dgt|ddS)z L{prefixedMethodNames} returns a list included methods with the given prefix defined on base classes of the class passed to it. c@ eZdZdS)z.ChildNrrrr r r rChildr.rr&N)rr r)rr.r r rtest_inheritedMethodsz-PrefixedMethodNamesTests.test_inheritedMethodN)rrrrr+r0r r r rr*|s r*c@r )AddMethodNamesToDictTestsz, Tests for L{addMethodNamesToDict}. cCsFGddd}Gdddt|}i}t||d||ddi|dS) z If C{baseClass} is passed to L{addMethodNamesToDict}, only methods which are a subclass of C{baseClass} are added to the result dictionary. c@r,)z;AddMethodNamesToDictTests.test_baseClass..AlternateNr-r r r r Alternater/r2c@eZdZddZdS)z7AddMethodNamesToDictTests.test_baseClass..ChildcSdSNr rr r rgood_alternatezFAddMethodNamesToDictTests.test_baseClass..Child.good_alternateN)rrrr6r r r rr. r.r& alternateN)rrr )rr2r.resultr r rr%s z(AddMethodNamesToDictTests.test_baseClassN)rrrrr%r r r rr1 r1c@r )Summerz9 A class we look up as part of the LookupsTests. cCr )z Do something. Nr rr r r reallySetrzSummer.reallySetN)rrrrr>r r r rr=r<r=c@sxeZdZdZddZddZddZdd Zd d Zd d Z ddZ ddZ ddZ ddZ ddZddZddZdS) LookupsTestszC Tests for L{namedClass}, L{namedModule}, and L{namedAny}. cC|tdtdS)zY L{namedClass} should return the class object for the name it is passed. twisted.test.test_reflect.SummerN)assertIsr namedClassr=rr r rtest_namedClassLookupz"LookupsTests.test_namedClassLookupcC"ddlm}|td|dS)zc L{namedModule} should return the module object for the name it is passed. rmonkeytwisted.python.monkeyN)twisted.pythonrHrBr namedModulerrHr r rtest_namedModuleLookups z#LookupsTests.test_namedModuleLookupcCs ddl}|td|jdS)zY L{namedAny} should return the package object for the name it is passed. rNtwisted.python)rJrBrnamedAnypythonrtwistedr r rtest_namedAnyPackageLookupsz'LookupsTests.test_namedAnyPackageLookupcCrF)zX L{namedAny} should return the module object for the name it is passed. rrGrIN)rJrHrBrrOrLr r rtest_namedAnyModuleLookups z&LookupsTests.test_namedAnyModuleLookupcCr@)zW L{namedAny} should return the class object for the name it is passed. rAN)rBrrOr=rr r rtest_namedAnyClassLookuprEz%LookupsTests.test_namedAnyClassLookupcCs|tdtjdS)z L{namedAny} should return the object an attribute of a non-module, non-package object is bound to for the name it is passed. z*twisted.test.test_reflect.Summer.reallySetN)r rrOr=r>rr r rtest_namedAnyAttributeLookupsz)LookupsTests.test_namedAnyAttributeLookupcCs|tdtjjdS)z L{namedAny} should return the object an attribute of an object which itself was an attribute of a non-module, non-package object is bound to for the name it is passed. z2twisted.test.test_reflect.Summer.reallySet.__doc__N)rBrrOr=r>rrr r r"test_namedAnySecondAttributeLookupsz/LookupsTests.test_namedAnySecondAttributeLookupcCsD|ttjd|ttjd|ttjd|ttjddS)z Exceptions raised by modules which L{namedAny} causes to be imported should pass through L{namedAny} to the caller. ztwisted.test.reflect_helper_ZDEztwisted.test.reflect_helper_VEztwisted.test.reflect_helper_IEN) assertRaisesZeroDivisionErrorrrO ValueError ImportErrorrr r rtest_importExceptionssz"LookupsTests.test_importExceptionscCs4|ttjd|ttjd|ttjddS)z If segments on the end of a fully-qualified Python name represents attributes which aren't actually present on the object represented by the earlier segments, L{namedAny} should raise an L{AttributeError}. ztwisted.nosuchmoduleintheworldz twisted.nosuch.modulein.theworldz0twisted.test.test_reflect.Summer.nosuchattributeN)rXAttributeErrorrrOrr r rtest_attributeExceptions sz%LookupsTests.test_attributeExceptionscCs|tjtjd}|t|d|tjtjd}|t|d|tjtjd}|t|d|tjtjd}|t|dd D]}|tjtj|}|t|d |fqFd S) a Passing a name which isn't a fully-qualified Python name to L{namedAny} should result in one of the following exceptions: - L{InvalidName}: the name is not a dot-separated list of Python objects - L{ObjectNotFound}: the object doesn't exist - L{ModuleNotFound}: the object doesn't exist and there is only one component in the name nosuchmoduleintheworldz(No module named 'nosuchmoduleintheworld'z@#$@(#.!@(#!@#z('@#$@(#.!@(#!@#' does not name an objectztcelfer.nohtyp.detsiwtz0'tcelfer.nohtyp.detsiwt' does not name an objectzEmpty module name)z.twistedztwisted.ztwisted..pythonzOname must be a string giving a '.'-separated list of Python identifiers, not %rN)rXrModuleNotFoundrOr strObjectNotFound InvalidName)rerr invalidNamer r rtest_invalidNames"s.   zLookupsTests.test_invalidNamescCs.dD]}t}tj||d}|||qdS)zk When module import fails with ImportError it returns the specified default value. )nosuchmtopoduleno.such.moduledefaultN)objectr requireModulerB)rnamerkr;r r rtest_requireModuleImportErrorGs z*LookupsTests.test_requireModuleImportErrorcCstd}||dS)zI When module import fails it returns L{None} by default. riN)rrm assertIsNone)rr;r r rtest_requireModuleDefaultNoneSs z*LookupsTests.test_requireModuleDefaultNonecCs,ddlm}t}|tjd|d|dS)ze When module import succeed it returns the module and not the default value. rrGrIrjN)rJrHrlrBrrm)rrHrkr r r!test_requireModuleRequestedImport[s  z.LookupsTests.test_requireModuleRequestedImportN)rrrrrDrMrSrTrUrVrWr\r^rgrorqrrr r r rr?s   % r?c@s0eZdZdZdZdefddZdefddZdS) BreakableFreturncC|jrtddS)Nzstr!z )breakStr RuntimeErrorrr r r__str__ozBreakable.__str__cCru)Nzrepr!z Breakable()) breakReprrwrr r r__repr__uryzBreakable.__repr__N)rrrrzrvrbrxr{r r r rrsjs rsc@seZdZdZeddZdS) BrokenTypeFcCru)Nzno namer|) breakNamerwrr r rrszBrokenType.__name__N)rrrr}propertyr r r rr||sr|BTBaseT)rzrvc@seZdZeddZdS) NoClassAttrcCs|jSr5) not_class)r"r r rszNoClassAttr.N)rrrr~ __class__r r r rrsrc@sPeZdZdZddZddZddZdd Zd d Zd d Z ddZ ddZ dS) SafeReprTestsz2 Tests for L{reflect.safe_repr} function. cCs2gddf}|tttj|ttt|dS)zg L{reflect.safe_repr} produces the same output as C{repr} on a working object. r:aN)r listmapr safe_reprrepr)rxsr r rtest_workingReprs &zSafeReprTests.test_workingReprcCJt}d|_t|}|d||tjtd||d|dS)z L{reflect.safe_repr} returns a string with class name, address, and traceback when the repr call failed. TzBreakable instance at 0xrRuntimeError: repr!N) rsrzrrassertInospathsplitext__file__rbbReprr r rtest_brokenReprs   zSafeReprTests.test_brokenReprcCs&t}d|_|t|t|dS)zT L{reflect.safe_repr} isn't affected by a broken C{__str__} method. TN)rsrvr rrrrrr r rtest_brokenStrszSafeReprTests.test_brokenStrcC*Gdddt}t|t|dS)Nc@r)z-SafeReprTests.test_brokenClassRepr..XTNrrrrzr r r rXrrrrrrrr r rtest_brokenClassRepr z"SafeReprTests.test_brokenClassReprcCsFGdddt}t|}dt|dd}|||dddS) z C{id} is used to print the ID of the object in case of an error. L{safe_repr} includes a traceback after a newline, so we only check against the first line of the repr. c@r)z2SafeReprTests.test_brokenReprIncludesID..XTNrr r r rrrrz.XTNrrrrvr r r rrrrrrr r rtest_brokenClassStrrz!SafeReprTests.test_brokenClassStrcCr)z If an object raises an exception when accessing its C{__class__} attribute, L{reflect.safe_repr} uses C{type} to retrieve the class object. TNoClassAttr instance at 0xrrN) rrzrrrrrrrrr r rtest_brokenClassAttribute   z'SafeReprTests.test_brokenClassAttributecCPGdddt}t|}|d||tjtd||d|dS)z If a class raises an exception when accessing its C{__name__} attribute B{and} when calling its C{__str__} implementation, L{reflect.safe_repr} returns 'BROKEN CLASS' instead of the class name. c@r)z6SafeReprTests.test_brokenClassNameAttribute..XTNrrrr}r r r rrrr.XTNrr r r rrrrrrrrr r rrrz SafeStrTests.test_brokenClassStrcCr)Nc@r)z,SafeStrTests.test_brokenClassRepr..XTNrr r r rrrrrrr r rrrz!SafeStrTests.test_brokenClassReprcCr)z If an object raises an exception when accessing its C{__class__} attribute, L{reflect.safe_str} uses C{type} to retrieve the class object. TrrRuntimeError: str!N) rrvrrrrrrr)rrbStrr r rr#rz&SafeStrTests.test_brokenClassAttributecCr)z If a class raises an exception when accessing its C{__name__} attribute B{and} when calling its C{__str__} implementation, L{reflect.safe_str} returns 'BROKEN CLASS' instead of the class name. c@r)z5SafeStrTests.test_brokenClassNameAttribute..XTNrr r r rr7rrrrrN)rrrrrrrr)rrrr r rr0rz*SafeStrTests.test_brokenClassNameAttributeN)rrrrrrrrrrrrrrr r r rrs rc@s0eZdZdZddZddZddZdd Zd S) FilenameToModuleTestsz1 Test L{filenameToModuleName} detection. cCstj|dd|_t|jttj|jdd }|dWdn1s,wYttjtj|jdd}|dWddS1sQwYdS)N fakepackagetestz __init__.pywr`)rrjoinmktempmakedirsopenwritedirname)rfr r rsetUpEs    "zFilenameToModuleTests.setUpcCs<t|j}||dt|jtjj}||ddS)zk L{filenameToModuleName} returns the correct module (a package) given a directory. zfakepackage.testN)rfilenameToModuleNamerr rseprmoduler r rtest_directoryMs  z$FilenameToModuleTests.test_directorycCs&ttj|jd}||ddS)zh L{filenameToModuleName} returns the correct module given the path to its file. ztest_reflect.pyfakepackage.test.test_reflectN)rrrrrr rr r r test_fileWszFilenameToModuleTests.test_filecCs,ttj|jdd}||ddS)zo L{filenameToModuleName} returns the correct module given a C{bytes} path to its file. rstest_reflect.pyrN)rrrrrencoder rr r r test_bytesasz FilenameToModuleTests.test_bytesN)rrrrrrrrr r r rr@s  rc@sHeZdZdZddZddZddZdd Zd d Zd d Z ddZ dS)FullyQualifiedNameTestsz) Test for L{fullyQualifiedName}. cCs|t||dS)ze Helper to check that fully qualified name of C{obj} results to C{expected}. N)r r)robjexpectedr r r_checkFullyQualifiedNamersz0FullyQualifiedNameTests._checkFullyQualifiedNamecCs.ddl}||dddl}||jddS)zd L{fullyQualifiedName} returns the full name of a package and a subpackage. rNrRrN)rRrrJrPrQr r r test_packageys z$FullyQualifiedNameTests.test_packagecCsddl}||jjddS)zV L{fullyQualifiedName} returns the name of a module inside a package. rNztwisted.python.compat)twisted.python.compatrrPcompatrQr r r test_modulesz#FullyQualifiedNameTests.test_modulecCs|ttddS)zS L{fullyQualifiedName} returns the name of a class and its module. z.FullyQualifiedNameTestsN)rrrrr r r test_classs z"FullyQualifiedNameTests.test_classcCs|tddS)zY L{fullyQualifiedName} returns the name of a function inside its module. z)twisted.python.reflect.fullyQualifiedNameN)rrrr r r test_functionsz%FullyQualifiedNameTests.test_functioncCs"||jtd|jjddS)zs L{fullyQualifiedName} returns the name of a bound method inside its class and its module. .z.test_boundMethodN)rtest_boundMethodrrrr r rrsz(FullyQualifiedNameTests.test_boundMethodcCs$||jjtd|jjddS)zv L{fullyQualifiedName} returns the name of an unbound method inside its class and its module. rz.test_unboundMethodN)rrtest_unboundMethodrrr r rrsz*FullyQualifiedNameTests.test_unboundMethodN) rrrrrrrrrrrr r r rrms  rc@sTeZdZddZddZddZddZd d Zd d Zd dZ ddZ ddZ dS)ObjectGrepTestscCsJt}d|i}|di}|dt||tj|dt||tjdS)zV Test references search through a dictionary, as a key or as a value. Nz[None]z{None}rlrrobjgrepisSame)rod1d2r r rtest_dictionarys zObjectGrepTests.test_dictionarycCs*t}d|g}|dt||tjdS)z8 Test references search through a list. N[1]r)rrLr r r test_listzObjectGrepTests.test_listcCs*t}|df}|dt||tjdS)z9 Test references search through a tuple. N[0]r)rrTr r r test_tuplerzObjectGrepTests.test_tuplecCs<Gddd}t}|}||_|dt||tjdS)zE Test references search through an object attribute. c@r,)z,ObjectGrepTests.test_instance..DummyNr-r r r rDummyr/rz.oN)rlrrrrr)rrrdr r r test_instances zObjectGrepTests.test_instancecCs:Gddd}|}t|}|dt||tjdS)zB Test references search through a weakref object. c@r,)z+ObjectGrepTests.test_weakref..DummyNr-r r r rrr/rz()N)weakrefrefrrrr)rrrw1r r r test_weakrefs zObjectGrepTests.test_weakrefcCsnGddd}|}|j}|dt||jtj|dt||jjtj|dt||jtjdS)zK Test references search through method special attributes. c@r3)z/ObjectGrepTests.test_boundMethod..DummycSr4r5r rr r rdummyr7z5ObjectGrepTests.test_boundMethod..Dummy.dummyN)rrrrr r r rrr8rz .__self__z.__self__.__class__z .__func__N)rrrr__self__rr__func__)rrrmr r rrsz ObjectGrepTests.test_boundMethodc CsGddd}|}dddd|di}dd|dg}|i|f}d d |d }|}||_|j}t|} |d t| |tjdS) zF Test references search using complex set of objects. c@r3)z.ObjectGrepTests.test_everything..DummycSr4r5r rr r rrr7z5ObjectGrepTests.test_everything..Dummy.methodN)rrrrr r r rrr8rr bazNQuuxFooshrfoobar)rr:rz"().__self__.attr[2][0][2]{'Foosh'})attrrrrrrrr) rrrD1rrD2irrr r rtest_everythings    zObjectGrepTests.test_everythingc Cs|g}|g}||g}||g}|dgtj||tjdd|ddgtj||tjdd|gdtj||tjdddS) z6 Test the depth of references search. rr:)maxDepth[1][0]r)rr z [1][1][0]rN)r rrr)rrrcrr r rtest_depthLimitszObjectGrepTests.test_depthLimitcCs<t}t}|d|||dt||tjdS)z@ Test references search through a deque object. Nr)rlrappendrrrr)rrDr r r test_deque's   zObjectGrepTests.test_dequeN) rrrrrrrrrr rrr r r rrs     rc@r3) GetClassTestscCs@Gddd}|}|t|jd|t|jddS)Nc@r,)z(GetClassTests.test_new..NewClassNr-r r r rNewClass5r/rtype)r rgetClassr)rrnewr r rtest_new4szGetClassTests.test_newN)rrrrr r r rr3r8r)$rrr collectionsrrJrtwisted.python.reflectrrrrrtwisted.trial.unittestr TestCaser rrrr(r*r1r=r?rsrr|rrrrrrrrr r r rs8    ) 5 ]V-E