&9_[c@sdZddlmZddgZddlZddlZddlZddlZddlm Z ddl Z ddl Z yddl mZWn!ek rddl mZnXdd lmZdd lmZdd lmZdd lmZdd lmZddlmZddlmZddlmZddlm Z ddl!m"Z"ddl#m$Z$m%Z%m&Z&ddl'm(Z(m)Z)m*Z*ddl+m,Z,ddl-m.Z.ddl/m0Z0ddl1m2Z2ddl3m4Z4dZ5e j6j7jZ8e9j:jZ;de j<e j=e j6e>fDZ?e@eAZBe@eCjDZEe$ZFejGZHddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/gZId0ZJd1ZKd2ZLd3d4ZMd5ZNd6ZOd7ZPeQd8ZRd9ZSd:ZTd;ZUde.fd<YZVdS(=sTools for inspecting Python objects. Uses syntax highlighting for presenting the various information elements. Similar in spirit to the inspect module, but all calls take a name argument to reference the name under which an object is being read. i(tprint_functiont Inspectort InspectColorsN(tdedent(t izip_longest(t zip_longest(tpage(tpretty(tskip_doctest_py3(t PyColorize(topenpy(t py3compat(t safe_hasattr(t compress_user(tindent(tlist_namespace(t TermColorst ColorSchemetColorSchemeTable(t cast_unicodet string_typestPY3(t signature(t Colorable(t highlight(t PythonLexer(t HtmlFormattercCst|ttdtS(Nt noclasses(RRRtTrue(tcode((s4lib/python2.7/site-packages/IPython/core/oinspect.pytpylight3scCsh|]}tj|qS((tinspecttgetdoc(t.0tt((s4lib/python2.7/site-packages/IPython/core/oinspect.pys :s t type_namet base_classt string_formt namespacetlengthtfilet definitiont docstringtsourcetinit_definitiontclass_docstringtinit_docstringtcall_deftcall_docstringtismagictisaliastisclasstargspectfoundtnamecKs)tttdg}|j||S(s1Make an object info dict with all fields present.N(tdictRt info_fieldstNonetupdate(tkwtinfodict((s4lib/python2.7/site-packages/IPython/core/oinspect.pyt object_infoVs cCst|}|dkrdS|jdr/dStjj|sEdStj|d}tj |j \}}WdQX|SdS(snGet encoding for python source file defining obj Returns None if obj is not defined in a sourcefile. s.sos.dlls.pydtrbN(s.sos.dlls.pyd( t find_fileR9tendswithtostpathtisfilet stdlib_iotopenR tdetect_encodingtreadline(tobjtofiletbuffertencodingtlines((s4lib/python2.7/site-packages/IPython/core/oinspect.pyt get_encoding]s  cCsy|j}Wntk r#nXt|tr@tj|Sy2tj|}t|}tj|d|SWntk rdSXdS(s=Stable wrapper around inspect.getdoc. This can't crash because of attribute problems. It also attempts to call a getdoc() method on the given object. This allows objects which provide their docstrings via non-standard mechanisms (like Pyro proxies) to still be inspected by ipython's ? system. RKN( R t Exceptiont isinstanceRRtcleandocRMR RR9(RHtdstdocstrRK((s4lib/python2.7/site-packages/IPython/core/oinspect.pyR ts     tcCst|tr g}xdddgD]}t||}|d k r%t|}|rbd|nd}|jtdjd||fd|tj |r|jt t |q|jtd||t |fd|q%q%W|rd j|Sd Snt |}ytj |}WnNtk rzt|d r{ytj |j}Wqwtk rsd SXq{nXt|}t|d|Sd S( slWrapper around inspect.getsource. This can be modified by other projects to provide customized source extraction. Parameters ---------- obj : object an object whose source code we will attempt to extract oname : str (optional) a name under which the object is known Returns ------- src : unicode or None tfgettfsettfdels%s.RSs# RKs %s%s = %s s t __class__N(ROtpropertytgetattrR9RMtappendRtjoinRt isfunctionRt getsourceRt _get_wrappedt TypeErrorthasattrRW(RHtonametsourcestattrnametfnRKt oname_prefixtsrc((s4lib/python2.7/site-packages/IPython/core/oinspect.pyR]s<           cCs:tj|p9tj|p9t|tp9t|tS(sTrue if obj is a function ()(RR\tismethodROt_builtin_func_typet_builtin_meth_type(RH((s4lib/python2.7/site-packages/IPython/core/oinspect.pytis_simple_callablescCsHt|dr(t| r(|j}ntr;tj|Stj|S(sWrapper around :func:`inspect.getfullargspec` on Python 3, and :func:inspect.getargspec` on Python 2. In addition to functions and methods, this can also handle objects with a ``__call__`` attribute. t__call__(R RjRkRRtgetfullargspect getargspec(RH((s4lib/python2.7/site-packages/IPython/core/oinspect.pyRms cCs&tj|d|d|d|dS(sFormat argspect, convenience wrapper around inspect's. This takes a dict instead of ordered arguments and calls inspect.format_argspec with the arguments in the necessary order. targstvarargstvarkwtdefaults(Rt formatargspec(R4((s4lib/python2.7/site-packages/IPython/core/oinspect.pytformat_argspecscCs|jd}|d kr$d }nay|dddk}Wnttfk rUnX|rq|dd|d%sit:s (RtmaxRt splitlinestljustRZRR[(Rttfieldst title_widthRRRtcontent((s4lib/python2.7/site-packages/IPython/core/oinspect.pyt_format_fieldss   !cCs~t|}i|d6d|dd6}|dkr8|S||}t|tsmi|d6d|dd6St||SdS(sFReturn a mime bundle representation of the input text. - if `formatter` is None, the returned mime bundle has a `text/plain` field, with the input text. a `text/html` field with a `
` tag containing the input text.

        - if `formatter` is not None, it must be a callable transforming the
          input text into a mime bundle. Default values for `text/plain` and
          `text/html` representations are the ones described above.

        Note:

        Formatters returning strings are supported but this behavior is deprecated.

        s
text/plains
s
s	text/htmlN(RR9ROR7(RtttextRRqt	formatted((s4lib/python2.7/site-packages/IPython/core/oinspect.pyt_mime_format.sc
Cs|d}d}tt|\}}td|D}xyt||D]h\}}|jd}d|kr{dnd}	||j|d|t|d|	|d7}qNW||d<|S(Ns
text/plainRScss|]}t|VqdS(N(R(R!R((s4lib/python2.7/site-packages/IPython/core/oinspect.pys	[ss
RR(tlisttzipRtstripRR(
Rttbundlet
text_plainRtheadstbodiest_lenRtbodytdelim((s4lib/python2.7/site-packages/IPython/core/oinspect.pytformat_mimeUs
9
c	sj|d|dd|igd6dd6}d+fd}fd}d	rv||d
dn3dr|d
kr||dd|n||dd|||ddndst|ry||dd|||dd||d
kr0dr0||dd|n&||dd|||dd|||dd||ddn0||dd|||dd|||ddtjrt|tjrdr||d dn||d!dd"d#kr||d$d"n||d%d&||dd|d
kr]||dd|n||dd|||d'd(|||dd|||d)d*|j|S(,s$Retrieve an info dict and format it.Ratinfotdetail_levels
text/plainRSs	text/htmlcsn|}|dk	rjj||}|dj||df|dcd|d|dd7s
s
(R9RRZ(RRtkeyRtfieldtformatted_field(RRt(s4lib/python2.7/site-packages/IPython/core/oinspect.pytappend_fieldos

cs!ij|d6t|d6S(Ns
text/plains	text/html(RR(R(Rt(s4lib/python2.7/site-packages/IPython/core/oinspect.pytcode_formattervsR2tReprR%R1itSourceR+t	DocstringR*tFileR(R3t	SignatureR)sInit signatureR,sInit docstringR.tTypeR#sCall signatureR/R$s
Base ClasssString formR&tInteractivet	NamespacetLengthR'sClass docstringR-sCall docstringR0N(	t_infoR9RjRRRORRR(	RtRHRaRRRt_mimeRR((RRts4lib/python2.7/site-packages/IPython/core/oinspect.pyt	_get_infoesN!


&cCs<|j|||||}|s+|d=ntj|dS(sShow detailed information about an object.

        Optional arguments:

        - oname: name of the variable pointing to the object.

        - formatter: callable (optional)
              A special formatter for docstrings.

              The formatter is a callable that takes a string as an input
              and returns either a formatted string or a mime type bundle
              in the form of a dictionnary.

              Although the support of custom formatter returning a string
              instead of a mime type bundle is deprecated.

        - info: a structure with some information fields which may have been
          precomputed already.

        - detail_level: if set to 1, more information is given.
        s	text/htmlN(RR(RtRHRaRRRtenable_html_pager((s4lib/python2.7/site-packages/IPython/core/oinspect.pytpinfos
cCsD|dk	r%tjdtddn|j|d|d|d|S(sNDEPRECATED. Compute a dict with detailed information about an object.
        smThe `formatter` keyword argument to `Inspector.info`is deprecated as of IPython 5.0 and will have no effects.t
stackleveliRaRRN(R9twarningstwarntDeprecationWarningR(RtRHRaRRR((s4lib/python2.7/site-packages/IPython/core/oinspect.pyRs	c	Cs}t|}|d0kr-d}d}d}n|j}|j}|j}|rt|syd|d}	Wqdt|}	qXqdt|}	|jr|	d|j7}	qn!t|}	|	d0krd}	nt	d	|d
t
d|d|}
d
}t|dd}|r$d}
n|r3d}
n	|j}
|
|
dR6R5R2R1iiisMagic functionsSystem aliasR#R$R%s <...> s
Rcss|]}|jVqdS(N(R(R!tq((s4lib/python2.7/site-packages/IPython/core/oinspect.pys	sR&R's.sos.dlls.pydss9Dynamically generated function. No source code available.R(R+R*R3R,R.R)RWR-RkR/R0RR4RptkeywordsN(s.sos.dlls.pyd(0RR9R1R2R&RRt__doc__R R7Rtintt__name__RWRRt
expandtabsR[tsplitRR?R@R
RRRORXR]trstripRNRuRR3RtAttributeErrorRt_object_init_docstringRYt_builtin_type_docstringsRRjRkt_func_call_docstringRmR_t_asdicttpopR=(RtRHRaRRtobj_typeR1R2tospaceRQRt
string_maxtshalft
obj_type_nametbclasstostrtstr_headtbinary_fileRRftinit_deftobj_initRtdeflntclstclass_dsR/Rtcallable_objR4targspec_dict((s4lib/python2.7/site-packages/IPython/core/oinspect.pyRs
						!			
	
			









	


	




		c	CsHd}d}|j}t|}	|	dkr=|d}n+|	dkrX|\}}ntd|x9|D]1}
|
|krotd|
|jfqoqoWtt}}xn|D]f}
||
}t||krqn|jt|t|||d|d	|}|j|qWt	j	d
j
t|dS(sMSearch namespaces with wildcards for objects.

        Arguments:

        - pattern: string containing shell-like wildcards to use in namespace
          searches and optionally a type specification to narrow the search to
          objects of that type.

        - ns_table: dict of name->namespaces for search.

        Optional arguments:

          - ns_search: list of namespace names to include in search.

          - ignore_case(False): make the search case-insensitive.

          - show_all(False): show all names, including those starting with
            underscores.
        tallRSiiis)invalid argument string for psearch: <%s>s'invalid namespace <%s>. Valid names: %stignore_casetshow_alls
N(RRt
ValueErrortkeystsettidtaddRR:RR[tsorted(Rttpatterntns_tablet	ns_searchRRttype_patterntfiltertcmdstlen_cmdsR6t
search_resulttnamespaces_seentns_nametnsttmp_res((s4lib/python2.7/site-packages/IPython/core/oinspect.pytpsearchs0




N(Rt
__module__RR	tANSICodeColorsR9RRRRRRRRRRRRRRRRRRRR(((s4lib/python2.7/site-packages/IPython/core/oinspect.pyRws.			:'	P	(WRt
__future__Rt__all__RRRRAttextwrapRRtioRDt	itertoolsRtImportErrorRtIPython.coreRtIPython.lib.prettyRtIPython.testing.skipdoctestRt
IPython.utilsR	R
RtIPython.utils.dir2RtIPython.utils.pathR
tIPython.utils.textRtIPython.utils.wildcardRtIPython.utils.coloransiRRRtIPython.utils.py3compatRRRtIPython.utils.signaturesRtIPython.utils.colorableRtpygmentsRtpygments.lexersRtpygments.formattersRRtFunctionTypeRkRtobjectRRt
ModuleTypet
MethodTypeRXRRRRhRtupperRitColorsRRR8R=RMR R]RjRmRsRR}R^R?RR(((s4lib/python2.7/site-packages/IPython/core/oinspect.pytsp
						?		
	
5		#