§
    ãŽ’jp!  ã            	       óÚ   — d Z ddlZddlZddlZddlmZmZmZm	Z	m
Z
mZmZmZmZmZmZmZmZmZ dej        e         dedefd„Zd	ej        e         defd
„Zej        dfdedededefd„ZdS )zReST-style docstring parsing.é    Né   )ÚDEPRECATION_KEYWORDSÚPARAM_KEYWORDSÚRAISES_KEYWORDSÚRETURNS_KEYWORDSÚYIELDS_KEYWORDSÚ	DocstringÚDocstringDeprecatedÚDocstringMetaÚDocstringParamÚDocstringRaisesÚDocstringReturnsÚDocstringStyleÚ
ParseErrorÚRenderingStyleÚargsÚdescÚreturnc                 óZ  — | d         }|t           v rÐt          | ¦  «        dk    r+| \  }}}|                     d¦  «        rd}|d d…         }n3d}n0t          | ¦  «        dk    r
| \  }}d }d }nt          d|› d	�¦  «        ‚t	          j        d
|t          j        ¬¦  «        }|r(|                     d¦  «                             d¦  «        nd }t          | |||||¬¦  «        S |t          t          z  v r_t          | ¦  «        dk    r	| d         }n)t          | ¦  «        dk    rd }nt          d|› d	�¦  «        ‚t          | |||t          v ¬¦  «        S |t          v rat	          j        d|t          j        ¬¦  «        }t!          | |r|                     d¦  «        nd |r|                     d¦  «        n|¬¦  «        S |t"          v rWt          | ¦  «        dk    r	| d         }n)t          | ¦  «        dk    rd }nt          d|› d	�¦  «        ‚t%          | ||¬¦  «        S t'          | |¬¦  «        S )Nr   é   Ú?TéÿÿÿÿFé   z$Expected one or two arguments for a z	 keyword.z.*defaults to (.+)©Úflagsr   ú.)r   ÚdescriptionÚarg_nameÚ	type_nameÚis_optionalÚdefaultz#Expected one or no arguments for a )r   r   r   Úis_generatorz7^(?P<version>v?((?:\d+)(?:\.[0-9a-z\.]+))) (?P<desc>.+)Úversionr   )r   r#   r   )r   r   r   )r   r   )r   ÚlenÚendswithr   ÚreÚmatchÚDOTALLÚgroupÚrstripr   r   r   r   r   ÚsearchÚIr
   r   r   r   )r   r   Úkeyr   r   r    r'   r!   s           úCC:\Projects\DSCons\.venv\Lib\site-packages\docstring_parser\rest.pyÚ_build_metar/      s­  € Ø
ˆqŒ'€Cà
�nÐÐÝˆt‰9Œ9˜Š>ˆ>Ø'+Ñ$ˆC�˜HØ×!Ò! #Ñ&Ô&ð $Ø"�Ø% c r cœN�	�	à#��Ý�‰YŒY˜!Š^ˆ^Ø ‰MˆC�ØˆIØˆKˆKåØE°sÐEÐEÐEñô ð õ ”Ð.°½B¼IÐFÑFÔFˆØ05Ð?�%—+’+˜a‘.”.×'Ò'¨Ñ,Ô,Ð,¸4ˆåØØØØØ#Øð
ñ 
ô 
ð 	
ð Õ¥Ñ0Ð0Ð0Ýˆt‰9Œ9˜Š>ˆ>Ø˜QœˆIˆIÝ�‰YŒY˜!Š^ˆ^ØˆIˆIåØD°cÐDÐDÐDñô ð õ  ØØØØ¥Ð/ð	
ñ 
ô 
ð 	
ð Õ"Ð"Ð"Ý”	ØFØÝ”$ð
ñ 
ô 
ˆõ
 #ØØ.3Ð=�E—K’K 	Ñ*Ô*Ð*¸Ø/4Ð>˜Ÿš FÑ+Ô+Ð+¸$ð
ñ 
ô 
ð 	
ð �oÐÐÝˆt‰9Œ9˜Š>ˆ>Ø˜QœˆIˆIÝ�‰YŒY˜!Š^ˆ^ØˆIˆIåØD°cÐDÐDÐDñô ð õ Ø 4°9ð
ñ 
ô 
ð 	
õ ˜d°Ð5Ñ5Ô5Ð5ó    Útextc           
      óB  — t          t          j        ¬¦  «        }| s|S t          j        | ¦  «        } t          j        d| t
          j        ¬¦  «        }|r9| d|                     ¦   «         …         }| |                     ¦   «         d…         }n| }d}| 	                    dd¦  «        }|d         pd|_
        t          |¦  «        dk    rY|d         pd}|                     d¦  «        |_        |                     d	¦  «        |_        |                     ¦   «         pd|_        i }i }t          j        d
|t
          j        t
          j        z  ¬¦  «        D �]`}|                     d¦  «        }	|	sŒ	 |	                     d¦  «         	                    dd¦  «        \  }
}n&# t,          $ r}t/          d|	› d�¦  «        |‚d}~ww xY w|
 	                    ¦   «         }|                     ¦   «         }d|v r3| 	                    dd¦  «        \  }}|dz   t          j        |¦  «        z   }t          |¦  «        dk    r|d         dk    r|||d         <   Œùt          |¦  «        dv r.|d         dk    r"||t          |¦  «        dk    rdn|d         <   �Œ8|j                             t5          ||¦  «        ¦  «         �Œb|j        D ]y}t7          |t8          ¦  «        r'|j        p|                     |j        ¦  «        |_        Œ>t7          |t@          ¦  «        r&|j        p|                     |j!        ¦  «        |_        ŒztE          d„ |j        D ¦   «         ¦  «        sH|rF| #                    ¦   «         D ]1\  }}|j                             tA          g |dd|¬¦  «        ¦  «         Œ2|S )zXParse the ReST-style docstring into its components.

    :returns: parsed docstring
    )Ústylez^:r   NÚ ú
r   r   z

z(^:.*?)(?=^:|\Z)ú:z%Error parsing meta information near "z".r   Útype)r   r   Úrtypec              3   ó@   K  — | ]}t          |t          ¦  «        V — Œd S )N)Ú
isinstancer   )Ú.0Úms     r.   ú	<genexpr>zparse.<locals>.<genexpr>£   s-   è è € ÐAÐA°1�z˜!Õ-Ñ.Ô.ÐAÐAÐAÐAÐAÐAr0   F)r   r   r   r"   Úreturn_name)$r	   r   ÚRESTÚinspectÚcleandocr&   r+   ÚMÚstartÚsplitÚshort_descriptionr$   Ú
startswithÚblank_after_short_descriptionr%   Úblank_after_long_descriptionÚstripÚlong_descriptionÚfinditerÚSr)   ÚlstripÚ
ValueErrorr   ÚmetaÚappendr/   r:   r   r   Úgetr   r   r>   ÚanyÚitems)r1   Úretr'   Ú
desc_chunkÚ
meta_chunkÚpartsÚlong_desc_chunkÚtypesÚrtypesÚchunkÚ
args_chunkÚexr   r   Ú
first_lineÚrestrO   r>   r   s                      r.   Úparser`   f   sÆ  € õ
 �.Ô-Ð
.Ñ
.Ô
.€CØð Øˆ
åÔ˜DÑ!Ô!€DÝŒI�d˜D­¬Ð-Ñ-Ô-€EØð Ø˜/˜EŸKšK™MœM˜/Ô*ˆ
Ø˜%Ÿ+š+™-œ-˜/˜/Ô*ˆ
ˆ
àˆ
Øˆ
à×Ò˜T 1Ñ%Ô%€EØ! !œHÐ,¨€CÔÝ
ˆ5�z„z�A‚~€~Ø œ(˜. bˆØ,;×,FÒ,FÀtÑ,LÔ,LˆÔ)Ø+:×+CÒ+CÀFÑ+KÔ+KˆÔ(Ø.×4Ò4Ñ6Ô6Ð>¸$ˆÔà€EØ€FÝ”Ø˜Z­r¬tµb´d©{ðñ ô ð 5ñ 5ˆð —’˜A‘”ˆØð 	Øð	Ø%*§\¢\°#Ñ%6Ô%6×%<Ò%<¸SÀ!Ñ%DÔ%DÑ"ˆJ˜
˜
øÝð 	ð 	ð 	ÝØA¸ÐAÐAÐAñô àðøøøøð	øøøð ×ÒÑ!Ô!ˆØ×ÒÑ!Ô!ˆà�4ˆ<ˆ<Ø#Ÿzšz¨$°Ñ2Ô2ÑˆJ˜Ø Ñ$¥wÔ'7¸Ñ'=Ô'=Ñ=ˆDõ ˆt‰9Œ9˜Š>ˆ>˜d 1œg¨Ò/Ð/Ø!ˆE�$�q”'‰NˆNÝ�‰YŒY˜&Ð Ð  T¨!¤W°Ò%7Ð%7Ø:>ˆF�3˜t™9œ9¨š>˜>�4�4¨t°A¬wÑ7Ñ7àŒH�OŠO�K¨¨dÑ3Ô3Ñ4Ô4Ð4Ñ4à”ð Lð LˆÝ�d�NÑ+Ô+ð 	LØ!œ^ÐG¨u¯yªy¸¼Ñ/GÔ/GˆDŒNˆNÝ˜Õ.Ñ/Ô/ð 	LØ!œ^ÐK¨v¯zªz¸$Ô:JÑ/KÔ/KˆDŒNøåÐAÐA¸¼ÐAÑAÔAÑAÔAð 
Àfð 
Ø&,§l¢l¡n¤nð 		ð 		Ñ"ˆK˜ØŒH�OŠOÝ ØØ'Ø $Ø!&Ø +ðñ ô ñô ð ð ð €Js   Å2,FÆ
GÆ)F=Æ=Gz    Ú	docstringÚrendering_styleÚindentc           	      ó  ‡‡— dt           j        t                   dt          fˆˆfd„}g }| j        r|                     | j        ¦  «         | j        r|                     d¦  «         | j        r|                     | j        ¦  «         | j        r|                     d¦  «         | j        D �]L}t          |t          ¦  «        rÓ|j        r|j        rd|j        › d�n
d|j        › d�}nd}‰t          j        k    rfd|j        › d�}| ||j        ¦  «        z  }|                     |¦  «         |d	d
…         r(|                     d|j        › d|d	d
…         › �¦  «         Œµd|› |j        › d�}| ||j        ¦  «        z  }|                     |¦  «         Œët          |t"          ¦  «        r±|j        r
d|j        › �nd}|j        rdnd}‰t          j        k    rQ|j        r.d|› d�}| ||j        ¦  «        z  }|                     |¦  «         |r|                     d|› �¦  «         �Œd|› |› d�}| ||j        ¦  «        z  }|                     |¦  «         �Œ±t          |t&          ¦  «        rB|j        rd|j        › d�nd}d|› d� ||j        ¦  «        z   }|                     |¦  «         �Œdd                     |j        ¦  «        › d� ||j        ¦  «        z   }|                     |¦  «         �ŒNd                     |¦  «        S )a  Render a parsed docstring into docstring text.

    :param docstring: parsed docstring representation
    :param rendering_style: the style to render docstrings
    :param indent: the characters used as indentation in the docstring string
    :returns: docstring text
    r   r   c                 óT  •— | sdS ‰t           j        k    r>|                      ¦   «         ^}}d                     d|z   gˆfd„|D ¦   «         z   ¦  «        S ‰t           j        k    rA|                      ¦   «         ^}}d                     d‰z   |z   gˆfd„|D ¦   «         z   ¦  «        S d| z   S )Nr4   r5   ú c                 ó   •— g | ]}‰|z   ‘ŒS © rh   ©r;   Úlinerc   s     €r.   ú
<listcomp>z1compose.<locals>.process_desc.<locals>.<listcomp>Å   s   ø€ Ð-MÐ-MÐ-MÀ¨f°t©mÐ-MÐ-MÐ-Mr0   c                 ó   •— g | ]}‰|z   ‘ŒS rh   rh   ri   s     €r.   rk   z1compose.<locals>.process_desc.<locals>.<listcomp>Ê   s   ø€ Ð*JÐ*JÐ*J¸T¨6°D©=Ð*JÐ*JÐ*Jr0   )r   ÚCLEANÚ
splitlinesÚjoinÚEXPANDED)r   Úfirstr_   rc   rb   s      €€r.   Úprocess_desczcompose.<locals>.process_desc¿   sÏ   ø€ Øð 	Ø�2à�nÔ2Ò2Ð2Ø!Ÿ_š_Ñ.Ô.ˆNˆU�TØ—9’9˜c E™k˜]Ð-MÐ-MÐ-MÐ-MÈÐ-MÑ-MÔ-MÑMÑNÔNÐNà�nÔ5Ò5Ð5Ø!Ÿ_š_Ñ.Ô.ˆNˆU�TØ—9’9Ø˜‘ Ñ&Ð'Ð*JÐ*JÐ*JÐ*JÀTÐ*JÑ*JÔ*JÑJñô ð ð �T‰zÐr0   r4   rf   z? z:param r6   Nr   z:type z:paramÚyieldsÚreturnsz:rtype:z:raisesr5   )ÚTÚOptionalÚstrrE   rP   rG   rJ   rH   rO   r:   r   r   r    r   rp   r   r   r   r"   r   ro   r   )	ra   rb   rc   rr   rW   rO   Ú	type_textr1   r-   s	    ``      r.   Úcomposery   ²   s¥  øø€ ð�1œ:¥cœ?ð ­sð ð ð ð ð ð ð ð  €EØÔ"ð 2Ø�Š�YÔ0Ñ1Ô1Ð1ØÔ.ð Ø�Š�RÑÔÐØÔ!ð 1Ø�Š�YÔ/Ñ0Ô0Ð0ØÔ-ð Ø�Š�RÑÔÐà”ð )ñ )ˆÝ�d�NÑ+Ô+ð (	ØŒ~ð  ð Ô'ð/Ð*˜œÐ*Ð*Ð*Ð*à.˜Tœ^Ð.Ð.Ð.ð �	ð  �	Ø¥.Ô"9Ò9Ð9Ø1 ¤Ð1Ð1Ð1�Ø˜˜ TÔ%5Ñ6Ô6Ñ6�Ø—’˜TÑ"Ô"Ð"Ø˜S˜b˜S”>ð LØ—L’LÐ!J¨$¬-Ð!JÐ!J¸)ÀCÀRÀC¼.Ð!JÐ!JÑKÔKÐKøà; 	Ð;¨4¬=Ð;Ð;Ð;�Ø˜˜ TÔ%5Ñ6Ô6Ñ6�Ø—’˜TÑ"Ô"Ð"Ð"Ý˜Õ.Ñ/Ô/ð 	Ø04´ÐFÐ,˜DœNÐ,Ð,Ð,ÀBˆIØ"Ô/Ð>�(�(°YˆCà¥.Ô"9Ò9Ð9ØÔ#ð 'Ø%˜s˜:˜:˜:�DØ˜L˜L¨Ô)9Ñ:Ô:Ñ:�DØ—L’L Ñ&Ô&Ð&Øð 8Ø—L’LÐ!6¨9Ð!6Ð!6Ñ7Ô7Ð7ùà,˜3Ð, 	Ð,Ð,Ð,�Ø˜˜ TÔ%5Ñ6Ô6Ñ6�Ø—’˜TÑ"Ô"Ð"Ñ"Ý˜�oÑ.Ô.ð 	Ø15´ÐGÐ-˜DœNÐ-Ð-Ð-Ð-ÀRˆIØ)˜YÐ)Ð)Ð)¨L¨L¸Ô9IÑ,JÔ,JÑJˆDØ�LŠL˜ÑÔÐÑà-�s—x’x ¤	Ñ*Ô*Ð-Ð-Ð-°°¸TÔ=MÑ0NÔ0NÑNˆDØ�LŠL˜ÑÔÐÑØ�9Š9�UÑÔÐr0   )Ú__doc__r@   r&   Útypingru   Úcommonr   r   r   r   r   r	   r
   r   r   r   r   r   r   r   ÚListrw   r/   rv   r`   ÚCOMPACTry   rh   r0   r.   ú<module>r      sŒ  ðØ #Ð #à €€€Ø 	€	€	€	Ø Ð Ð Ð ðð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð$J6�a”f˜S”kð J6¨ð J6°ð J6ð J6ð J6ð J6ðZI�”
˜3”ð I Ið Ið Ið Ið Ið\ '5Ô&<ØðQð QØðQà#ðQð ðQð 	ð	Qð Qð Qð Qð Qð Qr0   