U
ʗRe% @ s2 d dl mZ d dlZd dlmZmZmZmZmZmZ d dl m
Z
m Z m Z m
Z
mZmZmZ ddlmZmZ ddlmZ ddlmZ dd lmZ dd
lmZ dd l m Z dd l m Z dd
l m!Z!m"Z" e#e#dddZ$G dd deZ%ee&ee
f ee'df dddZ(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)docreturnc C s | d\}}}|S )z)Get the first paragraph from a docstring.z
) partition)r Z paragraph_ r /builddir/build/BUILDROOT/alt-python38-pip-22.2.1-2.el8.x86_64/opt/alt/python38/lib/python3.8/site-packages/pip/_vendor/rich/_inspect.py_first_paragraph s r! c
@ s e Zd ZdZdddddddddd eee eeeeeeeedd ddZee d d
d Z
e d d
dZ e
eee dddZee d ddZeee
dddZdS )Inspecta A 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+ r c C sd t | _|| _|p| || _| r.d } }}|| _|| _|p@|| _|pJ|| _|| _ || _
|
| _ d S )NT) r highlighterr, _make_titler# r$ r% r& r' r( r) r+ ) selfr, r# r$ r% r& r' r( r) r* r+ r r r __init__' s
zInspect.__init__r, r c C s: t |st|st|r t|n
tt|}| |}|S )zMake a default title.)r callabler strtyper- )r/ r, Z title_str
title_textr r r r. B s
zInspect._make_title)r c C s t jt| | jdddS )Nz scope.borderr r )r# border_stylepadding)r fitr _renderr# )r/ r r r __rich__L s
zInspect.__rich__)namer, r c
C s zt t|d }W n, tk
r, d}Y n tk
r@ Y dS X d}z t|}W n ttfk
rj Y nX t|dd}|r|d| | |}|pt |d|}t
|rd}nt
|rd }nd
}t
| d d |d d
f|df|} | S )z Get a signature for a callable.:z(...)Nzinspect.callablestylez link file:// __qualname__classz async defdef zinspect.r )r3 r
ValueError TypeErrorr OSErrorr stylizer- getattrinspectr iscoroutinefunctionassemblereplace)
r/ r< r,
_signatureZsource_filenameZ
callable_nameZsignature_textqualnameprefixZqual_signaturer r r _get_signatureT s6
zInspect._get_signaturec # s t ttf t ttf ddd}tt ttf d fdd | j t }t|}| jsfdd |D }| jszd d |D }|t| }fd
d|D }| j r|j |d t
j d d
d}|j dd |j
}| j}t r| d } | dk r| V dV | jr4| }
|
dk r4t|
dd} || } | V dV | jrzt szt szt sztt ddddddV dV |D ]\} \}
}t| | drd nd fd }|
dk r| }| d |||t |
q~t|rz| j sq~| | |}|dkr ||t||d nZ| jrn| |}|dk rn| d!|krLd!nd" ||}| d# | | ||| n||t||d q~|j r|V n|rt!d$| d%V dS )&zRender object.)itemr c S s" | \}\}}t ||d fS )Nr )r2 striplower)rQ key_errorr+ r r r
sort_items~ s z#Inspect._render..sort_items) attr_namer c
sD zdt | fW S tk
r> } z|df W Y S d}~X Y nX dS )z Get attribute or any exception.N)rH Exception)rW errorr, r r safe_getattr s z%Inspect._render..safe_getattrc S s g | ]}| d s|qS )__
startswith.0rT r r r
s
z#Inspect._render..c S s g | ]}| d s|qS )r r] r_ r r r ra s
c s g | ]}| |fqS r r r_ )r[ r r ra s )rT r6 F)r8 expandright)justify Nz inspect.helpr> T
< )
indent_guides
max_length
max_stringzinspect.value.border)r7 r\ zinspect.attr.dunderz inspect.attr)z =zinspect.equalsz
inspect.error)r-
rC z inspect.docz[b cyan]za[/][i] attribute(s) not shown.[/i] Run [b][magenta]inspect[/]([not b]inspect[/])[/b] for options.)"r
r3 r boolr, dirlenr( r' r) r grid
add_columnadd_rowr- r2 rP r& _get_formatted_docr r+ r r r r rK r^ copyrG reprr% append row_count from_markup)r/ rV keysZ total_itemsZnot_shown_countitems items_tablerq r- r _docZdoc_textrT rY r+ key_textwarningZ_signature_textr& r r )r, r[ r r: { s
&
zInspect._render)object_r c C s6 t |}|dkrdS t| }| 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)r r rR r$ r! r )r/ r~ r& r r r rr s
zInspect._get_formatted_doc)__name__
__module__r@ __doc__r r r rl r0 r r. r r; r3 rP r r r: rr r r r r r" s8
']r" .r1 c C s t | dst| } t| ddS )zNReturns the MRO of an object's class, or of the object itself if it's a class.__mro__r )hasattrr4 rH rZ r r r get_object_types_mro s
r c C s dd t | D S )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']`
c S s* g | ]"}t |d d dt |dd qS )r re .r@ )rH )r` type_r r r ra s z3get_object_types_mro_as_strings..)r rZ r r r get_object_types_mro_as_strings s r )r, fully_qualified_types_namesr c C s t | D ]}||kr dS qdS )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_namer r r is_object_one_of_types s r ),
__future__r rI r r r r r r typingr r
r r r
r r consoler r controlr r- r jupyterr panelr prettyr tabler textr r r3 r! r" objectr4 r r rl r r r r r s( $ X$