a
    “˜ëj  ã                   @  s†   d Z ddlmZ ddlZddlZddlZddlZddlmZ G dd„ dej	ƒZ
ddd	œd
d„Zdddœdd„Zdddddœdd„ZdS )z4Utilities related to attribute docstring extraction.é    )ÚannotationsN)ÚAnyc                      sV   e Zd Zddœ‡ fdd„Zdddœ‡ fdd	„Zd
ddœdd„Zdddœdd„Z‡  ZS )ÚDocstringVisitorÚNone)Úreturnc                   s    t ƒ  ¡  d | _i | _d | _d S ©N)ÚsuperÚ__init__ÚtargetÚattrsÚprevious_node_type)Úself©Ú	__class__© úb/mnt/bigstor/www/usecases/.venv/lib/python3.9/site-packages/pydantic/_internal/_docs_extraction.pyr	      s    
zDocstringVisitor.__init__zast.ASTr   )Únoder   c                   s   t ƒ  |¡}t|ƒ| _|S r   )r   ÚvisitÚtyper   )r   r   Znode_resultr   r   r   r      s    
zDocstringVisitor.visitzast.AnnAssignc                 C  s   t |jtjƒr|jj| _d S r   )Ú
isinstancer
   ÚastÚNameÚid)r   r   r   r   r   Úvisit_AnnAssign   s    z DocstringVisitor.visit_AnnAssignzast.Exprc                 C  sR   t |jtjƒrNt |jjtƒrN| jtju rNt |jj¡}| j	rH|| j
| j	< d | _	d S r   )r   Úvaluer   ÚConstantÚstrr   Ú	AnnAssignÚinspectÚcleandocr
   r   )r   r   Ú	docstringr   r   r   Ú
visit_Expr   s    ÿþ
ýzDocstringVisitor.visit_Expr)Ú__name__Ú
__module__Ú__qualname__r	   r   r   r!   Ú__classcell__r   r   r   r   r      s   r   z	list[str]r   )Úsourcer   c                 C  s(   t  d | ¡¡}| d¡r$d|› �}|S )NÚ )ú ú	zdef dedent_workaround():
)ÚtextwrapÚdedentÚjoinÚ
startswith)r&   Údedent_sourcer   r   r   Ú_dedent_source_lines)   s    

r/   z	type[Any]zlist[str] | None)Úclsr   c           	      C  sÞ   t  ¡ }|rÚt  |¡t  | ¡u rÒ|j}zt  |¡\}}W n tyJ   Y nˆ0 t  ||d d … ¡}t|ƒ}zt 	|¡}W n t
yŠ   Y nH0 |jd }t|tjƒr¶|jdkr¶|jd }t|tjƒrÒ|j| jkrÒ|S |j}qd S )Né   r   Zdedent_workaround)r   ÚcurrentframeÚ	getmoduleÚf_linenoÚ
findsourceÚOSErrorÚgetblockr/   r   ÚparseÚSyntaxErrorÚbodyr   ÚFunctionDefÚnameÚClassDefr"   Úf_back)	r0   ÚframeÚlnumÚlinesÚ_Zblock_linesr.   Z
block_treeÚstmtr   r   r   Ú_extract_source_from_frame4   s(    

rD   FÚboolzdict[str, str])r0   Úuse_inspectr   c                 C  sn   |st jdkr:zt | ¡\}}W qB ty6   i  Y S 0 nt| ƒ}|sJi S t|ƒ}tƒ }| t	 
|¡¡ |jS )aX  Map model attributes and their corresponding docstring.

    Args:
        cls: The class of the Pydantic model to inspect.
        use_inspect: Whether to skip usage of frames to find the object and use
            the `inspect` module instead.

    Returns:
        A mapping containing attribute names and their corresponding docstring.
    )é   é   )ÚsysÚversion_infor   Úgetsourcelinesr6   rD   r/   r   r   r   r8   r   )r0   rF   r&   rB   r.   Úvisitorr   r   r   Úextract_docstrings_from_clsR   s    rM   )F)Ú__doc__Ú
__future__r   r   r   rI   r*   Útypingr   ÚNodeVisitorr   r/   rD   rM   r   r   r   r   Ú<module>   s   