gUddlmZddlmZmZmZmZddlmZddl m Z m Z ddl m Z ddlmZddlmZerddlmZej(ej*ej,gZed Z ed Z d d d d  ddZd d d d  ddZej8eej*eej(eej,e iZded< ddZy )) annotations) TYPE_CHECKINGAnyCallableLiteral) parse_google)DocstringSectionDocstringSectionText) parse_numpy) parse_sphinx)Parser) Docstring)googlenumpysphinxauto) heuristics max_sectionsrNmethod style_orderdefaultc |r!t|tr|dfSt|dfS|r&|d}t|tr|dfSt|dfSy)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 ) docstringrrroptionsstyles O/var/www/openai/venv/lib/python3.12/site-packages/_griffe/docstrings/parsers.pyinfer_docstring_styler s[J$Wf5wDPP6'?DPPA"5&1udJJve}dJJ c Jt|f|||d|\}}| t||fi|S|S)aParse 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. r)rparse)rrrrrrsectionss r parse_autor$MsL4,   OE8Y111 Or z;dict[Parser, Callable[[Docstring], list[DocstringSection]]]parsersc |r*t|ts t|}t||fi|St|jgS)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)rparserrs rr"r"{s@&&)F^Fvy4G44  1 22r ) rrrDocstringDetectionMethodr*list[Parser] | list[DocstringStyle] | NonerParser | DocstringStyle | Nonerrreturnz3tuple[Parser | None, list[DocstringSection] | None]) rrrr)rr*rr+rrr,list[DocstringSection])rrr(zDocstringStyle | Parser | Nonerrr,r-) __future__rtypingrrrr_griffe.docstrings.googler_griffe.docstrings.modelsr r _griffe.docstrings.numpyr _griffe.docstrings.sphinxr _griffe.enumerationsr _griffe.modelsrrrr_default_style_orderDocstringStyler)rr$rr%__annotations__r"r rr:sT#882L02'( v}}fllC<=P"#?@6 (4>B.2 ** %*< * , *  *9*`(4>B.2 ## %#< # , #  ##N KK MM< MM< LL+ H D33 *33 3r