U 祡c%@s2ddlmZddlZddlmZmZmZmZmZmZddl m Z m Z m Z m Z mZmZmZddlmZmZddlmZddlmZdd lmZdd lmZdd lmZdd lmZdd l m!Z!m"Z"e#e#dddZ$GdddeZ%ee&ee fee'dfdddZ(e&e e#dddZ)e&e e#e*dddZ+dS))absolute_importN)cleandocgetdocgetfileisclassismodule signature)Any CollectionIterableOptionalTupleTypeUnion)GroupRenderableType)escape_control_codes)ReprHighlighter) JupyterMixin)Panel)Pretty)Table)TextTextType)docreturncCs|d\}}}|S)z)Get the first paragraph from a docstring.z ) partition)rZ paragraph_r1/tmp/pip-unpacked-wheel-qkhzhrww/rich/_inspect.py_first_paragraphsr!c @seZdZdZdddddddddd eeeeeeeeeeedd ddZee d d d Z e d d dZ e eee dddZeed ddZeee dddZdS)InspectaA renderable to inspect any Python Object. Args: obj (Any): An object to inspect. title (str, optional): Title to display over inspect result, or None use type. Defaults to None. help (bool, optional): Show full help text rather than just first paragraph. Defaults to False. methods (bool, optional): Enable inspection of callables. Defaults to False. docs (bool, optional): Also render doc strings. Defaults to True. private (bool, optional): Show private attributes (beginning with underscore). Defaults to False. dunder (bool, optional): Show attributes starting with double underscore. Defaults to False. sort (bool, optional): Sort attributes alphabetically. Defaults to True. all (bool, optional): Show all attributes. Defaults to False. value (bool, optional): Pretty print value of object. Defaults to True. NFT) titlehelpmethodsdocsprivatedundersortallvalue) objr#r$r%r&r'r(r)r*r+rc Csdt|_||_|p|||_| r.d}}}||_||_|p@||_|pJ||_||_ ||_ | |_ dS)NT) r highlighterr, _make_titler#r$r%r&r'r(r)r+) selfr,r#r$r%r&r'r(r)r*r+rrr __init__'s   zInspect.__init__r,rcCs:t|st|st|r t|n tt|}||}|S)zMake a default title.)rcallablerstrtyper-)r/r,Z title_strZ title_textrrr r.Bs   zInspect._make_title)rcCstjt||jdddS)Nz scope.borderrr)r# border_stylepadding)rZfitr_renderr#)r/rrr __rich__Ls  zInspect.__rich__)namer,rc Csztt|d}Wn,tk r,d}Yntk r@YdSXd}z t|}Wnttfk rjYnXt|dd}|r|d|||}|pt |d|}t |rd}nt |rd }nd }t |d d |d d f|df|} | S)zGet a signature for a callable.:z(...)Nzinspect.callablestylez link file:// __qualname__classz async defdef zinspect.r)r3r ValueError TypeErrorrOSErrorrstylizer-getattrinspectriscoroutinefunctionassemblereplace) r/r:r, _signatureZsource_filenameZ callable_nameZsignature_textqualnameprefixZqual_signaturerrr _get_signatureTs6     zInspect._get_signaturec#stttftttfddd}ttttfdfdd |jt}t|}|jsfdd|D}|jszd d|D}|t|}fd d|D}|j r|j |d t j d d d}|j dd|j }|j}tr|d} | dk r| VdV|jr4|} | dk r4t| dd} || } | VdV|jrztsztsztszttddddddVdV|D]\} \} }t| | drdndfd}| dk r|}|d|||t| q~t|rz|jsq~|| |}|dkr||t||d nZ|jrn||}|dk rn|d!|krLd!nd"||}|d#|||||n||t||d q~|j r|Vn|rt!d$|d%VdS)&zRender object.)itemrcSs"|\}\}}t||dfS)Nr)r2striplower)rOkey_errorr+rrr sort_items~s z#Inspect._render..sort_items) attr_namerc sDzdt|fWStk r>}z|dfWYSd}~XYnXdS)zGet attribute or any exception.N)rF Exception)rUerrorr,rr safe_getattrsz%Inspect._render..safe_getattrcSsg|]}|ds|qS)__ startswith.0rRrrr s z#Inspect._render..cSsg|]}|ds|qS)rr[r]rrr r_s csg|]}||fqSrrr])rYrr r_s)rRr5F)r7expandright)ZjustifyNz inspect.helpr<T <)Z indent_guides max_lengthZ max_stringzinspect.value.border)r6rZzinspect.attr.dunderz inspect.attr)z =zinspect.equalsz inspect.error)r- rAz inspect.docz[b cyan]za[/][i] attribute(s) not shown.[/i] Run [b][magenta]inspect[/]([not b]inspect[/])[/b] for options.)"r r3r boolr,dirlenr(r'r)rZgridZ add_columnadd_rowr-r2rNr&_get_formatted_docrr+rrrrrIr\copyrEreprr%appendZ row_countZ from_markup)r/rTkeysZ total_itemsZnot_shown_countitemsZ items_tablerjr-r_docZdoc_textrRrWr+Zkey_textwarningZ_signature_textr&rr)r,rYr r8{s        &           zInspect._render)object_rcCs6t|}|dkrdSt|}|js.t|}t|S)a Extract the docstring of an object, process it and returns it. The processing consists in cleaning up the doctring's indentation, taking only its 1st paragraph if `self.help` is not True, and escape its control codes. Args: object_ (Any): the object to get the docstring from. Returns: Optional[str]: the processed docstring, or None if no docstring was found. N)rrrPr$r!r)r/rsr&rrr rks  zInspect._get_formatted_doc)__name__ __module__r>__doc__r r rrgr0rr.rr9r3rNr rr8rkrrrr r"s8  ']r".r1cCst|dst|}t|ddS)zNReturns the MRO of an object's class, or of the object itself if it's a class.__mro__r)hasattrr4rFrXrrr get_object_types_mros rycCsddt|DS)z Returns the MRO of an object's class as full qualified names, or of the object itself if it's a class. Examples: `object_types_mro_as_strings(JSONDecoder)` will return `['json.decoder.JSONDecoder', 'builtins.object']` cSs*g|]"}t|dddt|ddqS)rurb.r>)rF)r^type_rrr r_sz3get_object_types_mro_as_strings..)ryrXrrr get_object_types_mro_as_stringssr|)r,fully_qualified_types_namesrcCs t|D]}||krdSqdS)z Returns `True` if the given object's class (or the object itself, if it's a class) has one of the fully qualified names in its MRO. TF)r|)r,r} type_namerrr is_object_one_of_typess r), __future__rrGrrrrrrtypingr r r r r rrconsolerrcontrolrr-rZjupyterrZpanelrprettyrtablertextrrr3r!r"objectr4ryr|rgrrrrr s(  $      X$