i^%SSKJr SSKrSSKrSSKJr SSKJr SSKJ r J r SSK J r SSK JrJrJr SSKJr SS KJrJr SS KJr SS KJr \(aSS KJrJrJr SS KJr SSK J!r!J"r"J#r# "SS\ 5r$SS\$RJS.SSjjr&SS.SSjjr'SSjr(SSjr)SSSSS.r*\"SS55r+\"SSS 9"S!S"\+55r,\"SSS 9"S#S$\+55r-\"SSS 9"S%S&\+55r.\"SSS 9"S'S(\+55r/\"SSS 9"S)S*\+55r0\"SSS 9"S+S,\+55r1\"SSS 9"S-S.\+55r2\"SSS 9"S/S0\+55r3\"SSS 9"S1S2\+55r4\"SSS 9"S3S4\+55r5\"SSS 9"S5S6\+55r6\"SSS 9"S7S8\+55r7\"SSS 9"S9S:\+55r8\"SSS 9"S;S<\+55r9\"SSS 9"S=S>\+55r:\"SSS 9"S?S@\+55r;\"SSS 9"SASB\+55r<\"SSS 9"SCSD\+55r=\"SSS 9"SESF\+55r>\"SSS 9"SGSH\+55r?\"SSS 9"SISJ\+55r@\"SSS 9"SKSL\+55rA\"SSS 9"SMSN\+55rB\"SSS 9"SOSP\+55rC\"SSS 9"SQSR\+55rD\"SSS 9"SSST\+55rE\"SSS 9"SUSV\+55rF\"SSS 9"SWSX\+55rG\"SSS 9"SYSZ\+55rH\"SSS 9"S[S\\+55rI\"SSS 9"S]S^\+55rJ\RS_\RS`\RSa\RSb0rO\RSa\RSc\RSd\RSe\RSf\RSg\RSh\RSi\RSj\RSk\RSl\RSm\RSb0 r]\RSn\RSo0r`\RSp\RSq\RSr\RSs\RSt\RSu\RSv\RSw\RSx\RSy0 rk0\@Sz_\2S{_\9S|_\6S}_\>S~_\GS_\CS_\3S_\?S_\DS_\4S_\,S_\FS_\/S_\HS_\-S_\.S_\0S\8S\AS\=S\7S\;S\\\GR@\\GRB\\GRD\\GRF\\GRH\\GRJ\\GRL\0 ErS\S'SSjrSSS.SSjjrSS\GRVSS.SSjjrSr\ "\SS9r\ "\S\S-S9r\ "\SS9r\ "\S\S-S9r\ "\SS9r\ "\S\S-S9r\ "\SS9r\ "\S\S-S9rg)) annotationsN) dataclass)fields)IntEnumauto)partial) TYPE_CHECKINGAnyProtocol)get_parameters)LogLevel ParameterKind)NameResolutionError)logger)IterableIteratorSequence)Path)ClassFunctionModulec:\rSrSr\"5r\"5r\"5r\"5r\"5r \"5r \"5r \"5r \"5r \"5r\"5r\"5r\"5r\"5r\"5r\"5r\"5r\"5r\"5r\"5r\"5rSrg)_OperatorPrecedenceN)__name__ __module__ __qualname____firstlineno__rNONEYIELDASSIGNSTARREDLAMBDAIF_ELSEORANDNOT COMP_MEMB_IDBIT_ORBIT_XORBIT_ANDLEFT_RIGHT_SHIFTADD_SUBMUL_DIV_REMAINPOS_NEG_BIT_NOTEXPONENTAWAITCALL_ATTRIBUTEATOMIC__static_attributes__rV/home/james-whalen/.local/lib/python3.13/site-packages/griffe/_internal/expressions.pyrrs 6D FE VFfG VFfG B &C &C6L VFfGfGvfGVNfOvH FEVN VFr6rTF)flatis_leftouter_precedencec#r# [U[5(a[U5nSnXC:aSnOwXC:Xar[U[5=(d& [U[5=(a UR S:HnU(a U(aSnO$[U[[ 45(a U(dSnU(a,Sv U(aURSS9ShvN OUv Sv gU(aURSS9ShvN gUv g[U[5(aUHn[XqX2S9ShvN M gUv gNhNBN7f)NFT**(r8)r8r:r9) isinstanceExpr_get_precedence ExprIfExp ExprBinOpoperator ExprBoolOpiteratetuple_yield)elementr8r9r:element_precedence needs_parensis_right_assocelems r7rJrJBs'4  ,W5  0L  3';7I.K73C3Ct3K #'LGi%<==g# I"???555 I D1 1 1M GU # #Dd@Pb b b 6 2 cs6CD7D1 'D70D311D7"D5#D73D75D7r>c#6# [U5n[[U5U[RS9ShvN UHCn[X[RS9ShvN [XB[RS9ShvN ME gNN![ a gf=fN;N7f)zApply a separator between elements. The caller is assumed to provide their own grouping (e.g. lists, tuples, slice) and will prevent parentheses from being added. r8r:N)iterrJnextrr StopIteration)elementsjointr8itrKs r7_joinrXms hB$r(@S@X@XYYY%=P=U=UVVV'?R?W?WXXX Z  WXsU B%BBB BBB9B: BB BBBBBc [U[5(a [U40UD6$[U[5(aUVs/sHn[ U40UD6PM sn$U$s snfN)rArB _expr_as_dictlist_field_as_dict)rKkwargsrOs r7r]r]sX'4  W///'4  ;BC74t.v.7CC NDsArBc [[U5SS9Vs0sH?nURS:wdMUR[[ XR540UD6_MA nnUR US'U$s snf)NcUR$rZ)name)fs r7_expr_as_dict..sr6)keyparentcls)sorted getfieldsrar]getattr classname) expressionr^fieldrs r7r[r[swIj17GHHE :: ! N N7:zz#BMfMMH  ((F5M M s A0.A0rIdictr\set)z typing.Tuplez typing.Dictz typing.Listz typing.Setc\rSrSrSrSSjrSSjrSS.SSjjrSSjrSS jr \ SS j5r \ SS j5r \ SS j5r \ SS j5r\ SSj5r\ SSj5r\ SSj5r\ SSj5rSrg)rBzBase class for expressions.cLSRSURSS955$)Nc3h# UH(n[U[5(aUO URv M* g7frZ)rAstrra).0rOs r7 Expr.__str__..s'hPgz$44t$))CPgs02Tr>)joinrHselfs r7__str__ Expr.__str__s'wwhPTP\P\bfP\Pghhhr6c#># URSS9ShvN gN7f)z.Iterate on the expression syntax and elements.Fr>N)rHrzs r7__iter__ Expr.__iter__s<c#$# SShvN gN7f)awIterate on the expression elements. Parameters: flat: Expressions are trees. When flat is false, this method iterates only on the first layer of the tree. To iterate on all the subparts of the expression, you have to do so recursively. It allows to handle each subpart specifically (for example subscripts, attribute, etc.), without them getting rendered as strings. On the contrary, when flat is true, the whole tree is flattened as a sequence of strings and instances of [Names][griffe.ExprName]. Yields: Strings and names when flat, strings and expressions otherwise. rNrr{r8s r7rH Expr.iterates" s cU$)zModernize the expression. For example, use PEP 604 type unions `|` instead of `typing.Union`. Returns: A modernized expression. rrzs r7 modernizeExpr.modernizes  r6c [U40UD6$)zReturn the expression as a dictionary. Parameters: **kwargs: Configuration options (none available yet). Returns: A dictionary. )r[)r{r^s r7as_dict Expr.as_dictsT,V,,r6c.URR$)zThe expression class name.) __class__rrzs r7rkExpr.classnames~~&&&r6c[U5$z%Path of the expressed name/attribute.rurzs r7path Expr.path4yr6c[U5$rrrzs r7canonical_pathExpr.canonical_pathrr6cURRSS5SRSS5SRS5$)z/Name of the expressed name/attribute/parameter..r=r?)rrsplitsplit removesuffixrzs r7canonical_nameExpr.canonical_names@""))#q1"5;;CCBGTTUXYYr6cN[U[5=(a URS:H$)z4Whether this attribute is annotated with `ClassVar`.ClassVarrA ExprSubscriptrrzs r7 is_classvarExpr.is_classvar!$ .T43F3F*3TTr6cj[U[5=(a URR5S:H$)z#Whether this expression is a tuple.rI)rArrlowerrzs r7is_tuple Expr.is_tuples+$ .Y43F3F3L3L3NRY3YYr6cN[U[5=(a URS:H$)z'Whether this expression is an iterator.rrrzs r7 is_iteratorExpr.is_iteratorrr6cN[U[5=(a URS:H$)z'Whether this expression is a generator. Generatorrrzs r7 is_generatorExpr.is_generators!$ .U43F3F+3UUr6rNreturnru)rIterator[str | Expr]r8boolrr)rrB)r^r rdict[str, Any]rr)rrrr__doc__r|rrHrrpropertyrkrrrrrrrr5rr6r7rBrBs%i,'+& -''ZZ UUZZUUVVr6)eqslotsc\rSrSr%SrS\S'SS.SSjjrSSjrSS jr\ SS j5r \ SS j5r \ SS j5r \ SS j5r Srg) ExprAttributezAttributes like `a.b`.zlist[str | Expr]valuesTr>c## [U5n[URSXSS9ShvN URSSHnSv [X1US9ShvN M gN1N 7f)NrTr@rrrQ)rCrJr)r{r8 precedencevalues r7rHExprAttribute.iterates_$T* $++a.tZ^___[[_EIeL L L% ` Ms!'AA'AA AAc[RUR5=n(a[XRR S9$U$N)rf) _modern_typesgetrExprNamelastrfr{moderns r7rExprAttribute.modernizes8"&&t':':; ;6 ;F99+;+;< < r6cvURcURUlURRU5 g)zXAppend a name to this attribute. Parameters: value: The expression name to append. N)rfrrappend)r{rs r7rExprAttribute.appends+ << 99EL 5!r6c URS$)z/The last part of this attribute (on the right).rrrzs r7rExprAttribute.lasts {{2r6c URS$)z/The first part of this attribute (on the left).rrrzs r7firstExprAttribute.first$s{{1~r6c.URR$)zThe path of this attribute.)rrrzs r7rExprAttribute.path)syy~~r6c.URR$)z%The canonical path of this attribute.)rrrzs r7rExprAttribute.canonical_path.syy'''r6rNr)rzExprName | ExprAttribute)rrrNonerr)r str | Exprr)rrrrr__annotations__rHrrrrrrrr5rr6r7rrsq 2&*M " ((r6rcP\rSrSr%SrS\S'S\S'S\S'SS .S S jjrS rg )rEi4zBinary operations like `a + b`.rleftrurFrightTr>c#@# [U5nUnURS:Xa-[UR[5(a[ US- 5n[ URXSS9ShvN SURS3v [ URXSS9ShvN gN4N7f)Nr<rTr@ F)rCrFrAr ExprUnaryOprrJr)r{r8rright_precedences r7rHExprBinOp.iterate?s$T* % ==D Z K%H%H2:>B $))$UYZZZ$--""$**4\abbb [bs$A#B%B&.BBBBrNrrrrrrrrHr5rr6r7rErE4s.) M &*ccr6rEcD\rSrSr%SrS\S'S\S'SS.S S jjrS rg ) rGiJz!Boolean operations like `a or b`.rurFSequence[str | Expr]rTr>c## [U5n[UR5n[[ U5XSS9ShvN UH(nSUR S3v [XAUSS9ShvN M* gN3N 7f)NTr@rF)rCrRrrJrSrF)r{r8rrWrs r7rHExprBoolOp.iterateSsp$T* $++ $r(TXYYYEdmm_A& &eUZ[ [ [ Z \s!8A2A.)A2$A0% A20A2rNrrrr6r7rGrGJs%+M  &*\\r6rGcX\rSrSr%SrS\S'S\S'\S Sj5rSS .SS jjrS r g )ExprCalli\zCalls like `f()`.rBfunctionr argumentsc.URR$z1The canonical path of this subscript's left part.)rrrzs r7rExprCall.canonical_pathes}}+++r6Tr>c## [URU[U5S9ShvN Sv [URSUS9ShvN Sv gN*N 7f)NrQr=, r>r?)rJrrCrXrrs r7rHExprCall.iteratejsJ$--d_UYEZ[[[ D999  \9s!"AA AA AArNrr) rrrrrrrrrHr5rr6r7rr\s7N## ,,'+r6rcP\rSrSr%SrS\S'S\S'S\S'S S .SS jjrS rg ) ExprCompareiqzComparisons like `a > b`.rrz Sequence[str] operatorsr comparatorsTr>c## [U5n[URXSS9ShvN [URUR 5Hup4SUS3v [XAUS9ShvN M! gNHN 7f)NTr@rrQ)rCrJrziprr)r{r8ropcomps r7rHExprCompare.iterate|sl$T* $))$UYZZZDNND,<,<=HBbT)Od K K K> [ Ls!$A3A/>A3%A1& A31A3rNrrrr6r7rrqs/# %%&*LLr6rc`\rSrSr%SrS\S'S\S'S\S'SrS \S 'S S .SS jjrSrg)ExprComprehensioniz(Comprehensions like `a for b in c if d`.rtargetiterabler conditionsFris_asyncTr>c#(# UR(aSv Sv [URUS9ShvN Sv [URUS9ShvN UR(a"Sv [ URSUS9ShvN ggNXN:N 7f)Nzasync zfor r>z in  if )rrJrrrrXrs r7rHExprComprehension.iteratesx ==N $++D111 $--d333 ??LT__f4@ @ @  23 As31BB BB1BBBBBrNr) rrrrrrrrHr5rr6r7rrs<2 ;$$9Hd%&* A Ar6rc8\rSrSr%SrS\S'SS.S SjjrSrg ) ExprConstantizConstants like `"a"` or `1`.rurTr>c#(# URv g7frZ)rrs r7rHExprConstant.iteratesjjsrNrrrr6r7rrs& J&*r6rcD\rSrSr%SrS\S'S\S'SS.S S jjrS rg ) ExprDictizDictionaries like `{"a": 0}`.zSequence[str | Expr | None]keysrrTr>c## Sv [S[URUR55SUS9ShvN Sv gN 7f)N{c3:# UHupUcSOUSU4v M g7f)Nr: r)rvrers r7rw#ExprDict.iterate..s! iMhzs fdE :Mhsrr>})rXrr rrs r7rHExprDict.iteratesK  iSQUQZQZ\`\g\gMh i      s8AA ArNrrrr6r7r r s$' %%  &*r6r cP\rSrSr%SrS\S'S\S'S\S'SS .S S jjrS rg ) ExprDictCompiz0Dict comprehensions like `{k: v for k, v in a}`.rrerSequence[Expr] generatorsTr>c## Sv [URUS9ShvN Sv [URUS9ShvN Sv [URSUS9ShvN Sv gNJN,N 7f)Nrr>rrr)rJrerrXrrs r7rHExprDictComp.iteratesb $((... $**4000 #D999 /09s1A/A)A/A+ A/A- A/+A/-A/rNrrrr6r7rrs,: O !&*r6rc8\rSrSr%SrS\S'SS.S SjjrSrg ) ExprExtSliceiz Extended slice like `a[x:y, z]`.rdimsTr>c#J# [URSUS9ShvN gN7f)Nrr>)rXrrs r7rHExprExtSlice.iteratesDt444s #!#rNrrrr6r7rrs* &*55r6rc8\rSrSr%SrS\S'SS.S SjjrSrg ) ExprFormattediz Formatted string like `{1 + 1}`.rrTr>c#v# Sv [URU[RS9ShvN Sv gN 7f)NrrQr)rJrrr rs r7rHExprFormatted.iterates2 $**4BUBZBZ[[[  \s +97 9rNrrrr6r7r!r!s* &*r6r!cD\rSrSr%SrS\S'S\S'SS.S S jjrS rg ) ExprGeneratorExpiz5Generator expressions like `a for b in c for d in e`.rrKrrTr>c## [URUS9ShvN Sv [URSUS9ShvN gN&N7f)Nr>rrJrKrXrrs r7rHExprGeneratorExp.iterates<$,,T222 #D999 39sAA AAAArNrrrr6r7r%r%s$? !&*::r6r%cP\rSrSr%SrS\S'S\S'S\S'SS.S S jjrS rg ) rDiz Conditions like `a if b else c`.rbodytestorelseTr>c## [U5n[URXSS9ShvN Sv [US-5n[URXS9ShvN Sv [ UR [5(a"UR RUS9ShvN g[UR XSS9ShvN gNNiN'N 7f) NTr@rrrQz else r>F) rCrJr*rr+rAr,rDrH)r{r8rtest_outer_precedences r7rHExprIfExp.iterates$T* $))$UYZZZ !4JN C$))$WWW dkk9 - -{{***5 5 5dkk[`a a a [ X 6 asF$CB<-CB>ACCC6C7C>CCCrNrrrr6r7rDrDs/*   &*bbr6rDc8\rSrSr%SrS\S'SS.S SjjrSrg ) ExprJoinedStriz!Joined strings like `f"a {b} c"`.rrTr>c#Z# Sv [URSUS9ShvN Sv gN 7f)Nzf'rsr>')rXrrs r7rHExprJoinedStr.iterate s* bt444  5 +) +rNrrrr6r7r1r1s+  &*r6r1cv^\rSrSr%SrS\S'S\S'SrS\S '\SU4S jj5rS S .SS jjr Sr U=r $) ExprKeywordi&zKeyword arguments like `a=b`.rurarrN Expr | Nonerc>UR(a&URRSURS3$[[U]$)zPath of the expressed keyword.r=r?)rrrasuperr7)r{rs r7rExprKeyword.canonical_pathAs; ==mm2231TYYKqA A[$66r6Tr>c#l# URv Sv [URUS9ShvN gN7f)N=r>)rarJrrs r7rHExprKeyword.iterateHs'ii $**4000s *424rrr) rrrrrrrrrrHr5 __classcell__)rs@r7r7r7&sG' I "!Hk I 77 '+11r6r7c8\rSrSr%SrS\S'SS.S SjjrSrg ) ExprVarPositionaliNz,Variadic positional parameters like `*args`.rBrTr>c#P# Sv [URUS9ShvN gN7f)N*r>rJrrs r7rHExprVarPositional.iterateUs $**4000 &$&rNrrrr6r7rArANs6 K&*11r6rAc8\rSrSr%SrS\S'SS.S SjjrSrg ) ExprVarKeywordiZz,Variadic keyword parameters like `**kwargs`.rBrTr>c#P# Sv [URUS9ShvN gN7f)Nr<r>rDrs r7rHExprVarKeyword.iterateas $**4000rFrNrrrr6r7rHrHZs6 K&*11r6rHcD\rSrSr%SrS\S'S\S'SS.S S jjrS rg ) ExprLambdaifz(Lambda expressions like `lambda a: a.b`.zSequence[ExprParameter] parametersrr*Tr>c## SnSnSn[UR5nSv U(aSv [URS5GH^upgUR[R LaSnOUR[R LaSv OsUR[RLaSv OQUR[RLa U(dSnO*UR[RLa U(dSnSv UR[R La U(aSnS v URv UR(aNUR[R [R4;a S v [URUS 9ShvN Xe:dGMZS v GMa S v [URU[RS9ShvN gNEN7f)NFlambdarrTrCr<z*, z/, r=r>rrrQ)lenrM enumeratekindrpositional_onlyvar_positional var_keywordpositional_or_keyword keyword_onlyradefaultrJr*rr )r{r8pos_only pos_or_kwkw_onlylengthindex parameters r7rHExprLambda.iterateosf T__% I )$//1 = E~~!>!>>=#?#?? =#<#<< =#F#FFy =#=#==g ~~]%B%BBx  ..   Y^^M* $))$ATAYAYZZZ @ [s*FGGG3GGGGrNrrrr6r7rLrLfs&2'' &*[[r6rLc8\rSrSr%SrS\S'SS.S SjjrSrg ) ExprListizLists like `[0, 1, 2]`.rrUTr>c#Z# Sv [URSUS9ShvN Sv gN 7f)N[rr>]rXrUrs r7rHExprList.iterate* 4888  9r5rNrrrr6r7raras!&*r6racD\rSrSr%SrS\S'S\S'SS.S S jjrS rg ) ExprListCompiz*List comprehensions like `[a for b in c]`.rrKrrTr>c## Sv [URUS9ShvN Sv [URSUS9ShvN Sv gN*N 7f)Nrcr>rrdr'rs r7rHExprListComp.iterateF $,,T222 #D999  39 A A  A A  A  A rNrrrr6r7riris$4 !&*r6ric\rSrSr%SrS\S'SrS\S'SrS\S 'SS jrS S .SS jjr SSjr \ SSj5r \ SSj5r \ SSj5r\ SSj5r\ SSj5r\ SSj5r\ SSj5rSrg)rizLThis class represents a Python object identified by a name in a given scope.ruraNz1str | ExprName | Module | Class | Function | Nonerf str | Nonemembercj[U[5(aURUR:H$[$)zXTwo name expressions are equal if they have the same `name` value (`parent` is ignored).)rArraNotImplemented)r{others r7__eq__ExprName.__eq__s( eX & &99 * *r6Tr>c## Uv g7frZrrs r7rHExprName.iterates  scx[RUR5=n(a[XRS9$U$r)rrrrrfrs r7rExprName.modernizes2"&&t':':; ;6 ;F;;7 7 r6c[UR[5(a%URRSUR3$UR$)zThe full, resolved name. If it was given when creating the name, return that. If a callable was given, call it and return its result. It the name cannot be resolved, return the source. r)rArfrrrarzs r7r ExprName.paths? dkk8 , ,kk&&'q 4 4yyr6cURc UR$[UR[5(a%URRSUR3$[UR[ 5(aURSUR3$URR RURUR5nURUR5$![a URs$f=f)z2The canonical name (resolved one, not alias name).r) rfrarArrrumembersrrpresolver)r{rfs r7rExprName.canonical_paths ;; 99  dkk8 , ,kk001499+> > dkk3 ' 'kk]!DII;/ /$$((dkkB >>$)), ," 99  sC..DDcURRURRUR5$![a& URR URs$f=f)z(The resolved object this name refers to.)rfmodules_collectionr~ra Exceptionresolvedrzs r7rExprName.resolvedsW 3;;11$++2E2Edii2PQ Q 3;;'' 2 2 3s;>-A.-A.ctURRn[SU55$![a gf=f)z3Whether this name resolves to an enumeration class.Fc3n# UH+n[U[5=(a URS:Hv M- g7f)z enum.EnumN)rArBr)rvbases r7rw)ExprName.is_enum_class..s-c]bUY:dD)Pd.A.A[.PP]bs35)rbasesrany)r{rs r7 is_enum_classExprName.is_enum_classs> MM''E c]bccc   s * 77cPURR$![a gf=f)z6Whether this name resolves to an enumeration instance.F)rfrrrzs r7is_enum_instanceExprName.is_enum_instances) ;;,, ,  s  %%c|URS:H=(a URR$![a gf=f)z3Whether this name resolves to an enumeration value.rF)rarfrrrzs r7 is_enum_valueExprName.is_enum_values7 99'HDKK,H,H H  s +. ;;c SUR;$)z/Whether this name resolves to a type parameter.rc)rrzs r7is_type_parameterExprName.is_type_parametersd))))r6r)rsobjectrr)r8rrzIterator[ExprName]rr)rzModule | Class | Noner)rrrrrrrfrprtrHrrrrrrrrrr5rr6r7rrsV I@DF =D/FJ4 '+     33 d d**r6rcD\rSrSr%SrS\S'S\S'SS.S S jjrS rg ) ExprNamedExpri z+Named/assignment expressions like `a := b`.rBrrrTr>c## [URUS9ShvN Sv [URUS9ShvN gN%N7f)Nr>z := )rJrrrs r7rHExprNamedExpr.iterates:$++D111 $**4000 20sAAAAAArNrrrr6r7rr s#5 L &*11r6rch\rSrSr%SrS\S'\RrS\S'Sr S\S 'Sr S \S 'S r g) ExprParameteriz4Parameters in function signatures like `a: int = 0`.rurarrRNr8 annotationstr | Expr | NonerXr) rrrrrrrrVrRrrXr5rr6r7rrs;> I'==D-="J "!%G %r6rc8\rSrSr%SrS\S'SS.S SjjrSrg ) ExprSeti*zSets like `{0, 1, 2}`.rrUTr>c#Z# Sv [URSUS9ShvN Sv gN 7f)Nrrr>rrers r7rHExprSet.iterate1rgr5rNrrrr6r7rr*s ""&*r6rcD\rSrSr%SrS\S'S\S'SS.S S jjrS rg ) ExprSetCompi7z)Set comprehensions like `{a for b in c}`.rrKrrTr>c## Sv [URUS9ShvN Sv [URSUS9ShvN Sv gN*N 7f)Nrr>rrr'rs r7rHExprSetComp.iterate@rlrmrNrrrr6r7rr7s$3 !&*r6rc\\rSrSr%SrSrS\S'SrS\S'SrS\S'SS .S S jjr S r g) ExprSliceiHzSlices like `[a:b:c]`.NrrupperstepTr>c# # URb[URUS9ShvN Sv URb[URUS9ShvN URb!Sv [URUS9ShvN ggN`N5N 7f)Nr>:)rrJrrrs r7rHExprSlice.iterateSs} :: !djjt4 4 4 :: !djjt4 4 4 99 Idiid3 3 3 ! 5 5 4s3%BB,BB ,BB B B Brr) rrrrrrrrrrHr5rr6r7rrHs< #E ##E #"D "&*44r6rc\rSrSr%SrS\S'S\S'SS.SSjjr\SS j5rSS jr \ SS j5r \ SS j5r S r g)ri^zSubscripts like `a[b]`.rrsliceTr>c## [URU[U5S9ShvN Sv [URU[R S9ShvN Sv gN8N 7f)NrQrcrd)rJrrCrrr rs r7rHExprSubscript.iterategsT$))$QUAVWWW $**4BUBZBZ[[[ X \s!"A!A.A!A A!A!cf[U5S:XaXUup#[U[5(aUR5n[U[5(aUR5n[ X!US9$[ R USSUS9nUSn[U[5(aUR5n[ X!US9$)NrrFrrr)rPrArBrrEr _to_binop)rUrrrs r7rExprSubscript._to_binopns x=A "KD$%%~~'%&&)$5A A&&x}&<  eT " "OO%Edu==r6cNURS:Xa$URURRSS9$URS:XaP[ UR[ 5(a UROURR 5n[USSS9$[[ UR[ 5(a UROURR 5[ UR[ 5(aURS9$URR 5S9$)Nz typing.Union|rztyping.Optionalrr)rr) rrrrUrArurrErr)r{rs r7rExprSubscript.modernize~s   . 0>>$**"5"5#>> >   "3 3!+DJJ!Q>Q>S *4::s ; ;$**  AEAUAUAW  r6c[UR[5(a UR$URR$)z'The path of this subscript's left part.)rArrurrzs r7rExprSubscript.paths- dii % %99 yy~~r6c[UR[5(a UR$URR$r)rArrurrzs r7rExprSubscript.canonical_paths/ dii % %99 yy'''r6rNr)rUrrrurrE)rzExprBinOp | ExprSubscriptr)rrrrrrrH staticmethodrrrrrr5rr6r7rr^s`!  &* > >   ((r6rcR\rSrSr%SrS\S'SrS\S'SS .SS jjrSS jrS r g ) ExprTupleizTuples like `(0, 1, 2)`.rrUFrimplicitTr>c## UR(dSv [URSUS9ShvN [UR5S:XaSv UR(dSv ggN87f)Nr=rr>r,r?)rrXrUrPrs r7rHExprTuple.iteratesS}}I4888 t}}  "I}}I 9s.A+A)9A+c [URVs/sH*n[U[5(aUOUR 5PM, snUR S9$s snf)N)rUr)rrUrArurr)r{els r7rExprTuple.modernizesFNRmm\mJr3//bR\\^Cm\]]  \s1ArNr)rr) rrrrrrrrHrr5rr6r7rrs("""HdZ&* r6rcD\rSrSr%SrS\S'S\S'SS.S S jjrS rg ) rizUnary operations like `-1`.rurFrrTr>c## URv URS:XaSv [URU[U5S9ShvN gN7f)NnotrrQ)rFrJrrCrs r7rHExprUnaryOp.iterates<mm ==E !I$**4/RVBWXXXsAAA ArNrrrr6r7rrs%%M &*YYr6rc<\rSrSr%SrSrS\S'SS.S SjjrS rg) ExprYieldiz Yield statements like `yield a`.NrrTr>c#t# Sv URb!Sv [URUS9ShvN ggN7f)Nyieldrr>)rrJrs r7rHExprYield.iterates5 :: !Idjjt4 4 4 " 4s -868rr) rrrrrrrrHr5rr6r7rrs *#E #&*55r6rc8\rSrSr%SrS\S'SS.S SjjrSrg ) ExprYieldFromiz%Yield statements like `yield from a`.rrTr>c#P# Sv [URUS9ShvN gN7f)Nz yield from r>rDrs r7rHExprYieldFrom.iterates$**4000rFrNrrrr6r7rrs/ &*11r6r~r+-&r^///<<@%rCr<>>andorz==z!=z>=iszis notinznot inc"[R$rZrr4_s r7rcrc +22r6c"[R$rZrrs r7rcrc /66r6c"[R$rZrrs r7rcrc  077r6c"[R$rZrrs r7rcrc rr6c"[R$rZrrs r7rcrc rr6c"[R$rZrrs r7rcrc s ,33r6c"[R$rZrrs r7rcrcs *11r6c"[R$rZrrs r7rcrcrr6c"[R$rZrrs r7rcrcrr6c"[R$rZrrs r7rcrcs .55r6c"[R$rZrrs r7rcrcrr6c"[R$rZrr3rs r7rcrc 0??r6c"[R$rZrrs r7rcrcrr6c"[R$rZrrs r7rcrcs +::r6cvS[R0RUR[R5$)Nr)rr(rrFr0es r7rcrcs(E#6#:#:;?? L_LoLopr6c[R[R[R[R[R[R[R[R[R[R[R [R [RS. UR$)N) r<rCrrrrrrrrrrr) rr1r/r.r-r,r+r*rFrs r7rcrcs!** / / / / / /!00 / / ( ( ( (!22!22 ( ( ( ( ' 'jjr6c^[R[RS.UR$)N)rr)rr'r&rFrs r7rcrc's#"5"9"9ATAWAWXYZYcYcdr6c"[R$rZ)rr)rs r7rcrc(s .;;r6c"[R$rZ)rr%rs r7rcrc)s ,44r6c"[R$rZ)rr"rs r7rcrc*rr6c"[R$rZrr$rs r7rcrc+s -44r6c"[R$rZrrs r7rcrc-s 3 : :r6c"[R$rZrr#rs r7rcrc.s !4!.=s 5H5M5Mr6)_precedence_maprtype)exprs r7rCrC<s   tDz+M Nt TTr6c [URU40UD6n[U[5(a&UR [ UR 55 U$[U[ 5(a![U[ UR U5/5$[U[5(a![U[ UR S5/5$[U[ UR 5/5$)Nru)_buildrrArrrattrru)noderfr^rs r7_build_attributer@s $**f / /D$ && HTYY'( $!!dHTYY$=>??$dHTYY$>?@@ $ 34 55r6c [[URU40UD6[[ UR 5[UR U40UD65$rZ)rErr_binary_op_maprrrrrfr^s r7 _build_binopr"LsE tyy&+F+tDGG}%tzz6,V, r6c [[[UR5URVs/sHn[ X140UD6PM sn5$s snfrZ)rG _bool_op_maprrrr)rrfr^rs r7 _build_boolopr%TsB T$'']#6:kkBkU ( (kB BsA c [URU40UD6nURVs/sHn[XA40UD6PM nnURVs/sHn[Xa4SU0UD6PM nn[ U/UQUQ5$s snfs snf)Nr)rfuncargskeywordsr)rrfr^rargpositional_argskwarg keyword_argss r7 _build_callr.[sdii262H@D J vc4V4 OJTXTaTabTa5F5F8FvFTaLb H??,? @@Kbs A6 A;c [[URU40UD6URVs/sHn[[ U5PM snUR Vs/sHn[XA40UD6PM sn5$s snfs snfrZ)rrrops_compare_op_maprr)rrfr^rrs r7_build_comparer2bsk tyy&+F+-1XX6Xrb "X6484D4DE4DD ' '4DE 6Es A3 A8 c [[URU4SS0UD6[URU40UD6URVs/sHn[X140UD6PM sn[ UR 5S9$s snf)N compr_targetT)r)rrrrRifsrr)rrfr^ conditions r7_build_comprehensionr7jsl t{{F@@@tyy&+F+>BhhGh ,V ,hGdmm$   HsA1 )in_formatted_str in_joined_str parse_stringsliteral_stringsc [UR[5(aeU(aU(d UR$U(aDU(d=[URSS[R SS9n[ URU40UD6$[S5S0R[UR5[5"UR5$![a$ [R"SUR5 Nrf=f)Nevalzr)modefilenameflagsoptimizezTried and failed to parse %r as Python code, falling back to using it as a string literal (postponed annotations might help: https://peps.python.org/pep-0563/).cg)Nz...rrs r7rc!_build_constant..sr6)rArrucompileast PyCF_ONLY_ASTrr* SyntaxErrorrdebugrrrepr)rrfr8r9r:r;r^parseds r7_build_constantrKss$**c"" !1::    = JJ2++ fkk6v>tzzSY@d]c@d eer6c l[URVs/sHn[X140UD6PM sn5$s snfrZ)rrbrrcs r7 _build_setrns- 499E9RF2009E FFErec [[URU40UD6URVs/sHn[X140UD6PM sn5$s snfrZ)rrrUrrOs r7_build_setcomprpsF vdhh9&9eietet;uet^aF3typing.Literaltyping_extensions.LiteralTrurv)rrrArrrrr)rrfr:r;rvr^r slice_exprs r7_build_subscriptr{s $**f / /D d]H5 6 64;N;NS < #O JJ  +    DJJOOO  **r6)rvr4c |[URVs/sHn[XQ40UD6PM snU=(d US9$s snf)N)r)rrbr)rrfrvr4r^rs r7 _build_tupler}$s8 TYYGYrfR262YGRaRqeq rrGs9c x[[[UR5[ UR U40UD65$rZ)r _unary_op_maprrroperandr!s r7_build_unaryopr/s- }T$'']3VDLL&5[TZ5[ \\r6c h[URcS5$[URU40UD65$rZ)rrrr!s r7 _build_yieldr3s/ TZZ/T ZZVDJJ5YRX5Y ZZr6c B[[URU40UD65$rZ)rrrr!s r7_build_yield_fromr7s  F=f= >>r6c\rSrSrSSjrSrg)_BuildCallablei;c grZr)r{rrfr^s r7__call___BuildCallable.__call__<sRUr6rN)rr rfModule | Classr^r rrB)rrrrrr5rr6r7rr;sUr6rzdict[type, _BuildCallable] _node_mapc 4[[U5"X40UD6$rZ)rrr!s r7rr_s T$Z  8 88r6rpr:cUcgUcURnUR(+n[XX#S9$![a SnNf=f)a:Build an expression from an AST. Parameters: node: The annotation node. parent: The parent used to resolve the name. member: The member name (for resolution in its scope). parse_strings: Whether to try and parse strings as type annotations. Returns: A string or resovable name or expression. NFr)moduleimports_future_annotations ValueErrorr)rrfrpr:rs r7get_expressionrcsT$ | B]]F!' A AAM $v KK  "!M "s 0 ??zD{path}:{lineno}: Failed to get expression from {node_class}: {error})rpr: log_level msg_formatcp[XX#S9$![anUcSnAgURRnURnO![ a SnOf=fUR n URRSU3n URXXzS9n [[UR5"U 5 SnAgSnAff=f)a Safely (no exception) build a resolvable annotation. Parameters: node: The annotation node. parent: The parent used to resolve the name. member: The member name (for resolution in its scope). parse_strings: Whether to try and parse strings as type annotations. log_level: Log level to use to log a message. None to disable logging. msg_format: A format string for the log message. Available placeholders: path, lineno, node, error. Returns: A string or resovable name or expression. rNz r)rlineno node_classerror) rrrrrelative_filepathrrformatrjrr) rrfrpr:rrrrrr error_strmessages r7r_r_s. 2d6WW  2  ^^,,  !%77D ! D !//05': ###e (11  2s= B5B0B0 AB0 AB0AAB00B5zG{path}:{lineno}: Failed to get %s expression from {node_class}: {error})r:r)r:rz base classz class keywordr6) rKz#str | Expr | tuple[str | Expr, ...]r8rr9rr:rrr)rUz-Iterable[str | Expr | tuple[str | Expr, ...]]rVrr8rrr)rKz+str | bool | Expr | list[str | Expr] | Noner^r rzstr | bool | None | list | dict)rlrBr^r rr)rrBrr)rz ast.Attributerfrr^r rrB)rz ast.BinOprfrr^r rrB)rz ast.BoolOprfrr^r rrB)rzast.Callrfrr^r rrB)rz ast.Comparerfrr^r rrB)rzast.comprehensionrfrr^r rrB)rz ast.Constantrfrr8rr9rr:rr;rr^r rr)rzast.Dictrfrr^r rrB)rz ast.DictComprfrr^r rrB) rzast.FormattedValuerfrr8rr^r rrB)rzast.GeneratorExprfrr^r rrB)rz ast.IfExprfrr^r rrB) rz ast.JoinedStrrfrr9rr^r rrBrZ) rz ast.keywordrfrrr8r^r rrB)rz ast.Lambdarfrr^r rrB)rzast.Listrfrr^r rrB)rz ast.ListComprfrr^r rrB) rzast.Namerfrrpror^r rrB)rz ast.NamedExprrfrr^r rrB)rzast.Setrfrr^r rrB)rz ast.SetComprfrr^r rrB)rz ast.Slicerfrr^r rrB)rz ast.Starredrfrr^r rrB)rz ast.Subscriptrfrr:rr;rrvrr^r rrB) rz ast.Tuplerfrrvrr4rr^r rrB)rz ast.UnaryOprfrr^r rrB)rz ast.Yieldrfrr^r rrB)rz ast.YieldFromrfrr^r rrB)rzast.ASTrfrr^r rrB) rast.AST | Nonerfrrpror: bool | Nonerr8)rrrfrrpror:rrzLogLevel | Nonerrurr8) __future__rrEsys dataclassesrrrienumrr functoolsrtypingr r r (griffe._internal.agents.nodes.parametersr griffe._internal.enumerationsr rgriffe._internal.exceptionsrgriffe._internal.loggerrcollections.abcrrrpathlibrgriffe._internal.modelsrrrrr4rJrXr]r[rrBrrErGrrrrr rrr!r%rDr1r7rArHrLrarirrrrrrrrrrrInvertNotUAddUSubrAddBitAndBitOrBitXorDivFloorDivLShiftMatMultModMultPowRShiftSubr AndOrr$EqNotEqLtLtEGtGtEIsIsNotInNotInr1rrCrr"r%r.r2r7rKrMrQrSrVrYr[r]r`rdrgrjrlrnrprrrtr{r}rrrr AttributeBinOpBoolOpCallCompare comprehensionConstantDictDictCompFormattedValue GeneratorExpIfExp JoinedStrkeywordLambdaListListCompName NamedExprSetSetCompSliceStarred SubscriptTupleUnaryOpYield YieldFromrrrrrr_ _msg_formatget_annotationsafe_get_annotationget_base_classsafe_get_base_classget_class_keywordsafe_get_class_keyword get_conditionsafe_get_conditionrr6r7rs # !+//CA;*<<??"'"P,?,F,F ( 0( ( ( * (  (^ Y;Y Y  Y  Y. 8%   ZVZV ZVz d$0(D0( 0(f d$cc c* d$\\ \" d$t ( d$L$L L$ d$AA A8 d$4  d$t $ d$4 ( d$545 5 d$ D    d$ :t :  : d$bb b8 d$ D    d$$1$$1 $1N d$11 1 d$1T1 1 d$'['[ '[T d$ t    d$ 4     e4 Z*tZ*!Z*z d$ 1D 1  1 d$ D    d$ d    d$ $     d$44 4* d$6(D6( 6(r d$    0 d$ Y$ Y  Y d$ 5 5  5 d$1D1 1JJGGUHHcHHc  GGSJJIIsJJGGSLL$JJKKGGSHHcGGTJJGGS"GGUFFD FFDIItFFCGGTFFCGGTFFDIIxFFDIIx 4 24647 4 7 4 2434 14 24645464?4 ?!4" :#4$p%4&'4DdE4F; 474:<9 269435 1g4nU 6A#!$P $P $P $P  $P  $P$P$P$PN# V V V V  V  V i i i i  i  iZ "Hx-fGwC !! + + + +  +  ++ +B" s s s s  s  s s][?VXV)MM#)II|)JJ )HHk ) KK ) + )LL/)HHk)LL/)()))II|)MM#)KK)JJ ) HHk!)"LL/#)$HHkMM$GGZKKII|KKMM#II|KKII|MM$9) %@9!% L L L  L  L  LD!%!)\% % %  %  %  %%%PX t<\) u=\) N%@ _, e< [(r6