+
    ~jm                          R t ^ RIt^ RIt^ RIt^RIHtHtHtH	t	H
t
HtHtHtHtHtHtHtHtHt R R ltR R lt]P,                  R3R R	 lltR# )
zReST-style docstring parsing.N)DEPRECATION_KEYWORDSPARAM_KEYWORDSRAISES_KEYWORDSRETURNS_KEYWORDSYIELDS_KEYWORDS	DocstringDocstringDeprecatedDocstringMetaDocstringParamDocstringRaisesDocstringReturnsDocstringStyle
ParseErrorRenderingStylec                f    V ^8  d   QhR\         P                  \        ,          R\        R\        /# )   argsdescreturn)TListstrr	   )formats   "j/Users/mitch_tango/dev/rabbit-r1-livekit/agent/.venv/lib/python3.14/site-packages/docstring_parser/rest.py__annotate__r      s.     J6 J6affSk J6 J6 J6    c           	      *   V ^ ,          pV\         9   d   \        V 4      ^8X  d(   V w  r#pVP                  R4      '       d	   RpVRR pM+RpM(\        V 4      ^8X  d
   V w  r$RpRpM\        RV R24      h\        P
                  ! RV\        P                  R7      pV'       d!   VP                  ^4      P                  R	4      MRp\        V VVVVVR
7      # V\        \        ,          9   dS   \        V 4      ^8X  d   V ^,          pM"\        V 4      ^8X  d   RpM\        RV R24      h\        V VVV\        9   R7      # V\        9   dm   \        P                  ! RV\        P                  R7      p\!        T V'       d   VP                  R4      MRV'       d   VP                  R4      R7      # TR7      # V\"        9   dJ   \        V 4      ^8X  d   V ^,          pM"\        V 4      ^8X  d   RpM\        RV R24      h\%        WVR7      # \'        WR7      # )    ?TNFz$Expected one or two arguments for a z	 keyword.z.*defaults to (.+)flags.)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   &&      r   _build_metar4      s   
q'C
nt9>'+$CH!!#&&"%crN	#Y!^ MCIK6se9E  .BIIF05%++a.'',4#
 	
 00t9>QIY!^I5cU)D   /	
 	
 ""		F$$

 #.3EKK	*/4F+
 	
 ;?
 	
 ot9>QIY!^I5cU)D  9
 	
 d55r   c                Z    V ^8  d   QhR\         P                  \        ,          R\        /# )r   textr   )r   Optionalr   r   )r   s   "r   r   r   f   s&     I I

3 II Ir   c                   \        \        P                  R7      pV '       g   V# \        P                  ! V 4      p \
        P                  ! RV \
        P                  R7      pV'       d'   V RVP                  4        pWP                  4       R pMT pRpVP                  R^4      pV^ ,          ;'       g    RVn
        \        V4      ^8  d_   V^,          ;'       g    RpVP                  R4      Vn        VP                  R4      Vn        VP!                  4       ;'       g    RVn        / p/ p\
        P$                  ! RV\
        P&                  \
        P                  ,          R7       EF/  pVP)                  ^ 4      p	V	'       g   K   V	P+                  R	4      P                  R	^4      w  rT
P                  4       pTP!                  4       pRT9   d9   TP                  R^4      w  rTR,           \        P                  ! T4      ,           p\        T4      ^8X  d   T^ ,          R8X  d   YT^,          &   K  \        T4      R9   d/   T^ ,          R8X  d!   Y\        T4      ^8X  d   RMT^,          &   EK  TP0                  P3                  \5        Y4      4       EK2  	  VP0                   F  p\7        V\8        4      '       d7   VP:                  ;'       g    VP=                  VP>                  4      Vn        KO  \7        V\@        4      '       g   Kg  VP:                  ;'       g    VP=                  VPB                  4      Vn        K  	  \D        ;QJ d&    R VP0                   4       F  '       g   K   RM	  RM! R VP0                   4       4      '       gL   V'       dD   VPG                  4        F/  w  ppVP0                  P3                  \A        . VRRVR7      4       K1  	  V#   \,         d   p\/        R
T	 R24      ThRp?ii ; i)zPParse the ReST-style docstring into its components.

:returns: parsed docstring
)stylez^:r   N 
z

z(^:.*?)(?=^:|\Z):z%Error parsing meta information near "z".typertypec              3   B   "   T F  p\        V\        4      x  K  	  R # 5i)N)
isinstancer   ).0ms   & r   	<genexpr>parse.<locals>.<genexpr>   s     A1z!-..s   TF)r   r$   r"   r'   return_name)   r   )$r   r   RESTinspectcleandocr,   r1   Mstartsplitshort_descriptionr*   
startswithblank_after_short_descriptionr+   blank_after_long_descriptionstriplong_descriptionfinditerSr/   lstrip
ValueErrorr   metaappendr4   r@   r
   r$   getr#   r   rE   anyitems)r6   retr-   
desc_chunk
meta_chunkpartslong_desc_chunktypesrtypeschunk
args_chunkexr   r   
first_linerestrW   rE   r$   s   &                  r   parserh   f   s"   
 .--
.C
D!DIIdD-E/EKKM*
++-/*


T1%E!!H,,C
5zA~(..b,;,F,Ft,L)+:+C+CF+K(.446>>$EFZrttbdd{  A	%*\\#%6%<%<S!%D"J
 !!4<#zz$2J$w'7'7'==D t9>d1g/!$q'NY& T!W%7:>3t9>4tAw7HHOOK3436 dN++!^^GGuyy/GDN.//!^^KKvzz$:J:J/KDN	  3AA333AAAAf&,lln"KHHOO ' $!& + '5 JK  	7wbA	s   #O&&P1PPz    c                H    V ^8  d   QhR\         R\        R\        R\        /# )r   	docstringrendering_styleindentr   )r   r   r   )r   s   "r   r   r      s6     Q QQ#Q Q 		Qr   c           	     >  aa R VV3R llp. pV P                   '       d   VP                  V P                   4       V P                  '       d   VP                  R4       V P                  '       d   VP                  V P                  4       V P                  '       d   VP                  R4       V P
                   EF  p\        V\        4      '       Ed   VP                  '       d4   VP                  '       d   RVP                   R2MRVP                   R2pMRpS\        P                  8X  dm   RVP                   R2pWs! VP                  4      ,          pVP                  V4       VRR '       d'   VP                  R	VP                   RVRR  24       K  K  R
V VP                   R2pWs! VP                  4      ,          pVP                  V4       EK!  \        V\        4      '       d   VP                  '       d   RVP                   2MRpVP                  '       d   RMRpS\        P                  8X  dd   VP                  '       d0   RV R2pWs! VP                  4      ,          pVP                  V4       V'       d   VP                  RV 24       EK  EK  RV V R2pWs! VP                  4      ,          pVP                  V4       EK  \        V\         4      '       dV   VP                  '       d   RVP                   R2MRpRV R2V! VP                  4      ,           pVP                  V4       EK  RRP#                  VP$                  4       R2V! VP                  4      ,           pVP                  V4       EK  	  RP#                  V4      # )zRender 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
c                Z    V ^8  d   QhR\         P                  \        ,          R\        /# )r   r   r   )r   r7   r   )r   s   "r   r   compose.<locals>.__annotate__   s"      1::c? s r   c                   < V '       g   R # S\         P                  8X  dI   V P                  4       vrRP                  RV,           .V Uu. uF  pSV,           NK  	  up,           4      # S\         P                  8X  dP   V P                  4       vrRP                  RS,           V,           .V Uu. uF  pSV,           NK  	  up,           4      # RV ,           # u upi u upi )r:   r;    )r   CLEAN
splitlinesjoinEXPANDED)r   firstrg   linerl   rk   s   &   r   process_desccompose.<locals>.process_desc   s    n222!__.NU99cEk]-Mftmm-MMNNn555!__.NU99&'T*JTT6D==T*JJ  Tz .N
 +Ks   
C
.C
r:   rq   z? z:param r<   Nz:type z:paramyieldsreturnsz:rtype:z:raisesr;   r)   )rM   rX   rO   rR   rP   rW   r@   r
   r$   r%   r   ru   r#   r"   r   r'   r   rt   r   )	rj   rk   rl   rx   r_   rW   	type_textr6   r3   s	   &ff      r   composer}      s       E"""Y001...R!!!Y//0---RdN++~~~ ''' 'r*T^^,A.   	."9"99 q1T%5%566T"Sb>LL6$--)CR.9I!JK "  	{4==/;T%5%566T".//04!DNN+,BI"///(YC."9"99###se1:DL)9)9::DLL&LL79+!67  3%	{!,T%5%566T"o..15!DNN+1-RIYKq)L9I9I,JJDLLsxx		*+1-T=M=M0NNDLLS T 99Ur   )__doc__rH   r,   typingr   commonr   r   r   r   r   r   r   r	   r
   r   r   r   r   r   r4   rh   COMPACTr}    r   r   <module>r      sM    #  	    $J6ZI\ '5&<&<Q Qr   