g< ddlmZddlmZddlmZmZddlmZm Z m Z ddl m Z m Z mZmZmZmZmZmZmZmZddlmZer ddlmZddlmZed Zed Zed Zed Z ed Z!edZ"edZ#edGddZ$eGddZ%eGddZ&ddd)dZ'dd d*dZ(d+dZ) d,dZ* d-dZ+ d-dZ, d-dZ- d-d Z.d-d!Z/ d-d"Z0d.d#Z1d/d$Z2d0d%Z3d1d&Z4d2d'Z5e$ee+e$ee(e$e e-e$ee,e$e#e.e$e!e/e$e"e0gZ6y()3) annotations)suppress) dataclassfield) TYPE_CHECKINGAnyCallable) DocstringAttributeDocstringParameterDocstringRaiseDocstringReturnDocstringSectionDocstringSectionAttributesDocstringSectionParametersDocstringSectionRaisesDocstringSectionReturnsDocstringSectionText)docstring_warning)Expr) Docstring)param parameterargargumentkeykeyword)type)varivarcvar)vartype)returnsreturn)rtype)raisesraiseexcept exceptionT)frozenc.eZdZUdZded<ded<ddZy) _FieldTypez)Maps directive names to parser functions.zfrozenset[str]namesz.Callable[[Docstring, int, _ParsedValues], int]readerc@tfd|jDS)zCheck if a line matches the field type. Parameters: line: Line to check against Returns: True if the line matches the field type, False otherwise. c3FK|]}jd|yw):N) startswith).0namelines N/var/www/openai/venv/lib/python3.12/site-packages/_griffe/docstrings/sphinx.py z%_FieldType.matches..:s!F:44??Qtf:.:s!)anyr,)selfr4s `r5matchesz_FieldType.matches1sF4::FFFN)r4strr#bool)__name__ __module__ __qualname____doc____annotations__r9r:r5r+r+*s3  :: Gr:r+cHeZdZUdZded<ded<ded<ded<d Zd ed <y ) _ParsedDirectivezr?r@rArJrBr:r5rDrD=s$F IO JGTr:rDceZdZUdZeeZded<eeZ ded<eeZ ded<eeZ d ed <eeZ ded <eeZ d ed <dZded<dZded<y) _ParsedValuesz@Values parsed from the docstring to be used to produce sections.)default_factoryrG descriptionzdict[str, DocstringParameter] parameterszdict[str, str] param_typeszdict[str, DocstringAttribute] attributesattribute_typeszlist[DocstringRaise] exceptionsNzDocstringReturn | None return_value str | None return_type)r=r>r?r@rlistrNrAdictrOrPrQrRrSrTrVrBr:r5rLrLHswJ"48K805d0KJ-K"'"=K=05d0KJ-K&+D&AO^A',T'BJ$B+/L(/"K"r:rL)warn_unknown_paramsc >t}d|i|}|j}d}|t|krg||}tD]*}|j |s|j |||fi|}n|j j||dz }|t|krgt|S)a!Parse a Sphinx-style docstring. Parameters: docstring: The docstring to parse. warn_unknown_params: Warn about documented parameters not appearing in the signature. **options: Additional parsing options. Returns: A list of docstring sections. rYr) rLlineslen _field_typesr9r-rNappend_parsed_values_to_sections) docstringrYoptions parsed_valuesr\curr_line_indexr4 field_types r5 parse_sphinxrfVs"OM 2 G OOEO CJ &_%&J!!$'"3*"3"3IP]"iah"i '  % % , ,T 21 CJ & &m 44r:c *t||}|jr |jSd}t|jdk(r|jd}n^t|jdk(r|jd}|jd}n't |dd|j d|jS||jvrt |dd|d|jS|rctt5|jj}||vr1d|d } d |d |fD]} | |vs| d | d z } nt |d| dddt||||} t||} t|| |j| |j|<|jS#1swYUxYw)Nr[r&Failed to parse field directive from ''zDuplicate parameter entry for 'z Parameter 'z+' does not appear in the function signature*z**z. Did you mean 'z'?)r3 annotationrNrI)_parse_directiverJrFr]rHrr4rOrAttributeErrorparent_determine_param_annotation_determine_param_defaultr rI) raoffsetrcrYrbparsed_directivedirective_typer3paramsmessage starred_namermdefaults r5_read_parameterrzzs( 6:***N  + +,1//2  - - .! 3)99!<//2)Q*PQaQfQfPggh(ij*** }''')Q*I$q(QR*** n %%%00F6!'v-XY'(Z2dV$=L#v-%5l^2#FF%>")Q8&-Ynm\J&y$7G%7 $** &MT"  & &&)& %s)2F F  Fc |jj|jjS#tt f$rYywxYwN)rprOlstripryroKeyError)rar3s r5rrrrsA**4;;=9AAA H %s03AAc4d}|jj|}||}||}||t|dd|d|4 |jj|j j }|S|S#ttf$rt|dd|dY|SwxYw)Nr%Duplicate parameter information for 'rkzNo matching parameter for ') rPgetrrprOr}rmror~)rar3rurcrmparsed_param_types r5rqrqs%)J%1155d;$& !# !&7&C)Q*OPTvUV(WX S"))44T[[]CNNJ :) S i.I$q,Q R  Ss1A33 BBc t||}|jr |jSt|jj }t |jdk(r|jd}n't|dd|jd|jS||j|<|jj|}|0|j||_ |jSt|dd|d|jS)Nrhr[rz#Failed to get parameter name from 'rkr)rnrJrF_consolidate_descriptive_typerIstripr]rHrr4rPrOrrm)rarsrcrbrt param_type param_namers r5_read_parameter_typers ( 6:***./?/E/E/K/K/MNJ  + +,1%55a8 )Q*MN^NcNcMdde(fg***,6Mj)  $ $ ( ( 4E     #)E   & && i.ST^S__`,a b  & &&r:c rt||}|jr |jSt|jdk(r|jd}n't |dd|j d|jSd}|jj|}||}n;tttt5|j|j}ddd||jvrt |dd|d|jSt!|||j"|j|<|jS#1swYexYw)Nrhr[rrjrkzDuplicate attribute entry for 'r3rmrN)rnrJrFr]rHrr4rRrrror~ TypeErrorrprmrQr rI)rarsrcrbrtr3rmparsed_attribute_types r5_read_attributers8 ( 6:***  + +,1//2)Q*PQaQfQfPggh(ij***$(J*99==dC(* nh :"))$/::J; }''')Q*I$q(QR  & && *<!(..*   &  & &&; :s /D--D6c t||}|jr |jSt|jj }t |jdk(r|jd}n't|dd|jd|jS||j|<|jj|}|0|j||_ |jSt|dd|d|jS)Nrhr[rz#Failed to get attribute name from 'rkz%Duplicate attribute information for ')rnrJrFrrIrr]rHrr4rRrQrrm)rarsrcrbrtattribute_typeattribute_name attributes r5_read_attribute_typers ( 6:***23C3I3I3O3O3QRN  + +,1)99!<)Q*MN^NcNcMdde(fg***4BM!!.1((,,^>&B'&B'c t||}|jr |jSt|jj }||_|j}|||_|jSr|) rnrJrFrrIrrVrTrm)rarsrcrbrtrVrTs r5_read_return_typerasm ( 6:***/0@0F0F0L0L0NOK +M --L"-   & &&r:cLdjt|j}t|g}|jr=t |jj }|jt||jr=t |jj }|jt||j%|jt|jg|jr$|jt|j|S)N )join_strip_blank_linesrNrrOrWvaluesr_rrQrrTrrSr)rctextresult param_valuesattribute_valuess r5r`r`ts 99' (A(AB CD&:4&@%AFM44;;=>  0>? 8 8 ? ? AB 01ABC!!- -}/I/I.JKL ,]-E-EFG Mr:ct|j|\}} |jdd\}}}|j }t |||jd |S#t$r$t |dd|dt ||gddcYSwxYw) Nr0rhrz-Failed to get ':directive: value' pair from 'rkrT)rJ )_consolidate_continuation_linesr\split ValueErrorrrDr)rarsr4rF_ directiverIs r5rnrns6yOD*H"jja09e KKME D*iooc.BE JJ H)Q*WX\W]]^(_`j"b$GGHsA*B  B cZ|}||jg}|dz }|t|kr^||jdsJ|j||j|dz }|t|kr||jdsJdj |j d|dz fS)Nr[r0rr)r}r]r1r_rrstrip)r\rsrdblocks r5rrsO ? # * * , -EqO CJ &u_/E/P/PQT/U U?+22451 CJ &u_/E/P/PQT/U 88E? ! !$ '1)< <rs#(//   7((TU i(45!,//0 z*GH $GGG$    # #  #GK!5R!% 0'0' 0'!0'  0'  0' 0'f !   @'' '!' '  '6('(' ('!(' ('  ('V'' '!' '  '6'' '!' '  '&'2'' '!' '  '&  K =36& "67|_-$&:;11}l+!#45 r: