%j=ddlmZddlmZddlmZddlmZerddlm Z ddlm Z m Z ddlm Z Gdd Z Gd d e ZGd d e ZGdde ZGdde ZGdde ZGddeZGddeZGddeZGddeZGddeZGddeZGd d!eZGd"d#eZGd$d%eZGd&d'eZGd(d)ZGd*d+eZGd,d-eZGd.d/eZ Gd0d1eZ!Gd2d3eZ"Gd4d5eZ#Gd6d7eZ$Gd8d9eZ%Gd:d;eZ&Gd<d=eZ'Gd>d?eZ(Gd@dAeZ)GdBdCeZ*GdDdEeZ+GdFdGeZ,GdHdIeZ-GdJdKeZ.dLS)M) annotations) TYPE_CHECKING)DocstringSectionKind) ExprTuple)Sequence)AnyLiteral)Exprc(eZdZdZdddd ZddZdS)DocstringElementz8This base class represents annotated, nameless elements.N annotation descriptionstrrstr | Expr | NonereturnNonec$||_ ||_dS)zInitialize the element. Parameters: annotation: The element annotation, if any. description: The element description. Nrr)selfrrs j/home/rurouni/.hermes/hermes-agent/venv/lib/python3.11/site-packages/griffe/_internal/docstrings/models.py__init__zDocstringElement.__init__s!,&-7%%kwargsrdict[str, Any]c  |j|jdS)Return this element's data as a dictionary. Parameters: **kwargs: Additional serialization options. Returns: A dictionary. rrr)rrs ras_dictzDocstringElement.as_dict!s/+   r)rrrrrrrrrr)__name__ __module__ __qualname____doc__rrrrr r sOBBLP & & & & & &       rr c8eZdZdZddddfd Zdfd ZxZS)DocstringNamedElementz5This base class represents annotated, named elements.N)rvaluenamerrrrr(rrclt||||_ ||_dS)zInitialize the element. Parameters: name: The element name. description: The element description. annotation: The element annotation, if any. value: The element value, as a string. rN)superrr)r()rr)rrr( __class__s rrzDocstringNamedElement.__init__3s9 [ZHHH (- ''rrrrc nd|jitjdi|}|j |j|d<|S)rr)Nr(r%)r)r+rr()rrbaser,s rrzDocstringNamedElement.as_dictIsD ?_UWW_%>%>v%>%>? : ! JDM r) r)rrrrrr(rrrr )r!r"r#r$rr __classcell__r,s@rr'r'0ss??)-#' ((((((((,          rr'ceZdZdZed dZejddZedd Zejdd Zd S)DocstringAdmonitionz$This class represents an admonition.rrc|jS)zThe kind of this admonition.r rs rkindzDocstringAdmonition.kind[ rr( str | Exprrc||_dSNr rr(s rr5zDocstringAdmonition.kind` rrc|jS)z The contents of this admonition.rr4s rcontentszDocstringAdmonition.contentsds rc||_dSr9r=r:s rr>zDocstringAdmonition.contentsis rNrr)r(r7rrrrr(rrr)r!r"r#r$propertyr5setterr>r%rrr2r2Xs.. X [   [    X _!!!_!!!rr2cLeZdZdZed dZejd dZdS) DocstringDeprecatedz3This class represents a documented deprecated item.rrc|jS)z The version of this deprecation.r r4s rversionzDocstringDeprecated.versionqr6rr(rc||_dSr9r r:s rrHzDocstringDeprecated.versionvr;rNrArB)r!r"r#r$rCrHrDr%rrrFrFnsZ== X ^   ^   rrFceZdZdZdS)DocstringRaisez/This class represents a documented raise value.Nr!r"r#r$r%rrrKrK{9999rrKceZdZdZdS) DocstringWarnz.This class represents a documented warn value.NrLr%rrrOrO8888rrOceZdZdZdS)DocstringReturnz0This class represents a documented return value.NrLr%rrrRrRs::::rrRceZdZdZdS)DocstringYieldz/This class represents a documented yield value.NrLr%rrrTrTrMrrTceZdZdZdS)DocstringReceivez1This class represents a documented receive value.NrLr%rrrVrVs;;;;rrVcLeZdZdZed dZejd dZd S) DocstringParameterz5This class represent a documented function parameter.rrc|jS)z$The default value of this parameter.r(r4s rdefaultzDocstringParameter.default zrr(rrc||_dSr9rZr:s rr[zDocstringParameter.default  rNr@rB)r!r"r#r$rCr[rDr%rrrXrXsZ?? X ^^rrXceZdZdZeddZejddZedd Zejdd Zedd ZejddZdS)DocstringTypeParameterz1This class represent a documented type parameter.rrc|jS)z)The default value of this type parameter.rZr4s rr[zDocstringTypeParameter.defaultr\rr(rrc||_dSr9rZr:s rr[zDocstringTypeParameter.defaultr^rcHt|jts|jSdS)z!The bound of this type parameter.N) isinstancerrr4s rboundzDocstringTypeParameter.bounds%$/955 #? "trrec||_dSr9r )rres rrezDocstringTypeParameter.boundr;rtuple[str | Expr, ...] | Noneclt|jtrt|jjSdS)z'The constraints of this type parameter.N)rdrrtupleelementsr4s r constraintsz"DocstringTypeParameter.constraintss0 doy 1 1 3122 2trrkSequence[str | Expr] | NonecD|t||_dSd|_dSr9)rr)rrks rrkz"DocstringTypeParameter.constraintss&  "' 44DOOO"DOOOrNr@rB)rerrr)rrg)rkrlrr) r!r"r#r$rCr[rDrerkr%rrr`r`s;; X ^^X  \   \ X ######rr`ceZdZdZdS)DocstringAttributez:This class represents a documented module/class attribute.NrLr%rrrorosDDDDrroc*eZdZdZeddZdS)DocstringFunctionz,This class represents a documented function.rrc|jS)zThe function signature.r r4s r signaturezDocstringFunction.signaturer6rNr@r!r"r#r$rCrsr%rrrqrqs866 Xrrqc*eZdZdZeddZdS)DocstringClassz)This class represents a documented class.rrc|jS)zThe class signature.r r4s rrszDocstringClass.signaturer6rNr@rtr%rrrvrvs833 XrrvceZdZdZdS)DocstringTypeAliasz.This class represents a documented type alias.NrLr%rrryryrPrryceZdZdZdS)DocstringModulez*This class represents a documented module.NrLr%rrr{r{s4444rr{c:eZdZUdZded< ddd Zdd ZddZdS)DocstringSectionz*This class represents a docstring section.rr5Ntitle str | Nonerrc$||_ d|_dS)z[Initialize the section. Parameters: title: An optional title. N)r~r()rr~s rrzDocstringSection.__init__s "'     rboolc*t|jS)z*Whether this section has a true-ish value.)rr(r4s r__bool__zDocstringSection.__bool__sDJrrrrc t|jdr|jjdi|}n|j}|jj|d}|jr |j|d<|S)zReturn this section's data as a dictionary. Parameters: **kwargs: Additional serialization options. Returns: A dictionary. r)r5r(r~r%)hasattrr(rr5r~)rrserialized_valuer.s rrzDocstringSection.as_dictsj 4:y ) ) *1tz1;;F;;  #z  2BCC : ' JDM rr9)r~rrr)rrr )r!r"r#r$__annotations__rrrr%rrr}r}sl44 ! ! ! ! !    rr}c@eZdZUdZejZded<d d fd ZxZ S)DocstringSectionTextz%This class represents a text section.rr5Nr(rr~rrrcXt|||_dS)zInitialize the section. Parameters: value: The section text. title: An optional title. Nr+rr(rr(r~r,s rrzDocstringSectionText.__init__s(  rr9)r(rr~rrr) r!r"r#r$rtextr5rrr/r0s@rrr s^//!5!:D::::           rrc@eZdZUdZejZded<d d fd ZxZ S)DocstringSectionParametersz+This class represents a parameters section.rr5Nr(list[DocstringParameter]r~rrrcXt|||_dS)zInitialize the section. Parameters: value: The section parameters. title: An optional title. Nrrs rrz#DocstringSectionParameters.__init__( /4 rr9)r(rr~rrr) r!r"r#r$r parametersr5rrr/r0s@rrrs^55!5!@D@@@@55555555555rrc,eZdZUdZejZded<dS)DocstringSectionOtherParametersz2This class represents an other parameters section.rr5N)r!r"r#r$rother_parametersr5rr%rrrr)s,<D>>>>33333333333rrcBeZdZUdZejZded< d d fd ZxZ S)DocstringSectionExamplesz*This class represents an examples section.rr5Nr(Slist[tuple[Literal[DocstringSectionKind.text, DocstringSectionKind.examples], str]]r~rrrcXt|||_dS)zInitialize the section. Parameters: value: The section examples. title: An optional title. Nrrs rrz!DocstringSectionExamples.__init__s( jo rr9)r(rr~rrr) r!r"r#r$rexamplesr5rrr/r0s@rrrsn44!5!>D>>>> ! p p p p p p p p p p prrc@eZdZUdZejZded<d d fd ZxZ S)DocstringSectionAttributesz,This class represents an attributes section.rr5Nr(list[DocstringAttribute]r~rrrcXt|||_dS)zInitialize the section. Parameters: value: The section attributes. title: An optional title. Nrrs rrz#DocstringSectionAttributes.__init__rrr9)r(rr~rrr) r!r"r#r$r attributesr5rrr/r0s@rrrs^66!5!@D@@@@55555555555rrc@eZdZUdZejZded<d d fd ZxZ S)DocstringSectionFunctionsz2This class represents a functions/methods section.rr5Nr(list[DocstringFunction]r~rrrcXt|||_dS)zInitialize the section. Parameters: value: The section functions. title: An optional title. Nrrs rrz"DocstringSectionFunctions.__init__s( .3 rr9)r(rr~rrr) r!r"r#r$r functionsr5rrr/r0s@rrrs^<rsz#""""" >>>>>>2222222((((((########111111        <%%%%%,%%%P!!!!!*!!!,      *    :::::%:::99999$999;;;;;+;;;:::::*:::<<<<<,<<<     .   ##########2######LEEEEE.EEE-*99999.99955555+555 %%%%%%%%P      +    5 5 5 5 5!1 5 5 5 GGGGG&@GGG 9 9 9 9 9%5 9 9 9 1 1 1 1 1- 1 1 1 0 0 0 0 0, 0 0 0 2 2 2 2 2. 2 2 2 1 1 1 1 1- 1 1 1 3 3 3 3 3/ 3 3 3 ppppp/ppp( 5 5 5 5 5!1 5 5 5 4 4 4 4 4 0 4 4 4 1 1 1 1 1. 1 1 1 5 5 5 5 5"2 5 5 5 2 2 2 2 2. 2 2 2 ddddd!1ddd"aaaaa!1aaaaar