+
    ~j$                         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 R R ltR R lt]P                   R3R R	 lltR# )
z^Epyoc-style docstring parsing.

.. seealso:: http://epydoc.sourceforge.net/manual-fields.html
N)	DocstringDocstringMetaDocstringParamDocstringRaisesDocstringReturnsDocstringStyle
ParseErrorRenderingStylec                Z    V ^8  d   QhR\         R\        P                  \         ,          /# )   stringreturn)strTOptional)formats   "l/Users/mitch_tango/dev/rabbit-r1-livekit/agent/.venv/lib/python3.14/site-packages/docstring_parser/epydoc.py__annotate__r      s"      s qzz#     c                 J    V P                  4       p \        V 4      ^ 8  d   V # R# )    N)striplen)r   s   &r   
_clean_strr      s     \\^F
6{Qr   c                Z    V ^8  d   QhR\         P                  \        ,          R\        /# )r   textr   )r   r   r   r   )r   s   "r   r   r      s&     s s

3 sI s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$                  ! R4      p\
        P$                  ! R	4      p\
        P$                  ! R
4      p	\
        P$                  ! R4      p
\
        P$                  ! R4      p. p\
        P&                  ! RV\
        P(                  \
        P                  ,          R7       EF  pVP+                  ^ 4      pV'       g   K  \
        P                  ! W}4      p\
        P                  ! W4      p\
        P                  ! W4      p\
        P                  ! W4      p\
        P                  ! W4      pT;'       g!    T;'       g    T;'       g    T;'       g    TpV'       g   \-        RV R24      hWP/                  4       R pV'       d6   RpVP+                  ^4      pVP+                  ^4      P!                  4       .pEMV'       d5   RpVP+                  ^4      pVP+                  ^4      P!                  4       .pMV'       dJ   RpVP+                  ^4      pVP+                  ^4      f   . MVP+                  ^4      P!                  4       .pMV'       d   RpVP+                  ^4      p. pMnRpVP+                  ^4      p\1        VP+                  ^4      P!                  4       4      pVf   . M\
        P                  ! RV4      pVR$9   d   \-        RV R24      hVP!                  4       pRV9   d:   VP                  R^4      w  ppVR,           \        P                  ! V4      ,           pVP3                  VVVV34       EK  	  / pV Fu  w  ppppVR%9  d   K  T;'       g    R&w  pVP5                  V/ 4      pRV9   d   RMRpVVV&   VR8X  g   KJ  VR'9   pVP5                  RV4      V8w  g   Kh  \-        RV R24      h	  / pV EF  w  ppppVR(9   d   VP7                  V^ ,          R4      '       g   Vw  pVV,          pVP7                  R4      p V '       d    V P                  R4      '       d	   Rp!V RR) p MRp!\
        P8                  ! RV\
        P:                  R7      pV'       d!   VP+                  ^4      P=                  R4      MRp"\?        VV.VP7                  R4      VV V!V"R 7      p#RVV&   MVR8X  df   VP7                  RR4      '       gN   VR,          p\A        V.VP7                  R4      VP7                  R4      VP7                  RR4      R!7      p#RVR&   MtVR8X  d&   T;'       g    R*w  p \C        V.V,           VV R"7      p#MHVR8X  d   \E        V.V,           VR#7      p#M+T;'       g    R&vpp$VP7                  VR4      '       g   Q hEK  VPF                  P3                  V#4       EK  	  V# )+zRParse the epydoc-style docstring into its components.

:returns: parsed docstring
)stylez^@)flagsN 
z

z-(param|keyword|type)(\s+[_A-z][_A-z0-9]*\??):z((ivar|cvar|var)(\s+[_A-z][_A-z0-9]*\??):z!(raise)(\s+[_A-z][_A-z0-9]*\??)?:z(return|rtype|yield|ytype):z.([_A-z][_A-z0-9]+)((\s+[_A-z][_A-z0-9]*\??)*):z(^@.*?)(?=^@|\Z)z%Error parsing meta information near "z".param	attributeraiser   metaz\s+type	type_namedescriptionis_generatorz$Error parsing meta information for "F?Tz.*defaults to (.+).)argsr'   arg_namer&   is_optionaldefault)r+   r'   r&   r(   )r+   r'   r&   )r+   r'   )
r!   ivarcvarvarkeywordr%   r   rtypeyieldytype)r!   r"   r   )r   >   r4   r5   )r!   r"   )N)$r   r   EPYDOCinspectcleandocresearchMstartsplitshort_descriptionr   
startswithblank_after_short_descriptionendswithblank_after_long_descriptionr   long_descriptioncompilefinditerSgroupr   endr   append
setdefaultgetmatchDOTALLrstripr   r   r   r   r$   )%r   retrM   
desc_chunk
meta_chunkpartslong_desc_chunkparam_patternattribute_patternraise_patternreturn_patternmeta_patternstreamchunkparam_matchattribute_matchraise_matchreturn_match
meta_matchbasekeyr+   tokendesc
first_linerestparamsr,   infoinfo_keyr(   is_doner&   r-   r.   	meta_item_s%   &                                    r   parserm      s0   
 .//
0C
D!DIIdD-E/EKKM*
++-/*


T1%E!!H,,C
5zA~(..b,;,F,Ft,L)+:+C+CF+K(.446>>$JJ8M 

#NOJJCDMZZ >?N::9L
 ;=FZrttbdd{  Aii5))$5=ii5yy7YY|3
         	 DUG2NOO99;=)
D{{1~CKKN((*+DD{{1~CKKN((*+DD{{1~CQ/2ekk!n6J6J6L5MDD{{1~CDD{{1~Cu{{1~3356E2BHHVU,CD    !;E7"E  !4<#zz$2J$w'7'7'==DtS$-.IN /1F!'c477))k  2."(C-;]X8"44L~|<L :8*BG  "(  "$G!'c4))'++d1gu2M2MKX(#D-IY//44"%crN	#HH2D		JE49ekk!n++C0tG&8_ HH]3!#'I !%GHXgkk(E&B&B(#D(U HH]3((;/!XXne<	I !%GHW_??7LY'UT\ #I
 V^%UT\ I
 ++IS1;;sE****	"e "(h Jr   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     I II#I I 		I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      '       d   VP                  '       d^   VP                  '       d   VP                   R2MVP                  pRVP                   R2pWs! VR4      ,          pVP                  V4       RVP                   R2V! VP                  R	4      ,           pVP                  V4       K  \        V\        4      '       d   VP                  '       d   RMRw  rVP                  '       d0   R
V	 R2V! VP                  R4      ,           pVP                  V4       VP                  '       d3   R
V R2V! VP                  R	4      ,           pVP                  V4       EKw  EKz  \        V\        4      '       dR   VP                  '       d   RVP                   R2MRpWs! VP                  R	4      ,          pVP                  V4       EK  R
RP                  VP                   4       R2pWs! VP                  R	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                f    V ^8  d   QhR\         P                  \        ,          R\        R\        /# )r   rd   is_typer   )r   r   r   bool)r   s   "r   r   compose.<locals>.__annotate__   s.     K K1::c? KT Kc Kr   c                   < V '       g   R # S\         P                  8X  g   S\         P                  8X  dX   V'       gP   V P                  4       vr#RP	                  RS,           V,           .V Uu. uF  pSV,           NK  	  up,           4      # V P                  4       vr#RP	                  RV,           .V Uu. uF  pSV,           NK  	  up,           4      # u upi u upi )r   r     )r	   EXPANDEDCLEAN
splitlinesjoin)rd   rt   firstrf   linerq   rp   s   &&   r   process_desccompose.<locals>.process_desc   s    n555~333G!__.NU99&'T*JTT6D==T*JJ  *yy#+D)IDD&4--D)IIJJ	 +K *Js   .C
6C
r   r)   z@type :Tz@param F@z@raise z@raise:rx   r    )r4   r5   )r   r3   )r?   rJ   rA   rD   rC   r$   
isinstancer   r&   r-   r,   r'   r   r(   r   r|   r+   )
ro   rp   rq   r   rS   r$   r&   r   arg_keytype_keys
   &ff       r   composer      su   K K E"""Y001...R!!!Y//0---RdN++~~~ ''' ~~&a( 
  a0Y55T"T]]O1-  %1 D LL.// $$$ #(  W
 ~~~8*Adnnd)KKT"7)1~T5E5Eu(MMT"   o..26...WT^^,A.iDL!1!1599DLLsxx		*+1-DL!1!1599DLLE F 99Ur   )__doc__r8   r:   typingr   commonr   r   r   r   r   r   r   r	   r   rm   COMPACTr    r   r   <module>r      sJ   
  	 	 	 	sp '5&<&<I Ir   