B \@sdZddlmZddlmZddlmZddlmZm Z ddl m Z ddl m Z mZddlmZe eZd d d d d dddgZGdddeZGdddeZddZddZGddde ZdS)z sphinx.ext.autodoc.directive ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ :copyright: Copyright 2007-2017 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. )nodes)ViewList)assemble_option_dict)Optionsget_documenters)logging)SphinxDirectiveswitch_source_input)nested_parse_with_titlesmembersz undoc-memberszinherited-memberszshow-inheritancezprivate-memberszspecial-memberszignore-module-allzexclude-membersc@seZdZdZddZdS)DummyOptionSpecz"An option_spec allows any options.cCsddS)NcSs|S)N)xr r ;lib/python3.7/site-packages/sphinx/ext/autodoc/directive.py*sz-DummyOptionSpec.__getitem__..r )selfkeyr r r __getitem__(szDummyOptionSpec.__getitem__N)__name__ __module__ __qualname____doc__rr r r rr %sr c@s eZdZdZddZddZdS)DocumenterBridgez'A parameters container for Documenters.cCs,||_||_||_||_t|_t|_dS)N)envreporterZgenoptlinenoset filename_setrresult)rrroptionsrr r r__init__0s zDocumenterBridge.__init__cCstj||jj|jfddS)N)location)loggerZwarningrZdocnamer)rmsgr r rwarn9szDocumenterBridge.warnN)rrrrr r$r r r rr-s rcCs`xJtD]B}||jkrqq|d|ddk}||jkr|s|j|||<qWtt||jS)z0Recognize options of Documenter from user input.zno-TN)AUTODOC_DEFAULT_OPTIONS option_specpopZautodoc_default_optionsrritems) documenterconfigrnameZnegatedr r rprocess_documenter_options>s  r,c Cs^t||J|jr0t}|j|_t|||nt}|j|_||d||jSQRXdS)z(Parse a generated content by Documenter.rN) r Ztitles_allowedrZsectiondocumentr Z paragraphZ nested_parseZchildren)statecontentr)Znoder r rparse_generated_contentLs r0c@s.eZdZdZeZdZdZdZdZ ddZ dS)AutodocDirectivezA directive class for all autodoc directives. It works as a dispatcher of Documenters. It invokes a Documenter on running. After the processing, it parses and returns the generated content by Documenter. Trc CsL|jjj}y||j\}}Wntk r:d\}}YnXtd|||j|j dd}t |j j |}yt ||j|j}WnDtttfk r}z tjd|j |f||fdgSd}~XYnXt|j |||}|||jd} | j|jd|jsgStdd |jx"|jD]} |jjjj| qWt|j|j| } | S) N)NNz[autodoc] %s:%s: input: %sz=An option to %s is either unknown or has an invalid value: %s)r!r)Z more_contentz[autodoc] output: %s )r.r-rZget_source_and_linerAttributeErrorr"debugZ block_textr+rrZappr,r*rKeyError ValueError TypeErrorerrorrZ argumentsZgenerater/rjoinrZsettingsZrecord_dependenciesaddr0) rrsourcerZobjtypeZdocclsZdocumenter_optionsexcZparamsr)fnrr r rrunis0  zAutodocDirective.runN) rrrrr r&Z has_contentZrequired_argumentsZoptional_argumentsZfinal_argument_whitespacer@r r r rr1]sr1N)rZdocutilsrZdocutils.statemachinerZdocutils.utilsrZsphinx.ext.autodocrrZ sphinx.utilrZsphinx.util.docutilsrr Zsphinx.util.nodesr Z getLoggerrr"r%objectr rr,r0r1r r r rs