-h:UddlmZddlmZmZmZmZddlmZddl m Z m Z ddl m Z ddlmZddlmZerddlmZejejejgZed Z ed Z d d d d d"dZd d d d d#dZejeejeejeeje iZded<d$d!Zd S)%) annotations) TYPE_CHECKINGAnyCallableLiteral) parse_google)DocstringSectionDocstringSectionText) parse_numpy) parse_sphinx)Parser) Docstring)googlenumpysphinxauto) heuristics max_sectionsrNmethod style_orderdefault docstringrrDocstringDetectionMethodr*list[Parser] | list[DocstringStyle] | NonerParser | DocstringStyle | Noneoptionsrreturn3tuple[Parser | None, list[DocstringSection] | None]c |r(t|tr|nt|dfS|r0|d}t|tr|nt|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 )rrrrrstyles W/var/www/FlaskApp/flask-venv/lib/python3.11/site-packages/_griffe/docstrings/parsers.pyinfer_docstring_styler$ smJQ$Wf55Jww6'??DPPKA"5&11Duuve}}dJJ :list[DocstringSection]c Nt|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)r$parse)rrrrrr"sectionss r# parse_autor*Ms\4,   OE8Y11111 Or%z;dict[Parser, Callable[[Docstring], list[DocstringSection]]]parsersparserDocstringStyle | Parser | Nonec |r7t|tst|}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. )r!r r+r value)rr,rs r#r(r({sV5&&)) $F^^Fvy44G444  1 1 22r%) rrrrrrrrrrrr) rrrrrrrrrrrr&)rrr,r-rrrr&) __future__rtypingrrrr_griffe.docstrings.googler_griffe.docstrings.modelsr r _griffe.docstrings.numpyr _griffe.docstrings.sphinxr _griffe.enumerationsr _griffe.modelsrrrr_default_style_orderDocstringStylerr$r*rr+__annotations__r(r%r#r<s#""""""888888888888222222LLLLLLLL000000222222'''''')(((((( v}flC<=P"#?@6 (4>B.2 ******`(4>B.2 ######N K M< M< L+ H333333r%