B .ÛKc£ ã@sÀdZddlZddlZddlZddlmZmZmZddlm Z ddl m Z e  e j d¡Zeeeeeeffdœdd „Zeeeefdœd d „Zdeeeed œdd„Zeeedœdd„ZdS)z#Utilities for docstring processing.éN)ÚDictÚListÚTuple)ÚBody)ÚRemovedInSphinx60WarningZ field_marker)ÚsÚreturncCsÐd}i}g}|s||fSx¨t|ƒD]œ}| ¡dkrBd}| |¡q"t |¡}|r°|s°| ¡dd… dd¡d}| d¡r¤|dd… ¡}|| ¡d… ¡||<q¾| |¡q"d }| |¡q"Wd   |¡|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ÚlineZmatchedZ field_nameÚname©rú5lib/python3.7/site-packages/sphinx/util/docstrings.pyÚseparate_metadatas&     rcCs tjdtddt|ƒ\}}|S)Nz!extract_metadata() is deprecated.é)Ú stacklevel)ÚwarningsÚwarnrr)rZ docstringrrrrÚextract_metadata,s  r#é)rÚtabsizercCsÔ| |¡ ¡}tj}x:|dd…D]*}t| ¡ƒ}|r"t|ƒ|}t||ƒ}q"Wt|ƒrh|d ¡|d<|tjkržx*tdt|ƒƒD]}|||d…||<q‚Wx|r¸|ds¸| d¡q W|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éÿÿÿÿr ) Ú expandtabsÚ splitlinesÚsysÚmaxsizeÚlenÚlstripÚminÚrangeÚpopr)rr%rZmarginrZcontentÚindentÚirrrr4s"     rcCs~g}dd„| ¡ ¡Dƒ}xH|D]@}| d¡r |dd…}|rV|ddkrV|dd…}| |¡q W|rz|d rz| 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ú Xsz&prepare_commentdoc..z#:rNrú r r&r )r'r(rr)rÚresultrrrrrÚprepare_commentdocSs      r6)r$)Ú__doc__Úrer)r!ÚtypingrrrZdocutils.parsers.rst.statesrZsphinx.deprecationrÚcompileZpatternsrÚstrrr#Úintrr6rrrrÚs