%j+nddlmZddlZddlmZmZmZddlmZer$ddl m Z ddl m Z ddl mZddlmZdd lmZdd lmZejejejgZed Z ejd gd fejdgdfejdgdfiZGddedZdddddd)d$ZGd%d&edZdddddd*d(ZdS)+) 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 exceptionc6eZdZUdZded< ded< ded<dS) PerStyleOptionsz(Per-style options for docstring parsing.rgoogler numpyr sphinxN__name__ __module__ __qualname____doc____annotations__h/home/rurouni/.hermes/hermes-agent/venv/lib/python3.11/site-packages/griffe/_internal/docstrings/auto.pyr4r4isB22.-..r?r4F)totalrmethod style_orderdefaultper_style_options docstringr rCDocstringDetectionMethodrD*list[Parser] | list[DocstringStyle] | NonerEParser | DocstringStyle | NonerFPerStyleOptions | Noner.3tuple[Parser | None, list[DocstringSection] | None]c l ddlm}|pi}d|ptD}|dkrn|D]A}t|\ } fd|D}t fd|Dr|dfcSB|t |t r|nt |dfS|dkri} |D](}||fi||i| |<)d | D} t| } |D]}| || kr || |fcStd |d ) 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)parserscZg|](}t|trt|n|)Sr>) isinstancestrr).0styles r@ z)infer_docstring_style..s1www%Juc$:$:E6%===wwwr?rcg|]A}tj|tjtjzBSr>)recompileformat IGNORECASE MULTILINE)rR replacementpatterns r@rTz)infer_docstring_style..sGZe 7>>+66  8TUUr?c3LK|]}|jVdS)N)searchvalue)rRr\rGs r@ z(infer_docstring_style..s1KKw7>>)/22KKKKKKr?Nrc4i|]\}}|t|Sr>)len)rRrSsections r@ z)infer_docstring_style..s$ZZZG ZZZr?zInvalid method 'z'.) #griffe._internal.docstrings.parsersrN_default_style_order _patternsanyrPrgetitemsmaxvalues ValueError) rGrCrDrErFrNrS replacementspatternsstyle_sections style_lengthsrr\s ` @r@infer_docstring_stylerrts<<;;;;;)/RwwS^SvbvwwwK   # #E$-e$4 !G\iuHKKKK(KKKKK #d{""" #!/Z-H-H/wwfU\oo_ccc   b bE$2GEN9$a$a@Q@U@UV[]_@`@`$a$aN5 ! !ZZ>CWCWCYCYZZZ =//1122   4 4EU#|33nU333334 2222 3 33r?cBeZdZUdZded< ded< ded< ded <d S) AutoOptionsz"Options for Auto-style docstrings.rHrCrIrDrJrErKrFNr8r>r?r@rtrtsQ,,$$$$0;;;;?++++;----//r?rtlist[DocstringSection]cddlm}|pi}t|||||\}}||||fi||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)rerwrrri)rGrCrDrErFrwrSsectionss r@ parse_autorys.:99999)/R++ OE8uYJJ):)>)>ub)I)IJJJ Or?) rGr rCrHrDrIrErJrFrKr.rL) rGr rCrHrDrIrErJrFrKr.ru) __future__rrVtypingrrrgriffe._internal.enumerationsr"griffe._internal.docstrings.googler"griffe._internal.docstrings.modelsr !griffe._internal.docstrings.numpyr rer "griffe._internal.docstrings.sphinxr griffe._internal.modelsr r7r5r6rfrHrgr4rrrtryr>r?r@rs#""""" 44444444440000002@@@@@@CCCCCC>>>>>>BBBBBB@@@@@@111111 v}flC##?@6 M,   8 L$   & M1   aG  T/////iu////(4>B.204 848484848484v 0 0 0 0 0)5 0 0 0 0 (4>B.204 $$$$$$$$r?