| 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/__pycache__/ |
Upload File : |
a
�ab�K � @ s� d dl Z d dlZd dlZd dlZd dlZd dlmZ d dlmZ d dlmZ d dlm Z d dl
m Z m Z m
Z
mZ d dlZd dlmZmZ d dlmZ d d lmZ d d
lmZmZ d d lmZ d ejv r�ejd � d
�Z ng d�Z de e� Z e � edd�Z!e"e#d�dd�Z$e"e"d�dd�Z%dAe"e
e" e#d�dd�Z&e"e"e dd�d d �Z'dBe"e"e e"dd �d d �Z(g dfe"e"e"e
e" e e
e" e#e
e" e"dd!�
d"d#�Z)dCe
e" e e"e"dd%�d&d'�Z*g fe"e e
e" e#d(�d)d*�Z+e"e e
e" e#d+�d,d-�Z,e"e
e" e e ee"e
e" e
e" f ddf d.�d/d0�Z-e"e
e" e e#d.�d1d2�Z.dDe"e
e" e e"e
e" d3�d4d5�Z/e"e
e" e#d6�d7d8�Z0e j1d9�d:d;�Z2ej3d<d� fe
e" e4d=�d>d?�Z5e6d@k�r�e5� dS )E� N)�copy��fnmatch)�EXTENSION_SUFFIXES)�path)�Any� Generator�List�Tuple)�__display_version__� package_dir)�
EXTENSIONS)�__)�FileAvoidWrite� ensuredir)� ReSTRendererZSPHINX_APIDOC_OPTIONS�,)�membersz
undoc-memberszshow-inheritance)z.pyz.pyxZ templatesZapidoc)�filename�returnc C s4 t �| �}tttdd�D ]}|d| kr dS qdS )NT)�key�reverse�__init__F)r �basename�sorted� PY_SUFFIXES�len)r r �suffix� r �5/usr/lib/python3.9/site-packages/sphinx/ext/apidoc.py� is_initpy3 s
r )�modnamesr c G s d� td | ��S )N�.)�join�filter)r! r r r � module_join= s r% )�dirname�filesr c C s8 |d u r| d u rdS |d u r&t �| �}tdd� |D ��S )NFc s s | ]}t |�r|V qd S �N�r ��.0�fr r r � <genexpr>I � z is_packagedir.<locals>.<genexpr>)�os�listdir�any)r& r' r r r �
is_packagedirB s
r2 )�name�text�optsr c C s� t |dd �}t�|jd| |jf �}|jrB|s>ttd�| � d S |jsht� |�rh|s�ttd�| � nF|s|ttd�| � t
|��}|� |� W d � n1 s�0 Y d S )N�quietz%s.%szWould create file %s.z!File %s already exists, skipping.zCreating file %s.) �getattrr r# �destdirr �dryrun�printr �force�isfiler �write)r3 r4 r5 r6 Zfnamer, r r r �
write_fileL s
r> )�packager r5 �user_template_dirr c C s` t t�}|jr d|vr |�d� t| |�}|j |||d�}t|tg��d|�}t |||� d S )N�private-members)�
show_headingsr �qualname�automodule_optionsz module.rst_t)
r �OPTIONS�includeprivate�appendr% �
noheadingsr � template_dir�renderr> )r? r r5 r@ �optionsrC �contextr4 r r r �create_module_file_ s
�rM )
�root�master_package�subroot�py_filesr5 �subs� is_namespace�excludesr@ r c
s� � ����fdd�|D �} � ��fdd�|D �}
��fdd�|
D �}
t t�} �jrdd| vrd| �d� t���} | | |
|�j�j| �j �jd� }
t |t
g�� d|
�}t | |�� |
r҈jr�|
D ]}t
d |�|� q�d S )Nc s, g | ]$}t t��|��� �st��|��qS r )�is_skipped_packager r# r% )r+ �pkgname�rT rO r5 rN rP r r �
<listcomp>v s �z'create_package_file.<locals>.<listcomp>c s6 g | ].}t t��|��� �st|�s|�d �d �qS )r" r )�is_skipped_moduler r# r �split�r+ �sub)rT r5 rN r r rX z s �c s g | ]}t � �|��qS r )r% )r+ �modname)rO rP r r rX } s �rA ) rV � subpackages�
submodulesrS � modulefirst�separatemodulesrD rB �maxdepthz
package.rst_t)r rE rF rG r% r` ra rH rb r rI rJ r> rM )rN rO rP rQ r5 rR rS rT r@ r^ r_ rK rV rL r4 Z submoduler rW r �create_package_fileq s4 � �
�
rc �modules)rd r5 r3 r@ r c C sp | � � d}| d d � D ]"}|�|d �r6| �|� q|}q|j|j| d�}t|tg��d|�}t|||� d S )N� r" )�headerrb Zdocnamesz toc.rst_t) �sort�
startswith�removerf rb r rI rJ r> )rd r5 r3 r@ � prev_module�modulerL r4 r r r �create_modules_toc_file� s �rl )r& r5 rT r c sd t �� �sdS t�t �� d��}tdd� |D ��}|s@|js@dS t� �fdd�|D ��r\dS dS d S )NFz*.pyc s s | ]}t |�r|V qd S r( r) r* r r r r- � r. z%is_skipped_package.<locals>.<genexpr>Tc 3 s | ]}t t�� |���V qd S r( )� is_excludedr r# r* �r& rT r r r- � r. )r �isdir�globr# r1 �implicit_namespaces�all)r& r5 rT r' Zregular_packager rn r rU � s
rU )r r5 rT r c C s0 t �| �sdS t �| ��d�r(|js(dS dS d S )NT�_F)r �existsr rh rF )r r5 rT r r r rY � s
rY )�rootpathrT r5 r c # s� t |dd�}t |dd�}tj| |d�D ]^\�}}t��fdd�|D ��}|rRd� nd� t� ��fd d�|D ��|d d �< �||fV q&d S )
N� followlinksFrF )rv c 3 s. | ]&}|� t�rtt��|�� �s|V qd S r( )�endswithr rm r r# r* )rT rN r r r- � s
�zwalk.<locals>.<genexpr>)r" )r" rs c 3 s. | ]&}|� � �stt��|���s|V qd S r( )rh rm r r# r[ �Zexclude_prefixesrT rN r r r- � s �)r7 r/ �walkr )ru rT r5 rv rF rR r' r rx r ry � s "ry c C s& t | ||�D ]\}}}|r dS q dS �NTF)ry )ru rT r5 �_rootZ_subsr' r r r �has_child_module� s r| )ru rT r5 r@ r c C s� t |dd�}t| �s|r*| �tj�d }nd }g }t| ||�D �]:\}}} td | �}
|
o\|} |
r�| d d � D ]"} t| �rn| �| � | �d| � qnn|| kr�|s�|d d �= q>|
s�| �r2|s�t | �dks�t
||��sz|t | �d � � tj�� tjd�}
| �rt
|||��rzt|||
| ||| ||� |�t||
�� q>| D ]B}tt�| |�||��s6|�d�d }t||||� |�|� �q6q>|S )Nrq F���r � r" )r7 r2 rZ r �sepry r ri �insertr rU �lstrip�replacer| rc rG r% rY r# rM )ru rT r5 r@ rq Z root_packageZ toplevelsrN rR r' Zis_pkgrS r, Z
subpackageZpy_filerk r r r � recurse_tree� sD
�
�r� )rN rT r c C s |D ]}t | |�r dS qdS rz r )rN rT �excluder r r rm # s
rm )r c C s� t jdtd�td�d�} | jddddt d � | jd
td �d � | jd
dtd�d� | jdddddtd�d� | jdddtd�d � | jd d dd td td!�d"� | jd#d$dd%td&�d � | jd'd(dd)d*td+�d,� | jd-d.dd/td0�d � | jd1d2dd3td4�d � | jd5d6dd7td8�d � | jd9dd:d;td<�d,� | jd=d>d?d:td@�d � | jdAdBddCtdD�d � | jdEdFddGtdH�d � | jdIddJtdK�d � | jdLdMddNdOtdP�d,� | jdQdRddStdT�d � | jdUdVddWtdX�d � | jdYdZdd[td\�d � | jd]d^dd_td`�d � | jdadbddtdc�d � | jdddeddftdg�d � | �tdh��}|jdidjdkdltdm�dn� tD ]*}|jdo| dpdq| dktdr�| ds� �qd| �tdt��}|jdudvdwdxtdy�dz� | S ){NzH%(prog)s [OPTIONS] -o <OUTPUT_PATH> <MODULE_PATH> [EXCLUDE_PATTERN, ...]z:For more information, visit <https://www.sphinx-doc.org/>.aE
Look recursively in <MODULE_PATH> for Python modules and packages and create
one reST file with automodule directives per package in the <OUTPUT_PATH>.
The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be
excluded from generation.
Note: By default this script will not overwrite already created files.)�usage�epilog� descriptionz --version�versionZ show_versionz %%(prog)s %s)�action�destr� � module_pathzpath to module to document)�help�exclude_pattern�*zGfnmatch-style file and/or directory patterns to exclude from generation)�nargsr� z-oz --output-dir�storer8 Tz directory to place all output)r� r� �requiredr� z-q�
store_truer6 z,no output on stdout, just warnings on stderr)r� r� r� z-dz
--maxdepthrb � z;maximum depth of submodules to show in the TOC (default: 4))r� r� �type�defaultr� z-fz--forcer; zoverwrite existing filesz-lz--follow-linksrv FzNfollow symbolic links. Powerful when combined with collective.recipe.omelette.)r� r� r� r� z-nz --dry-runr9 z%run the script without creating filesz-ez
--separatera z1put documentation for each module on its own pagez-Pz --privaterF zinclude "_private" modulesz --tocfile�tocfilerd z0filename of table of contents (default: modules)z-Tz--no-toc� store_falsez%don't create a table of contents filez-Ez
--no-headingsrH zedon't create headings for the module/package packages (e.g. when the docstrings already contain them)z-Mz--module-firstr` z7put module documentation before submodule documentationz--implicit-namespacesrq zNinterpret module paths according to PEP-0420 implicit namespaces specificationz-sz--suffixr Zrstzfile suffix (default: rst)z-Fz--full�fullz.generate a full project with sphinx-quickstartz-az--append-syspath�append_syspathz9append module_path to sys.path, used when --full is givenz-Hz
--doc-projectrf z(project name (default: root module name)z-Az --doc-author�authorz,project author(s), used when --full is givenz-Vz
--doc-versionz*project version, used when --full is givenz-Rz
--doc-release�releasezEproject release, used when --full is given, defaults to --doc-versionzextension optionsz --extensionsr
�
extensionsrG zenable arbitrary extensions)�metavarr� r� r� z--ext-%s� append_constz
sphinx.ext.%szenable %s extension)r� �constr� r� zProject templatingz-tz
--templatedirZ TEMPLATEDIR� templatedirz%template directory for template files)r� r� r� )�argparse�ArgumentParserr � add_argumentr �int�add_argument_groupr
)�parser�group�extr r r �
get_parser/ s� �
��� �
� � �
� �
�
� � �
�
�� � �
� � � � �
�
�
�r� r~ )�argvr c C s. t j�tjd� t j�tj�td�d� t � }|�
| �}t� |j �}|j
d u r`|�tj�d |_
|j�d�r||jdd � |_t�|�s�ttd�| tjd� t�d� |js�t|j� d d
� |jD �}t ||||j �}|j �rd d l m } |�!� d}d}|D ]&} | �|d ��rq�| }|d
| 7 }q�|jdd|j
|j"�p<d|j#�pFd|j$�pX|j#�pXdd|j ddg d�ddd|j%|d||j&d�}
|j'�r�|
d �(|j'� |j)�r�d|
d< |
d d d � D ]2} d| v �r�|
d �*| � |
d �(| �d�� �q�|j�s*|j+|
d|j,|j d� n|j-�r*t.|||j-|j � d S )Nre �locale�sphinxr} r" r~ z%s is not a directory.)�filec S s g | ]}t �|��qS r )r �abspath)r+ r� r r r rX � r. zmain.<locals>.<listcomp>r )�
quickstartz %s
Frs ZAuthor�indexT)zsphinx.ext.autodoczsphinx.ext.viewcodezsphinx.ext.todo�en)r r �dotZprojectr� r� r� r ZmasterZepubr� ZmakefileZ batchfileZ make_modeZmastertocmaxdepthZ
mastertoctree�languager� r� r� r6 r )ZsilentZ overwriter� )/r� r� � setlocale�LC_ALLZ init_consoler/ r r# r r� �
parse_argsr� r� rf rZ r r rh ro r: r �sys�stderr�exitr9 r r8 r� r� r� r� Z
sphinx.cmdr� rg r� r� r� rb r� r� �extendr6 ri Zgenerater; r� rl ) r� r� �argsru rT rd �qsrj r4 rk �dr� r r r �main� sz
�
�r� �__main__)NN)N)rd N)N)7r� rp r� r/ r� r r Zimportlib.machineryr r �typingr r r r
Z
sphinx.localer� r r Zsphinx.cmd.quickstartr
r Zsphinx.util.osutilr r Zsphinx.util.templater �environrZ rE �tupler r# rI �str�boolr r% r2 r> rM rc rl rU rY ry r| r� rm r� r� r� r� r� �__name__r r r r �<module> sj
�� �
� & � �
�
� � 6 a"L