o NiyC@sdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddlm Z ddl mZmZmZddlmZddlZddlmZddlmZdd lmZmZdd lmZdd lmZdd lmZm Z m!Z!m"Z"dd l#m$Z$m%Z%ddl&m'Z'm(Z(ddl)m*Z*erddl+m,Z,ddl m-Z-Gddde-Z.e j/fdXddZ0dYd#d$Z1dZd&d'Z2d[d*d+Z3d\d.d/Z4d]d5d6Z5d^d9d:Z6d_d>d?Z7d`dAdBZ8dadGdHZ9dbdMdNZ:d[dOdPZ;dcdQdRZdVkre?e=e j@dWddS)ez+Build documentation from a provided source.) annotationsN)path) TYPE_CHECKINGAnyTextIO) SystemMessage)__display_version__)Sphinx) SphinxErrorSphinxParallelError)__) TeeStripANSI)color_terminalnocolorred terminal_safe)docutils_namespacepatch_docutils)format_exception_cut_framessave_traceback) ensuredir)Sequence)Protocolc@seZdZdddZdS) SupportsWritetextstrreturn int | NonecCsdSN)selfrrrD/home/ubuntu/.local/lib/python3.10/site-packages/sphinx/cmd/build.pywrite#szSupportsWrite.writeN)rrrr)__name__ __module__ __qualname__r"rrrr!r"srapp Sphinx | Noneargsr exception BaseExceptionstderrrrNonecCsXt|tjrdS|jr$tttd|dtt t ddSt|d|j s/|jrQt d}t|t rFd|j}t||dn td|t|dt|tr`ttd|ddSt|tr|tttd|dtt|jd|ddSt|trttd |j|dtt||ddSt|trtttd |dttt||dt||}tttd ||ddSt|trd t|vrtttd |dttt||dt|dttd|dtd|ddStttd|dtt|dt||}tttd ||dttd|dttd|ddS)Nz5Exception occurred while building, starting debugger:)filez(Error in parallel process) z Interrupted!zreST markup error:rz%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:zThis 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 . Thanks!) isinstancebdbBdbQuitpdbprintrr traceback print_exc post_mortemsysexc_info verbosityr KeyboardInterruptrrr(r categoryr UnicodeErrorr RuntimeErrorrrstrip)r&r(r)r+exc exc_formattbpathrrr!handle_exception&s                     rCvaluerintcCs2|dkrtSt|}|dkrttd|S)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. autorz&job number should be a positive number)multiprocessing cpu_countrEargparseArgumentTypeErrorr )rDjobsrrr! jobs_argumentsrLargparse.ArgumentParserc Cstjdtdtdd}|jddddtd |jd d td d |jddtdd |jddtdd|td}|jdddddtdd|jdddd td!td"d#|jd$d%d&d'td(d)|jd*d+d&d,td-d)|td.}|jd/d0d1d2td3d4|jd5d6d1d7td8d4|d9}|jd:d;d&dd?d@dAdBgtdCdD|jdEdFdGdAdHgtdIdD|jdJdKdLdAdMgtdNdD|jdOdPd&dQtdRd)|tdS}|jdTdUdVdWdXtdYdZ|jd[d\d&d]td^d)|jd_d`d&datdbd)|jdcdddedfdgtdhdi|jdjdkdddedltdmdn|tdo}|jdpdqdrdstdtd4|jdudvd&dwtdxd)|jdyd&tjdz|jd{d|d&d}td~d)|jddd&dtdd)|jdd&dtdd)|jdkrpd|_|S)Nz5%(prog)s [OPTIONS] SOURCEDIR OUTPUTDIR [FILENAMES...]z:For more information, visit .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. )usageepilog descriptionz --versionversion show_versionz %(prog)s )actiondestrQ sourcedir SOURCE_DIRz"path to documentation source files)metavarhelp outputdir OUTPUT_DIRzpath to output directory filenames*zS(optional) a list of specific files to rebuild. Ignored if --write-all is specified)nargsrXzgeneral optionsz --builderz-bBUILDERbuilderhtmlz builder to use (default: 'html'))rWrTdefaultrXz--jobsz-jNr/rKzTrun in parallel with N processes, when possible. 'auto' uses the number of CPU cores)rWratyperTrXz --write-allz-a store_true force_allz;write all files (default: only write new and changed files))rSrTrXz --fresh-envz-Efreshenvz4don't use a saved environment, always read all filesz path optionsz --doctree-dirz-dPATH doctreedirzKdirectory for doctree and environment files (default: OUTPUT_DIR/.doctrees))rWrTrXz --conf-dirz-cconfdirzDdirectory for the configuration file (conf.py) (default: SOURCE_DIR)zbuild configuration optionsz --isolatedz-Cnoconfigzs^           ^  `        0