U \ªShr ã@stdZddlmZddlZddlZddlmZe ejd¡Z dddœd d „Z ddd d dœdd„Z dd dœdd„Z dS)z#Utilities for docstring processing.é)Ú annotationsN)ÚBodyZ field_markerÚstrztuple[str, dict[str, str]])ÚsÚreturncCsÌd}i}g}|s||fSt|ƒD]œ}| ¡dkr@d}| |¡q t |¡}|r®|s®| ¡dd… dd¡d}| d¡r¢|dd… ¡}|| ¡d… ¡||<q¼| |¡q d }| |¡q d   |¡|fS) z,Separate docstring into metadata and others.FÚéNú:rzmeta éTÚ ) Úprepare_docstringÚstripÚappendÚfield_list_item_reÚmatchÚgroupÚsplitÚ startswithÚendÚjoin)rZin_other_elementÚmetadataÚlinesÚlineZmatchedÚ field_nameÚname©rúI/root/rtd-docs/venv/lib/python3.8/site-packages/sphinx/util/docstrings.pyÚseparate_metadata s&       réÚintz list[str])rÚtabsizercCsÈ| |¡ ¡}tj}|dd…D]*}t| ¡ƒ}|r t|ƒ|}t||ƒ}q t|ƒrd|d ¡|d<|tjkr–tdt|ƒƒD]}|||d…||<q||r®|ds®| d¡q–|rÄ|drÄ|  d¡|S)awConvert a docstring into lines of parseable reST. Remove common leading indentation, where the indentation of the first line is ignored. Return the docstring as a list of lines usable for inserting into a docutils ViewList (used as argument of nested_parse().) An empty line is added to act as a separator between this docstring and following content. rNréÿÿÿÿr) Ú expandtabsÚ splitlinesÚsysÚmaxsizeÚlenÚlstripÚminÚrangeÚpopr)rr rÚmarginrÚcontentÚindentÚirrrr *s"        r cCszg}dd„| ¡ ¡Dƒ}|D]@}| d¡r|dd…}|rT|ddkrT|dd…}| |¡q|rv|d rv| d ¡|S) z˜Extract documentation comment lines (starting with #:) and return them as a list of lines. Returns an empty list if there is no documentation. cSsg|] }| ¡‘qSr)r )Ú.0rrrrÚ Nsz&prepare_commentdoc..z#:éNrú rr!r)r"r#rr)rÚresultrrrrrÚprepare_commentdocIs      r4)r) Ú__doc__Ú __future__rÚrer$Zdocutils.parsers.rst.statesrÚcompileÚpatternsrrr r4rrrrÚs