o w!åg¸ã@sôUddlmZddlmZmZmZmZddlmZddl m Z m Z ddl m Z ddlmZddlmZer;ddlmZejejejgZed Z ed Z d d d d œd%dd„Zd d d d œd&dd„Zejeejeejeeje iZded <d'd#d$„Zd S)(é)Ú annotations)Ú TYPE_CHECKINGÚAnyÚCallableÚLiteral)Ú parse_google)ÚDocstringSectionÚDocstringSectionText)Ú parse_numpy)Ú parse_sphinx)ÚParser)Ú Docstring)ÚgoogleÚnumpyÚsphinxÚauto)Ú heuristicsÚ max_sectionsrN©ÚmethodÚ style_orderÚdefaultÚ docstringr rÚ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!ú\/mnt/skqttb/ctump_chatbot/chatbot/lib/python3.10/site-packages/_griffe/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)rrrrrr Úsectionsr!r!r"Ú parse_autoMsÿü û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. )rr r(r Úvalue)rr)rr!r!r"r%{s   r%) rr rrrrrrrrrr) rr rrrrrrrrrr$)rr r)r*rrrr$) Ú __future__rÚtypingrrrrÚ_griffe.docstrings.googlerÚ_griffe.docstrings.modelsrr Ú_griffe.docstrings.numpyr Ú_griffe.docstrings.sphinxr Ú_griffe.enumerationsr Ú_griffe.modelsr rrrÚ_default_style_orderÚDocstringStylerr#r'rr(Ú__annotations__r%r!r!r!r"Ús8     û0û' ü