+
    ~j                     J   R t ^ RIt^ RIt0 Rmt0 RmtRR0tRR0tRR0tRR	0t	 ! R
 R]
4      t ! R R]P                  4      t ! R R]P                  4      t ! R R4      t ! R R]4      t ! R R]4      t ! R R]4      t ! R R]4      t ! R R]4      t ! R R4      tR# ) zCommon methods for parsing.Ndeprecation
deprecatedreturnreturnsyieldyieldsexampleexamplesc                       ] tR t^tRtRtR# )
ParseErrorz*Base class for all parsing related errors. N)__name__
__module____qualname____firstlineno____doc____static_attributes__r       l/Users/mitch_tango/dev/rabbit-r1-livekit/agent/.venv/lib/python3.14/site-packages/docstring_parser/common.pyr   r      s    4r   r   c                   .    ] tR t^tRt^t^t^t^t^t	Rt
R# )DocstringStylezDocstring style.r   N)r   r   r   r   r   RESTGOOGLENUMPYDOCEPYDOCAUTOr   r   r   r   r   r      s    DFHFDr   r   c                   &    ] tR t^$tRt^t^t^tRtR# )RenderingStylez1Rendering style when unparsing parsed docstrings.r   N)	r   r   r   r   r   COMPACTCLEANEXPANDEDr   r   r   r   r   r   $   s    ;GEHr   r   c                   6   a  ] tR t^,t o RtV 3R lR ltRtV tR# )DocstringMetazDocstring meta information.

Symbolizes lines in form of

    :param arg: description
    :raises ValueError: if something happens
c                r   < V ^8  d   QhRS[ P                  S[,          RS[ P                  S[,          RR/# )   argsdescriptionr   NTListstrOptional)format__classdict__s   "r   __annotate__DocstringMeta.__annotate__5   s5     ' 'FF3K'./jjo'	'r   c                    Wn         W n        R# )a  Initialize self.

:param args: list of arguments. The exact content of this variable is
    dependent on the kind of docstring; it's used to distinguish
    between custom docstring meta information items.
:param description: associated docstring description.
Nr%   r&   )selfr%   r&   s   &&&r   __init__DocstringMeta.__init__5   s     	&r   r1   N)r   r   r   r   r   r3   r   __classdictcell__r-   s   @r   r"   r"   ,   s     ' 'r   r"   c                   B   a a ] tR t^Ct oRtV3R lV 3R lltRtVtV ;t# )DocstringParamz*DocstringMeta symbolizing :param metadata.c                   < V ^8  d   QhRS[ P                  S[,          RS[ P                  S[,          RS[RS[ P                  S[,          RS[ P                  S[,          RS[ P                  S[,          RR/# )	r$   r%   r&   arg_name	type_nameis_optionaldefaultr   Nr(   r)   r*   r+   bool)r,   r-   s   "r   r.   DocstringParam.__annotate__F   sz      ffSk ZZ_ 	
 ::c? ZZ% C 
r   c                V   < \         SV `  W4       W0n        W@n        WPn        W`n        R# Initialize self.N)superr3   r:   r;   r<   r=   )r2   r%   r&   r:   r;   r<   r=   	__class__s   &&&&&&&r   r3   DocstringParam.__init__F   s'     	+ "&r   )r:   r=   r<   r;   	r   r   r   r   r   r3   r   r5   __classcell__rE   r-   s   @@r   r8   r8   C   s     4  r   r8   c                   F   a a ] tR t^Wt oRtRV3R lV 3R llltRtVtV ;t# )DocstringReturnsz7DocstringMeta symbolizing :returns or :yields metadata.c                   < V ^8  d   QhRS[ P                  S[,          RS[ P                  S[,          RS[ P                  S[,          RS[RS[ P                  S[,          RR/# )r$   r%   r&   r;   is_generatorreturn_namer   Nr>   )r,   r-   s   "r   r.   DocstringReturns.__annotate__Z   sg     ' 'ffSk' ZZ_' ::c?	'
 ' ZZ_' 
'r   c                J   < \         SV `  W4       W0n        W@n        WPn        R# rB   )rD   r3   r;   rM   rN   )r2   r%   r&   r;   rM   rN   rE   s   &&&&&&r   r3   DocstringReturns.__init__Z   s#     	+"(&r   )rM   rN   r;   NrG   rI   s   @@r   rK   rK   W   s     A' ' 'r   rK   c                   B   a a ] tR t^it oRtV3R lV 3R lltRtVtV ;t# )DocstringRaisesz+DocstringMeta symbolizing :raises metadata.c                   < V ^8  d   QhRS[ P                  S[,          RS[ P                  S[,          RS[ P                  S[,          RR/# )r$   r%   r&   r;   r   Nr'   )r,   r-   s   "r   r.   DocstringRaises.__annotate__l   sK     	' 	'ffSk	' ZZ_	' ::c?		'
 
	'r   c                >   < \         SV `  W4       W0n        W n        R# rB   )rD   r3   r;   r&   )r2   r%   r&   r;   rE   s   &&&&r   r3   DocstringRaises.__init__l   s     	+"&r   )r&   r;   rG   rI   s   @@r   rT   rT   i        5	' 	' 	'r   rT   c                   B   a a ] tR t^xt oRtV3R lV 3R lltRtVtV ;t# )DocstringDeprecatedz/DocstringMeta symbolizing deprecation metadata.c                   < V ^8  d   QhRS[ P                  S[,          RS[ P                  S[,          RS[ P                  S[,          RR/# )r$   r%   r&   versionr   Nr'   )r,   r-   s   "r   r.    DocstringDeprecated.__annotate__{   sK     	' 	'ffSk	' ZZ_	' C		'
 
	'r   c                >   < \         SV `  W4       W0n        W n        R# rB   )rD   r3   r]   r&   )r2   r%   r&   r]   rE   s   &&&&r   r3   DocstringDeprecated.__init__{        	+&r   )r&   r]   rG   rI   s   @@r   r[   r[   x   s     9	' 	' 	'r   r[   c                   B   a a ] tR t^t oRtV3R lV 3R lltRtVtV ;t# )DocstringExamplez+DocstringMeta symbolizing example metadata.c                   < V ^8  d   QhRS[ P                  S[,          RS[ P                  S[,          RS[ P                  S[,          RR/# )r$   r%   snippetr&   r   Nr'   )r,   r-   s   "r   r.   DocstringExample.__annotate__   sK     	' 	'ffSk	' C	' ZZ_		'
 
	'r   c                >   < \         SV `  W4       W n        W0n        R# rB   )rD   r3   re   r&   )r2   r%   re   r&   rE   s   &&&&r   r3   DocstringExample.__init__   ra   r   )r&   re   rG   rI   s   @@r   rc   rc      rY   r   rc   c                      a  ] tR t^t o RtRV 3R lR llt]V 3R lR l4       t]V 3R lR l4       t]V 3R	 lR
 l4       t	]V 3R lR l4       t
]V 3R lR l4       t]V 3R lR l4       t]V 3R lR l4       tRtV tR# )	Docstringz Docstring object representation.Nc                   < V ^8  d   QhRR/# )r$   r   Nr   )r,   r-   s   "r   r.   Docstring.__annotate__   s     
 
 

r   c                X    RV n         RV n        RV n        RV n        . V n        Wn        R# )rC   NF)short_descriptionlong_descriptionblank_after_short_descriptionblank_after_long_descriptionmetastyle)r2   rs   s   &&r   r3   Docstring.__init__   s0    
 "& $-2*,1)	
r   c                D   < V ^8  d   QhRS[ P                  S[,          /# r$   r   )r(   r+   r*   )r,   r-   s   "r   r.   rl      s      QZZ_ r   c                6   . 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'       g   R# RP	                  V4      # )zkReturn the full description of the function

Returns None if the docstring did not include any description
 N
)rn   appendrp   ro   join)r2   rets   & r   r&   Docstring.description   sp     !!!JJt--.111

2   JJt,,-yy~r   c                D   < V ^8  d   QhRS[ P                  S[,          /# rv   )r(   r)   r8   )r,   r-   s   "r   r.   rl      s      P P~. Pr   c                t    V P                    Uu. uF  p\        V\        4      '       g   K  VNK  	  up# u upi )z0Return a list of information on function params.)rr   
isinstancer8   r2   items   & r   paramsDocstring.params   s+     "&Oj~.NOOO   55c                D   < V ^8  d   QhRS[ P                  S[,          /# rv   )r(   r)   rT   )r,   r-   s   "r   r.   rl      s     
 
/ 
r   c                t    V P                    Uu. uF  p\        V\        4      '       g   K  VNK  	  up# u upi )zLReturn a list of information on the exceptions that the function
may raise.
)rr   r   rT   r   s   & r   raisesDocstring.raises   s4     "YY
&T*T?*KDDY
 	
 
r   c                D   < V ^8  d   QhRS[ P                  S[,          /# rv   )r(   r+   rK   )r,   r-   s   "r   r.   rl      s      $45 r   c                `    V P                    F  p\        V\        4      '       g   K  Vu # 	  R# )zUReturn a single information on function return.

Takes the first return information.
Nrr   r   rK   r   s   & r   r   Docstring.returns   s*     IID$ 011  r   c                D   < V ^8  d   QhRS[ P                  S[,          /# rv   )r(   r)   rK   )r,   r-   s   "r   r.   rl      s     
 
aff%56 
r   c                t    V P                    Uu. uF  p\        V\        4      '       g   K  VNK  	  up# u upi )z0Return a list of information on function return.r   r   s   & r   many_returnsDocstring.many_returns   5     "YY
&T*T;K*LDDY
 	
 
r   c                D   < V ^8  d   QhRS[ P                  S[,          /# rv   )r(   r+   r[   )r,   r-   s   "r   r.   rl      s      QZZ(;< r   c                `    V P                    F  p\        V\        4      '       g   K  Vu # 	  R# )z:Return a single information on function deprecation notes.N)rr   r   r[   r   s   & r   r   Docstring.deprecation   s*     IID$ 344  r   c                D   < V ^8  d   QhRS[ P                  S[,          /# rv   )r(   r)   rc   )r,   r-   s   "r   r.   rl      s     
 
!&&!12 
r   c                t    V P                    Uu. uF  p\        V\        4      '       g   K  VNK  	  up# u upi )z2Return a list of information on function examples.)rr   r   rc   r   s   & r   r	   Docstring.examples   r   r   )rq   rp   ro   rr   rn   rs   rR   )r   r   r   r   r   r3   propertyr&   r   r   r   r   r   r	   r   r5   r6   s   @r   rj   rj      s     *
 
  $ P P 
 
   
 
   
 
r   rj   >   argkeyparamkeywordargument	attribute	parameter>   raiseexceptr   	exception)r   enumtypingr(   PARAM_KEYWORDSRAISES_KEYWORDSDEPRECATION_KEYWORDSRETURNS_KEYWORDSYIELDS_KEYWORDSEXAMPLES_KEYWORDSRuntimeErrorr   Enumr   r   r"   r8   rK   rT   r[   rc   rj   r   r   r   <module>r      s    !   =%|4 i( H%
+ 5 5TYY TYY ' '.] ('} '$'m ''- ''} 'O
 O
r   