| Server IP : 127.0.0.1 / Your IP : 216.73.216.109 Web Server : Apache/2.4.54 (Win64) OpenSSL/1.1.1q PHP/8.1.10 System : Windows NT DESKTOP-E5T4RUN 10.0 build 19045 (Windows 10) AMD64 User : SERVERWEB ( 0) PHP Version : 8.1.10 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : OFF | Perl : OFF | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : C:/cygwin64/lib/python3.9/site-packages/sphinx/ext/autodoc/__pycache__/ |
Upload File : |
a
�abI � @ sL d Z ddlZddlmZmZmZmZmZmZ ddl m
Z
ddl m Z m
Z
ddlmZ ddlmZ ddlmZmZ dd lmZ dd
lmZmZ dd lmZ dd l m Z m Z dd
l m Z ddl!m"Z"m#Z# ddl$m%Z% e �&e'�Z(g d�Z)g d�Z*G dd� de+�Z,G dd� d�Z-ee eee d�dd�Z.eee ee
d�dd�Z/G d d � d e"�Z0dS ) z�
sphinx.ext.autodoc.directive
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
:copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�Any�Callable�Dict�List�Set�Type)�nodes)�Element�Node)�RSTState)�
StringList)�Reporter�assemble_option_dict)�Config)�RemovedInSphinx50Warning�RemovedInSphinx60Warning)�BuildEnvironment)�
Documenter�Options)�logging)�SphinxDirective�switch_source_input)�nested_parse_with_titles) �membersz
undoc-memberszinherited-memberszshow-inheritance�private-members�special-memberszignore-module-all�exclude-membersz member-orderzimported-memberszclass-doc-from)r r r r c @ s8 e Zd ZdZed�dd�Zeeegef d�dd�ZdS ) �DummyOptionSpecz"An option_spec allows any options.��returnc C s dS )z&Behaves like some options are defined.T� ��selfr r �@/usr/lib/python3.9/site-packages/sphinx/ext/autodoc/directive.py�__bool__* s zDummyOptionSpec.__bool__)�keyr c C s dd� S )Nc S s | S �Nr )�xr r r# �<lambda>/ � z-DummyOptionSpec.__getitem__.<locals>.<lambda>r )r" r% r r r# � __getitem__. s zDummyOptionSpec.__getitem__N) �__name__�
__module__� __qualname__�__doc__�boolr$ �strr r* r r r r# r ' s r c @ s\ e Zd ZdZeeeeedd�dd�Z e
dd�dd�Z e e
d �d
d ��Ze ed �d d
��ZdS )�DocumenterBridgez'A parameters container for Documenters.N)�env�reporter�options�lineno�stater c C s2 || _ || _|| _|| _t� | _t� | _|| _d S r& ) r2 � _reporterZgenoptr5 �set�record_dependenciesr �resultr6 )r" r2 r3 r4 r5 r6 r r r# �__init__5 s zDocumenterBridge.__init__)�msgr c C s, t jdtdd� tj|| jj| jfd� d S )NzTDocumenterBridge.warn is deprecated. Please use sphinx.util.logging module instead.� ��
stacklevel��location)�warnings�warnr �loggerZwarningr2 �docnamer5 )r" r< r r r# rC ? s �zDocumenterBridge.warnr c C s t jdtdd� | jS )Nz,DocumenterBridge.filename_set is deprecated.r= r> )rB rC r r9 r! r r r# � filename_setE s �z DocumenterBridge.filename_setc C s t jdtdd� | jS )Nz(DocumenterBridge.reporter is deprecated.r= r> )rB rC r r7 r! r r r# r3 K s �zDocumenterBridge.reporter)r+ r, r- r. r r
r �intr r; r0 rC �propertyr rF r3 r r r r# r1 2 s �
r1 )�
documenter�configr4 r c C s� t D ]�}|| jvrqq|�d| d�du }||jv r�|s�||v r�t|j| t�r�|tv r�|| dur�|| �d�r�d�|j| || dd� g�||< q�|j| ||< q|� |�dur|| �
d�||< qt t |�
� | j��S )z0Recognize options of Documenter from user input.zno-TN�+�,� )�AUTODOC_DEFAULT_OPTIONS� option_spec�popZautodoc_default_options�
isinstancer0 �AUTODOC_EXTENDABLE_OPTIONS�
startswith�join�get�lstripr r �items)rI rJ r4 �nameZnegatedr r r# �process_documenter_optionsR s
� rY )r6 �contentrI r c C sv t | |��X |jr0t�� }| j|_t| ||� n t�� }| j|_| �|d|� |jW d � S 1 sh0 Y dS )z1Parse an item of content generated by Documenter.r N) r Ztitles_allowedr �section�documentr Z paragraphZ nested_parseZchildren)r6 rZ rI Znoder r r# �parse_generated_contentl s r] c @ s8 e Zd ZdZe� ZdZdZdZdZ e
e d�dd�Z dS ) �AutodocDirectivez�A directive class for all autodoc directives. It works as a dispatcher of Documenters.
It invokes a Documenter upon running. After the processing, it parses and returns
the content generated by Documenter.
TrM r r c
C sT | j jj}z|�| j�\}}W n ty8 d\}}Y n0 t�d||| j� | j dd � }| j
j j j
| }zt|| j| j�}W nN tttfy� } z0tjd| j |f | j
j|fd� g W Y d }~S d }~0 0 t| j
|||| j �}||| jd �} | j| jd� |j�s g S t�dd �|j�� |j D ]}
| j jj j � |
� �q&t | j |j| �} | S )
N)NNz[autodoc] %s:%s: input:
%s� z=An option to %s is either unknown or has an invalid value: %sr@ r )Z more_contentz[autodoc] output:
%s�
) r6 r\ r3 Zget_source_and_liner5 �AttributeErrorrD �debugZ
block_textrX r2 Zapp�registryZ documentersrY rJ r4 �KeyError�
ValueError� TypeError�errorrE r1 Z argumentsZgeneraterZ r: rT r9 Zsettings�addr] ) r" r3 �sourcer5 ZobjtypeZdocclsZdocumenter_options�exc�paramsrI �fnr: r r r# �run� s6
�
�
zAutodocDirective.runN)
r+ r, r- r. r rO Z has_contentZrequired_argumentsZoptional_argumentsZfinal_argument_whitespacer r
rm r r r r# r^ } s r^ )1r. rB �typingr r r r r r Zdocutilsr Zdocutils.nodesr r
Zdocutils.parsers.rst.statesr Zdocutils.statemachiner Zdocutils.utilsr
r Z
sphinx.configr Zsphinx.deprecationr r Zsphinx.environmentr Zsphinx.ext.autodocr r Z sphinx.utilr Zsphinx.util.docutilsr r Zsphinx.util.nodesr Z getLoggerr+ rD rN rR �dictr r1 rY r] r^ r r r r# �<module> s4
� �