U j5{iMã@sÔddlmZddlZddlZddlmZmZddlmZm Z m Z ddl m Z ddl mZmZmZdd d œd d „Zd ddœdd„ZGdd„deƒZGdd„deƒZGdd„deƒZdd dœdd„Zdddœdd„ZdS)é)Ú annotationsN)ÚAnyÚIterator)ÚPythonAttributeÚ PythonModuleÚ getModule)ÚMethodicalMachineé)Ú TypeMachineÚ InputProtocolÚCorezPythonAttribute | PythonModuleÚbool)ÚattrÚreturncCs<t | ¡¡}|dkrdS|}t|tƒs0|j}q|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Ú getmoduleÚloadÚ isinstancerZonObjectÚnameÚ__name__)rZ sourceModuleZ currentModule©rú5/tmp/pip-unpacked-wheel-9dyvm7t1/automat/_discover.pyÚisOriginalLocations rzPythonModule | PythonAttributezJIterator[tuple[str, MethodicalMachine | TypeMachine[InputProtocol, Core]]])ÚwithinrccsÌt |g¡}tƒ}|rÈ| ¡}| ¡}t|tƒs:t|tƒrZ||krZ| |¡|j |fVqt   |¡rŽt |ƒrŽ||krŽ| |¡|  | ¡¡qt|tƒr||kr| |¡|  | ¡¡|  | ¡¡qdS)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)Ú collectionsÚdequeÚsetÚpoprrrr ÚaddrrÚisclassrÚ extendleftÚiterAttributesrZ iterModules)rÚqueueÚvisitedrÚvaluerrrÚfindMachinesViaWrappers4 úÿÿþ ÿÿÿ  r%c@seZdZdZdS)Ú InvalidFQPNzH The given FQPN was not a dot-separated list of Python objects. N©rÚ __module__Ú __qualname__Ú__doc__rrrrr&Osr&c@seZdZdZdS)ÚNoModulezG A prefix of the FQPN was not an importable module or package. Nr'rrrrr+Usr+c@seZdZdZdS)ÚNoObjectz; A suffix of the FQPN was not an accessible object Nr'rrrrr,[sr,Ústr)Úfqpnrc s|s tdƒ‚t | d¡¡}d|kr2td|fƒ‚| ¡‰z tˆƒ}Wntk rbtˆƒ‚YnX|rª| ¡‰z |ˆ}Wn"tk rž| ˆ¡Yq®YqdX|  ¡qd|S|}|D]J‰zt ‡fdd„|  ¡Dƒƒ}Wq¶t k rþt d |jˆ¡ƒ‚Yq¶Xq¶|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(|] }|j dd¡dˆkr|VqdS)r/r éÿÿÿÿN)rÚrsplit)Ú.0Úchild©Ú componentrrÚ ‹sþzwrapFQPN..z{}.{})r&rrÚsplitÚpopleftrÚKeyErrorr+Ú appendleftrÚnextr!Ú StopIterationr,Úformatr)r.Ú componentsÚmoduleÚ attributerr5rÚwrapFQPNas@ÿÿ      þ rBcCs 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%rB)r.rrrÚ findMachines–srC)Ú __future__rrrÚtypingrrZtwisted.python.modulesrrrZautomatrZ_typedr r r rr%Ú Exceptionr&r+r,rBrCrrrrÚs  05