Your IP : 172.28.240.42
ΔMc @ s~ d Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l m Z d d l m Z d d k Z
e
Z d e j f d YZ e Z
d e j f d YZ d
e f d YZ d e f d
YZ d e f d YZ d e f d YZ d e f d YZ d e f d YZ d e f d YZ d e f d YZ d e f d YZ d e f d YZ i e e j 6e e j 6e e j 6e e j 6e e j 6e e j 6e e j 6e e j! 6e e j" 6e e j# 6e e j$ 6e e j% 6e e j& 6e e j' 6e e j( 6Z) d e j* f d YZ+ d d& d! YZ, d" d' d# YZ- d$ d( d% YZ. d S() s Support 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.
iN( t pb( t reflecti t Poolc B s e Z d Z RS( c C s{ t | } | j j | r) | j | St j t | t } t j | i } | | j | <| j | | | | Sd S( N(
t idt datat has_keyt typeTablet gett typet ExplorerGenerict typest InstanceTypet __init__( t selft objectt
identifiert oidt klasst e( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyt getExplorer s
( t __name__t
__module__R ( ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR s t Explorerc B sJ e Z d d g Z g Z d g Z d Z d Z d Z d Z d Z
RS( R R t get_refcountc C s | | _ | | _ t | | _ g | _ t j | j d | j g | _ t j | j d | j g | _ t j | j d | j d S( Nt
propertiest attributeGroupst accessors( R R R R R t accumulateClassListt __class__R R ( R
R R ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR 5 s
c C s d d d g } | j | j | j | j i } x! | D] } t | | | | <q< Wt j | | | d <| j j | d <| S( NR R R t viewt
explorerClass( t extendR R t getattrR t ViewPointR R ( R
t perspectivet allt statet key( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyt getStateToCopyForF s
c C s
t j | S( N( t syst getrefcount( R
R" ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyt view_get_refcountS s N( R R R R R t NoneR R R R& R) ( ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR - s
R c B s e Z d d d g Z d Z RS( t strt reprt typenamec C sG t j | | | t | | _ t | | _ t | j | _ d S( N( R R R+ R, R R R- ( R
R R ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR Y s ( R R R R ( ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR V s t ExplorerImmutablec B s e Z d g Z d Z RS( t valuec C s t j | | | | | _ d S( N( R R R/ ( R
R R ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR c s ( R R R R ( ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR. ` s t ExplorerSequencec B s> e Z d g Z d g Z d g Z d Z d Z d Z RS( t lent elementst get_elementsc C s8 t j | | | | | _ t | | _ g | _ d S( N( R R t seqR1 R2 ( R
R4 R ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR m s c C si t | j | _ g } xJ t | j D]9 } d | j | f } | j t j | j | | q( W| S( Ns %s[%s]( R1 R4 t xrangeR t appendt explorerPoolR ( R
t lt iR ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR3 u s $c C s
| j S( N( R3 ( R
R" ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyt view_get_elements s ( R R R R R R R3 R: ( ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR0 h s t ExplorerMappingc B sJ e Z d g Z d g Z d d g Z d Z d Z d Z d Z RS( R1 t keyst get_keyst get_itemc C s8 t j | | | | | _ t | | _ g | _ d S( N( R R t dctR1 R< ( R
R? R ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR s c C sr | j j } t | | _ g } xG t | j D]6 } d | j | f } | j t j | | | q4 W| S( Ns
%s.keys()[%s]( R? R< R1 R5 R R6 R7 R ( R
R< R8 R9 R ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR= s !c C s
| j S( N( R= ( R
R" ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyt
view_get_keys s c C s] t | t j k r! | j } n | j | } d | j t | f } t j | | } | S( Ns %s[%s]( R R
R R R? R R, R7 R ( R
R" R% t itemR ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyt
view_get_item s
( R R R R R R R= R@ RB ( ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR; s t ExplorerBuiltinc B s& e Z d Z d d d g Z d Z RS( 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.
t doct nameR
c C s; t j | | | | j | _ | j | _ | j | _ d S( N( R R t __doc__RD R RE t __self__R
( R
t functionR ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR s ( R R RF R R ( ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyRC s t ExplorerInstancec B s, e Z d Z d g Z d d g Z d Z RS( 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.
R t methodsR c C s t j | | | i } i } x t | D] } | d d k rH q, n t j | | g d } t | | } t | } | t j k r t j
| | | | <q, t j
| | | | <q, Wt j
| j | j d | _
| | _ | | _ d S( Ni t _t .s
.__class__( R R t dirt stringt joinR R R
t
MethodTypeR7 R R R R R RJ ( R
t instanceR t membersRJ R9 t mIdentifiert membert mType( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR s"
( R R RF R R R ( ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyRI s t
ExplorerClassc B s5 e Z d Z d d d d g Z d d g Z d Z RS( s6
@ivar name: the name the class was defined with
@ivar doc: the class's docstring
@ivar bases: a list of this class's base classes.
@ivar module: the module the class is defined in
Attribute groups:
- B{methods} -- class methods
- B{data} -- other members of the class
RE RD t basest moduleRJ R c C s@ t j | | | | s% | j } n i } i } x t | D] } | d d k rf | d k rf q> n t j | | g d } t | | } t | } | t j k r t
j | | | | <q> t
j | | | | <q> W| j | _ t
j | | _ | | _ | | _ t
j | j | d | _ t | d d | _ d S( Ni RK R RL s
.__bases__R ( R R R RM RN RO R R R
RP R7 R RE t inspectt getdocRD R RJ t __bases__RW R* RX ( R
t theClassR RR RJ R9 RS RT RU ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR s* ( R R RF R R R ( ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyRV s
t ExplorerFunctionc B s& e Z d d d d d g Z d Z RS( RE RD t filet linet signaturec C sc t j | | | | j } | j } | j d @o5 d } | j d @oH d } | | | } t | j | } | j r d } xj t | t | j | D]I }
| j | } t
j | d | | f } | j |
| | d } q Wn | r| j
| d n | r | j | d | n | j | _ | | _ t j | | _ | j | _ | j | _ d S( Ni i i i s %s.func_defaults[%d]( R R t func_codet co_argcountt co_flagst Signaturet co_varnamest
func_defaultsR5 R1 R7 R t set_defaultt set_keywordt set_varlistR RE R` RY RZ RD t co_filenameR^ t co_firstlinenoR_ ( R
RH R t codet argcountt takesListt
takesKeywordst nR` t i_dR9 t default( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR s2
( R R R R ( ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR] s t ExplorerMethodc B s e Z d d g Z d Z RS( R
R c C s | j } t | t j k r- | j j } n t j | | | t | | _ t j | j
| d | _ t j | j | d | _
| j r | j j n d S( Ns .im_classs .im_self( t im_funcR R
R t __call__R] R R R7 R t im_classR t im_selfR
R` t discardSelf( R
t methodR RH ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR D s ( R R R R ( ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyRs = s t ExplorerModulec B s5 e Z d Z d d d g Z d d d g Z d Z RS( 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 _")
RE RD R^ t classest functionsR c C sG t j | | | i } i } i } x | j j D] \ } } | d d k rW q5 n d | | f } t | t j k r t j | | | | <q5 t | t j k r t j | | | | <q5 t | t j
k r q5 t j | | | | <q5 W| j | _ t
j | | _ t | d d | _ | | _ | | _ | | _ d S( Ni RK s %s.%st __file__( R R t __dict__t itemsR R
t ClassTypeR7 R t FunctionTypet
ModuleTypeR RE RY RZ RD R R* R^ R{ R| R ( R
RX R R| R{ R R% R/ RS ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR f s. ( R R RF R R R ( ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyRz V s Rd c B s e Z d Z d Z d Z d Z d Z d Z d Z d Z
d Z d Z d Z
d
Z d Z d Z d
Z d Z d Z RS( s I represent the signature of a callable.
Signatures are immutable, so don't expect my contents to change once
they've been set.
i i i c C s9 | | _ d g t | | _ d g t | | _ d S( N( RE R* R1 Rr t flavour( R
t argNames( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR s c C s | j | S( N( RE ( R
t arg( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyt get_name s c C sY | t j k r$ | j j | } n | j | | j k rK t | j | f St d f Sd S( N(
R
t
StringTypeRE t indexR t _HAS_DEFAULTt TrueRr t FalseR* ( R
R ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyt get_default s
c C sE | t j k r$ | j j | } n | j | j | <| | j | <d S( N( R
R RE R R R Rr ( R
R R/ ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyRg s c C s8 | t j k r$ | j j | } n | j | j | <d S( N( R
R RE R t _VAR_LISTR ( R
R ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyRi s c C s8 | t j k r$ | j j | } n | j | j | <d S( N( R
R RE R t
_KEYWORD_DICTR ( R
R ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyRh s c C s8 | t j k r$ | j j | } n | j | | j k S( N( R
R RE R R R ( R
R ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyt
is_varlist s c C s8 | t j k r$ | j j | } n | j | | j k S( N( R
R RE R R R ( R
R ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyt
is_keyword s c C s4 | j d | _ | j j d | j j d d S( sK Invoke me to discard the first argument if this is a bound method.
i i N( RE Rr t popR ( R
( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyRx s c C s4 i t | j d 6t | j d 6t | j d 6S( NRE R Rr ( t tupleRE R Rr ( R
( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyt getStateToCopy s c C s
t | j S( N( R1 RE ( R
( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyt __len__ s c C s g } x t t | D] } | j | } | j | \ } } | r\ d | | f } nD | j | r{ d | f } n% | j | r d | f } n | } | j | q Wt j | d S( Ns %s=%ss *%ss **%ss , ( R5 R1 R R R R R6 RN RO ( R
t arglistR RE t
hasDefaultRr t a( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyt __str__ s N( R R RF R* t _FLAVOURLESSR R R R R R Rg Ri Rh R R Rx R R R ( ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyRd s"
t CRUFT_WatchyThingiec B s e Z d Z d Z RS( c C s+ t | | j | j } | j | | | S( s Watch the object returned by evaluating the identifier.
Whenever I think the object might have changed, I'll send an
ObjectLink of it to the callback.
WARNING: This calls eval() on its argument!
( t evalt globalNamespacet localNamespacet watchObject( R
R t callbackR ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyt watchIdentifier s c C s9 t | t j k r! t d n i } t j | j | d x! | j j D] } d | | <qM W| j } i } t j d | j j
t | f t | j f | } t j
| | | d d | | d <| | _ x] | D]U } t | | }
t |
t j
k r |
j d k r t | } | j | q q Wd S( s Watch the given object.
Whenever I think the object might have changed, I'll send an
ObjectLink of it to the callback.
The identifier argument is used to generate identifiers for
objects which are members of this one.
s+ Sorry, can only place a watch on Instances.t i s Watching%s%Xc S s | | j | | S( N( t browseObject( t slfR9 t bt cb( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyt <lambda>. s t _watchEmitChangedN( R R
R t TypeErrorR t addMethodNamesToDictR R~ R< R R R t _MonkeysSetattrMixinRP R* R Rw t _WatchMonkeyt install( R
R R R R? t kRR t clazzNSt clazzRE t mt monkey( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR s,
( R R R R ( ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR s
R c B s8 e Z d Z d Z d Z d Z d Z d Z RS( 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.
c C s
| | _ d S( s7 Make a monkey to hang on this instance object.
N( RQ ( R
RQ ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR R s c C s_ t | j | d } | | k r[ t j | | j | j j | j j | <| | f | _ n d S( s? Install myself on my instance in place of this method.
N( R RQ R* R
RP R R~ t oldMethod( R
t methodIdentifierR ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR W s
"c C se | j d k r d S| j d d k r@ t | j | j d n! t | j | j d | j d d S( s] Remove myself from this instance and restore the original method.
(I hope.)
Ni i ( R R* t delattrRQ t setattr( R
( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyt uninstallc s
c O s= | j d r) t | j d | | } n d } | j | S( s@ Pretend to be the method I replaced, and ring the bell.
i N( R t applyR* R ( R
RQ R t kwt rval( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyRu r s
N( R R RF R* R R R R Ru ( ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR J s R c B s e Z d Z d Z RS( sD A mix-in class providing __setattr__ for objects being watched.
c C sT t | j j d d r9 | j j d j | | | n
| | j | <| j d S( s- Set the attribute and ring the bell.
i t __setattr__N( t hasattrR R[ R R~ R ( R
R t v( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR s
( R R RF R ( ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyR ~ s ( ( ( (/ RF RY RN R' R
t UserDictt twisted.spreadR t twisted.pythonR R R R R7 t CacheableR R R. R0 R; RC RI RV R] Rs Rz R R RP R R t BuiltinFunctionTypet ListTypet TupleTypet DictTypeR t NoneTypet IntTypet FloatTypet LongTypet ComplexTypeR t CopyableRd R R R ( ( ( s< /usr/lib/python2.7/dist-packages/twisted/manhole/explorer.pyt <module> sL 0 )
*()/-
eQ4