o q+WZ@sddlZddlZddlmZddlmZmZddZddZGdd d e Z Gd d d e Z Gd d d e Z ddZ ddZdS)N)MethodicalMachine) PythonModule getModulecCsDt|}|dur dS|}t|ts|j}t|tr|j|jkS)z Attempt to discover if this appearance of a PythonAttribute representing a class refers to the module where that class was defined. NF)inspect getmoduleload isinstanceronObjectname__name__)attr sourceModule currentModuler3/usr/lib/python3/dist-packages/automat/_discover.pyisOriginalLocations  rccst|g}t}|rc|}|}t|tr)||vr)|||j|fVn6t |rCt |rC||vrC||| | nt|tr_||vr_||| | | ||s dSdS)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) collectionsdequesetpoprrraddr risclassr extendleftiterAttributesr iterModules)withinqueuevisitedr valuerrrfindMachinesViaWrappers&     rc@eZdZdZdS) InvalidFQPNzH The given FQPN was not a dot-separated list of Python objects. Nr __module__ __qualname____doc__rrrrr!>r!c@r )NoModulezG A prefix of the FQPN was not an importable module or package. Nr"rrrrr'Dr&r'c@r )NoObjectz; A suffix of the FQPN was not an accessible object Nr"rrrrr(Jr&r(c s|stdt|d}d|vrtd|f|zt}Wn ty.tw|rP|z|}WntyI|Yn w| |s1|S|}|D]!zt fdd| D}WqVt ywt d|jw|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.zOname must be a string giving a '.'-separated list of Python identifiers, not %rc3s*|]}|jdddkr|VqdS)r)N)r rsplit).0child componentrr yszwrapFQPN..z{}.{})r!rrsplitpopleftrKeyErrorr' appendleftrnextr StopIterationr(formatr )fqpn componentsmodule attributerr0rwrapFQPNPsD       r>cCs 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. @type within: an FQPN @param within: Where to start the search. @return: a generator which yields FQPN, L{MethodicalMachine} pairs. )rr>)r:rrr findMachiness r?)rrautomatrtwisted.python.modulesrrrr Exceptionr!r'r(r>r?rrrrs & 1