o w!g< @sddlmZddlmZddlmZmZddlmZm Z m Z ddl m Z m Z mZmZmZmZmZmZmZmZddlmZerJddlmZddlmZed Zed Zed Zed Z ed Z!edZ"edZ#eddGdddZ$eGdddZ%eGdddZ&dddKd!d"Z'dddLd&d'Z(dMd+d,Z)dNd.d/Z*dOd0d1Z+dOd2d3Z,dOd4d5Z-dOd6d7Z.dOd8d9Z/dOd:d;Z0dPdd?Z2dRdCdDZ3dSdFdGZ4dTdHdIZ5e$ee+e$ee(e$e e-e$ee,e$e#e.e$e!e/e$e"e0gZ6dJS)U) annotations)suppress) dataclassfield) TYPE_CHECKINGAnyCallable) DocstringAttributeDocstringParameterDocstringRaiseDocstringReturnDocstringSectionDocstringSectionAttributesDocstringSectionParametersDocstringSectionRaisesDocstringSectionReturnsDocstringSectionText)docstring_warning)Expr) Docstring)param parameterargargumentkeykeyword)type)varivarcvar)vartype)returnsreturn)rtype)raisesraiseexcept exceptionT)frozenc@s,eZdZUdZded<ded<d d d Zd S) _FieldTypez)Maps directive names to parser functions.zfrozenset[str]namesz.Callable[[Docstring, int, _ParsedValues], int]readerlinestrr"boolcstfdd|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. c3s |] }d|VqdS):N) startswith).0namer,[/mnt/skqttb/ctump_chatbot/chatbot/lib/python3.10/site-packages/_griffe/docstrings/sphinx.py :sz%_FieldType.matches..)anyr*)selfr,r4r3r5matches1s z_FieldType.matchesN)r,r-r"r.)__name__ __module__ __qualname____doc____annotations__r9r4r4r4r5r)*s r)c@s>eZdZUdZded<ded<ded<ded<d Zd ed <d S) _ParsedDirectivezrEr4r4r4r5r?=s r?c@seZdZUdZeedZded<eedZ ded<eedZ ded<eedZ d ed <eedZ ded <eedZ d ed <dZded<dZded<dS) _ParsedValuesz@Values parsed from the docstring to be used to produce sections.)default_factoryrB 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=rlistrHr>dictrIrJrKrLrMrNrPr4r4r4r5rFHs  rF)warn_unknown_params docstringrrSr.optionsrr"list[DocstringSection]cKst}d|i|}|j}d}|t|kr?||}tD]}||r.|j|||fi|}nq|j||d7}|t|kst|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. rSr) rFlineslen _field_typesr9r+rHappend_parsed_values_to_sections)rTrSrU parsed_valuesrXcurr_line_indexr, field_typer4r4r5 parse_sphinxVs$      r`offsetr@r]c KsXt||}|jr |jSd}t|jdkr|jd}n t|jdkr,|jd}|jd}nt|dd|jd|jS||jvrLt|dd|d|jS|rtt 7|j j}||vrd|d } d |d |fD]} | |vr{| d | d 7} nqkt|d| Wdn1swYt ||||} t ||} t || |j| d|j|<|jS)NrWr&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'?)r2 annotationrHrD)_parse_directiverErArYrCrr,rIrAttributeErrorparent_determine_param_annotation_determine_param_defaultr rD) rTrar]rSrUparsed_directivedirective_typer2paramsmessage starred_namergdefaultr4r4r5_read_parameterzsH          rsr2r-rOc Cs.z |jj|jWSttfyYdSwN)rjrIlstriprrriKeyError)rTr2r4r4r5rls rlrnc Csd}|j|}|dur|}|dur|}|dur&|dur&t|dd|d|durMz |jj|j}W|SttfyLt|dd|dY|Sw|S)Nr%Duplicate parameter information for 'rezNo matching parameter for ') rJgetrrjrIrurgrirv)rTr2rnr]rgparsed_param_typer4r4r5rks" rkcKt||}|jr |jSt|j}t|jdkr|jd}nt|dd|j d|jS||j |<|j |}|durQ|j durG||_ |jSt|dd|d|jS)NrbrWrz#Failed to get parameter name from 'rerw)rhrErA_consolidate_descriptive_typerDstriprYrCrr,rJrIrxrg)rTrar]rUrm param_type param_namerr4r4r5_read_parameter_type     rcKst||}|jr |jSt|jdkr|jd}nt|dd|jd|jSd}|j|}|dur5|}nt t t t |j |j}Wdn1sLwY||jvrct|dd|d|jSt|||jd|j|<|jS)NrbrWrrdrezDuplicate attribute entry for 'r2rgrH)rhrErArYrCrr,rLrxrrirv TypeErrorrjrgrKr rD)rTrar]rUrmr2rgparsed_attribute_typer4r4r5_read_attributes.     rcKrz)NrbrWrz#Failed to get attribute name from 'rez%Duplicate attribute information for ')rhrErAr{rDr|rYrCrr,rLrKrxrg)rTrar]rUrmattribute_typeattribute_name attributer4r4r5_read_attribute_typerrcKsft||}|jr |jSt|jdkr%|jd}|jt||jd|jSt |dd|j d|jS)NrbrW)rgrHrz*Failed to parse exception directive from 're) rhrErArYrCrMr[r rDrr,)rTrar]rUrmex_typer4r4r5_read_exception5s  rc Kszt||}|jr |jS|jdur|j}nz|jj}Wnty0t|dd|jdd}Ynwt d||j d|_ |jS)Nrz!No return type or annotation at 'rer) rhrErArPrjrgrirr,r rDrN)rTrar]rUrmrgr4r4r5 _read_returnHs    rcKsDt||}|jr |jSt|j}||_|j}|dur||_|jSrt) rhrErAr{rDr|rPrNrg)rTrar]rUrmrPrNr4r4r5_read_return_typeas rcCsdt|j}t|g}|jrt|j}|t||j r/t|j }|t ||j dur=|t |j g|j rH|t|j |S)N )join_strip_blank_linesrHrrIrQvaluesr[rrKrrNrrMr)r]textresult param_valuesattribute_valuesr4r4r5r\ts  r\c Cs|t|j|\}}z |dd\}}}Wnty/t|dd|dt||gdddYSw|}t|||d |S) Nr/rbrz-Failed to get ':directive: value' pair from 'rerT)rE )_consolidate_continuation_linesrXsplit ValueErrorrr?r|)rTrar,rA_ directiverDr4r4r5rhs rhrXrBtuple[str, int]cCs|}||g}|d7}|t|kr4||ds4||||d7}|t|kr4||drd|d|dfS)NrWr/rr)rurYr0r[rrstrip)rXrar^blockr4r4r5rsrdescriptive_typecCs |ddS)Nz or z | )replace)rr4r4r5r{s r{cCsX|s|Sd}d}d}t|D]\}}|r|r|s|d7}qd}|}q|||dS)NFrrWT) enumerateisspace)rX content_foundinitial_content final_contentindexr,r4r4r5rs rN)rTrrSr.rUrr"rV) rTrrar@r]rFrSr.rUrr"r@)rTrr2r-r"rO) rTrr2r-rnrOr]rFr"r) rTrrar@r]rFrUrr"r@)r]rFr"rV)rTrrar@r"r?)rXrBrar@r"r)rr-r"r-)rXrBr"rB)7 __future__r contextlibr dataclassesrrtypingrrr_griffe.docstrings.modelsr r r r r rrrrr_griffe.docstrings.utilsr_griffe.expressionsr_griffe.modelsr frozenset _PARAM_NAMES_PARAM_TYPE_NAMES_ATTRIBUTE_NAMES_ATTRIBUTE_TYPE_NAMES _RETURN_NAMES_RETURN_TYPE_NAMES_EXCEPTION_NAMESr)r?rFr`rsrlrkrrrrrrr\rhrr{rrZr4r4r4r5s\  0     ) 3   +