\d_ndZddlZddlZddlmZddlmZddlmZm Z m Z m Z m Z ddl mZGddZGd d eZGd d ZGd deZGddeZGddeZGddeZGddZGddeZGddZGddeeZedefdddZGd d!eZGd"d#eZGd$d%eZGd&d'eZ Gd(d)eZ!Gd*d+eZ"Gd,d-eZ#dS).z6 Test cases for the L{twisted.python.reflect} module. N)deque)reflect)accumulateMethodsaddMethodNamesToDictfullyQualifiedNameprefixedMethodNamesprefixedMethods)SynchronousTestCaseceZdZdZdZdS)Basez` A no-op class which can be used to verify the behavior of method-discovering APIs. cdS)z9 A no-op method which can be discovered. Nselfs 9lib/python3.11/site-packages/twisted/test/test_reflect.pymethodz Base.methodN)__name__ __module__ __qualname____doc__rrrrr r s-      rr ceZdZdZdS)SubzF A subclass of a class with a method which can be discovered. N)rrrrrrrrr$srrceZdZdZdZdZdS)Separatez= A no-op class with methods with differing prefixes. cdS)zJ A no-op method which a matching prefix to be discovered. Nrrs r good_methodzSeparate.good_method/rrcdS)zO A no-op method with a mismatched prefix to not be discovered. Nrrs r bad_methodzSeparate.bad_method4rrN)rrrrrr rrrrr*s<        rrc$eZdZdZdZdZdZdS)AccumulateMethodsTestszt Tests for L{accumulateMethods} which finds methods on a class hierarchy and adds them to a dictionary. ct}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 assertEqualrrxoutputs r test_ownClassz$AccumulateMethodsTests.test_ownClass@sE FF!V$$$ (AH-v66666rct}i}t|||d|ji|dS)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%s rtest_baseClassz%AccumulateMethodsTests.test_baseClassKsE EE!V$$$ (AH-v66666rct}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%s r test_prefixz"AccumulateMethodsTests.test_prefixWsG JJ!VW--- (AM2F;;;;;rN)rrrrr(r*r-rrrr"r":sK 7 7 7 7 7 7 < < < < .ChildNrrrrrrChildr9 Drr;rr,N)rr$r)rr;s rtest_inheritedMethodz-PrefixedMethodNamesTests.test_inheritedMethodsW      H    (%8%H%HIIIIIrN)rrrrr6r=rrrr4r4|sDMMM J J J J Jrr4ceZdZdZdZdS)AddMethodNamesToDictTestsz, Tests for L{addMethodNamesToDict}. cGdd}Gddt|}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. ceZdZdS);AddMethodNamesToDictTests.test_baseClass..AlternateNr:rrr AlternaterBr<rrCceZdZdZdS)7AddMethodNamesToDictTests.test_baseClass..ChildcdSNrrs rgood_alternatezFAddMethodNamesToDictTests.test_baseClass..Child.good_alternaterN)rrrrHrrrr;rE#     rr;r, alternateN)rrr$)rrCr;results rr*z(AddMethodNamesToDictTests.test_baseClasss              Hi   UFGY??? +q)622222rN)rrrrr*rrrr?r?s-33333rr?ceZdZdZdZdS)Summerz9 A class we look up as part of the LookupsTests. cdS)z Do something. Nrrs r reallySetzSummer.reallySetrrN)rrrrrQrrrrOrOs-     rrOc`eZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdZdS) LookupsTestszC Tests for L{namedClass}, L{namedModule}, and L{namedAny}. c`|tjdtdS)zY L{namedClass} should return the class object for the name it is passed. twisted.test.test_reflect.SummerN)assertIsr namedClassrOrs rtest_namedClassLookupz"LookupsTests.test_namedClassLookups* g()KLLfUUUUUrcbddlm}|tjd|dS)zc L{namedModule} should return the module object for the name it is passed. rmonkeytwisted.python.monkeyN)twisted.pythonr[rVr namedModulerr[s rtest_namedModuleLookupz#LookupsTests.test_namedModuleLookups< *))))) g)*ABBFKKKKKrchddl}|tjd|jdS)zY L{namedAny} should return the package object for the name it is passed. rNtwisted.python)r]rVrnamedAnypythonrtwisteds rtest_namedAnyPackageLookupz'LookupsTests.test_namedAnyPackageLookups8  g&'788'.IIIIIrcbddlm}|tjd|dS)zX L{namedAny} should return the module object for the name it is passed. rrZr\N)r]r[rVrrcr_s rtest_namedAnyModuleLookupz&LookupsTests.test_namedAnyModuleLookups< *))))) g&'>??HHHHHrc`|tjdtdS)zW L{namedAny} should return the class object for the name it is passed. rUN)rVrrcrOrs rtest_namedAnyClassLookupz%LookupsTests.test_namedAnyClassLookups* g&'IJJFSSSSSrcj|tjdtjdS)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$rrcrOrQrs rtest_namedAnyAttributeLookupz)LookupsTests.test_namedAnyAttributeLookups;   I J J       rct|tjdtjjdS)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)rVrrcrOrQrrs r"test_namedAnySecondAttributeLookupz/LookupsTests.test_namedAnySecondAttributeLookups<  T U U   $     rc6|ttjd|ttjd|ttjd|t tjddS)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) assertRaisesZeroDivisionErrorrrc ValueError ImportErrorrs rtest_importExceptionsz"LookupsTests.test_importExceptionss  w/1R     w/1R     (*J    )+K     rc|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)rqAttributeErrorrrcrs rtest_attributeExceptionsz%LookupsTests.test_attributeExceptions s|  G,.N    G,.P        >     rc"|tjtjd}|t |d|tjtjd}|t |d|tjtjd}|t |d|tjtjd}|t |dd D]S}|tjtj|}|t |d |Td 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..pythonzMname must be a string giving a '.'-separated list of Python identifiers, not N)rqrModuleNotFoundrcr$strObjectNotFound InvalidName)rerr invalidNames rtest_invalidNameszLookupsTests.test_invalidNames"sn  "G$46N   S#MNNN  "G$46F   S#MNNN  "G$46N   S#UVVV 3W5ErJJ S#6777F  K##G$79I;WWC   C)47      rcdD]<}t}tj||}|||=dS)zk When module import fails with ImportError it returns the specified default value. )nosuchmtopoduleno.such.moduledefaultN)objectr requireModulerV)rnamerrMs rtest_requireModuleImportErrorz*LookupsTests.test_requireModuleImportErrorGsR : + +DhhG*4AAAF MM&' * * * *  + +rcXtjd}||dS)zI When module import fails it returns L{None} by default. rN)rr assertIsNone)rrMs rtest_requireModuleDefaultNonez*LookupsTests.test_requireModuleDefaultNoneSs/&'788 &!!!!!rcddlm}t}|t jd||dS)ze When module import succeed it returns the module and not the default value. rrZr\rN)r]r[rrVrr)rr[rs r!test_requireModuleRequestedImportz.LookupsTests.test_requireModuleRequestedImport[sV *)))))((  !"97 K K K      rN)rrrrrXr`rgrirkrmrorurxrrrrrrrrSrSsVVV LLLJJJIIITTT           *   *###J + + +"""      rrSc.eZdZdZdZdefdZdefdZdS) BreakableFreturnc2|jrtddS)Nzstr!z )breakStr RuntimeErrorrs r__str__zBreakable.__str__os = !v&& & =rc2|jrtddS)Nzrepr!z Breakable()) breakReprrrs r__repr__zBreakable.__repr__us > !w'' ' =rN)rrrrrr}rrrrrrrjsTIH!!!!! !#!!!!!!rrc(eZdZdZedZdS) BrokenTypeFc2|jrtddS)Nzno namer) breakNamerrs rrzBrokenType.__name__s > *y)) )|rN)rrrrpropertyrrrrr|s2I XrrBTBaseT)rrc&eZdZedZdS) NoClassAttrc|jSrG) not_class)r&s rzNoClassAttr.s1;rN)rrrr __class__rrrrrs!..//IIIrrcBeZdZdZdZdZdZdZdZdZ dZ d Z d S) SafeReprTestsz2 Tests for L{reflect.safe_repr} function. c gddf}|tttj|ttt |dS)zg L{reflect.safe_repr} produces the same output as C{repr} on a working object. rLaN)r$listmapr safe_reprrepr)rxss rtest_workingReprzSafeReprTests.test_workingReprsS ii  c'"3R88994D" ;N;NOOOOOrc,t}d|_tj|}|d||t jtd||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) rrrrassertInospathsplitext__file__rbbReprs rtest_brokenReprzSafeReprTests.test_brokenReprs KK !!$$ 0%888 bg&&x003U;;; +U33333rct}d|_|tj|t |dS)zT L{reflect.safe_repr} isn't affected by a broken C{__str__} method. TN)rrr$rrrrrs rtest_brokenStrzSafeReprTests.test_brokenStrsA KK  *1--tAww77777rcGddt}tj|tj|dS)NceZdZdZdS)-SafeReprTests.test_brokenClassRepr..XTNrrrrrrrXrIIIrrrrrrrs rtest_brokenClassReprz"SafeReprTests.test_brokenClassReprs\         !!!##rcGddt}tj|}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. ceZdZdZdS)2SafeReprTests.test_brokenReprIncludesID..XTNrrrrrrrrrz.XTNrrrrrrrrrHHHrrrrs rtest_brokenClassStrz!SafeReprTests.test_brokenClassStrs\         !!!##rc,t}d|_tj|}|d||t jtd||d|dS)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) rrrrrrrrrrs rtest_brokenClassAttributez'SafeReprTests.test_brokenClassAttributes} MM !!$$ 2E::: bg&&x003U;;; +U33333rc8Gddt}tj|}|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. ceZdZdZdS)6SafeReprTests.test_brokenClassNameAttribute..XTNrrrrrrrrrrrr > > 4 4 4 4 4 4 4 4rrcNeZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d S) SafeStrTestsz1 Tests for L{reflect.safe_str} function. cxgd}|tj|t|dS)Nr)r$rsafe_strr}rr&s rtest_workingStrzSafeStrTests.test_workingStrs8 II )!,,c!ff55555rcXt}d|_tj|dSNT)rrrrrs rrzSafeStrTests.test_brokenStrs) KK rcZd}|tj|ddS)zh L{safe_str} for C{str} with ascii-only data should return the value unchanged. aN)r$rrrs rtest_workingAsciizSafeStrTests.test_workingAsciis0  )!,,c22222rcd}|tj||ddS)zw L{safe_str} for C{bytes} with utf-8 encoded data should return the value decoded into C{str}. stüstutf-8N)r$rrdecoders rtest_workingUtf8_3zSafeStrTests.test_workingUtf8_3s<  )!,,ahhw.?.?@@@@@rcxd}tj|}||t|dS)z= Use str() for non-utf8 bytes: "b'non-utf8'" N)rrr$r})rr&xStrs rtest_brokenUtf8zSafeStrTests.test_brokenUtf8s; "" s1vv&&&&&rcXt}d|_tj|dSr)rrrrrs rrzSafeStrTests.test_brokenReprs) KK rcGddt}tj|tj|dS)NceZdZdZdS)+SafeStrTests.test_brokenClassStr..XTNrrrrrrrrrrrrrs rrz SafeStrTests.test_brokenClassStrs\         rcGddt}tj|tj|dS)NceZdZdZdS),SafeStrTests.test_brokenClassRepr..XTNrrrrrrrrrrrs rrz!SafeStrTests.test_brokenClassReprs\         rc,t}d|_tj|}|d||t jtd||d|dS)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) rrrrrrrrr)rrbStrs rrz&SafeStrTests.test_brokenClassAttribute#s} MM "" 2D999 bg&&x003T::: *D11111rc8Gddt}tj|}|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_str} returns 'BROKEN CLASS' instead of the class name. ceZdZdZdS)5SafeStrTests.test_brokenClassNameAttribute..XTNrrrrrr7rrrrrrN)rrrrrrrr)rrrs rrz*SafeStrTests.test_brokenClassNameAttribute0s        $$ +T222 bg&&x003T::: *D11111rN)rrrrrrrrrrrrrrrrrrrs666 333AAA'''  2 2 2 2 2 2 2 2rrc*eZdZdZdZdZdZdZdS)FilenameToModuleTestsz1 Test L{filenameToModuleName} detection. cdtj|dd|_tj|jt tj|jdd5}|ddddn #1swxYwYt tjtj|jdd5}|dddddS#1swxYwYdS)N fakepackagetestz __init__.pywr{)rrjoinmktempmakedirsopenwritedirname)rfs rsetUpzFilenameToModuleTests.setUpEsYGLL vFF  DI "',,ty-88# > > ! GGBKKK                "',,rwty99=II3 O O ST GGBKKK                  s$B''B+.B+D%%D),D)ctj|j}||dtj|jtjjz}||ddS)zk L{filenameToModuleName} returns the correct module (a package) given a directory. zfakepackage.testN)rfilenameToModuleNamerr$rseprmodules rtest_directoryz$FilenameToModuleTests.test_directoryMse -di88 !3444-di"'+.EFF !344444rctjtj|jd}||ddS)zh L{filenameToModuleName} returns the correct module given the path to its file. ztest_reflect.pyfakepackage.test.test_reflectN)rrrrr r$rs r test_filezFilenameToModuleTests.test_fileWsK - GLL$5 6 6   !@AAAAArctjtj|jdd}||ddS)zo L{filenameToModuleName} returns the correct module given a C{bytes} path to its file. rstest_reflect.pyrN)rrrrr encoder$rs r test_bytesz FilenameToModuleTests.test_bytesasY - GLL))'224F G G   !@AAAAArN)rrrrrrrrrrrrr@sb555BBB B B B B Brrc<eZdZdZdZdZdZdZdZdZ dZ d S) FullyQualifiedNameTestsz) Test for L{fullyQualifiedName}. cL|t||dS)ze Helper to check that fully qualified name of C{obj} results to C{expected}. N)r$r)robjexpecteds r_checkFullyQualifiedNamez0FullyQualifiedNameTests._checkFullyQualifiedNamers) +C00(;;;;;rcxddl}||dddl}||jddS)zd L{fullyQualifiedName} returns the full name of a package and a subpackage. rNrfrb)rfr#r]rdres r test_packagez$FullyQualifiedNameTests.test_packageysN  %%gy999 %%gn6FGGGGGrcNddl}||jjddS)zV L{fullyQualifiedName} returns the name of a module inside a package. rNztwisted.python.compat)twisted.python.compatr#rdcompatres r test_modulez#FullyQualifiedNameTests.test_modules2 %$$$ %%gn&;=TUUUUUrcL|ttddS)zS L{fullyQualifiedName} returns the name of a class and its module. z.FullyQualifiedNameTestsN)r#rrrs r test_classz"FullyQualifiedNameTests.test_classs4 %% #%J%J%J     rc<|tddS)zY L{fullyQualifiedName} returns the name of a function inside its module. z)twisted.python.reflect.fullyQualifiedNameN)r#rrs r test_functionz%FullyQualifiedNameTests.test_functions, %%  K     rcf||jtd|jjddS)zs L{fullyQualifiedName} returns the name of a bound method inside its class and its module. .z.test_boundMethodN)r#test_boundMethodrrrs rr0z(FullyQualifiedNameTests.test_boundMethodsE %%  ! D D$.1 D D D     rcp||jjtd|jjddS)zv L{fullyQualifiedName} returns the name of an unbound method inside its class and its module. r/z.test_unboundMethodN)r#rtest_unboundMethodrrs rr2z*FullyQualifiedNameTests.test_unboundMethodsG %% N - F F$.1 F F F     rN) rrrrr#r%r)r+r-r0r2rrrrrms<<< H H HVVV              rrcDeZdZdZdZdZdZdZdZdZ dZ d Z d S) ObjectGrepTestsct}d|i}|di}|dtj||tj|dtj||tjdS)zV Test references search through a dictionary, as a key or as a value. Nz[None]z{None}rrrobjgrepisSame)rod1d2s rtest_dictionaryzObjectGrepTests.test_dictionarysm HHAYY hAw~ F FGGG hAw~ F FGGGGGrct}d|g}|dtj||tjdS)z8 Test references search through a list. N[1]r6)rr9Ls r test_listzObjectGrepTests.test_lists@ HH 1I eW_Q7>BBCCCCCrct}|df}|dtj||tjdS)z9 Test references search through a tuple. N[0]r6)rr9Ts r test_tuplezObjectGrepTests.test_tuples@ HH I eW_Q7>BBCCCCCrcGdd}t}|}||_|dtj||tjdS)zE Test references search through an object attribute. ceZdZdS),ObjectGrepTests.test_instance..DummyNr:rrrDummyrGr<rrHz.oN)rr9rrr7r8)rrHr9ds r test_instancezObjectGrepTests.test_instancesq          HH EGG dGOAq'.AABBBBBrcGdd}|}tj|}|dtj||tjdS)zB Test references search through a weakref object. ceZdZdS)+ObjectGrepTests.test_weakref..DummyNr:rrrrHrMr<rrHz()N)weakrefrefrrr7r8)rrHr9w1s r test_weakrefzObjectGrepTests.test_weakrefsn          EGG [^^ dGOB7>BBCCCCCrcGdd}|}|j}|dtj||jtj|dtj||jjtj|dtj||jtjdS)zK Test references search through method special attributes. ceZdZdZdS)/ObjectGrepTests.test_boundMethod..DummycdSrGrrs rdummyz5ObjectGrepTests.test_boundMethod..Dummy.dummyrIrN)rrrrVrrrrHrTrJrrHz .__self__z.__self__.__class__z .__func__N)rVrrr7__self__r8r__func__)rrHr9ms rr0z ObjectGrepTests.test_boundMethods          EGG G k7?1aj'.#Q#QRRR ! OAqz3W^ D D    k7?1aj'.#Q#QRRRRRrc6Gdd}|}dddd|di}dd|dg}|i|f}d d |d }|}||_|j}tj|} |d t j| |t jdS) zF Test references search using complex set of objects. ceZdZdZdS).ObjectGrepTests.test_everything..DummycdSrGrrs rrz5ObjectGrepTests.test_everything..Dummy.methodrIrN)rrrrrrrrHr\rJrrHrbazNQuuxFooshrfoobar)rrLrz"().__self__.attr[2][0][2]{'Foosh'})attrrrNrOrrr7r8) rrHr9D1r?rCD2irYr s rtest_everythingzObjectGrepTests.test_everythings          EGG%vq' 2 2r1  EEGG 5Q ' ' EGG H KNN 0'/!Q2W2W     rc ng}|g}||g}||g}|dgtj||tjd|ddgtj||tjd|gdtj||tjddS) z6 Test the depth of references search. rBrL)maxDepth[1][0]r)rBrjz [1][1][0]rN)r$rr7r8)rrrcrIs rtest_depthLimitzObjectGrepTests.test_depthLimits  C F F %'/!QQR"S"S"STTT  H wq!W^aPPP     * * * OAq'.1 = = =     rct}t}|d|||dt j||tjdS)z@ Test references search through a deque object. Nr>)rrappendrrr7r8)rr9Ds r test_dequezObjectGrepTests.test_deque's^ HH GG    eW_Q7>BBCCCCCrN) rrrr<r@rDrJrQr0rgrlrprrrr4r4s H H HDDDDDD C C C D D DSSS&   .   $ D D D D Drr4ceZdZdZdS) GetClassTestscGdd}|}|tj|jd|tj|jddS)NceZdZdS)(GetClassTests.test_new..NewClassNr:rrrNewClassru5r<rrvtype)r$rgetClassr)rrvnews rtest_newzGetClassTests.test_new4s        hjj )(33rs   """"""CBBBBB         $         &<&<&<&<&