o Ni@s.ddlmZddlmZddlmZmZddlmZddl m Z ddl m Z m Z ddlmZmZddlmZdd lmZmZdd lmZer^dd lmZdd lmZdd lmZddlmZe e!Z"gdZ#gdZ$Gddde%e&ee&ge&ffZ'GdddZ(d*ddZ)d+d%d&Z*Gd'd(d(eZ+d)S),) annotations)Callable) TYPE_CHECKINGAny)nodes) StringList)Reporterassemble_option_dict) DocumenterOptions)logging)SphinxDirectiveswitch_source_input)nested_parse_to_nodes)Node)RSTState)Config)BuildEnvironment) membersz undoc-memberszinherited-memberszshow-inheritanceprivate-membersspecial-memberszignore-module-allexclude-membersz member-orderzimported-memberszclass-doc-fromzno-value)rrrrc@s$eZdZdZd ddZd d d Zd S)DummyOptionSpecz"An option_spec allows any options.returnboolcCsdS)z&Behaves like some options are defined.T)selfrrP/home/ubuntu/.local/lib/python3.10/site-packages/sphinx/ext/autodoc/directive.py__bool__&szDummyOptionSpec.__bool___keystrCallable[[str], str]cCsddS)NcSs|SNr)xrrr+sz-DummyOptionSpec.__getitem__..r)rrrrr __getitem__*szDummyOptionSpec.__getitem__N)rr)rr rr!)__name__ __module__ __qualname____doc__rr%rrrrr#s rc@seZdZdZdddZdS)DocumenterBridgez'A parameters container for Documenters.envrreporterReporter | Noneoptionsr linenointstaterrNonecCs2||_||_||_||_t|_t|_||_dSr") r+ _reportergenoptr/setrecord_dependenciesrresultr1)rr+r,r.r/r1rrr__init__1s zDocumenterBridge.__init__N) r+rr,r-r.r r/r0r1rrr2)r&r'r(r)r8rrrrr*.sr* documentertype[Documenter]configrr.dict[str, str]rr cCs|j}tD]]}||jvr q|d|ddu}||vrR|sR||vrKt||trK|tvrJ||durJ||drJ||d||dd||<q||||<q||durb|| d||<qt t | |jS)z0Recognize options of Documenter from user input.zno-TN+,) autodoc_default_optionsAUTODOC_DEFAULT_OPTIONS option_specpop isinstancer AUTODOC_EXTENDABLE_OPTIONS startswithgetlstripr r items)r9r;r.default_optionsnamenegatedrrrprocess_documenter_options<s   "rMr1rcontentrr list[Node]cCstt||+|jrt||WdSt}|j|_|j|d|dd|jWdS1s3wYdS)z1Parse an item of content generated by Documenter.NrF) match_titles)rtitles_allowedrr paragraphdocument nested_parsechildren)r1rNr9noderrrparse_generated_contentVs $rWc@s0eZdZdZeZdZdZdZdZ d ddZ 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. Tr?rrrOc CsL|jjj}z ||j\}}Wn tyd\}}Ynwtd|||j|j dd}|j j j j |}z t||j|j}Wn%tttfyd}ztjd|j ||j j|fdgWYd}~Sd}~wwt|j ||||j}|||jd} | j|jd|jsgStdd |j|jD] } |jjjj| qt|j|j| } | S) N)NNz[autodoc] %s:%s: input: %sz=An option to %s is either unknown or has an invalid value: %s)locationr) more_contentz[autodoc] output: %s ) r1rSr,get_source_and_liner/AttributeErrorloggerdebug block_textrKr+appregistry documentersrMr;r.KeyError ValueError TypeErrorerrordocnamer* argumentsgeneraterNr7joinr6settingsaddrW) rr,sourcer/objtypedocclsdocumenter_optionsexcparamsr9fnr7rrrrunqs<    zAutodocDirective.runN)rrO) r&r'r(r)rrB has_contentrequired_argumentsoptional_argumentsfinal_argument_whitespacervrrrrrXdsrXN)r9r:r;rr.r<rr )r1rrNrr9r rrO), __future__rcollections.abcrtypingrrdocutilsrdocutils.statemachinerdocutils.utilsrr sphinx.ext.autodocr r sphinx.utilr sphinx.util.docutilsr rsphinx.util.parsingrdocutils.nodesrdocutils.parsers.rst.statesr sphinx.configrsphinx.environmentr getLoggerr&r_rArEdictr rr*rMrWrXrrrrs.          "