| 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/cmd/__pycache__/ |
Upload File : |
a
�abx1 � @ s� d Z ddlZddlZddlZddlZddlZddlZddlZddlZddlm Z ddl
m Z m Z m
Z
ddlmZ ddlZddlmZmZ ddlmZ ddlmZ dd lmZ dd
lmZmZm Z dd l m Z m Z m Z m!Z! dd l"m#Z#m$Z$ dd
l%m&Z&m'Z' ej(fee e)e dd�dd�Z*e+e,d�dd�Z-ej.d�dd�Z/ej0dd� fe
e+ e,d�dd�Z1ej0dd� fe
e+ e,d�dd �Z2ej0dd� fe
e+ e,d�d d �Z3e4d k�r�e�5e3ej0dd� �� dS ) z�
sphinx.cmd.build
~~~~~~~~~~~~~~~~
Build documentation from a provided source.
:copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�path)�IO�Any�List)�
SystemMessage)�__display_version__� package_dir)�Sphinx)� SphinxError)�__)�Tee�format_exception_cut_frames�save_traceback)�color_terminal�nocolor�red�
terminal_safe)�docutils_namespace�patch_docutils)�abspath� ensuredir)�app�args� exception�stderr�returnc C s( t |tj�rd S |jrHtttd��|d� t�� t� t
� � d � �n�t|d� |j s^|jrtt�d |� t|d� t |t
�r�ttd�|d� �n�t |t�r�tttd��|d� tt|jd �|d� �nZt |t�r�ttd|j �|d� tt|�|d� �n&t |t��rTtttd��|d� ttt|��|d� t| �}tttd �| �|d� n�t |t��r�d
t|�v �r�tttd ��|d� ttt|��|d� t|d� ttd �|d� td
|d� nftttd��|d� tt� �� |d� t| �}tttd �| �|d� ttd�|d� ttd�|d� d S )Nz5Exception occurred while building, starting debugger:)�file� z Interrupted!zreST markup error:r z%s:zEncoding error:z[The full traceback has been saved in %s, if you want to report the issue to the developers.zrecursion depthzRecursion error:z�This can happen with very large or deeply nested source files. You can carefully increase the default Python recursion limit of 1000 in conf.py with e.g.:z+ import sys; sys.setrecursionlimit(1500)zException occurred:ziPlease also report this if it was a user error, so that a better error message can be provided next time.zbA bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!)�
isinstance�bdbZBdbQuit�pdb�printr r � traceback� print_excZ post_mortem�sys�exc_info� verbosity�KeyboardInterruptr r r r
�category�str� UnicodeErrorr � RuntimeErrorr
�rstrip)r r r r Ztbpath� r- �4/usr/lib/python3.9/site-packages/sphinx/cmd/build.py�handle_exception# sf �
��
�
����r/ )�valuer c C s8 | dkrt �� S t| �}|dkr0t�td���n|S dS )z�
Special type to handle 'auto' flags passed to 'sphinx-build' via -j flag. Can
be expanded to handle other special scaling requests, such as setting job count
to cpu_count.
�autor z&job number should be a positive numberN)�multiprocessing� cpu_count�int�argparse�ArgumentTypeErrorr )r0 �jobsr- r- r. �
jobs_argumentW s r8 )r c C sx t jdtd�td�d�} | jddddt d � | jd
td �d � | jd
td�d � | jddtd�d� | �td��}|jddddtd�d� |jddd td �d � |jd dd td!�d � |jd"d#d$td%�d&� |jd'd(d)td*td+�d,� | �d-�}|jd.d#d/td0�d&� |jd1dd2td3�d � |jd4d5d6d7g td8�d9� |jd:d;d6d<g td=�d9� |jd>d?d6d@g tdA�d9� |jdBddCtdD�d � | �tdE��}|jdFdGdHdItdJ�dK� |jdLddMtdN�d � |jdOddPtdQ�d � |jdRdSdTdUtdV�dW� |jdXdYdZdSd[td\�d]� |jd^d_d`tda�d&� |jdbddctdd�d � |jdeddftdg�d � |jdhdditdj�d � |jdkddltdm�d � | S )nNz5%(prog)s [OPTIONS] SOURCEDIR OUTPUTDIR [FILENAMES...]z:For more information, visit <https://www.sphinx-doc.org/>.a�
Generate documentation from source files.
sphinx-build generates documentation from the files in SOURCEDIR and places it
in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration
settings. The 'sphinx-quickstart' tool may be used to generate template files,
including 'conf.py'
sphinx-build can create documentation in different formats. A format is
selected by specifying the builder name on the command line; it defaults to
HTML. Builders can also perform other tasks related to documentation
processing.
By default, everything that is outdated is built. Output only for selected
files can be built by specifying individual filenames.
)�usage�epilog� descriptionz --version�versionZ show_versionz %%(prog)s %s)�action�destr< � sourcedirz"path to documentation source files)�help� outputdirzpath to output directory� filenames�*z?a list of specific files to rebuild. Ignored if -a is specified)�nargsr@ zgeneral optionsz-bZBUILDER�builderZhtmlz builder to use (default: html))�metavarr> �defaultr@ z-a�
store_true� force_allz;write all files (default: only write new and changed files))r= r> r@ z-E�freshenvz4don't use a saved environment, always read all filesz-d�PATH�
doctreedirzPpath for the cached environment and doctree files (default: OUTPUTDIR/.doctrees))rF r> r@ z-j�N� r7 z`build in parallel with N processes where possible (special value "auto" will set N to cpu-count))rF rG �typer> r@ zbuild configuration optionsz-c�confdirzOpath where configuration file (conf.py) is located (default: same as SOURCEDIR)z-C�noconfigz*use no config file at all, only -D optionsz-Dz
setting=value�append�definez(override a setting in configuration file)rF r= r> rG r@ z-Az
name=value�
htmldefinez pass a value into HTML templatesz-tZTAG�tagsz*define tag: include "only" blocks with TAGz-n�nitpickyz1nit-picky mode, warn about all missing referenceszconsole output optionsz-v�countr& r z$increase verbosity (can be repeated))r= r> rG r@ z-q�quietz,no output on stdout, just warnings on stderrz-Q� really_quietz#no output at all, not even warningsz--color� store_constZyesr1 z-do emit colored output (default: auto-detect))r= �constrG r@ z-Nz
--no-color�color�noz1do not emit colored output (default: auto-detect))r> r= r[ r@ z-w�FILE�warnfilez)write warnings (and errors) to given filez-W�warningiserrorzturn warnings into errorsz --keep-going�
keep_goingz)with -W, keep going when getting warningsz-Tr" z show full traceback on exceptionz-Pr zrun Pdb on exception)r5 �ArgumentParserr � add_argumentr �add_argument_groupr8 )�parser�groupr- r- r. �
get_parserg s� �
����
�
�
�
��
�
�
�
�
�
� �
�
�
� �
�
�
�
�
�rg rN )�argvr c C s ddl m} |�| dd� �S )z Sphinx build "make mode" entry.r )� make_moderN N)Z
sphinx.cmdri Z
run_make_mode)rh ri r- r- r. � make_main� s rj c C sB t � }|�| �}|jr d|_n|js,|j|_|jsDtj�|j d�|_|j
}g }|D ]}tj� |�sR|� |� qR|r�|�
td�| � |jr�|r�|�
td�� |jdks�|jdkr�t� s�t� tj}tj}tj}|jr�d}|jr�d }}|�rj|j�rjz(t|j�} tt�| �� t |jd�}
W n> t �yZ } z$|�
td�|j| f � W Y d} ~ n
d} ~ 0 0 t ||
�}|}i } |j D ]F}
z|
� d d
�\}}
W n" t!�y� |�
td �� Y n0 |
| |< �qt|j"D ]j}
z|
� d �\}}
W n" t!�y� |�
td �� Y n0 z t#|
�}
W n t!�y Y n0 |
| d
| < �q�|j$�r>d| d< d}z�|j�pP|j}t%|��� t&� �l t'|j|j|j |j|j(| |||j)|j*|j+|j,|j-|j.�}|�/|j|� |j0W d � W d � W S 1 �s�0 Y W d � n1 �s�0 Y W n: t t1f�y< } z t2||| |� W Y d} ~ dS d} ~ 0 0 dS )z'Sphinx build "main" command-line entry.Nz .doctreeszcannot find files %rz&cannot combine -a option and filenamesr] r1 �wz cannot open warning file %r: %s�=rN z1-D option argument must be in the form name=valuez1-A option argument must be in the form name=valuezhtml_context.%sTrV r )3rg �
parse_argsrQ rP r? rL �osr �joinrA rB �isfilerR �errorr rI r\ r r r$ �stdoutr rX rY r_ r r �dirname�open� Exceptionr rS �split�
ValueErrorrT r4 rV r r r rE rJ r` rU r& r7 ra ZbuildZ
statuscoder' r/ )rh re r rB Z
missing_files�filename�statusZwarningrq r_ Zwarnfp�excZ
confoverrides�val�keyr rP r- r- r. �
build_main� s�
�
�Zr} c C sN t j�tjd� t j�tj�td�d� | d d� dgkrBt | �S t
| �S d S )N� �locale�sphinxrN z-M) r� r � setlocale�LC_ALLZ init_consolern r ro r rj r} )rh r- r- r. �main# s
r� �__main__)6�__doc__r5 r r r2 rn r r$ r" r �typingr r r Zdocutils.utilsr Z
sphinx.localer� r r Zsphinx.applicationr Z
sphinx.errorsr
r Z sphinx.utilr r
r Zsphinx.util.consoler r r r Zsphinx.util.docutilsr r Zsphinx.util.osutilr r r �
BaseExceptionr/ r) r4 r8 rb rg rh rj r} r� �__name__�exitr- r- r- r. �<module> s8
4_""W"