VhMddlmZddlZddlZddlmZmZddlmZm Z m Z ddl m Z ddl mZmZmZddZ dd ZGd d eZGd d eZGddeZddZ ddZy)) annotationsN)AnyIterator)PythonAttribute PythonModule getModule)MethodicalMachine) TypeMachine InputProtocolCorectj|j}|y|}t|ts|j }t|ts|j |jk(S)z Attempt to discover if this appearance of a PythonAttribute representing a class refers to the module where that class was defined. F)inspect getmoduleload isinstanceronObjectname__name__)attr sourceModule currentModules A/home/dcms/DCMS/lib/python3.12/site-packages/automat/_discover.pyisOriginalLocationrsb $$TYY[1LM 5%..  5   !6!6 66c#Ktj|g}t}|r#|j}|j }t |t st |tr&||vr"|j||j|fntj|r@t|r5||vr1|j||j|jnct |trS||vrO|j||j|j|j|j!|r"yyw)a Recursively yield L{MethodicalMachine}s and their FQPNs within a L{PythonModule} or a L{twisted.python.modules.PythonAttribute} wrapper object. Note that L{PythonModule}s may refer to packages, as well. The discovery heuristic considers L{MethodicalMachine} instances that are module-level attributes or class-level attributes accessible from module scope. Machines inside nested classes will be discovered, but those returned from functions or methods will not be. @type within: L{PythonModule} or L{twisted.python.modules.PythonAttribute} @param within: Where to start the search. @return: a generator which yields FQPN, L{MethodicalMachine} pairs. N) collectionsdequesetpoprrr r addrrisclassr extendleftiterAttributesr iterModules)withinqueuevisitedrvalues rfindMachinesViaWrapperr*s(   vh 'E    yy{  u/ 0Juk4R7" KK ))U" " OOE "'9$'?EQXDX KK    T002 3 l +W0D KK    T002 3   T--/ 0! s EE E ceZdZdZy) InvalidFQPNzH The given FQPN was not a dot-separated list of Python objects. Nr __module__ __qualname____doc__rrr,r,Orr,ceZdZdZy)NoModulezG A prefix of the FQPN was not an importable module or package. Nr-r1rrr4r4Ur2rr4ceZdZdZy)NoObjectz; A suffix of the FQPN was not an accessible object Nr-r1rrr6r6[r2rr6cL|s tdtj|jd}d|vrtd||j  t }|r)|j  |}|j|r)|S#t $r twxYw#t $r|jYnwxYw|}|D]W tfd|jD}'#t$r&tdj|jwxYw|S)z Given an FQPN, retrieve the object via the global Python module namespace and wrap it with a L{PythonModule} or a L{twisted.python.modules.PythonAttribute}. zFQPN was empty.zMname must be a string giving a '.'-separated list of Python identifiers, not c3fK|](}|jjdddk(r|*yw)r8r N)rrsplit).0child components r zwrapFQPN..s7::$$S!,R0I=s.1z{}.{})r,rrsplitpopleftrKeyErrorr4r appendleftnextr$ StopIterationr6formatr)fqpn componentsmodule attributer?s @rwrapFQPNrLasQ *++""4::c?3J Z%) ,  ""$I"9% &&(  I&F KKM   "y!!"   ! !) ,  IF  F&557I  F7>>)..)DE E FF s* B4B&B#&CC"C11/D c*tt|S)a Recursively yield L{MethodicalMachine}s and their FQPNs in and under the a Python object specified by an FQPN. The discovery heuristic considers L{MethodicalMachine} instances that are module-level attributes or class-level attributes accessible from module scope. Machines inside nested classes will be discovered, but those returned from functions or methods will not be. @param fqpn: a fully-qualified Python identifier (i.e. the dotted identifier of an object defined at module or class scope, including the package and modele names); where to start the search. @return: a generator which yields (C{FQPN}, L{MethodicalMachine}) pairs. )r*rL)rHs r findMachinesrNs$ "(4. 11r)rzPythonAttribute | PythonModulereturnbool)r&PythonModule | PythonAttributerOJIterator[tuple[str, MethodicalMachine | TypeMachine[InputProtocol, Core]]])rHstrrOrQ)rHrSrOrR) __future__rrrtypingrrtwisted.python.modulesrrrautomatr _typedr r r rr* Exceptionr,r4r6rLrNr1rrrZsz" KK%447"-1 *-1O-1`) { { 2j2 2O2r