o i@sUddlmZddlZddlZddlmZddlmZddl m Z ddl m Z m Z mZmZddlmZmZmZe r?dd lmZed Zd'ddZd(ddZdgddfdgddfd gd!d"fgZd#ed$<ed%d&ZdS))) annotationsN)Callable)contextmanager) Signature) TYPE_CHECKINGAnyLiteralcast) DocstringDocstringSectionKindObject)DocstringFormat)googlenumpysphinxfuncCallable[..., Any]sigrdocstring_formatrreturn!tuple[str | None, dict[str, str]]cCsD|j}|dur difStt|}|dkrt|n|}t|d||dddd}t |}Wdn1s8wYi}tdd|Dd} rSd d | jD}d } td d|Dd} rd| j} td d|Dd} r| jd} | j }| j }|rd|dnd }d|d|d}| rd| d|} | |fS|} | |fS)aExtract the function description and parameter descriptions from a function's docstring. The function parses the docstring using the specified format (or infers it if 'auto') and extracts both the main description and parameter descriptions. If a returns section is present in the docstring, the main description will be formatted as XML. Returns: A tuple containing: - str: Main description string, which may be either: * Plain text if no returns section is present * XML-formatted if returns section exists, including and tags - dict[str, str]: Dictionary mapping parameter names to their descriptions Nautor F)returns_named_valuereturns_multiple_items)linenoparserparentparser_optionscs |] }|jtjkr|VqdSN)kindr parameters.0pr&Y/var/www/html/karishye-ai-python/venv/lib/python3.10/site-packages/pydantic_ai/_griffe.py 9z#doc_descriptions..cSsi|]}|j|jqSr&)name descriptionr#r&r&r' :sz$doc_descriptions..csrr )r!r textr#r&r&r'r(=r)csrr )r!r returnsr#r&r&r'r(@r)rzz z z z z z ) __doc__r GriffeObject_infer_docstring_styler _disable_griffe_loggingparsenextvaluer+ annotation)rrrdocrdocstring_style docstringsectionsparamsr" main_descmainreturn_return_statement return_desc return_typetype_tag return_xmlr&r&r'doc_descriptionss@   rEr8strDocstringStylecs8tD]\}}fdd|D}t|r|SqdS)z%Simplistic docstring style inference.c3s,|]}t|tjtjBVqdSr )researchformat IGNORECASE MULTILINE)r$ replacementr8patternr&r'r(Rs z)_infer_docstring_style..r)_docstring_style_patternsany)r8 replacementsstylematchesr&rNr'r2Os r2z&\n[ \t]*:{0}([ \t]+\w+)*:([ \t]+.+)?\n)param parameterargargumentkeykeywordtypevarivarcvarvartyper/rrtyperaisesraiseexcept exceptionrz!\n[ \t]*{0}:([ \t]+.+)?\n[ \t]+.+)args argumentsr<r"z keyword argszkeyword argumentsz other argszother argumentsz other paramsother parametersra exceptionsr/yieldsreceivesexamples attributes functionsmethodsclassesmoduleswarnswarningsrz\n[ \t]*{0}\n[ \t]*---+\n) deprecatedr"rgr/rirjrarqrlrmrnrorprz+list[tuple[str, list[str], DocstringStyle]]rPccs0tj}tjtjdVtj|dSr )loggingrootgetEffectiveLevelsetLevelERROR) old_levelr&r&r'r3s  r3)rrrrrrrr)r8rFrrG) __future__r _annotationsrtrHcollections.abcr contextlibrinspectrtypingrrrr griffer r r r1toolsrrGrEr2rP__annotations__r3r&r&r&r's8      = L