§
    _÷#d£  ã                   ó  — d Z ddlZddlZddlZddlmZmZmZ ddlm	Z	 ddl
mZ  ej        e	j        d         ¦  «        Zdedeeeeef         f         fd	„Zdedeeef         fd
„Zddededee         fd„Zdedee         fd„ZdS )z#Utilities for docstring processing.é    N)ÚDictÚListÚTuple)ÚBody)ÚRemovedInSphinx60WarningÚfield_markerÚsÚreturnc                 óš  — d}i }g }| s| |fS t          | ¦  «        D �]}|                     ¦   «         dk    rd}|                     |¦  «         Œ3t                               |¦  «        }|r²|s°|                     ¦   «         dd…                              dd¦  «        d         }|                     d¦  «        rN|dd…                              ¦   «         }||                     ¦   «         d…                              ¦   «         ||<   Œê|                     |¦  «         �Œd	}|                     |¦  «         �Œd
 	                    |¦  «        |fS )z,Separate docstring into metadata and others.FÚ é   Nú:r   zmeta é   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Únames           ú8/usr/lib/python3/dist-packages/sphinx/util/docstrings.pyÚseparate_metadatar#      sU  € àÐØ!€HØ€Eàð Ø�(ˆ{Ðå! !Ñ$Ô$ð #ñ #ˆØ�:Š:‰<Œ<˜2ÒÐØ$ÐØ�LŠL˜ÑÔÐÐå(×.Ò.¨tÑ4Ô4ˆGØð 	#Ð/ð 	#Ø$Ÿ]š]™_œ_¨Q¨R¨RÔ0×6Ò6°s¸AÑ>Ô>¸qÔA�
Ø×(Ò(¨Ñ1Ô1ð 'Ø% a b bœ>×/Ò/Ñ1Ô1�DØ%)¨'¯+ª+©-¬-¨.¨.Ô%9×%?Ò%?Ñ%AÔ%A�H˜T‘N�Nà—L’L Ñ&Ô&Ð&Ñ&à#'Ð Ø—’˜TÑ"Ô"Ð"Ñ"à�9Š9�UÑÔ˜XÐ%Ð%ó    c                 ób   — t          j        dt          d¬¦  «         t          | ¦  «        \  }}|S )Nz!extract_metadata() is deprecated.é   )Ú
stacklevel)ÚwarningsÚwarnr   r#   )r	   Ú	docstringr   s      r"   Úextract_metadatar+   ,   s<   € Ý„MÐ5Ý*°qð:ñ :ô :ð :õ ,¨AÑ.Ô.Ñ€IˆxØ€Or$   é   Útabsizec                 ó~  — |                       |¦  «                             ¦   «         }t          j        }|dd…         D ]G}t	          |                     ¦   «         ¦  «        }|r"t	          |¦  «        |z
  }t          ||¦  «        }ŒHt	          |¦  «        r|d                              ¦   «         |d<   |t          j        k     r3t          dt	          |¦  «        ¦  «        D ]}||         |d…         ||<   Œ|r'|d         s|                     d¦  «         |r|d         ¯|r|d         r| 	                    d¦  «         |S )aw  Convert 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   )r	   r-   r   Úmarginr   ÚcontentÚindentÚis           r"   r   r   4   sH  € ð �LŠL˜Ñ!Ô!×,Ò,Ñ.Ô.€EåŒ[€FØ�a�b�b”	ð )ð )ˆÝ�d—k’k‘m”mÑ$Ô$ˆØð 	)Ý˜‘Y”Y Ñ(ˆFÝ˜ Ñ(Ô(ˆFøå
ˆ5�z„zð %Ø˜”8—?’?Ñ$Ô$ˆˆa‰Ø•”ÒÐÝ�q�#˜e™*œ*Ñ%Ô%ð 	)ð 	)ˆAØ˜Q”x   Ô(ˆE�!‰HˆHà
ð ˜˜aœð Ø�	Š	�!‰Œˆð ð ˜˜aœð ð ð ��r”ð Ø�Š�RÑÔÐØ€Lr$   c                 óJ  — g }d„ |                       ¦   «                              ¦   «         D ¦   «         }|D ]N}|                     d¦  «        r7|dd…         }|r|d         dk    r
|dd…         }|                     |¦  «         ŒO|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.
    c                 ó6   — g | ]}|                      ¦   «         ‘ŒS © )r   )Ú.0r   s     r"   ú
<listcomp>z&prepare_commentdoc.<locals>.<listcomp>X   s    € ÐBÐBÐB˜dˆT�ZŠZ‰\Œ\ÐBÐBÐBr$   z#:r&   Nr   ú r   r/   r   )r0   r1   r   r   )r	   Úresultr   r   s       r"   Úprepare_commentdocrD   S   s¾   € ð €FØBÐB a§l¢l¡n¤n×&?Ò&?Ñ&AÔ&AÐBÑBÔB€EØð  ð  ˆØ�?Š?˜4Ñ Ô ð 	 Ø˜˜˜”8ˆDàð  ˜˜Qœ 3š˜Ø˜A˜B˜B”x�Ø�MŠM˜$ÑÔÐøØð �&˜”*ð Ø�Š�bÑÔÐØ€Mr$   )r,   )Ú__doc__Úrer2   r(   Útypingr   r   r   Údocutils.parsers.rst.statesr   Úsphinx.deprecationr   ÚcompileÚpatternsr   Ústrr#   r+   Úintr   rD   r?   r$   r"   ú<module>rN      sA  ðØ )Ð )à 	€	€	€	Ø 
€
€
€
Ø €€€Ø $Ð $Ð $Ð $Ð $Ð $Ð $Ð $Ð $Ð $à ,Ð ,Ð ,Ð ,Ð ,Ð ,à 7Ð 7Ð 7Ð 7Ð 7Ð 7à�R”Z ¤¨nÔ =Ñ>Ô>Ð ð&˜ð &  s¨D°°c°¬NÐ':Ô!;ð &ð &ð &ð &ð:˜ð   S¨# X¤ð ð ð ð ðð ˜ð  sð °4¸´9ð ð ð ð ð>˜#ð  $ s¤)ð ð ð ð ð ð r$   