iz"SSKJr SSKrSSKJrJrJrJr SSKJ r SSK J r \(a$SSK J r SSKJr SSKJr SS KJr SS KJr SS KJr \ R0\ R2\ R4/r\S r\ R2S /SQ4\ R4S/SQ4\ R0S/SQ40r"SS\SS9rSSSSS.SSjjr"SS\SS9r SSSSS.SSjjr!g)) 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 exceptionc<\rSrSr%SrS\S'S\S'S\S'S rg ) PerStyleOptionsjz(Per-style options for docstring parsing.r googler numpyrsphinxN__name__ __module__ __qualname____firstlineno____doc____annotations____static_attributes__r;Z/home/james-whalen/.local/lib/python3.13/site-packages/griffe/_internal/docstrings/auto.pyr6r6js 2 . - .rDr6F)totalrmethod style_orderdefaultper_style_optionsc ^SSKJn U(a'U(a [S5e[S[SS9 XUUS.nO U(d0nU=(d [ Vs/sH%n[ U[5(a [U5OUPM' nnUS:XaUHn[UupU V s/sHHn [R"URU 5[R[R-5PMJ n n [U4S jU 55(dMUS 4s $ Ub[ U[5(aUS 4$[U5S 4$US :Xa0n UH nXg"T40UR!U05D6X'M" U R#5VV s0sHup}U[%U 5_M nnn ['UR)55nUHnXU:XdM X|U4s $ [S US 35es snfs sn fs sn nf)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. **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. stacklevelr8r9r:rc3X># UHoRTR5v M! g7f)N)searchvalue).0pattern docstrings rE (infer_docstring_style..sK(w>>)//22(s'*NrzInvalid method 'z'.)#griffe._internal.docstrings.parsersrM ValueErrorrDeprecationWarning_default_style_order isinstancestrr _patternsrecompileformat IGNORECASE MULTILINEanygetitemslenmaxvalues)rXrHrIrJrKoptionsrMstylerW replacements replacementpatternsstyle_sectionssection style_lengthsrs` rEinfer_docstring_styleruusB< QR R JL^klm'.GT S^SvbvSvwSv%Juc$:$:6%=ESvKw  E$-e$4 !GiuiuZe 7>>+6  8TUiu K(KKKd{" !"/Z-H-Hw_cccfU\o_ccc  E$+N9$a@Q@U@UV[]_@`$aN !!CQCWCWCYZCYG ,CY Z=//12  E#|3U333! 'xr2 33-x [s,GAG7GcH\rSrSr%SrS\S'S\S'S\S'S \S 'S rg ) AutoOptionsz"Options for Auto-style docstrings.DocstringDetectionMethodrH*list[Parser] | list[DocstringStyle] | NonerIParser | DocstringStyle | NonerJPerStyleOptions | NonerKr;Nr<r;rDrErwrws), $$0;;? ++;--/rDrwc SSKJn U(a'U(a [S5e[S[SS9 XUUS.nO U(d0n[ UUUUUS9upxUcU"X40UR U05D6$U$) aEParse 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.rOrPrRrG)r[r~r\rr]rurh) rXrHrIrJrKrmr~rnsectionss rE parse_autors4: QR R KM_lmn'.GT ++ OEYJ):)>)>ub)IJJ OrD)rXrrHryrIrzrJr{rKr|rmrr0z3tuple[Parser | None, list[DocstringSection] | None])rXrrHryrIrzrJr{rKr|rmrr0zlist[DocstringSection])" __future__rrbtypingrrrrr#rgriffe._internal.enumerationsr "griffe._internal.docstrings.googler "griffe._internal.docstrings.modelsr !griffe._internal.docstrings.numpyr r[r "griffe._internal.docstrings.sphinxrgriffe._internal.modelsrr:r8r9r^ryrar6rurwrr;rDrErsy# 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 .. %.< . , . . ...rD