File: //opt/saltstack/salt/lib/python3.10/site-packages/rich/__pycache__/_inspect.cpython-310.pyc
o
;j�& � @ s0 d dl Z d dl mZmZmZmZmZmZ d dlmZm Z m
Z
m Z m Z m
Z
mZ ddlmZmZ ddlmZ ddlmZ ddlmZ dd lmZ dd
lmZ dd l m Z dd l m Z m Z d
e!de!fdd�Z"G dd� de�Z#dee$e
e f de e%df fdd�Z&de$de e! fdd�Z'de$de e! de(fdd�Z)dS ) � N)�cleandoc�getdoc�getfile�isclass�ismodule� signature)�Any�
Collection�Iterable�Optional�Tuple�Type�Union� )�Group�RenderableType)�escape_control_codes)�ReprHighlighter)� JupyterMixin)�Panel)�Pretty)�Table)�Text�TextType�doc�returnc C s | � d�\}}}|S )z)Get the first paragraph from a docstring.z
)� partition)r Z paragraph�_� r �A/opt/saltstack/salt/lib/python3.10/site-packages/rich/_inspect.py�_first_paragraph s r c @ s� e Zd ZdZdddddddddd� dedee ded ed
ed ed ed
edededdfdd�Zdede fdd�Z
de fdd�Z de
dedee fdd�Zdee fdd�Zd edee
fd d �ZdS ) �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, callables at the top, leading and trailing underscores ignored. Defaults to True.
all (bool, optional): Show all attributes. Defaults to False.
value (bool, optional): Pretty print value of object. Defaults to True.
NFT) �title�help�methods�docs�private�dunder�sort�all�value�objr" r# r$ r% r& r' r( r) r* r c C sd t � | _|| _|p
| �|�| _| rd } }}|| _|| _|p || _|p%|| _|| _ || _
|
| _ 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__c C s: t |�s t|�s t|�rt|�ntt|��}| �|�}|S )zMake a default title.)r �callabler �str�typer, )r. r+ Z title_strZ
title_textr r r r- @ s ��
�
�
zInspect._make_titlec C s t jt| �� � | jddd�S )Nz scope.border�r r )r" � border_style�padding)r Zfitr �_renderr" )r. r r r �__rich__J s
�zInspect.__rich__�namec
C s z
t t|��d }W n ty d}Y n
ty Y dS w d}zt|�}W n ttfy2 Y nw t|dd�}|rC|�d|� �� | �|�}|pOt |d|�}t
|t �sbt |d|�}t
|t �sb|}t � |�rjd }n
t �
|�rrd
}nd }t�|� d �d
|�d d�� �f|df|�} | S )z Get a signature for a callable.�:z(...)Nzinspect.callable��stylez link file://� __qualname__�__name__�classz async def�def� zinspect.r )r1 r �
ValueError� TypeErrorr �OSErrorr �stylizer, �getattr�
isinstance�inspectr Ziscoroutinefunction�assemble�replace)
r. r8 r+ Z
_signatureZsource_filenameZ
callable_nameZsignature_text�qualname�prefixZqual_signaturer r r �_get_signatureR sB � �
�zInspect._get_signaturec # s� � dt ttf dt ttf fdd�}dtdt ttf f� fdd� �| j� t� �}t|�}| js6dd � |D �}| js@d
d � |D �}|t|� }�fd d �|D �}| j rX|j |d � t
j d
dd�}|j dd� |j
}| j}t� �r| �d� �} | dur| V dV | jr�| �� �}
|
dur�t|
dd�} || �} | V dV | jr�t� �s�t� �s�t� �s�tt� dddd�dd�V dV |D ]�\} \}
}t�| | �d �r�d nd fd �}|
dur�|�� }|� d � |||t |
��� q�t|��r4| j s�q�| �| |�}|du �r||t||d!�� q�| j�r.| �|�}|du�r.|� d"|v �r d"nd#� ||�}|� d$� |� |� |||� q�||t||d!�� q�|j �rG|V dS |�rVt�!d%|� d&��V dS dS )'zRender object.�itemr c S s" | \}\}}t |�|�d��� fS )Nr )r0 �strip�lower)rM �key�_errorr* r r r �
sort_items� s z#Inspect._render.<locals>.sort_items� attr_namec
s> zdt � | �fW S ty } z
|dfW Y d}~S d}~ww )z Get attribute or any exception.N)rE � Exception)rS �error�r+ r r � safe_getattr� s ��z%Inspect._render.<locals>.safe_getattrc S � g | ] }|� d �s|�qS )�__��
startswith��.0rP r r r �
<listcomp>� � z#Inspect._render.<locals>.<listcomp>c S rX )r rZ r\ r r r r^ � r_ c s g | ]}|� |�f�qS r r r\ )rW r r r^ � s )rP r3 F)r5 �expand�right)Zjustify� Nz inspect.helpr: T�
�< )Z
indent_guidesZ
max_lengthZ
max_stringzinspect.value.border)r4 rY zinspect.attr.dunderz inspect.attr)z =zinspect.equalsz
inspect.error)r, �
r@ z inspect.docz[b cyan]za[/][i] attribute(s) not shown.[/i] Run [b][magenta]inspect[/]([not b]inspect[/])[/b] for options.)"r r1 r �boolr+ �dir�lenr' r& r( r ZgridZ
add_column�add_rowr, r0 rL r% �_get_formatted_docr r* r r r r rH r[ �copyrD �reprr$ �appendZ row_countZ from_markup)r. rR �keysZ total_itemsZnot_shown_count�itemsZ items_tableri r, r Z_docZdoc_textrP rU r* Zkey_text�warningZ_signature_textr% r r )r+ rW r r6 } s� �"
���
��zInspect._render�object_c C s6 t |�}|du r
dS t|��� }| jst|�}t|�S )a�
Extract the docstring of an object, process it and returns it.
The processing consists in cleaning up the docstring'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 rN r# r r )r. rq r% r r r rj � s
zInspect._get_formatted_doc)r= �
__module__r< �__doc__r r r rf r/ r r- r r7 r1 rL r
r r6 rj r r r r r! sN ������� �
� � �
�
+]r! r+ .c C s t | d�s t| �} t| dd�S )zNReturns the MRO of an object's class, or of the object itself if it's a class.�__mro__r )�hasattrr2 rE rV r r r �get_object_types_mro� s
rv 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 )rr rb �.r< )rE )r] �type_r r r r^ s ��z3get_object_types_mro_as_strings.<locals>.<listcomp>)rv rV r r r � get_object_types_mro_as_strings� s �ry �fully_qualified_types_namesc C s t | �D ] }||v r
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)ry )r+ rz � type_namer r r �is_object_one_of_types s
�r| )*rG r r r r r r �typingr r r
r r r
r Zconsoler r Zcontrolr r, r Zjupyterr Zpanelr Zprettyr �tabler �textr r r1 r r! �objectr2 rv ry rf r| r r r r �<module> s. $ &\
���