Jiz"ddlmZddlZddlmZmZmZmZddlm Z ddl m Z er$ddl m Z ddlmZddlmZdd lmZdd lmZdd lmZe j0e j2e j4gZed Z e j2d gdfe j4dgdfe j0dgdfiZGddedZddddd ddZGddedZ ddddd ddZ!y)) 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"rrrr r!z&\n[ \t]*:{0}([ \t]+\w+)*:([ \t]+.+)?\n)param parameterargargumentkeykeywordtypevarivarcvarvartyperreturnrtyperraiseexcept exceptionc4eZdZUdZded< ded< ded<y) PerStyleOptionsz(Per-style options for docstring parsing.r googler numpyrsphinxN__name__ __module__ __qualname____doc____annotations__r/var/www/html/BankruptcyAI-uat/bankruptcy-ai/venv/lib/python3.12/site-packages/griffe/_internal/docstrings/auto.pyr6r6js 2 . - .rAr6F)totalrmethod style_orderdefaultper_style_optionsc jddlm}|r&|r tdtdtd|||d}n|si}|xst Dcgc]}t |tr t|n|!}}|dk(r|D]y}t|\}} | D cgc]F} tj|j| tjtjzH} } tfd | Dsu|d fcS|t |tr|d fSt|d fS|d k(ri} |D]!}||fi|j!|i| |<#| j#D cic]\}} |t%| }}} t'|j)}|D]}|||k(s || |fcStd |d cc}wcc} wcc} }w)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. stacklevelr7r8r9rc3TK|]}|jj!yw)N)searchvalue).0pattern docstrings rB z(infer_docstring_style..sKw7>>)//2Ks%(NrzInvalid method 'z'.)#griffe._internal.docstrings.parsersrJ ValueErrorrDeprecationWarning_default_style_order isinstancestrr _patternsrecompileformat IGNORECASE MULTILINEanygetitemslenmaxvalues)rUrErFrGrHoptionsrJstylerT replacements replacementpatternsstyle_sectionssection style_lengthsrs` rBinfer_docstring_stylerqusB< QR R JL^klm'.GT S^Svbvw%Juc$:6%=EwKw   #E$-e$4 !G\iuZe 7>>+6  8TUHK(KKd{"  #"/Z-Hw_cccfU\o_ccc   bE$2GEN9$a@Q@U@UV[]_@`$aN5 ! bCQCWCWCYZG ,Z Z=//12   4EU#|3nU333 4 'xr2 33-x [s$F%A F* F/c@eZdZUdZded< ded< ded< ded <y ) AutoOptionsz"Options for Auto-style docstrings.DocstringDetectionMethodrE*list[Parser] | list[DocstringStyle] | NonerFParser | DocstringStyle | NonerGPerStyleOptions | NonerHNr:r@rArBrsrss), $$0;;? ++;--/rArsc ddlm}|r&|r tdtdtd|||d}n|si}t |||||\}}||||fi|j |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)parserKz<`**options` are deprecated. Use `per_style_options` instead.rLrMrOrD)rWryrXrrYrqrd) rUrErFrGrHriryrjsectionss rB parse_autor{s4: QR R KM_lmn'.GT ++ OE8YJ):)>)>ub)IJJ OrA)rUrrErtrFrurGrvrHrwrirr0z3tuple[Parser | None, list[DocstringSection] | None])rUrrErtrFrurGrvrHrwrirr0zlist[DocstringSection])" __future__rr^typingrrrrr#rgriffe._internal.enumerationsr "griffe._internal.docstrings.googler "griffe._internal.docstrings.modelsr !griffe._internal.docstrings.numpyr rWr "griffe._internal.docstrings.sphinxrgriffe._internal.modelsrr9r7r8rZrtr]r6rqrsr{r@rArBrsy# 990@C>B@1 v}}fllC##?@6 MM, 8 LL$ & MM1 aG  T/iu/(4>B.204 B4B4 %B4< B4 , B4 . B4B49B4J 0)5 0 (4>B.204 .. %.< . , . . ...rA