Ë
    >²Xjm   ã            	       óê   — 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j2                  dfdedededefd„Zy)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                 ó¬  — | d   }|t         v r²t        | «      dk(  r"| \  }}}|j                  d«      rd}|d d }n*d}n't        | «      dk(  r
| \  }}d }d }nt        d|› d	�«      ‚t	        j
                  d
|t        j                  ¬«      }|r |j                  d«      j                  d«      nd }t        | |||||¬«      S |t        t        z  v rIt        | «      dk(  r| d   }n t        | «      dk(  rd }nt        d|› d	�«      ‚t        | |||t        v ¬«      S |t        v r_t	        j                  d|t        j                  ¬«      }t!        | |r|j                  d«      nd |r|j                  d«      ¬«      S |¬«      S |t"        v rBt        | «      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           ú[/var/www/html/content_generation/venv/lib/python3.12/site-packages/docstring_parser/rest.pyÚ_build_metar/      s  € Ø
ˆq‰'€Cà
ŒnÑÜˆt‹9˜Š>Ø'+Ñ$ˆC�˜HØ×!Ñ! #Ô&Ø"�Ø% c r˜N‘	à#‘Ü�‹Y˜!Š^Ø ‰MˆC�ØˆIØ‰KäØ6°s°e¸9ÐEóð ô —‘Ð.°¼B¿I¹IÔFˆÙ05�%—+‘+˜a“.×'Ñ'¨Ô,¸4ˆäØØØØØ#Øô
ð 	
ð Ô¤Ñ0Ñ0Üˆt‹9˜Š>Ø˜Q™‰IÜ�‹Y˜!Š^Ø‰IäØ5°c°U¸)ÐDóð ô  ØØØØ¤Ð/ô	
ð 	
ð Ô"Ñ"Ü—	‘	ØFØÜ—$‘$ô
ˆô
 #ØÙ.3�E—K‘K 	Ô*¸Ù/4˜Ÿ™ FÓ+ô
ð 	
ð ;?ô
ð 	
ð ŒoÑÜˆt‹9˜Š>Ø˜Q™‰IÜ�‹Y˜!Š^Ø‰IäØ5°c°U¸)ÐDóð ô Ø 4°9ô
ð 	
ô ˜d°Ô5Ð5ó    Útextc           
      óª  — t        t        j                  ¬«      }| s|S t        j                  | «      } t        j                  d| t
        j                  ¬«      }|r'| d|j                  «        }| |j                  «       d }n| }d}|j                  dd«      }|d   xs d|_
        t        |«      dkD  rN|d   xs d}|j                  d«      |_        |j                  d	«      |_        |j!                  «       xs d|_        i }i }t        j$                  d
|t
        j&                  t
        j                  z  ¬«      D �]  }|j)                  d«      }	|	sŒ	 |	j+                  d«      j                  dd«      \  }
}|
j                  «       }|j!                  «       }d|v r0|j                  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   <   ŒÞ|j0                  j3                  t5        ||«      «       �Œ |j0                  D ]€  }t7        |t8        «      r/|j:                  xs |j=                  |j>                  «      |_        ŒBt7        |t@        «      sŒS|j:                  xs |j=                  |jB                  «      |_        Œ‚ tE        d„ |j0                  D «       «      sC|rA|jG                  «       D ].  \  }}|j0                  j3                  tA        g |dd|¬«      «       Œ0 |S # t,        $ r}t/        d|	› d�«      |‚d}~ww xY w)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        «      –— Œ y ­w)N)Ú
isinstancer   )Ú.0Úms     r.   Ú	<genexpr>zparse.<locals>.<genexpr>£   s   è ø€ ÐA¹°1Œz˜!Ô-×.¹ùs   ‚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‰I�d˜D¬¯©Ô-€EÙØ˜/˜EŸK™K›MÐ*ˆ
Ø˜%Ÿ+™+›-˜/Ð*‰
àˆ
Øˆ
à×Ñ˜T 1Ó%€EØ! !™HÒ,¨€CÔÜ
ˆ5ƒz�A‚~Ø ™(š. bˆØ,;×,FÑ,FÀtÓ,LˆÔ)Ø+:×+CÑ+CÀFÓ+KˆÔ(Ø.×4Ñ4Ó6Ò>¸$ˆÔà€EØ€FÜ—‘Ø˜Z¬r¯t©t´b·d±d©{÷ð ˆð —‘˜A“ˆÙØð	Ø%*§\¡\°#Ó%6×%<Ñ%<¸SÀ!Ó%DÑ"ˆJ˜
ð
 ×ÑÓ!ˆØ×ÑÓ!ˆà�4‰<Ø#Ÿz™z¨$°Ó2ÑˆJ˜Ø Ñ$¤w×'7Ñ'7¸Ó'=Ñ=ˆDô ˆt‹9˜Š>˜d 1™g¨Ò/Ø!ˆE�$�q‘'ŠNÜ�‹Y˜&Ñ  T¨!¡W°Ò%7Ø:>ˆFœ3˜t›9¨š>‘4¨t°A©wÒ7à�H‰H�O‰OœK¨¨dÓ3Ö4ð3ð6 —”ˆÜ�dœNÔ+Ø!Ÿ^™^ÒG¨u¯y©y¸¿¹Ó/GˆD�NÜ˜Ô.Õ/Ø!Ÿ^™^ÒK¨v¯z©z¸$×:JÑ:JÓ/KˆD�Nð	 ô ÑA¸¿ºÓAÔAÁfØ&,§l¡l¦nÑ"ˆK˜Ø�H‰H�O‰OÜ ØØ'Ø $Ø!&Ø +ôõð '5ð €JøôK ò 	ÜØ7¸°w¸bÐAóàðûð	ús   Å$L4Ì4	MÌ=MÍMz    Ú	docstringÚrendering_styleÚindentc           	      óx  ‡‡— dt         j                  t           dt        fˆˆfd„}g }| j                  r|j	                  | j                  «       | j
                  r|j	                  d«       | j                  r|j	                  | j                  «       | j                  r|j	                  d«       | j                  D �]j  }t        |t        «      rè|j                  r-|j                  rd|j                  › d�nd|j                  › d�}nd}‰t        j                  k(  rad|j                  › d�}| ||j                   «      z  }|j	                  |«       |d	d
 sŒž|j	                  d|j                  › d|d	d
 › �«       ŒÃd|› |j                  › d�}| ||j                   «      z  }|j	                  |«       Œüt        |t"        «      rÂ|j                  rd|j                  › �nd}|j$                  rdnd}‰t        j                  k(  rR|j                   r,d|› d�}| ||j                   «      z  }|j	                  |«       |s�Œˆ|j	                  d|› �«       �Œžd|› |› d�}| ||j                   «      z  }|j	                  |«       �ŒÎt        |t&        «      rJ|j                  rd|j                  › d�nd}d|› d� ||j                   «      z   }|j	                  |«       �Œ(ddj)                  |j*                  «      › d� ||j                   «      z   }|j	                  |«       �Œm dj)                  |«      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                 óf  •— | sy‰t         j                  k(  r;| j                  «       ^}}dj                  d|z   g|D �cg c]  }‰|z   ‘Œ	 c}z   «      S ‰t         j                  k(  r>| j                  «       ^}}dj                  d‰z   |z   g|D �cg c]  }‰|z   ‘Œ	 c}z   «      S d| z   S c c}w c c}w )Nr4   r5   Ú )r   ÚCLEANÚ
splitlinesÚjoinÚEXPANDED)r   Úfirstr_   Úlinerc   rb   s       €€r.   Úprocess_desczcompose.<locals>.process_desc¿   sÂ   ø€ ÙØàœn×2Ñ2Ò2Ø!Ÿ_™_Ó.ˆNˆU�TØ—9‘9˜c E™k˜]ÉÓ-MÉÀ¨f°t«mÈÑ-MÑMÓNÐNàœn×5Ñ5Ò5Ø!Ÿ_™_Ó.ˆNˆU�TØ—9‘9Ø˜‘ Ñ&Ð'ÁTÓ*JÁT¸T¨6°D«=ÀTÑ*JÑJóð ð �T‰zÐùò .Nùò
 +Ks   ¾B)
ÂB.
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   rj   r   r   r   r"   r   ri   r   )	ra   rb   rc   rm   rW   rO   Ú	type_textr1   r-   s	    ``      r.   Úcomposert   ²   sß  ù€ ðœ1Ÿ:™:¤c™?ð ¬sö ð  €EØ×"Ò"Ø�‰�Y×0Ñ0Ô1Ø×.Ò.Ø�‰�RÔØ×!Ò!Ø�‰�Y×/Ñ/Ô0Ø×-Ò-Ø�‰�RÔà—•ˆÜ�dœNÔ+Ø�~Š~ð ×'Ò'ð ˜Ÿ™Ð' rÑ*à˜TŸ^™^Ð,¨AÐ.ñ ð  �	Ø¤.×"9Ñ"9Ò9Ø  §¡ ¨qÐ1�Ø™ T×%5Ñ%5Ó6Ñ6�Ø—‘˜TÔ"Ø˜S˜b’>Ø—L‘L 6¨$¯-©-¨¸¸)ÀCÀR¸.Ð9IÐ!JÕKà 	˜{¨4¯=©=¨/¸Ð;�Ø™ T×%5Ñ%5Ó6Ñ6�Ø—‘˜TÕ"Ü˜Ô.Ô/Ø04·²˜!˜DŸN™NÐ+Ñ,ÀBˆIØ"×/Ò/‘(°YˆCà¤.×"9Ñ"9Ò9Ø×#Ò#Ø˜s˜e 1˜:�DØ™L¨×)9Ñ)9Ó:Ñ:�DØ—L‘L Ô&ÛØ—L‘L 7¨9¨+Ð!6Ö7à˜3˜% 	˜{¨!Ð,�Ø™ T×%5Ñ%5Ó6Ñ6�Ø—‘˜TÖ"Ü˜œoÔ.Ø15·²˜!˜DŸN™NÐ+¨1Ñ-ÀRˆIØ˜Y˜K qÐ)©L¸×9IÑ9IÓ,JÑJˆDØ�L‰L˜Öà�s—x‘x §	¡	Ó*Ð+¨1Ð-±¸T×=MÑ=MÓ0NÑNˆDØ�L‰L˜ÖðS ðT �9‰9�UÓÐr0   )Ú__doc__r@   r&   Útypingrp   Úcommonr   r   r   r   r   r	   r
   r   r   r   r   r   r   r   ÚListrr   r/   rq   r`   ÚCOMPACTrt   © r0   r.   Ú<module>r{      s§   ðÙ #ã Û 	Û ÷÷ ÷ ÷ ð$J6�a—f‘f˜S‘kð J6¨ð J6°ó J6ðZI�—
‘
˜3‘ð I Ió Ið\ '5×&<Ñ&<ØñQØðQà#ðQð ðQð 	ô	Qr0   