o N i ã@s`dZddlmZddlZddlZddlmZe ejd¡Z dd d „Z dddd„Z ddd„Z dS)z#Utilities for docstring processing.é)Ú annotationsN)ÚBodyÚ field_markerÚsú str | NoneÚreturnú!tuple[str | None, dict[str, str]]cCsÌd}i}g}|s ||fSt|ƒD]N}| ¡dkr d}| |¡qt |¡}|rW|sW| ¡dd… dd¡d}| d¡rQ|dd… ¡}|| ¡d… ¡||<q| |¡qd }| |¡qd   |¡|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)rÚin_other_elementÚmetadataÚlinesÚlineÚmatchedÚ field_nameÚname©rúJ/home/ubuntu/.local/lib/python3.10/site-packages/sphinx/util/docstrings.pyÚseparate_metadata s&       r!éÚstrÚtabsizeÚintú list[str]cCsÒ| |¡ ¡}tj}|dd…D]}t| ¡ƒ}|r%t|ƒ|}t||ƒ}qt|ƒr2|d ¡|d<|tjkrKtdt|ƒƒD] }|||d…||<q>|r\|ds\| d¡|r\|drQ|rg|drg|  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. r Nréÿÿÿÿr ) Ú expandtabsÚ splitlinesÚsysÚmaxsizeÚlenÚlstripÚminÚrangeÚpopr)rr$rÚmarginrÚcontentÚindentÚirrr r*s&   €    ÿ  rcCszg}dd„| ¡ ¡Dƒ}|D] }| d¡r/|dd…}|r*|ddkr*|dd…}| |¡q|r;|d r;| 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ú r r'r )r(r)rr)rÚresultrrrrr Úprepare_commentdocIs    €  r:)rrrr)r")rr#r$r%rr&)rr#rr&) Ú__doc__Ú __future__rÚrer*Údocutils.parsers.rst.statesrÚcompileÚpatternsrr!rr:rrrr Ús