a
    �˜ëj¦&  ã                   @   s&  d dl Z d dl mZmZmZmZmZmZ d dlmZm	Z	m
Z
mZmZmZmZ ddlmZmZ ddlmZ ddlmZ ddlmZ dd	lmZ dd
lmZ ddlmZ ddlmZm Z  e!e!dœdd„Z"G dd„ deƒZ#ee$ee f ee%df dœdd„Z&e$e	e! dœdd„Z'e$e	e! e(dœdd„Z)dS )é    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   úL/mnt/bigstor/www/usecases/.venv/lib/python3.9/site-packages/rich/_inspect.pyÚ_first_paragraph   s    r    c                   @   s¦   e Zd ZdZddddddddddœ	eee eeeeeeeeddœdd„Zee	d	œd
d„Z
edœdd„Zeeee	 dœdd„Zee dœdd„Zeee dœdd„ZdS )Ú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|  |¡| _|	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    

zInspect.__init__©r+   r   c                 C   s:   t |ƒst|ƒst|ƒr t|ƒn
tt|ƒƒ}|  |¡}|S )zMake a default title.)r   Úcallabler   ÚstrÚtyper,   )r.   r+   Z	title_strZ
title_textr   r   r   r-   @   s    ÿÿÿ

ý
zInspect._make_title)r   c                 C   s   t jt|  ¡ Ž | jddd�S )Nzscope.border©r   r   )r"   Úborder_styleÚpadding)r   Zfitr   Ú_renderr"   )r.   r   r   r   Ú__rich__J   s    
üzInspect.__rich__)Únamer+   r   c           
   	   C   s  zt t|ƒƒd }W n( ty*   d}Y n ty<   Y dS 0 d}zt|ƒ}W n ttfyd   Y n0 t|dd�}|r†| d|› �¡ |  |¡}|pžt	|d|ƒ}t
|t ƒsÄt	|d|ƒ}t
|t ƒsÄ|}t |¡rÔd	}nt |¡räd
}nd}t |› d�d| dd¡› �f|df|¡}	|	S )zGet a signature for a callable.ú:z(...)Nzinspect.callable©Ústylezlink file://Ú__qualname__Ú__name__Úclassz	async defÚdefú zinspect.r   )r2   r   Ú
ValueErrorÚ	TypeErrorr   ÚOSErrorr   Ústylizer,   ÚgetattrÚ
isinstanceÚinspectr   ÚiscoroutinefunctionÚassembleÚreplace)
r.   r9   r+   Ú
_signatureZsource_filenameZcallable_nameZsignature_textÚqualnameÚprefixZqual_signaturer   r   r   Ú_get_signatureR   s>    




ýzInspect._get_signaturec                 #   s¾  t ttf t ttf dœdd„}tt ttf dœ‡ fdd„‰| j‰ tˆ ƒ}t|ƒ}| jsfdd„ |D ƒ}| jszd	d„ |D ƒ}|t|ƒ }‡fd
d„|D ƒ}| j	rª|j	|d� t
jddd�}|jdd� |j}| j}tˆ ƒrø|  dˆ ¡}	|	durø|	V  dV  | j�r4|  ˆ ¡}
|
du�r4t|
dd�}||ƒ}|V  dV  | j�rztˆ ƒ�sztˆ ƒ�sztˆ ƒ�szttˆ dddd�dd�V  dV  |D �]\}\}}t || d¡�r¢dndfd¡}|du�rÞ| ¡ }| d¡ |||t|ƒƒƒ �q~t|ƒ�rz| j�sô�q~|  ||¡}|du �r||t||d �ƒ nZ| j�rn|  |¡}|du�rn| d!|v �rLd!nd"¡ ||ƒ}| d#¡ | |¡ |||ƒ n||t||d �ƒ �q~|j �r |V  n|�rºt !d$|› d%�¡V  dS )&zRender object.)Úitemr   c                 S   s"   | \}\}}t |ƒ| d¡ ¡ fS )Nr   )r1   ÚstripÚlower)rP   ÚkeyÚ_errorr*   r   r   r   Ú
sort_items€   s    z#Inspect._render.<locals>.sort_items)Ú	attr_namer   c              
      sB   zdt ˆ | ƒfW S  ty< } z|dfW  Y d}~S d}~0 0 dS )zGet attribute or any exception.N)rF   Ú	Exception)rV   Úerror©r+   r   r   Úsafe_getattr„   s    z%Inspect._render.<locals>.safe_getattrc                 S   s   g | ]}|  d ¡s|‘qS )Ú__©Ú
startswith©Ú.0rS   r   r   r   Ú
<listcomp>�   ó    z#Inspect._render.<locals>.<listcomp>c                 S   s   g | ]}|  d ¡s|‘qS )r   r\   r^   r   r   r   r`   ‘   ra   c                    s   g | ]}|ˆ |ƒf‘qS r   r   r^   )rZ   r   r   r`   “   ra   )rS   r4   F)r6   ÚexpandÚright)ZjustifyÚ Nzinspect.helpr;   Té
   é<   )Zindent_guidesÚ
max_lengthZ
max_stringzinspect.value.border)r5   r[   zinspect.attr.dunderzinspect.attr)z =zinspect.equalszinspect.error)r,   Ú
rA   zinspect.docz[b cyan]za[/][i] attribute(s) not shown.[/i] Run [b][magenta]inspect[/]([not b]inspect[/])[/b] for options.)"r   r2   r   Úboolr+   ÚdirÚlenr'   r&   r(   r   ZgridZ
add_columnÚadd_rowr,   r1   rO   r%   Ú_get_formatted_docr   r*   r   r   r   r   rJ   r]   ÚcopyrE   Úreprr$   ÚappendZ	row_countZfrom_markup)r.   rU   ÚkeysZtotal_itemsZnot_shown_countÚitemsZitems_tablerl   r,   r   Z_docZdoc_textrS   rX   r*   Zkey_textÚwarningZ_signature_textr%   r   r   )r+   rZ   r   r7   }   sˆ     

&þþû








ÿzInspect._render)Úobject_r   c                 C   s6   t |ƒ}|du rdS t|ƒ ¡ }| js.t|ƒ}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   rQ   r#   r    r   )r.   rt   r%   r   r   r   rm   Ú   s    zInspect._get_formatted_doc)r>   Ú
__module__r=   Ú__doc__r   r   r   ri   r/   r   r-   r   r8   r2   rO   r
   r   r7   rm   r   r   r   r   r!      s8   ôó
+]r!   .r0   c                 C   s   t | dƒst| ƒ} t| ddƒS )zNReturns the MRO of an object's class, or of the object itself if it's a class.Ú__mro__r   )Úhasattrr3   rF   rY   r   r   r   Úget_object_types_mroð   s    
ry   c                 C   s   dd„ 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ƒ› dt |ddƒ› �‘qS )ru   rd   Ú.r=   )rF   )r_   Útype_r   r   r   r`      s   ÿz3get_object_types_mro_as_strings.<locals>.<listcomp>)ry   rY   r   r   r   Úget_object_types_mro_as_stringsù   s    þr|   )r+   Úfully_qualified_types_namesr   c                 C   s    t | ƒD ]}||v r dS qdS )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   )*rH   r   r   r   r   r   r   Útypingr   r	   r
   r   r   r   r   Úconsoler   r   Úcontrolr   r,   r   Zjupyterr   Zpanelr   Úprettyr   Útabler   Útextr   r   r2   r    r!   Úobjectr3   ry   r|   ri   r   r   r   r   r   Ú<module>   s$    $ \$	þ