a Fb@sNdZddgZddlZddlZddlmZddlZddlZddlZddlm Z ddl Z ddl Z ddl mZddlmZdd lmZdd lmZdd lmZdd lmZdd lmZddlmZddlmZddlmZddlm Z ddlm!Z!ddl"m#Z#m$Z$m%Z%ddl&m'Z'ddl(m)Z)ddl*m+Z+ddl,m-Z-ddl.m/Z/ddl0m1Z1ddZ2e j3j4jZ5e6j7jZ8dde j9e j:e j3e;fDZZ?e=e@jAZBe#ZCejDZEgdZFdd ZGd!d"ZHee@dfd#d$d%ZId;ee@dfd#d'd(ZJd)d*ZKe+d+d,ZLe+d-d.ZMe+d7sr#) type_name base_class string_form namespacelengthfile definition docstringsourceinit_definitionclass_docstringinit_docstringcall_defcall_docstringismagicisaliasisclassfoundnamecKsddtD}|||S)z1Make an object info dict with all fields present.cSsi|] }|dqSNr)r!krrr Vzobject_info..) info_fieldsupdate)kwZinfodictrrr object_infoTs r>cCsvt|}|durdS|dr"dStj|s2dSt|d }t|j \}}Wdn1sd0Y|SdS)znGet encoding for python source file defining obj Returns None if obj is not defined in a sourcefile. Nz.soz.dllz.pydrb) find_fileendswithospathisfile stdlib_ioopenr detect_encodingreadline)objofilebufferencodinglinesrrr get_encoding[s  .rOreturncCsBz |}WntyYn0t|tr4t|St|}|S)a=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. )r Exception isinstancestrrZcleandoc)rJdsZdocstrrrrr rs      r c Cst|trg}dD]z}t||}|durt|}|r` 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. z
z
 text/plain text/htmlN)rSdict)ryrrrvZ formattedrrr _mime_formats   zInspector._mime_formatc Cs|d}d}tt|\}}tdd|D}t||D]P\}}|d}d|vrVdnd} |||d|t|d| |d7}q8||d<|S)NrrVcss|]}t|VqdSr7len)r!rrrr 1r:z(Inspector.format_mime..rZr:)listzipmaxstriprr) rybundleZ text_plainrZheadsZbodies_lenrbodyZdelimrrr format_mime+s 0zInspector.format_mimerc sj|||dgdd}d,ttdfdd }fdd } d rZ||d d nd r|dkrz||dd| n||dd|||ddnRdst|r(||dd| ||dd| ||dd||dkrdr||dd| n||dd|||dd||dd||ddn||dd| ||d d!| ||dd||d"d d#d$krv||d%d#||d&d'||dd|dkrdr||dd| n||dd|||d(d)|||dd|||d*d+||S)-a9Retrieve an info dict and format it. Parameters ---------- obj : any Object to inspect and return info from oname : str (default: ''): Name of the variable pointing to `obj`. formatter : callable info already computed information detail_level : integer Granularity of detail level, if set to 1, give more information. omit_sections : container[str] Titles or keys to omit from output (can be set, tuple, etc., anything supporting `in`) reinfo detail_levelrVrN)titlekeycsn|vs|vrdS|}|durj||}|d||df|dd|d|dd7<dS)Nrrz

z

rZ)rr])rrrrZfieldZformatted_fieldr omit_sectionsryrr append_fieldVs z)Inspector._get_info..append_fieldcs|t|dS)Nr)rr)r)ryrrcode_formatter_sz+Inspector._get_info..code_formatterr3Reprr&r2rZSourcer,Z Docstringr+ZFiler)r4Z Signaturer*zInit signaturer-zInit docstringr/Typer$Z Subclasses subclasseszCall signaturer0z String formr'Z InteractiveZ NamespaceZLengthr(zClass docstringr.zCall docstringr1)N)rrTrlr) ryrJrerrrrZ_mimerrrrr _get_info;sL        zInspector._get_infoTcCs.|j||||||d}|s |d=t|dS)a Show 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 dictionary. 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. - omit_sections: set of section keys and titles to omit )rrN)rr)ryrJrerrrZenable_html_pagerrrrrpinfos ! zInspector.pinfocCs"tjdtdd|j||||dS)z Inspector.info() was likely improperly marked as deprecated while only a parameter was deprecated. We "un-deprecate" it. zThe `Inspector.info()` method has been un-deprecated as of 8.0 and the `formatter=` keyword removed. `Inspector._info` is now an alias, and you can just call `.info()` directly.rmrnr)rqrrrsr)ryrJrerrrrr_infos zInspector._infocCs|durd}d}d}n|j}|j}|j}|rt|s`zd|d}Wqdt|}Yq0qdt|}|jr|d|j7}nt|}|durd }t|d ||dd } d } t| d d} |rd| d<n|rd| d<nt |j | d<z|j } t| | d<Wn Yn0||j krztt|} d}|st | | kr| d| d| | d} ddt |dd| dD} | | |<Wn Yn0|r|| d<ztt || d<WntyYn0d}t|}|durd }n.|drd }n|drd}t|| d<|rxtz:t|ts<|s`t||}|durX|}|| d<WntyvYn0|r|| d|s|| d <t|rd | d!<z|||}Wnt yd}Yn0z |j!}Wnt yd}YnH0|dur,z|||}Wnt y*Yn0t|}|t"krBd}|rP|| d"<|r^|| d#<d$d%t #|D}t |d&krd'|}nd'|dd&d(g}|| d)<n|||}|r|| d*<|rzt$|d+}Wnd}Yn 0t|}|t%vrd}|r||kr|| d,<zt|j!}|t"kr8d}Wnt yRd}Yn0|rb|| d#<t&|d-rt'|s||j(|}|r|| d*kr|| d.<t|j(}|t)krd}|r|| d/<t*fi| S)0aCompute a dict with detailed information about an object. Parameters ---------- obj : any An object to find information about oname : str (default: '') Name of the variable pointing to `obj`. info : (default: None) A struct (dict like with attr access) with some information fields which may have been precomputed already. detail_level : int (default:0) If set to 1, more information is given. Returns ------- An object info dict with known fields from `info_fields`. Keys are strings, values are string or None. NFrVz!Alias to the system command: %srzzAlias: z Alias to z Docstring: zT)r6r5r3r2rrmzMagic functionr$z System aliasr%r&z <...> rZrcss|]}|VqdSr7)r)r!qrrrrr:z!Inspector.info..r'r(r?zz9Dynamically generated function. No source code available.r)r,r+r4r-r/cSsg|] }|jqSr)__name__)r!subrrr jr:z"Inspector.info.. , z...rr*rcr.rpr0r1)+r2r3r'rrT__doc__r rinttyperrcrr expandtabsr^splitrRrArBrrrrSr[r`rstrip_source_contains_docstringr{rr4rAttributeErrorr_object_init_docstring__subclasses__r\_builtin_type_docstringsr rlrp_func_call_docstringr>)ryrJrerrr2r3ZospacerUrZ string_maxZshalfZbclassZostrZstr_headZ binary_filerrhZinit_defZobj_initrnamesZ all_namesZdeflnclsZclass_dsr0rrrrrs                            zInspector.infocCs<z"tt|j\}t||kWSty6YdS0dS)z Check whether the source *src* contains the docstring *doc*. This is is helper function to skip displaying the docstring if the source already contains it, avoiding repetition of information. FN)astparserrZ get_docstringrR)rhr~Zdef_noderrrrs  z$Inspector._source_contains_docstringF) list_typescCsd}d}|r$tdttdS|} t| } | dkrF| d}n| dkrX| \}}n td||D] } | |vrhtd | |fqhtt} } |D]D}||}t || vrq| t |t |||||d }| |qtdt| dS) aSearch 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. - list_types(False): list all available object types for object matching. allrVrZNrzrrmz)invalid argument string for psearch: <%s>z'invalid namespace <%s>. Valid names: %s) ignore_caseshow_all) rr^sortedrrr ValueErrorkeyssetidaddrr<)rypatternZns_tableZ ns_searchrrrZ type_patternfilterZcmdsZlen_cmdsr6Z search_resultZnamespaces_seenZns_namensZtmp_resrrrpsearchs<     zInspector.psearch)rV)rV)rVN)rV)rV)N)rVNNrr)rVNNrTr)rVNr)rVNr)r __module__ __qualname__rr ANSICodeColorsrrrTrrrrrr rrrrrrrrrr staticmethodrr __classcell__rrrrresH    9  & a ( T cCsg}d}d}|jD]f}|jtjkr,d}n|r>|dd}|jtjkrPd}n|jtjkrn|rn|dd}|t|q|r|dt |t dd|Ddkrd |d d d|D}nd |d |}|j tjurt|j }|d |7}|S)z This was mostly taken from inspect.Signature.__str__. Look there for the comments. The only change is to add linebreaks when this gets too long. FT/*css|]}t|dVqdS)rmNrr!rrrrrr:z$_render_signature..Kz{}( {})rVcss|]}d|VqdS)z {}, N)rrrrrrsz{}({})rz -> {}) parametersvalueskindrZ_POSITIONAL_ONLYr]Z_VAR_POSITIONALZ _KEYWORD_ONLYrTrsumrr^Zreturn_annotationZ_emptyZformatannotation)Z obj_signatureZobj_nameresultZpos_onlyZkw_onlyZparamZrenderedZannorrrrs4       r)rV)T)Tr__all__rrrrrqrCtextwraprtypesiorFtypingrZ IPython.corerZIPython.lib.prettyrZIPython.testing.skipdoctestr Z IPython.utilsr r r ZIPython.utils.dir2r ZIPython.utils.pathrZIPython.utils.textrZIPython.utils.wildcardrrZIPython.utils.coloransirrrZIPython.utils.py3compatrZIPython.utils.colorablerZIPython.utils.decoratorsrZpygmentsrZpygments.lexersrZpygments.formattersrr FunctionTyperprobjectrr ModuleType MethodTyper[rrrrirTupperrjZColorsrrr;r>rOr r`rlrtrxrrarArrrrrrrs~                        <   %#