+
    Ri"                         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   "V/home/ubuntu/hermes-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                0    V ^8  d   QhR\         R\        /# )r   textr   )r   r   )r   s   "r   r   r      s     d d d	 d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\
        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T;'       g    T;'       g    T;'       g    TpV'       g   \-        RV R24      hWP/                  4       R p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KA  	  / 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8X  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!(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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!   keywordr$   r   rtypeyieldytype)r!   r   )r   >   r0   r1   )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   retrI   
desc_chunk
meta_chunkpartslong_desc_chunkparam_patternraise_patternreturn_patternmeta_patternstreamchunkparam_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   parserg      s   
 .//
0C
D!DIIdD-E/EKKM*
++-/*


T1%E!!H,,C
5zA~(..b,;,F,Ft,L)+:+C+CF+K(.446>>$JJ8M JJCDMZZ >?N::9L
 ;=FZrttbdd{  Aii5ii5yy7YY|3
HH{HHlHHjDUG2NOO99;=)
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$-.mr /1F!'c4**))k  2."(C-;]X8"44L~|<L :8*BG  "(  "$G!'c47?7;;tAw#>#>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   r^   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)r^   rn   firstr`   linerk   rj   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:rr   r    )r0   r1   )r   r/   )r;   rF   r=   r@   r?   r#   
isinstancer   r%   r,   r+   r&   r   r'   r   rv   r*   )
ri   rj   rk   ry   rO   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__r4   r6   typingr   commonr   r   r   r   r   r   r   r	   r   rg   COMPACTr    r   r   <module>r      sJ   
  	 	 	 	dR '5&<&<I Ir   