U \Sh% @s<ddlmZddlmZmZddlmZddlmZm Z ddl m Z ddl m Z ddlmZmZddlmZdd lmZdd lmZmZdd lmZdd lmZmZdd lmZee Z!ddddddddddddg Z"ddddgZ#Gddde$Z%GdddZ&ddd d!d"d#d$Z'd%d&d'd(d)d*d+Z(Gd,d-d-eZ)d.S)/) annotations)AnyCallable)nodes)ElementNode)RSTState) StringList)Reporterassemble_option_dict)Config)BuildEnvironment) DocumenterOptions)logging)SphinxDirectiveswitch_source_input)nested_parse_with_titlesmembersz undoc-memberszinherited-memberszshow-inheritancezprivate-memberszspecial-memberszignore-module-allzexclude-membersz member-orderzimported-memberszclass-doc-fromzno-valuec@s.eZdZdZddddZdddd d Zd S) DummyOptionSpecz"An option_spec allows any options.boolreturncCsdS)z&Behaves like some options are defined.T)selfrrO/root/rtd-docs/venv/lib/python3.8/site-packages/sphinx/ext/autodoc/directive.py__bool__"szDummyOptionSpec.__bool__strzCallable[[str], str])keyrcCsddS)NcSs|SNr)xrrr'z-DummyOptionSpec.__getitem__..r)rrrrr __getitem__&szDummyOptionSpec.__getitem__N)__name__ __module__ __qualname____doc__rr#rrrrrsrc@s(eZdZdZdddddddd d Zd S) DocumenterBridgez'A parameters container for Documenters.r zReporter | NonerintrNone)envreporteroptionslinenostatercCs2||_||_||_||_t|_t|_||_dSr) r+Z _reporterZgenoptr.setrecord_dependenciesr resultr/)rr+r,r-r.r/rrr__init__-szDocumenterBridge.__init__N)r$r%r&r'r3rrrrr(*sr(ztype[Documenter]r dictr) documenterconfigr-rcCstD]}||jkrq|d|ddk}||jkr|s||krt|j|tr|tkr||dk r||drd|j|||ddg||<q|j|||<q| |dk r|| d||<qt t | |jS)z0Recognize options of Documenter from user input.zno-TN+,)AUTODOC_DEFAULT_OPTIONS option_specpopZautodoc_default_options isinstancerAUTODOC_EXTENDABLE_OPTIONS startswithjoingetlstriprr items)r5r6r-nameZnegatedrrrprocess_documenter_options8s   rErr r list[Node])r/contentr5rc Csjt||V|jr0t}|j|_t|||nt}|j|_||d||jW5QRSQRXdS)z1Parse an item of content generated by Documenter.rN) rZtitles_allowedrsectiondocumentrZ paragraphZ nested_parsechildren)r/rGr5noderrrparse_generated_contentQs rLc@s4eZdZdZeZdZdZdZdZ ddddZ d S) AutodocDirectivezA 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. Tr9rrFrc CsX|jjj}z||j\}}Wntk r:d\}}YnXtd|||j|j dd}|j j j j |}zt||j|j}WnPtttfk r}z,tjd|j |f|j j|fdgWYSd}~XYnXt|j ||||j}|||jd} | j|jd|jsgStdd |j|jD]} |jjjj| q*t|j|j| } | S) N)NNz[autodoc] %s:%s: input: %sz=An option to %s is either unknown or has an invalid value: %s)locationr)Z more_contentz[autodoc] output: %s ) r/rIr,Zget_source_and_liner.AttributeErrorloggerdebugZ block_textrDr+ZappregistryZ documentersrEr6r-KeyError ValueError TypeErrorerrorZdocnamer( argumentsgeneraterGr2r@r1settingsaddrL) rr,sourcer.objtypeZdocclsZdocumenter_optionsexcparamsr5fnr2rrrrunns6   zAutodocDirective.runN) r$r%r&r'rr;Z has_contentZrequired_argumentsZoptional_argumentsZfinal_argument_whitespacerbrrrrrMbsrMN)* __future__rtypingrrZdocutilsrZdocutils.nodesrrZdocutils.parsers.rst.statesrZdocutils.statemachiner Zdocutils.utilsr r Z sphinx.configr Zsphinx.environmentr Zsphinx.ext.autodocrrZ sphinx.utilrZsphinx.util.docutilsrrZsphinx.util.nodesr getLoggerr$rRr:r>r4rr(rErLrMrrrrs@