o óæh’ã@sUddlmZddlmZmZmZmZmZddlm Z m Z ddl m Z m Z ddlmZmZddlmZmZddlmZerCddlmZejejejgZed Z ed Z ee eefZ d d d d œd%dd„Zd d d d œd&dd„Z ej!e eje ejeejeiZ"de#d <d'd#d$„Z$d S)(é)Ú annotations)Ú TYPE_CHECKINGÚAnyÚCallableÚLiteralÚUnion)Ú GoogleOptionsÚ parse_google)ÚDocstringSectionÚDocstringSectionText)Ú NumpyOptionsÚ parse_numpy)Ú SphinxOptionsÚ parse_sphinx)ÚParser)Ú Docstring)ÚgoogleÚnumpyÚsphinxÚauto)Ú heuristicsÚ max_sectionsrN©ÚmethodÚ style_orderÚdefaultÚ docstringrrÚDocstringDetectionMethodrú*list[Parser] | list[DocstringStyle] | NonerúParser | DocstringStyle | NoneÚoptionsrÚreturnú3tuple[Parser | None, list[DocstringSection] | None]cKsP|rt|tƒr |dfSt|ƒdfS|r&|d}t|tƒr |dfSt|ƒdfSdS)a>Infer the parser to use for the docstring. [:octicons-heart-fill-24:{ .pulse } Sponsors only](../../../insiders/index.md){ .insiders } — [:octicons-tag-24: Insiders 1.3.0](../../../insiders/changelog.md#1.3.0). The 'heuristics' method uses regular expressions. The 'max_sections' method parses the docstring with all parsers specified in `style_order` and returns the one who parsed the most sections. If heuristics fail, the `default` parser is returned. If multiple parsers parsed the same number of sections, `style_order` is used to decide which one to return. The `default` parser is never used with the 'max_sections' method. For non-Insiders versions, `default` is returned if specified, else the first parser in `style_order` is returned. If `style_order` is not specified, `None` is returned. Additional options are parsed to the detected parser, if any. Parameters: docstring: The docstring to parse. method: The method to use to infer the parser. style_order: The order of the styles to try when inferring the parser. default: The default parser to use if the inference fails. **options: Additional parsing options. Returns: The inferred parser, and optionally parsed sections (when method is 'max_sections'). Nr)NN)Ú isinstancer)rrrrr Ústyle©r%úd/var/www/html/openai_agents/venv/lib/python3.10/site-packages/griffe/_internal/docstrings/parsers.pyÚinfer_docstring_style"s %r'úlist[DocstringSection]cKs:t|f|||dœ|¤Ž\}}|durt||fi|¤ŽS|S)aÚParse a docstring by automatically detecting the style it uses. [:octicons-heart-fill-24:{ .pulse } Sponsors only](../../../insiders/index.md){ .insiders } — [:octicons-tag-24: Insiders 1.3.0](../../../insiders/changelog.md#1.3.0). See [`infer_docstring_style`][griffe.infer_docstring_style] for more information on the available parameters. Parameters: docstring: The docstring to parse. method: The method to use to infer the parser. style_order: The order of the styles to try when inferring the parser. default: The default parser to use if the inference fails. **options: Additional parsing options. Returns: A list of docstring sections. rN)r'Úparse)rrrrr r$Úsectionsr%r%r&Ú parse_autoOsÿü ûr+z;dict[Parser, Callable[[Docstring], list[DocstringSection]]]ÚparsersÚparserúDocstringStyle | Parser | NonecKs6|rt|tƒs t|ƒ}t||fi|¤ŽSt|jƒgS)aParse the docstring. Parameters: docstring: The docstring to parse. parser: The docstring parser to use. If None, return a single text section. **options: The options accepted by the parser. Returns: A list of docstring sections. )r#rr,r Úvalue)rr-r r%r%r&r)}s   r)) rrrrrrrrr rr!r") rrrrrrrrr rr!r()rrr-r.r rr!r()%Ú __future__rÚtypingrrrrrÚ"griffe._internal.docstrings.googlerr Ú"griffe._internal.docstrings.modelsr r Ú!griffe._internal.docstrings.numpyr r Ú"griffe._internal.docstrings.sphinxrrÚgriffe._internal.enumerationsrÚgriffe._internal.modelsrrrrÚ_default_style_orderÚDocstringStylerÚDocstringOptionsr'r+rr,Ú__annotations__r)r%r%r%r&Ús<  û0û' ü