iKjddlmZddlZddlmZmZmZddlmZer$ddl m Z ddl m Z ddl mZddlmZdd lmZdd lmZej*ej,ej.gZed Z ej,d gd fej.dgdfej*dgdfiZGddedZddddd ddZGddedZddddd ddZy)) annotationsN) TYPE_CHECKINGLiteral TypedDict)Parser) GoogleOptions)DocstringSection) NumpyOptions)DocstringStyle) SphinxOptions) Docstring) heuristics max_sectionsz!\n[ \t]*{0}:([ \t]+.+)?\n[ \t]+.+)args argumentsparams parametersz keyword argszkeyword argumentsz other argszother argumentsz other paramsother parametersraises exceptionsreturnsyieldsreceivesexamples attributes functionsmethodsclassesmoduleswarnswarningsz\n[ \t]*{0}\n[ \t]*---+\n) deprecatedrrrrrrr rrrrrz&\n[ \t]*:{0}([ \t]+\w+)*:([ \t]+.+)?\n)param parameterargargumentkeykeywordtypevarivarcvarvartyperreturnrtyperraiseexcept exceptionc4eZdZUdZded< ded< ded<y) PerStyleOptionsz(Per-style options for docstring parsing.rgoogler numpyr sphinxN__name__ __module__ __qualname____doc____annotations__q/Users/ahmed/devFolder/Ultron/claude-voice/.venv/lib/python3.12/site-packages/griffe/_internal/docstrings/auto.pyr4r4is 2 . - .r?r4F)totalrmethod style_orderdefaultper_style_optionsc ddlm}|xsi}|xstDcgc]}t|tr t |n|!}}|dk(r|D]y}t |\}}|D cgc]F} tj|j| tjtjzH} } tfd| Dsu|dfcS|t|t r|dfSt |dfS|dk(ri} |D]!}||fi|j|i| |<#| jD cic]\}} |t| } }} t!| j#}|D]}| ||k(s || |fcSt%d|dcc}wcc} wcc} }w) aInfer the parser to use for the docstring. 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. 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. per_style_options: Additional parsing options per style. Returns: The inferred parser, and optionally parsed sections (when method is 'max_sections'). r)parsersrc3TK|]}|jj!yw)N)searchvalue).0pattern docstrings r@ z(infer_docstring_style..sK(w7>>)//2(s%(NrzInvalid method 'z'.)#griffe._internal.docstrings.parsersrH_default_style_order isinstancestrr _patternsrecompileformat IGNORECASE MULTILINEanygetitemslenmaxvalues ValueError)rNrCrDrErFrHstylerM replacements replacementpatternsstyle_sectionssection style_lengthsrs` r@infer_docstring_stylerhts<<)/RS^SvbvSvwSv%Juc$:6%=ESvKw  E$-e$4 !G\iuiuZe 7>>+6  8TUiu K(KKd{" !"/Z-Hw_cccfU\o_ccc  E$2GEN9$a@Q@U@UV[]_@`$aN5 !!CQCWCWCYZCYG ,CY Z=//12  EU#|3nU333! 'xr2 33-x [s$E?A F&F c@eZdZUdZded< ded< ded< ded <y ) AutoOptionsz"Options for Auto-style docstrings.DocstringDetectionMethodrC*list[Parser] | list[DocstringStyle] | NonerDParser | DocstringStyle | NonerEPerStyleOptions | NonerFNr8r>r?r@rjrjs), $$0;;? ++;--/r?rjc|ddlm}|xsi}t|||||\}}||||fi|j|iS|S)a5Parse a docstring by automatically detecting the style it uses. 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. per_style_options: Additional parsing options per style. Returns: A list of docstring sections. r)parserB)rPrprhr[)rNrCrDrErFrprasectionss r@ parse_autorrs\.:)/R++ OE8YJ):)>)>ub)IJJ Or?) rNr rCrkrDrlrErmrFrnr.z3tuple[Parser | None, list[DocstringSection] | None]) rNr rCrkrDrlrErmrFrnr.zlist[DocstringSection]) __future__rrUtypingrrrgriffe._internal.enumerationsr"griffe._internal.docstrings.googler"griffe._internal.docstrings.modelsr !griffe._internal.docstrings.numpyr rPr "griffe._internal.docstrings.sphinxr griffe._internal.modelsr r7r5r6rQrkrTr4rhrjrrr>r?r@r{sZ# 440@C>B@1 v}}fllC##?@6 MM, 8 LL$ & MM1 aG  T/iu/(4>B.204 8484 %84< 84 , 84 . 84984v 0)5 0 (4>B.204 $$ %$< $ , $ . $$r?