File: //usr/lib/python3/dist-packages/sphinx/ext/autodoc/__pycache__/preserve_defaults.cpython-310.pyc
o
�W�a� � @ s� d Z ddlZddlZddlZddlmZmZmZmZ ddl m
Z
ddl m Z ddl
mZ ddl
mZ ddlmZ e�e�ZG d d
� d
�Zd ed ejfd
d�Zdee dejd ee fdd�Z de
d ede d dfdd�Z de
d eeef fdd�Z dS )aF
sphinx.ext.autodoc.preserve_defaults
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Preserve the default argument values of function signatures in source code
and keep them not evaluated for readability.
:copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�Any�Dict�List�Optional)�Sphinx)�__)�parse)�unparse)�loggingc @ s, e Zd Zdeddfdd�Zdefdd�ZdS )� DefaultValue�name�returnNc C s
|| _ d S �N�r )�selfr � r �F/usr/lib/python3/dist-packages/sphinx/ext/autodoc/preserve_defaults.py�__init__ s
zDefaultValue.__init__c C s | j S r r )r r r r �__repr__ s zDefaultValue.__repr__)�__name__�
__module__� __qualname__�strr r r r r r r s r �objr
c C s` z#t �| �}|�d�rtd| �}|jd jd W S t|�}|jd W S ttfy/ Y dS w )z�Get FunctionDef object from living object.
This tries to parse original code for living object and returns
AST node for given *obj*.
�� z\tz if True:
r N)�inspect� getsource�
startswith� ast_parse�body�OSError� TypeError)r �source�moduler r r �get_function_def" s
�r% �lines�positionc C s\ z!t jdk r W d S |j|jkr | |jd }||j|j� W S W d S ttfy- Y d S w )N)� � � )�sys� version_info�lineno�
end_lineno�
col_offset�end_col_offset�AttributeError�
IndexError)r& r' �liner r r �get_default_value5 s
�r4 �app� bound_methodc
C s� | j jsdS zt�|��� }|d �d�r|�dd� W n
ttfy) g }Y nw z�t |�}|j
j s7|j
j r�t�
|�}t|j
j �}t|j
j �}t|j�� �}t|�D ]L\} }
|
j|
jur�|
j|
j|
jfv r�|�d�} t|| �} | du rxt| �} |
jt| �d�|| < qS|�d�} t|| �} | du r�t| �} |
jt| �d�|| < qS|j|d�}||_ W dS W dS t tfy� Y dS t y� }
zt � t!d�||
� W Y d}
~
dS d}
~
ww )z2Update defvalue info of *obj* using type_comments.Nr r � )�default)�
parametersz3Failed to parse a default argument value for %r: %s)"�config�autodoc_preserve_defaultsr r �
splitlinesr �insertr! r" r% �args�defaults� kw_defaults� signature�listr9 �values� enumerater8 �empty�kind�POSITIONAL_ONLY�POSITIONAL_OR_KEYWORD�popr4 � ast_unparse�replacer �
__signature__r1 �NotImplementedError�logger�warningr )r5 r r6 r& �function�sigr? r@ r9 �i�paramr8 �value�excr r r �update_defvalueC sP ��
� � ��rV c C s$ | � ddd� | �dt� ddd�S )Nr; FTz autodoc-before-process-signaturez1.0)�version�parallel_read_safe)�add_config_value�connectrV )r5 r r r �setupm s
�r[ ) �__doc__�astr r+ �typingr r r r �sphinx.applicationr �
sphinx.localer �sphinx.pycode.astr r r rJ � sphinx.utilr
� getLoggerr rN r � FunctionDefr% r �ASTr4 �boolrV r[ r r r r �<module> s
*