-Ph dZddlmZddlZddlZddlmZejejdZ dd Z dddZ ddZ dS)z#Utilities for docstring processing.) annotationsN)Body field_markers str | Nonereturn!tuple[str | None, dict[str, str]]cd}i}g}|s||fSt|D]}|sd}||/t|}|r|s|ddddd}|drN|dd}||d||<||d}||d ||fS) z,Separate docstring into metadata and others.FN:rzmeta T ) prepare_docstringstripappendfield_list_item_rematchgroupsplit startswithendjoin)rin_other_elementmetadatalineslinematched field_namenames V/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/sphinx/util/docstrings.pyseparate_metadatar! sR!H E ({!!$$##zz|| #$  LL    (..t44G #/ #$]]__QRR066sA>>qA ((11'%abb>//11D%)'++--//%:%@%@%B%BHTNNLL&&&&#'  T"""" 99U  X %%strtabsizeint list[str]c~||}tj}|ddD]G}t |}|r"t ||z }t ||}Ht |r|d|d<|tjkr3tdt |D]}|||d||<|r'|ds|d|r|d|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. r Nr) expandtabs splitlinessysmaxsizelenlstripminrangepopr)rr%rmarginrcontentindentis r rr*sH LL ! ! , , . .E [Fabb ))dkkmm$$  )YY(F((F 5zz%8??$$a  q#e**%% ) )AQx(E!HH a !  a r R Lr"cJg}d|D}|D]N}|dr7|dd}|r|ddkr |dd}||O|r|dr|d |S) zExtract documentation comment lines (starting with #:) and return them as a list of lines. Returns an empty list if there is no documentation. c6g|]}|S)r).0rs r z&prepare_commentdoc..Ns B B BdTZZ\\ B B Br"z#:Nr r r)r*)r+r,rr)rresultrrs r prepare_commentdocr@IsF B Ballnn&?&?&A&A B B BE   ??4  8D Q3ABBx MM$    &* b Mr")rrrr )r#)rr$r%r&rr')rr$rr') __doc__ __future__rrer-docutils.parsers.rst.statesrcompilepatternsrr!rr@r:r"r rGs))"""""" ,,,,,,RZ n =>>&&&&:>r"