o iz"@s0ddlmZddlZddlmZmZmZmZddlm Z ddl m Z erHddl m Z ddlmZddlmZdd lmZdd lmZdd lmZe je je jgZed Z e jd gdfe jdgdfe jdgdfiZGdddeddZdddddd.d'd(ZGd)d*d*eddZ dddddd/d,d-Z!dS)0) annotationsN) TYPE_CHECKINGAnyLiteral TypedDict)warn)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!rrrrr z&\n[ \t]*:{0}([ \t]+\w+)*:([ \t]+.+)?\n)param parameterargargumentkeykeywordtypevarivarcvarvartyperreturnrtyperraiseexcept exceptionc@s.eZdZUdZded< ded< ded<dS) PerStyleOptionsz(Per-style options for docstring parsing.r googler numpyr sphinxN__name__ __module__ __qualname____doc____annotations__r>r>f/var/www/html/karishye-ai-python/venv/lib/python3.10/site-packages/griffe/_internal/docstrings/auto.pyr4js r4F)totalrmethod style_orderdefaultper_style_options docstringrrBDocstringDetectionMethodrC*list[Parser] | list[DocstringStyle] | NonerDParser | DocstringStyle | NonerEPerStyleOptions | Noneoptionsrr/3tuple[Parser | None, list[DocstringSection] | None]c  sTddlm}|r|rtdtdtdd|||d}n|s i}dd |p&tD}|d kre|D]"}t|\}fd d |D} tfd d | DrQ|dfSq/|dus[t|t r_|dfSt |dfS|dkri} |D]}||fi| |i| |<qmdd| D} t | } |D]}| || kr|| |fSqtd|d)a"Infer 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. **options: Deprecated. Use `per_style_options` instead. Returns: The inferred parser, and optionally parsed sections (when method is 'max_sections'). r)parsers2Cannot use both `options` and `per_style_options`.z;`**options` is deprecated. Use `per_style_options` instead. stacklevelr5r6r7cSs"g|] }t|tr t|n|qSr>) isinstancestrr).0styler>r>r? s"z)infer_docstring_style..rcs&g|]}t|tjtjBqSr>)recompileformat IGNORECASE MULTILINE)rU replacement)patternr>r?rWsc3s|] }|jVqdS)N)searchvalue)rUr^)rFr>r? sz(infer_docstring_style..NrcSsi|] \}}|t|qSr>)len)rUrVsectionr>r>r? sz)infer_docstring_style..zInvalid method 'z'.)#griffe._internal.docstrings.parsersrM ValueErrorrDeprecationWarning_default_style_order _patternsanyrSrgetitemsmaxvalues) rFrBrCrDrErKrMrV replacementspatternsstyle_sections style_lengthsrr>)rFr^r?infer_docstring_styleus< !   &"  rsc@s8eZdZUdZded< ded< ded< ded <d S) AutoOptionsz"Options for Auto-style docstrings.rGrBrHrCrIrDrJrENr8r>r>r>r?rts rtlist[DocstringSection]c Ks|ddlm}|r|rtdtdtdd|||d}n|s i}t|||||d\}}|d ur<|||fi||iS|S) auParse 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. **options: Deprecated. Use `per_style_options` instead. Returns: A list of docstring sections. r)parserNz<`**options` are deprecated. Use `per_style_options` instead.rOrPrRrAN)rervrfrrgrsrk) rFrBrCrDrErKrvrVsectionsr>r>r? parse_autos$  rx)rFrrBrGrCrHrDrIrErJrKrr/rL)rFrrBrGrCrHrDrIrErJrKrr/ru)" __future__rrXtypingrrrrr"rgriffe._internal.enumerationsr"griffe._internal.docstrings.googler "griffe._internal.docstrings.modelsr !griffe._internal.docstrings.numpyr rer "griffe._internal.docstrings.sphinxr griffe._internal.modelsrr7r5r6rhrGrir4rsrtrxr>r>r>r?sP         JE