}c dZddlZddlZddlZddlmZmZmZddlm Z ddl m Z ej e j dZdedeeeeefffd Zdedeeeffd Zdded edeefd ZdedeefdZdS)z#Utilities for docstring processing.N)DictListTuple)Body)RemovedInSphinx60Warning field_markersreturncd}i}g}|s||fSt|D]}|dkrd}||3t|}|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)r in_other_elementmetadatalineslinematched field_namenames 6lib/python3.11/site-packages/sphinx/util/docstrings.pyseparate_metadatar#sW!H E ({!!$$## ::<<2  #$  LL    (..t44G #/ #$]]__QRR066sA>>qA ((11'%abb>//11D%)'++--..%9%?%?%A%AHTNNLL&&&&#'  T"""" 99U  X %%cbtjdtdt|\}}|S)Nz!extract_metadata() is deprecated.) stacklevel)warningswarnrr#)r docstringrs r"extract_metadatar+,s< M5*q::::,A..Ix Or$tabsizec~||}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 Nrr ) expandtabs splitlinessysmaxsizelenlstripminrangepopr)r r-rmarginrcontentindentis r"rr4sJ 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..Xs B B BdTZZ\\ B B Br$z#:r&Nr r r/r )r0r1rr)r resultrrs r"prepare_commentdocrDSsF B Ballnn&?&?&A&A B B BE   ??4  8D Q3 ABBx MM$    &* b Mr$)r,)__doc__rer2r(typingrrrdocutils.parsers.rst.statesrsphinx.deprecationrcompilepatternsrstrr#r+intrrDr?r$r"rNsA)) $$$$$$$$$$,,,,,,777777RZ n =>>&&sDcN':!;&&&&:S#Xs49>#$s)r$