Fe dZddlmZddlZddlZddlmZejejdZ d dZ d d dZ d dZ y) z#Utilities for docstring processing.) annotationsN)Body field_markercd}i}g}|s||fSt|D]}|jdk(rd}|j|*tj |}|r|s|j ddj ddd}|jdr8|ddj}||jdj||<|j|d }|j|d j||fS) z,Separate docstring into metadata and others.FN:rzmeta T ) prepare_docstringstripappendfield_list_item_rematchgroupsplit startswithendjoin)sin_other_elementmetadatalineslinematched field_namenames 8/usr/lib/python3/dist-packages/sphinx/util/docstrings.pyseparate_metadatar s!H E ({!!$# ::<2 $  LL (..t4G/$]]_QR066sA>qA ((1%ab>//1D%)'++-.%9%?%?%AHTNLL&#'  T"#" 99U X %%c|j|j}tj}|ddD]8}t |j }|st ||z }t ||}:t |r|dj |d<|tjkr%tdt |D] }|||d||<|r|ds|jd|r|ds|r|dr|jd|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. rNrr) expandtabs splitlinessysmaxsizelenlstripminrangepopr)rtabsizermarginrcontentindentis rr r *s LL ! , , .E [[Fab )dkkm$ Y(F(F )  5z8??$a  q#e*% )AQx(E!H ) a !  a r R Lr c2g}|jjDcgc]}|j}}|D]9}|jds|dd}|r |ddk(r|dd}|j |;|r|dr|j d|Scc}w) zExtract documentation comment lines (starting with #:) and return them as a list of lines. Returns an empty list if there is no documentation. z#:Nr rr"r)r#r$r rr)rresultrrs rprepare_commentdocr5IsF&'lln&?&?&A BdTZZ\ BE B  ??4 8DQ3ABx MM$   &* b M CsB)rz str | Nonereturnz!tuple[str | None, dict[str, str]]))rstrr,intr6 list[str])rr8r6r:) __doc__ __future__rrer%docutils.parsers.rst.statesrcompilepatternsrrr r5r rrBs=)" ,RZZ n =>&:>r