U -e@sUdZddgZddlmZddlmZddlmZddlZddl Z ddlZddl Z ddl Z ddl Z ddlZddlZddlZddlmZmZmZmZmZmZejd krdd lmZn dd lmZdd lmZdd lmZdd lm Z ddl!m"Z"ddl!m#Z#ddl$m%Z%ddl&m'Z'ddl(m)Z)ddl*m+Z+ddl*m,Z,ddl-m.Z.m/Z/m0Z0ddl1m2Z2ddl3m4Z4ddl5m6Z6ddl7m8Z8ddl9m:Z:ddl;meee>e>ffZ?ee@d<ee>e>fZAee@d<eGdd d ZBd!d"ZCejDjEjZFeGjHjZId#d$ejJejKejDeLfDZMeNeOZPeNe>jQZRe.ZSe"jTZUd%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7gZVd8d9ZWd:d;ZXee>dfd<d=d>ZYdTee>dfd<d@dAZZdBdCZ[e6dDdEZ\e6dFdGZ]e6dUdIdJZ^dKdLZ_e>d<dMdNZ`dOdPZaGdQdde4Zbe>d<dRdSZcdS)VzTools 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. Inspector InspectColors) dataclass) signature)dedentN)AnyOptionalDictUnionListTuple) ) TypeAlias)page)pretty) skip_doctest) PyColorize)openpy) safe_hasattr) compress_user)indent)list_namespace) typestr2type) TermColors ColorSchemeColorSchemeTable) cast_unicode) Colorable)undoc) highlight) PythonLexer) HtmlFormatterZ__custom_documentations__UnformattedBundleBundlec@sJeZdZUeed<eed<eed<eeed<eed<eed<ddZd S) OInfoismagicisaliasfound namespaceparentobjcCs t||S)zGet a field from the object for backward compatibility with before 8.12 see https://github.com/h5py/h5py/issues/2253 )getattr)selffieldr/V/var/www/html/Darija-Ai-Train/env/lib/python3.8/site-packages/IPython/core/oinspect.pygetHsz OInfo.getN) __name__ __module__ __qualname__bool__annotations__rstrrr1r/r/r/r0r%?s  r%cCst|ttddS)NT)Z noclasses)r r!r")coder/r/r0pylightYsr9cCsh|]}t|qSr/)inspectgetdoc).0tr/r/r0 _sr> type_name base_class string_formr)lengthfile definition docstringsourceinit_definitionclass_docstringinit_docstringcall_defcall_docstringr&r'isclassr(namecKsddtD}|||S)z1Make an object info dict with all fields present.cSsi|] }|dqSNr/)r<kr/r/r0 ~szobject_info..) info_fieldsupdate)kwZinfodictr/r/r0 object_info|s rTc Csbt|}|dkrdS|dr"dStj|s2dSt|d}t|j \}}W5QRX|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_ioopenrdetect_encodingreadline)r+ofilebufferencodinglinesr/r/r0 get_encodings  rdreturncCsDz |}Wntk r YnXt|tr6t|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 isinstancer7r:cleandoc)r+dsZdocstrr/r/r0r;s     r;c Cs&t|trg}dD]}t||}|dk rt|}|rrNrcsJtt|j||d||_tjd||d|_|jj|_||_| |dS)N)r*configr7)outr*style) superr__init__ color_tablerParserparserformatstr_detail_levelset_active_scheme)r-rZcode_color_tableschemerr*rrwr/r0rs  zInspector.__init__rkrecCs$ztt||WSYdSXdS)zReturn the call signature for any callable object. If any exception is generated, None is returned instead and the exception is suppressed.N)_render_signaturer)r-r+ryr/r/r0_getdefszInspector._getdefcCsd|jjj||jjjfS)z*Return a header string with proper colors.z%s%s%s)rZ active_colorsheadernormal)r-hr/r/r0Z__heads zInspector.__headcCs&|dk r"|j||jj|dSrN)rrr)r-rr/r/r0rs zInspector.set_active_schemecCs,td|dd|r"td|ntdS)z-Generic message when no information is found.z No %s found endzfor %sN)print)r-msgryr/r/r0noinfoszInspector.noinfocCsft|stddSd}t|r,|d}|||}|dkrN|d|nt|||dddS)zwPrint the call signature for any callable object. If the object is a class, print the constructor information.zObject is not callable.NrkzClass constructor information: zdefinition headerrr)callablerr:rL_Inspector__headrrr)r-r+ryroutputr/r/r0pdefs   zInspector.pdefc Cs|j}g}t|}|r&||d|}|rF||d|t|t|rt|drt|j}|dk r||d|t|n4t|drt|j }|r||d|t||s| d|nt d |dS) aPrint the docstring for any object. Optional: -formatter: a function to run the docstring through for specially formatted docstrings. Examples -------- In [1]: class NoInit: ...: pass In [2]: class NoDoc: ...: def __init__(self): ...: pass In [3]: %pdoc NoDoc No documentation found for NoDoc In [4]: %pdoc NoInit No documentation found for NoInit In [5]: obj = NoInit() In [6]: %pdoc obj No documentation found for obj In [5]: obj2 = NoDoc() In [6]: %pdoc obj2 No documentation found for obj2 z plain/textzClass docstring:rNzInit docstring:rzCall docstring:Z documentationro) rr;r1rqrr:rLhasattrrrrrrr) r-r+ry formatterheadrcrjinit_dscall_dsr/r/r0pdocs*"   zInspector.pdoccCs\tzt||d}Wntk r0d}YnX|dkrH|d|nt||dS)z$Print the source code for an object.)ryNrF) linecache checkcachertrgrrr)r-r+ryr}r/r/r0psource s zInspector.psourcecCs~t|}|dkr |d|dSt|}|dr@td|n:tj|sZtd|n t| t j |dd|ddS) z0Show the whole file where an object was defined.NrCrUz File %r is binary, not printing.z%File %r does not exist, not printing.F)Zskip_encoding_cookier) rrrWrXrrYrZr[rrrZ read_py_file)r-r+ryrr`r/r/r0pfiles   zInspector.pfile)textrfcCsX|dt|dd}|dkr$|S||}t|tsH|d|ddSt|f|SdS)aRReturn 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.

        z
z

text/plain	text/htmlN)htmlescaperhdict)r-rrr	formattedr/r/r0_mime_format0s
zInspector._mime_format)bundlerfc
CsJt|dtst|dD]}t|tstqi}g}tdd|dD}|dD]R\}}|d}d|krrdnd}|||d|t|d||qTd	||d<d|krt|dtst|dD]}t|tstqt|dttfrd	dd|dD|d<|
D]}	|	d	kr:q&n||	}q&|S)
zRFormat a mimebundle being created by _make_info_unformatted into a real mimebundlercss|]\}}t|VqdSrNlen)r<r_r/r/r0	[sz(Inspector.format_mime..ror:rcss"|]\}}d|d|VqdS)z
z

Nr/)r<rbodyr/r/r0rns)rr)rhlistAssertionErrortuplemaxstriprqrrrrkeys)
r-ritemZnew_brc_lenrrdelimrOr/r/r0format_mimeRs4
(

zInspector.format_mimertitlekeyc	Cs`||ks||krdS||}|dk	r\|||}|d||df|d||dfdS)z^Append an info value to the unformatted mimebundle being constructed by _make_info_unformattedNrr)rrq)	r-rrrinfo
omit_sectionsrr.Zformatted_fieldr/r/r0_append_info_fieldxs
zInspector._append_info_fieldc	sggd}d+tttdfdd
}tdfdd}d	rP||d
dndr|d
krp||dd|n||dd|||ddnRdst|r||dd|||dd|||dd||d
krdr||dd|n||dd|||dd||dd||ddn||dd|||dd |||dd||d!dd"d#krl||d$d"||d%d&||dd|d
krdr||dd|n||dd|||d'd(|||dd|||d)d*||S),z;Assemble the mimebundle as unformatted lists of informationrNrcsj||||ddS)N)rrrrr)r)rrrrrrr-r/r0append_fieldsz6Inspector._make_info_unformatted..append_fieldrecs|t|dS)Nr)rr9)r)r-r/r0code_formattersz8Inspector._make_info_unformatted..code_formatterr'ReprrAr&rZSourcerFZ	DocstringrEFilerCrL	SignaturerDzInit signaturerGzInit docstringrITyper?Z
Subclasses
subclasseszCall signaturerJzString formr)Interactive	NamespaceZLengthrBzClass docstringrHzCall docstringrK)N)r#r7r$r)	r-r+rrdetail_levelrrrrr/rr0_make_info_unformattedsTz Inspector._make_info_unformattedr/)r+ryrrfc	Cs0|j||||d}|j|||||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`)
        ryrr)rr)rrr)	r-r+ryrrrrZ	info_dictrr/r/r0	_get_infoszInspector._get_infoT)rc	Cs:|dk	st|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
        N)rr)rrr)	r-r+ryrrrZenable_html_pagerrZinfo_br/r/r0pinfos!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.rrr)rrrr)r-r+ryrrr/r/r0_info&szInspector._infoc!CsD|dkrd}d}d}n|j}|j}|j}|dd}d}	d}
|rp|jdk	rpt|jtrpt|jt}||d}	t	|d||dd}|	r|	}
nt|rt
|szd|d	}
Wqd
t|}
YqXn dt|}
|jr|
d|j7}
nt
|}|dkrd
}
n|}
|
|
}
d}t|dd}|r,d|d<n|rrzMagic functionr?zSystem aliasr@rAz <...> rorcss|]}|VqdSrN)r)r<qr/r/r0rsz!Inspector.info..r)rBrUzz9Dynamically generated function. No source code available.rCrFrErLrGrIcSsg|]
}|jqSr/)r2)r<subr/r/r0
sz"Inspector.info..r, z...rrDrwrHrrJrK).r&r'r)splitr*r	HOOK_NAMEr,r1rrr7__doc__r;inttyper2rwrr
expandtabsrrrgrWrXrrrrhrprtrstrip_source_contains_docstringr:rLrAttributeErrorr_object_init_docstring__subclasses___builtin_type_docstringsrrr_func_call_docstringrT)!r-r+ryrrr&r'ZospaceZatt_nameZparents_docsZpreludeZparents_docs_dictrrjZ
ds_or_NoneZ
string_maxZshalfZbclassZostrZstr_headbinary_filerr}Zinit_defZobj_initrnamesZ	all_namesZdeflnclsZclass_dsrJrr/r/r0r5s"
















zInspector.infocCs>z"tt|j\}t||kWStk
r8YdSXdS)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)astparserr
get_docstringrg)r}rZdef_noder/r/r0rs
z$Inspector._source_contains_docstringF)
list_typescCsd}d}|r$tdttdS|}	t|	}
|
dkrF|	d}n|
dkrX|	\}}ntd||D] }||krhtd	||fqhtt}}
|D]D}||}t	||
krq|
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.
        allrkroNrrrz)invalid argument string for psearch: <%s>z'invalid namespace <%s>. Valid names: %s)ignore_caseshow_all)
rrrsortedrrr
ValueErrorrsetidaddrrR)r-patternZns_tableZ	ns_searchrrrZtype_patternfilterZcmdsZlen_cmdsrMZ
search_resultZnamespaces_seenZns_namensZtmp_resr/r/r0psearch(s>


zInspector.psearch)rk)rk)rkN)rk)rk)N)rkNNrr/)rkNNrTr/)rkNr)rkNr)%r2r3r4rrANSICodeColorsrr
r7rrrrrrrrrrrr#r$rrrrrr%rrrr	rstaticmethodrr
__classcell__r/r/rr0rsn

9

"(R')
c
cCsg}d}d}|jD]l}|jtjjkr.d}n|r@|dd}|jtjjkrTd}n |jtjjkrt|rt|dd}|t	|q|r|dt
|tdd|Ddkrd|d	
d
d|D}nd|d
|}|jtjk	rt|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)rNrr<rr/r/r0rsz$_render_signature..Kz{}(
{})rkcss|]}d|VqdS)z    {},
N)rr#r/r/r0rsz{}({})rz -> {})
parametersvalueskindr:	ParameterPOSITIONAL_ONLYrqVAR_POSITIONALKEYWORD_ONLYr7rsumrrrreturn_annotation_emptyformatannotation)Z
obj_signatureobj_nameresultZpos_onlykw_onlyparamrenderedannor/r/r0rks4


r)rk)T)dr__all__dataclassesrr:rtextwraprrrior\rrYsystypesrtypingrrr	r
rrversion_infoZtyping_extensionsrZIPython.corerZIPython.lib.prettyrZIPython.testing.skipdoctestrZ
IPython.utilsrrZIPython.utils.dir2rZIPython.utils.pathrZIPython.utils.textrZIPython.utils.wildcardrrZIPython.utils.coloransirrrZIPython.utils.py3compatrZIPython.utils.colorablerZIPython.utils.decoratorsrpygmentsr Zpygments.lexersr!Zpygments.formattersr"rr7r#r6r$r%r9FunctionTyperr
objectrr
ModuleType
MethodTyperpr	rrrupperrZColorsrrrQrTrdr;rtrrrrrurWrrrr/r/r/r0s 
 


?

%#`