
    -hTz                       U d dl mZ d dlZd dlmZ d dlmZ d dlm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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 dl$m%Z%m&Z& d dl'm(Z(m)Z) d d	l*m+Z+ erd d
lm,Z, d dlm-Z-m.Z. d dl*m/Z/ d dl0m1Z1 e(j2        e(j3        e(j4        e(j5        e(j6        e(j7        e(j8        e(j9        e(j:        e(j;        e(j<        e(j<        e(j=        e(j>        dZ?djdZ@djdZAdddkdZBdld!ZCd"ZDdeEd#<   d$ZFdeEd%<   d&ZGdeEd'<   d(ZHdeEd)<    ejI        d*eG d+eH d,eG d-eH d.	ejJ        ejK        z            ZLd/eEd0<   eLZMd/eEd1<   eLZNd/eEd2<    ejI        d3eG d4eG d5eD d6eF d7eH d8ejJ        ejK        z            ZOd/eEd9<    ejI        d:          ZPd/eEd;<    ejI        d<          ZQd/eEd=<   ddd>dmdAZRdddndCZSddd>dodEZTdddpdGZUdddqdIZVdddrdKZWdddsdMZXdddtdOZYdddudQZZdddvdSZ[dddwdUZ\dddxdWZ]dddydYZ^dddZdzd]Z_d{ddZ`e(j3        eSe(j4        eTe(j2        eUe(j8        eYe(j9        eZe(j:        e_e(j;        e[e(j<        e\e(j=        e]e(j>        e^e(j5        eVe(j6        eWe(j7        eXiZadeddddfd|diZbdS )}    )annotationsN)suppress)dedent)TYPE_CHECKING)DocstringAttributeDocstringClassDocstringFunctionDocstringModuleDocstringParameterDocstringRaiseDocstringReceiveDocstringReturnDocstringSectionDocstringSectionAdmonitionDocstringSectionAttributesDocstringSectionClassesDocstringSectionDeprecatedDocstringSectionExamplesDocstringSectionFunctionsDocstringSectionModulesDocstringSectionOtherParametersDocstringSectionParametersDocstringSectionRaisesDocstringSectionReceivesDocstringSectionReturnsDocstringSectionTextDocstringSectionWarnsDocstringSectionYieldsDocstringWarnDocstringYield)docstring_warningparse_docstring_annotation)DocstringSectionKindLogLevel)ExprName)Pattern)AnyLiteral)Expr)	Docstring)
deprecated
parameterszother parametersreturnsyieldsreceivesraiseswarnsexamples
attributes	functionsmethodsclassesmoduleslinestrreturnboolc                ,    |                                   S )N)stripr8   s    U/var/www/FlaskApp/flask-venv/lib/python3.11/site-packages/_griffe/docstrings/numpy.py_is_empty_liner@   U   s    zz||    c                h    t          |            o"t          |                     dd                    S )N- )r@   replacer>   s    r?   _is_dash_linerF   Y   s.    d###Mt||C7L7L(M(MMrA   T)warnings	docstringr*   offsetintrG   optionsr'   tuple[list[list[str]], int]c                  | j         }|t          |          k    rg |fS |}g }t          ||                   r|dz  }t          ||                   ||         g}|dz  }|t          |          k     r@||         }t          |          r|                    d           n|                    d          r|                    |dd                     n|                    d          rkt          |          t          |                                          z
  }	|                    ||	d                     |rt          | |d|dz    d|	            nG|dz   t          |          k     rt          ||dz                      rn1|                    |           |g}|dz  }|t          |          k     @|r|                    |           ||dz
  fS )N   rD   z        z,Confusing indentation for continuation line z' in docstring, should be 4 spaces, not )lineslenr@   append
startswithlstripr!   rF   )
rH   rI   rG   rK   rQ   
new_offsetitemscurrent_itemr8   cont_indents
             r?   _read_block_itemsrZ   ]   s    OEU6zJE z*
+
+ a
 z*
+
+  *%&L!OJ s5zz
!
!Z $ 	"####__W%% 	"QRR))))__S!! 	"d))c$++--&8&88K[\\ 2333 !=:PQ> = =/:= =   !^c%jj((]5a;P-Q-Q( LL&&& 6La
? s5zz
!
!B  #\"""*q.  rA   tuple[str, int]c               x   | j         }|t          |          k    rd|fS |}g }t          ||                   r|dz  }t          ||                   |t          |          k     rt          ||                   }|r/|t          |          dz
  k     rt          ||dz                      rnd|r/|t          |          dz
  k     rt          ||dz                      rn3|                    ||                    |dz  }|t          |          k     d                    |                              d          |dz
  fS )NrD   rN      
)rQ   rR   r@   rF   rS   joinrstrip)rH   rI   rK   rQ   rV   blockis_emptys          r?   _read_blockrc      sR   OEU6zJE z*
+
+ a
 z*
+
+ 
s5zz
!
!!%
"344 	
SZZ!^33eJYZNF[8\8\3 	
SZZ!^33eJYZNF[8\8\3U:&'''a
 s5zz
!
! 99U""4((*q.88rA   z\{_RE_OBz\}_RE_CBz\*{0,2}[_a-z][_a-z0-9]*_RE_NAMEz.+_RE_TYPEz
    (?:
        (?P<nt_name>z)\s*:\s*(?P<nt_type>z4)  # name and type
        |  # or
        (?P<name>zu)\s*:\s*  # just name
        |  # or
        \s*:\s*$  # no name, no type
        |  # or
        (?::\s*)?(?P<type>z)\s*  # just type
    )
    r&   _RE_RETURNS
_RE_YIELDS_RE_RECEIVESz
    (?P<names>z(?:,\sz5)*)
    (?:
        \s:\s
        (?:
            (?:z(?P<choices>.+)z)|
            (?P<type>z)
        )?
    )?
    _RE_PARAMETERz^\s*<BLANKLINE>\s*$_RE_DOCTEST_BLANKLINEz(\s*#\s*doctest:.+)$_RE_DOCTEST_FLAGS)warn_unknown_paramsrG   rn   $tuple[list[DocstringParameter], int]c                  g }t          | fd|i|\  }}|D ]}t                              |d                   }	|	s|rt          | |d|d          d           C|	                    d                              d          }
|	                    d          pd |	                    d          }d |r||                    dd	          d         nCrAt          j        d
          }	|	r*|	                    d          |	                    d          r                    d          r
d d         t          |          d	k    r/d	                    |d	d                    
                                ndg|
D ]M}t          t          t                    5  | j        j        |         j        	 d d d             n?# 1 swxY w Y   N|rt          | |d|
            nt#          | t$          j                  P|
D ]M}t          t          t                    5  | j        j        |         j        	 d d d             n# 1 swxY w Y   N|rw|rut          t                    5  | j        j        }|
D ]9}||vr3d| d}d| d| fD ]}||v r|d| dz  } nt          | ||           :	 d d d            n# 1 swxY w Y   |                    fd|
D                        ||fS )NrI   r   Could not parse line ''namesz, typechoicesrN   z8^(?P<annotation>.+),\s+default(?: |: |=)(?P<default>.+)$default
annotationz
, optionalir^   rD   z'No types or annotations for parameters 	log_levelzParameter 'z+' does not appear in the function signature*z**z. Did you mean 'z'?c              3  >   K   | ]}t          |           V  dS ))valuerw   descriptionN)r   ).0namerw   rv   r}   s     r?   	<genexpr>z#_read_parameters.<locals>.<genexpr>  sG       
 
hlt7zWbccc
 
 
 
 
 
rA   )rZ   rk   matchr!   groupsplitreendswithrR   r_   r`   r   AttributeErrorKeyErrorparentr,   rw   r"   r$   debugrv   extend)rH   rI   rn   rG   rK   r,   rW   rV   itemr   rs   ru   r   paramsmessagestarred_namerw   rv   r}   s                   @@@r?   _read_parametersr      s    ,.J *)NNFNgNNE: 7
 7
##DG,, 	 ^!)Z9\RVWXRY9\9\9\]]]G$$**400[[((0D
++i(( 	7 JmmD!,,Q/GG 	7HXZdeeE 7++i00"[[66
 	**--l;; 	*#DSD)J69$ii!mmdiiQRR))00222 p pnh77  !*!1!<T!B!MJ                  p%i=ngl=n=nooo3J	U]UcdddJ?  nh77  '.9$?GG                  
	J+ 
	J.)) 	J 	J")4! J JD6))"a"a"a"a-7ZZd,E & &L+v55 '+Nl+N+N+N N %  6 *)ZIIIJ	J 	J 	J 	J 	J 	J 	J 	J 	J 	J 	J 	J 	J 	J 	J 	 
 
 
 
 
 
pu
 
 
 	
 	
 	
 	
 z!!s7   GG	G!III+A	KK	K	-tuple[DocstringSectionParameters | None, int]c                   t          | f||d|\  }}|rt          |          |fS |rt          | |d|            d |fS )NrI   rG   z!Empty parameters section at line )r   r   r!   )rH   rI   rG   rK   r,   rV   s         r?   _read_parameters_sectionr   "  ss     .ieQYee]deeJ
 B)*55zAA _)Z1]U[1]1]^^^rA   2tuple[DocstringSectionOtherParameters | None, int]c                   t          | f|d|d|\  }}|rt          |          |fS |rt          | |d|            d |fS )NF)rI   rn   rG   z'Empty other parameters section at line )r   r   r!   )rH   rI   rn   rG   rK   r,   rV   s          r?   _read_other_parameters_sectionr   1  s     .!	 
  J
  G.z::JFF e)Z1c[a1c1cdddrA   -tuple[DocstringSectionDeprecated | None, int]c               L   t          | f||d|\  }}|s|rt          | |d|            d |fS |r't          |          dk    rt          | |d|            |d         }|d         }t          d                    |dd                              }t          ||          |fS )Nr   z!Empty deprecated section at line rN   zToo many deprecated items at r   r^   )versiontext)rZ   r!   rR   r   r_   r   )	rH   rI   rG   rK   rW   rV   r   r   r   s	            r?   _read_deprecated_sectionr   G  s     *)aFXaaY`aaE:   	ci5aY_5a5abbbZ [CJJNN)Z1YQW1Y1YZZZ8D1gG$))DH%%&&D%gDAAA:MMrA   *tuple[DocstringSectionReturns | None, int]c                  t          | f||d|\  }}|s|rt          | |d|            d |fS g }t          |          D ]\  }}t                              |d                   }	|	s|rt          | |d|d          d           F|	                                }
|
d         p|
d         }|
d         p|
d	         }t          d
                    |dd                              }|t          t          t          t                    5  | j        j        r| j        j        }n | j        j        r| j        j        }nt          t#          |          dk    r~|j        r|j        j        |         }nd|j        r|j        }n!|j        r|j        j        d         }nt          t/          |t0                    r|}n|j        r|j        j        |         }n|}d d d            n# 1 swxY w Y   nt3          || t4          j                  }|                    t;          |pd||                     t=          |          |fS )Nr   zEmpty returns section at line r   rq   rr   nt_namer   nt_typert   r^   rN   r]   rx   rD   r   rw   r}   )rZ   r!   	enumeraterh   r   	groupdictr   r_   r   r   r   
ValueErrorr   is_functionr-   is_attributerw   rR   is_tuplesliceelementsis_iteratoris_generator
isinstancer%   r"   r$   r   rS   r   r   )rH   rI   rG   rK   rW   rV   r-   indexr   r   groupsr   rw   r   return_items                  r?   _read_returns_sectionr   a  s    *)aFXaaY`aaE:   	`i5^V\5^5^___ZG '' &b &bt!!$q'** 	 ^!)Z9\RVWXRY9\9\9\]]]""i 2F6NI&8&.
diiQRR))**.(J?? 5 5#/ %!*!1!9JJ%2 %!*!1!<JJ$$u::>>!* 5%/%5%>u%E

%1 -*4*:KK'4 -*4*:*CA*FKK",,%k8<< 5)4JJ(1 5)4):)CE)JJJ)4J-5 5 5 5 5 5 5 5 5 5 5 5 5 5 50 4J	U]UcdddJDJB:[_```aaaa"7++Z77s   CGG#	&G#	)tuple[DocstringSectionYields | None, int]c                  t          | f||d|\  }}|s|rt          | |d|            d |fS g }t          |          D ]\  }}t                              |d                   }	|	s|rt          | |d|d          d           F|	                                }
|
d         p|
d         }|
d         p|
d	         }t          d
                    |dd                              }|t          t          t          t          t                    5  | j        j        }|j        r|j        }n!|j        r|j        j        d         }nt          t'          |t(                    r|}n|j        r|j        j        |         }n|}d d d            n# 1 swxY w Y   nt-          || t.          j                  }|                    t5          |pd||                     t7          |          |fS )Nr   zEmpty yields section at line r   rq   rr   r   r   r   rt   r^   rN   rx   rD   r   )rZ   r!   r   ri   r   r   r   r_   r   r   
IndexErrorr   r   r   rw   r   r   r   r   r   r%   r   r"   r$   r   rS   r    r   )rH   rI   rG   rK   rW   rV   r.   r   r   r   r   r   rw   r   
yield_items                  r?   _read_yields_sectionr     sj    *)aFXaaY`aaE:   	_i5]U[5]5]^^^ZF '' ` `t  a)) 	 ^!)Z9\RVWXRY9\9\9\]]]""i 2F6NI&8&.
diiQRR))**.*h
KK , ,&-8
) %!+!1JJ, %!+!1!:1!=JJ$$j(33 ,!+JJ( ,!+!1!:5!AJJ!+J, , , , , , , , , , , , , , , 4J	U]UcdddJn$*"Y]^^^____!&)):55s   A1F

F	F	+tuple[DocstringSectionReceives | None, int]c                  t          | f||d|\  }}|s|rt          | |d|            d |fS g }t          |          D ]u\  }}t                              |d                   }	|	s|rt          | |d|d          d           F|	                                }
|
d         p|
d         }|
d         p|
d	         }t          d
                    |dd                              }|t          t          t                    5  | j        j        }|j        rF|j        j        d         }t!          |t"                    r|}n|j        r|j        j        |         }n|}d d d            n# 1 swxY w Y   nt'          || t(          j                  }|                    t/          |pd||                     wt1          |          |fS )Nr   zEmpty receives section at line r   rq   rr   r   r   r   rt   r^   rN   rx   rD   r   )rZ   r!   r   rj   r   r   r   r_   r   r   r   r   r-   r   r   r   r   r%   r   r"   r$   r   rS   r   r   )rH   rI   rG   rK   rW   rV   r/   r   r   r   r   r   rw   r   receives_items                  r?   _read_receives_sectionr     sJ    *)aFXaaY`aaE:   	ai5_W]5_5_```ZH '' d dt""47++ 	 ^!)Z9\RVWXRY9\9\9\]]]""i 2F6NI&8&.
diiQRR))**.(33 	3 	3&-5
* 3$.$4$=a$@M!-:: 3%2

&/ 3%2%8%A%%H

%2
	3 	3 	3 	3 	3 	3 	3 	3 	3 	3 	3 	3 	3 	3 	3 4J	U]UcdddJ(djbZ]abbbcccc#H--z99s   AE''E+	.E+	)tuple[DocstringSectionRaises | None, int]c               X   t          | f||d|\  }}|s|rt          | |d|            d |fS g }|D ]f}t          |d         |           }t          d                    |dd                              }	|                    t          ||	                     gt          |          |fS )Nr   zEmpty raises section at line r   r^   rN   rw   r}   )rZ   r!   r"   r   r_   rS   r   r   )
rH   rI   rG   rK   rW   rV   r0   r   rw   r   s
             r?   _read_raises_sectionr     s     *)aFXaaY`aaE:   	_i5]U[5]5]^^^ZF O O/QCC
diiQRR))**n
MMMNNNN!&)):55rA   (tuple[DocstringSectionWarns | None, int]c               X   t          | f||d|\  }}|s|rt          | |d|            d |fS g }|D ]f}t          |d         |           }t          d                    |dd                              }	|                    t          ||	                     gt          |          |fS )Nr   zEmpty warns section at line r   r^   rN   r   )rZ   r!   r"   r   r_   rS   r   r   )
rH   rI   rG   rK   rW   rV   r1   r   rw   r   s
             r?   _read_warns_sectionr     s     *)aFXaaY`aaE:   	^i5\TZ5\5\]]]ZE M M/QCC
diiQRR))**]jdKKKLLLL ''33rA   -tuple[DocstringSectionAttributes | None, int]c                  t          | f||d|\  }}|s|rt          | |d|            d |fS g }|D ]}|d         }d|v rD|                    dd          \  }	}
|	                                }	|
                                pd }
n|}	d }
|
Kt	          t
          t          t                    5  | j        |	         j	        }
d d d            n# 1 swxY w Y   nt          |
| t          j                  }
t          d                    |dd                              }|                    t!          |	|
|                     t#          |          |fS )	Nr   z!Empty attributes section at line r   :rN   rx   r^   r   )rZ   r!   r   r=   r   r   r   	TypeErrorr   rw   r"   r$   r   r   r_   rS   r   r   )rH   rI   rG   rK   rW   rV   r3   r   	name_typer   rw   r   s               r?   _read_attributes_sectionr   0  s    *)aFXaaY`aaE:   	ci5aY_5a5abbbZ J b bG	)(sA66D*::<<D#))++3tJJDJ.(I>> ? ?&-d3>
? ? ? ? ? ? ? ? ? ? ? ? ? ? ? 4J	U]UcdddJdiiQRR))**,$:[_```aaaa%j11:==s   -CC	C	,tuple[DocstringSectionFunctions | None, int]c                  t          | f||d|\  }}|s|rt          | |d|            d |fS g }|D ]}|d         }d|v rE|                    dd          d         }	|	                                }	|                                }
n|}	d }
t	          d                    |dd                                                              }|                    t          |	|
|                     t          |          |fS )Nr   z(Empty functions/methods section at line r   (rN   r^   r   )	rZ   r!   r   r=   r   r_   rS   r	   r   )rH   rI   rG   rK   rW   rV   r4   r   name_signaturer   	signaturer   s               r?   _read_functions_sectionr   W  s4    *)aFXaaY`aaE:   	ji5h`f5h5hiiiZI 
_ 
_a.  !''Q//2D::<<D&,,..II!DIdiiQRR))**0022*X\]]]^^^^$Y//;;rA   *tuple[DocstringSectionClasses | None, int]c                  t          | f||d|\  }}|s|rt          | |d|            d |fS g }|D ]}|d         }d|v rE|                    dd          d         }	|	                                }	|                                }
n|}	d }
t	          d                    |dd                                                              }|                    t          |	|
|                     t          |          |fS )Nr   zEmpty classes section at line r   r   rN   r^   r   )	rZ   r!   r   r=   r   r_   rS   r   r   )rH   rI   rG   rK   rW   rV   r6   r   r   r   r   r   s               r?   _read_classes_sectionr   w  s1    *)aFXaaY`aaE:   	`i5^V\5^5^___ZG 
Z 
Za.  !''Q//2D::<<D&,,..II!DIdiiQRR))**0022~4ISWXXXYYYY"7++Z77rA   *tuple[DocstringSectionModules | None, int]c                  t          | f||d|\  }}|s|rt          | |d|            d |fS g }|D ]}|d         }d|v rE|                    dd          d         }	|	                                }	|                                }
n|}	d }
t	          d                    |dd                                                              }|                    t          |	|
|                     t          |          |fS )Nr   zEmpty modules section at line r   r   rN   r^   r   )	rZ   r!   r   r=   r   r_   rS   r
   r   )rH   rI   rG   rK   rW   rV   r7   r   r   r   r   r   s               r?   _read_modules_sectionr     s1    *)aFXaaY`aaE:   	`i5^V\5^5^___ZG 
[ 
[a.  !''Q//2D::<<D&,,..II!DIdiiQRR))**0022DYTXYYYZZZZ"7++Z77rA   )trim_doctest_flagsrG   r   +tuple[DocstringSectionExamples | None, int]c                  t          | f||d|\  }}g }d}d}	g }
g }|                    d          D ]}t          |          rS|r;|r6|                    t          j        d                    |          f           g }d}O|
                    |           e|rN|r6t                              d|          }t                              d|          }|                    |           |
                    d          r|	 }	|
                    |           |	r|
                    |           |
                    d          r|
rI|                    t          j        d                    |
                              d          f           g }
d}|rt                              d|          }|                    |           |
                    |           |
rH|                    t          j        d                    |
                              d          f           n6|r4|                    t          j        d                    |          f           |rt          |          |fS |rt          | |d|            d |fS )	Nr   Fr^   rD   ```z>>>TzEmpty examples section at line )rc   r   r@   rS   r#   r2   r_   rm   subrl   rT   r   r`   r   r!   )rH   rI   r   rG   rK   r   rV   sub_sectionsin_code_examplein_code_blockcurrent_textcurrent_exampler8   s                r?   _read_examples_sectionr     s    #9ZVhZZRYZZD*hjLOM L!#O

4   "& "&$ !	& *" ) '')=)F		RaHbHb(cddd&(O"'##D)))) 	&! ;(,,R66,00T::""4((((__U## 	& --M%%%% 	&%%%%__U## 	& "##%9%>		,@W@W@^@^_c@d@d$efff!"O! 7(,,R66""4(((( %%%% Y16		,8O8O8V8VW[8\8\]^^^^	 Y1:DIIo<V<VWXXX B'55zAA ])Z1[SY1[1[\\\rA   sectionslistcurrent	list[str]admonition_titleNonec                   |r|                                                     dd          }|dv r
|d d         }|                     t          |d                    |                              d          |                     d S |rYt          |          rL|                     t          d                    |                              d                               d S d S d S )NrP   rC   )rG   notesr^   )kindr   title)lowerrE   rS   r   r_   r`   anyr   )r   r   r   r   s       r?   _append_sectionr     s    O%%''//S99((( 9D&YYw''..t44&  	
 	
 	
 	
 	
 
 OS\\ O,TYYw-?-?-F-Ft-L-LMMNNNNNO O O OrA   F)ignore_init_summaryr   rn   rG   r   list[DocstringSection]c                  g }g }d}d}	| j         }
||||d|}|d         oC| j        duo:| j        j        dk    o*| j        j        o| j        j        duo| j        j        j        }|rdnd}|t          |
          k     r|
|                                         }|	rG|                    d	                              d
          rd}	|	                    |
|                    nY|                    d	                              d
          rd}	|	                    |
|                    nt          |
|                   r|	                    d           n|t          |
          dz
  k    r1|	                    |
|                    t          |||           d}g }nt          |
|dz                      rmt          |||           g }|t          v rCd}t          t          |                  } || fd|dz   i|\  }}|r|	                    |           n)|
|         }|dz  }n|	                    |
|                    |dz  }|t          |
          k     t          |||           |S )a}  Parse a Numpydoc-style docstring.

    This function iterates on lines of a docstring to build sections.
    It then returns this list of sections.

    Parameters:
        docstring: The docstring to parse.
        ignore_init_summary: Whether to ignore the summary in `__init__` methods' docstrings.
        trim_doctest_flags: Whether to remove doctest flags from Python example blocks.
        warn_unknown_params: Warn about documented parameters not appearing in the signature.
        warnings: Whether to log warnings at all.
        **options: Additional parsing options.

    Returns:
        A list of docstring sections.
    rD   F)r   r   rn   rG   r   N__init__r]   r   rP   r   TrN   rI   )rQ   r   r   r   is_classrR   r   rU   rT   rS   r@   r   rF   _section_kind_section_reader)rH   r   r   rn   rG   rK   r   current_sectionr   r   rQ   ignore_summaryrI   
line_lowerreadersections                   r?   parse_numpyr     s   2 (*HOMOE 122	 
 G 	%& 	-D(	-!Z/	- (	- #4/		-
 #,  !'QQaF
3u::

6]((**
  ,	2  %%0077 & %""5=1111 s##..u55 $	2 M""5=1111 E&M** 	2""2&&&& s5zzA~%%""5=111Ho7GHHH! OO 5!,-- 	2Ho7GHHH O ]**#% (z)BC"(&"Q"Q6A:"Q"Q"Q -OOG,,, $)= ! ""5=111!e 3u::

j Ho/?@@@OrA   )r8   r9   r:   r;   )
rH   r*   rI   rJ   rG   r;   rK   r'   r:   rL   )rH   r*   rI   rJ   rK   r'   r:   r[   )rH   r*   rI   rJ   rn   r;   rG   r;   rK   r'   r:   ro   )
rH   r*   rI   rJ   rG   r;   rK   r'   r:   r   )rH   r*   rI   rJ   rn   r;   rG   r;   rK   r'   r:   r   )
rH   r*   rI   rJ   rG   r;   rK   r'   r:   r   )
rH   r*   rI   rJ   rG   r;   rK   r'   r:   r   )
rH   r*   rI   rJ   rG   r;   rK   r'   r:   r   )
rH   r*   rI   rJ   rG   r;   rK   r'   r:   r   )
rH   r*   rI   rJ   rG   r;   rK   r'   r:   r   )
rH   r*   rI   rJ   rG   r;   rK   r'   r:   r   )
rH   r*   rI   rJ   rG   r;   rK   r'   r:   r   )
rH   r*   rI   rJ   rG   r;   rK   r'   r:   r   )
rH   r*   rI   rJ   rG   r;   rK   r'   r:   r   )
rH   r*   rI   rJ   rG   r;   rK   r'   r:   r   )rH   r*   rI   rJ   r   r;   rG   r;   rK   r'   r:   r   )r   r   r   r   r   r9   r:   r   )rH   r*   r   r;   r   r;   rn   r;   rG   r;   rK   r'   r:   r   )c
__future__r   r   
contextlibr   textwrapr   typingr   _griffe.docstrings.modelsr   r   r	   r
   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r    _griffe.docstrings.utilsr!   r"   _griffe.enumerationsr#   r$   _griffe.expressionsr%   r&   r'   r(   r)   _griffe.modelsr*   r+   r,   other_parametersr-   r.   r/   r0   r1   r2   r3   r4   r6   r7   r   r@   rF   rZ   rc   rd   __annotations__re   rf   rg   compile
IGNORECASEVERBOSErh   ri   rj   rk   rl   rm   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r    rA   r?   <module>r     sW  ( # " " " " " " 				                                                                               8 S R R R R R R R ? ? ? ? ? ? ? ? ( ( ( ( ( ( )########(((((((((((( '1&1,=#+")$-")!'$-&1%/#-#+#+ $   N N N N 	;! ;! ;! ;! ;! ;!|9 9 9 92         * * * * *    !rz

 
3;
 
 	
 
 $
 
 
 MBJ      "
 ! ! ! !# # # # ##		 	'	 	
 	 	
 (.	 	 	 	 	 MBJ      ",,B!C!C  C C C C'RZ(?@@  @ @ @ @ !%F" F" F" F" F" F"Z 	     & !%     4 	N N N N N N< 	88 88 88 88 88 88~ 	06 06 06 06 06 06n 	,: ,: ,: ,: ,: ,:f 	6 6 6 6 6 6: 	4 4 4 4 4 4: 	$> $> $> $> $> $>V 	< < < < < <H 	8 8 8 8 8 8H 	8 8 8 8 8 8H  $> > > > > >BO O O O( #%=)+I#%=!5 3!#9#%="$; "7 "7 "7!5!#9( !&# $j j j j j j j jrA   