ó [³XMc@sŠdZddlZddlZddlZddlZddlZddlZddlmZddl m Z ddkZ e Z dejfd„ƒYZ e ƒZdejfd „ƒYZd efd „ƒYZd efd „ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZieej6eej6eej6eej6eej6eej 6eej!6eej"6eej#6eej$6eej%6eej&6eej'6eej(6eej)6Z*dej+fd„ƒYZ,d d&d!„ƒYZ-d"d'd#„ƒYZ.d$d(d%„ƒYZ/dS()sSupport for python object introspection and exploration. Note that Explorers, what with their list of attributes, are much like manhole.coil.Configurables. Someone should investigate this further. (TODO) Also TODO: Determine how much code in here (particularly the function signature stuff) can be replaced with functions available in the L{inspect} module available in Python 2.1. iÿÿÿÿN(tpb(treflectitPoolcBseZd„ZRS(cCs{t|ƒ}|jj|ƒr)|j|Stjt|ƒtƒ}tj|iƒ}||j|<|j |||ƒ|SdS(N( tidtdatathas_keyt typeTabletgetttypetExplorerGenerictnewtinstancet__init__(tselftobjectt identifiertoidtklasste((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyt getExplorers   (t__name__t __module__R(((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyRstExplorercBsJeZddgZgZdgZdZdZd„Zd„Z d„Z RS(RRt get_refcountcCs‹||_||_t|ƒ|_g|_tj|jd|jƒg|_tj|jd|jƒg|_tj|jd|jƒdS(Nt propertiestattributeGroupst accessors( RRRRRtaccumulateClassListt __class__RR(R RR((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR 5s       cCsƒdddg}|j|jƒ|j|jƒi}x!|D]}t||ƒ||eZdgZdgZdgZd„Zd„Zd„ZRS(tlentelementst get_elementscCs8tj|||ƒ||_t|ƒ|_g|_dS(N(RR tseqR1R2(R R4R((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR ms cCsit|jƒ|_g}xJt|jƒD]9}d|j|f}|jtj|j||ƒƒq(W|S(Ns%s[%s](R1R4txrangeRtappendt explorerPoolR(R tltiR((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR3us $cCs |jƒS(N(R3(R R"((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pytview_get_elements€s(RRRRRR R3R:(((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR0hs      tExplorerMappingcBsJeZdgZdgZddgZd„Zd„Zd„Zd„ZRS(R1tkeystget_keystget_itemcCs8tj|||ƒ||_t|ƒ|_g|_dS(N(RR tdctR1R<(R R?R((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR Šs cCsr|jjƒ}t|ƒ|_g}xGt|jƒD]6}d|j|f}|jtj|||ƒƒq4W|S(Ns %s.keys()[%s](R?R<R1R5RR6R7R(R R<R8R9R((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR=“s!cCs |jƒS(N(R=(R R"((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyt view_get_keysŸscCs]t|ƒtjkr!|j}n|j|}d|jt|ƒf}tj||ƒ}|S(Ns%s[%s]( Rttypest InstanceTypeRR?RR,R7R(R R"R%titemR((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyt view_get_item£s   ( RRRRRR R=R@RD(((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR;…s    tExplorerBuiltincBs&eZdZdddgZd„ZRS(s @ivar name: the name the function was defined as @ivar doc: function's docstring, or C{None} if unavailable @ivar self: if not C{None}, the function is a method of this object. tdoctnameR cCs;tj|||ƒ|j|_|j|_|j|_dS(N(RR t__doc__RFRRGt__self__R (R tfunctionR((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR ¶s  (RRRHRR (((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyRE¯stExplorerInstancecBs,eZdZdgZddgZd„ZRS(sq Attribute groups: - B{methods} -- dictionary of methods - B{data} -- dictionary of data members Note these are only the *instance* methods and members -- if you want the class methods, you'll have to look up the class. TODO: Detail levels (me, me & class, me & class ancestory) @ivar klass: the class this is an instance of. RtmethodsRc Csòtj|||ƒi}i}x›t|ƒD]}|ddkrHq,ntj||gdƒ}t||ƒ}t|ƒ}|tjkr£t j ||ƒ||ntj||gdƒ}t||ƒ}t|ƒ}|tj krÁt j ||ƒ||t j ||ƒ||W|j|_ t j|ƒ|_||_||_t j |j|dƒ|_t|ddƒ|_dS(NiRMR RNs .__bases__R(RR RRORPRQR RRARRR7RRGtinspecttgetdocRFRRLt __bases__RXR*RY( R ttheClassRRSRLR9RTRURV((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR òs*      (RRRHRRR (((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyRWås  tExplorerFunctioncBs&eZdddddgZd„ZRS(RGRFtfiletlinet signaturec Csctj|||ƒ|j}|j}|jd@o5d}|jd@oHd}|||}t|j| ƒ}|jrèd} xjt|t |jƒ|ƒD]I} |j| } t j | d|| fƒ} |j | | ƒ| d} q˜Wn|r|j |dƒn|r |j|d|ƒn|j|_||_tj|ƒ|_|j|_|j|_dS(Niiiis%s.func_defaults[%d](RR t func_codet co_argcounttco_flagst Signaturet co_varnamest func_defaultsR5R1R7Rt set_defaultt set_keywordt set_varlistRRGRaRZR[RFt co_filenameR_tco_firstlinenoR`( R RJRtcodetargcountt takesListt takesKeywordstnRati_dR9tdefault((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR s2        (RRRR (((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR^stExplorerMethodcBseZddgZd„ZRS(R RcCs¤|j}t|ƒtjkr-|jj}ntj|||ƒt|ƒ|_tj |j |dƒ|_ tj |j |dƒ|_ |j r |jjƒndS(Ns .im_classs.im_self(tim_funcRRARBt__call__R^R RR7Rtim_classRtim_selfR Rat discardSelf(R tmethodRRJ((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR Ds    (RRRR (((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyRt=s tExplorerModulecBs5eZdZdddgZdddgZd„ZRS(sÄ @ivar name: the name the module was defined as @ivar doc: documentation string for the module @ivar file: the file the module is defined in Attribute groups: - B{classes} -- the public classes provided by the module - B{functions} -- the public functions provided by the module - B{data} -- the public data members provided by the module ("Public" is taken to be "anything that doesn't start with _") RGRFR_tclassest functionsRc CsGtj|||ƒi}i}i}xÍ|jjƒD]¼\}}|ddkrWq5nd||f}t|ƒtjkr•tj||ƒ||.st_watchEmitChangedN(RRARBt TypeErrorRtaddMethodNamesToDictRRR<R tclassobjRRt_MonkeysSetattrMixintinstancemethodR*R RRRxt _WatchMonkeytinstall( R RRR R?tkRStclazzNStclazzRGtmtmonkey((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyRŸs,         (RRR¡RŸ(((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR›ùs R®cBs8eZdZdZd„Zd„Zd„Zd„ZRS(s¶I hang on a method and tell you what I see. TODO: Aya! Now I just do browseObject all the time, but I could tell you what got called with what when and returning what. cCs ||_dS(s7Make a monkey to hang on this instance object. N(R (R R ((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR RscCs_t|j|dƒ}||k r[tj||j|jjƒ|jj|<||f|_ndS(s?Install myself on my instance in place of this method. N(R R R*R R­RRt oldMethod(R tmethodIdentifierRµ((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR¯Ws  cCse|jdkrdS|jddkr@t|j|jdƒn!t|j|jd|jdƒdS(s]Remove myself from this instance and restore the original method. (I hope.) Nii(RµR*tdelattrR tsetattr(R ((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyt uninstallds cOs=|jdr)t|jd||ƒ}nd}|jƒ|S(s@Pretend to be the method I replaced, and ring the bell. iN(RµtapplyR*R¨(R R R˜tkwtrval((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyRvss   N( RRRHR*RµR R¯R¹Rv(((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR®Js   R¬cBseZdZd„ZRS(sDA mix-in class providing __setattr__ for objects being watched. cCsTt|jjddƒr9|jjdj|||ƒn ||j|<|jƒdS(s-Set the attribute and ring the bell. it __setattr__N(thasattrRR\R½RR¨(R R°tv((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR½‚s  (RRRHR½(((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR¬s((((0RHRZR RPR'RAtUserDictttwisted.spreadRttwisted.pythonRR‹RŒRR7t CacheableRR R.R0R;RERKRWR^RtR{RBRRRR‚RƒtBuiltinFunctionTypetListTypet TupleTypetDictTypeRˆtNoneTypetIntTypet FloatTypetLongTypet ComplexTypeRtCopyableReR›R®R¬(((s</usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pytsL<   ) *()/-               eQ5