+ S_yiC 2aR*tR0t^RIt^RIt^RIt^RIt^RIt^RIt^RIHt^RIH t H t H t ^RI H t ^RIHtHtHtHtHtHtHtHtHtHtHtHt]'d)^RIHt!RR] 4t]]]3,t]P>tR t !R R ]PB!R R 44t"R+R lt#R+Rlt$Rt%Rt&Rt'R,Rlt(]PRPU4UUu0uF`wr]+!V],4'gK]-!V]P\]P^]P`]Pb]Pd34'gK^VkKb uppt3R,Rlt4]PRPU4UUu0uF3wr]+!V],4'gK]-!V]Pj4'gK1VkK5 uppt6]PRPU4UUu0uF3wr]+!V],4'gK]-!V]P4'gK1VkK5 upp0R-m,t7Rt8Rt9Rt:Rt;Rt<]Pz3t>]^k^RI?H@t@]>]@3, t>RtBRtCRtDRtERtF]G!4tHRtIR,R ltJR!tK!R"R#4tLR$tMR%tNR&tO] !RR'7R(4tPR)tQR#uuppiuuppiuuppi ]AdLci;i).N)ABCMeta)ModuleexprAST) lru_cache) CallableDictIterableIteratorListOptionalTupleUnioncastAny TYPE_CHECKINGType)NodeNGc*]tRt^,tRtRt^t^t^tRt R#) EnhancedASTN) __name__ __module__ __qualname____firstlineno__ first_token last_tokenlineno end_linenoend_col_offset__static_attributes__r0/usr/lib/python3/dist-packages/asttokens/util.pyrr,sKJ FJNr"rcn\PV,: R\V4PR4: 2#)zRReturns a human-friendly representation of a token with the given type and string.:u)tokentok_namereprlstrip)tok_typestrings&&r# token_reprr-9s*NN8,,d6l.A.A#.F GGr"c*a]tRt^@toRtRtRtVtR#)Tokenam TokenInfo is an 8-tuple containing the same 5 fields as the tokens produced by the tokenize module, and 3 additional ones useful for this module: - [0] .type Token type (see token.py) - [1] .string Token (a string) - [2] .start Starting (row, column) indices of the token (a 2-tuple of ints) - [3] .end Ending (row, column) indices of the token (a 2-tuple of ints) - [4] .line Original line (string) - [5] .index Index of the token in the list of tokens that it belongs to. - [6] .startpos Starting character offset into the input text. - [7] .endpos Ending character offset into the input text. cB\VPVP4#N)r-typer,selfs&r#__str__ Token.__str__Ns dii --r"rN)rrrr__doc__r5r!__classdictcell__ __classdict__s@r#r/r/@s ..r"r/z0type string start end line index startpos endposcfVPV8H;'dVRJ;'gVPV8H#)zVReturns true if token is of the given type and, if a string is given, has that string.N)r2r,r'r+tok_strs&&&r# match_tokenr>Ss0 x  P PW_%O%O 8OPr"c \WV4'gW\R\W4: R\V4: RVP^,: RVP^,^,: 24hR#)z Verifies that the given token is of the expected type. If tok_str is given, the token string is verified too. If the token doesn't match, raises an informative ValueError. zExpected token z, got z on line z col N)r> ValueErrorr-strstartr<s&&&r# expect_tokenrCYsR Ug . . #SZ kk!nnekk!nq(* ++ /r"cfV\P\P\P39#)zO These are considered non-coding tokens, as they don't affect the syntax tree. )r'NLCOMMENTENCODING) token_types&r#is_non_coding_tokenrIes" %--@ @@r"c\P!\\.\3,\ P !V4P44#)z7 Generates standard library tokens for the given code. )tokenizegenerate_tokensrrrAioStringIOreadline)texts&r#rLrLms4  ! !$xC'8"++d:K:T:T"U VVr"c>\VR4'd\#\#)z Returns a function which yields all direct children of a AST node, skipping children that are singleton nodes. The function depends on whether ``node`` is from ``ast`` or from the ``astroid`` module. get_children)hasattriter_children_astroiditer_children_astnodes&r#iter_children_funcrXxs#*$"?"? VEVVr"cXV'g\V4'd.#VP4#r1) is_joined_strrR)rWinclude_joined_strs&&r#rTrTs#  d 3 3 I   r"c#b"V'g\V4'dR#\V\P4'd8\ VP VP 4Fwr#VeVxVxK R#\P!V4FpVP\9gKVxK R#5ir1) rZ isinstanceastr zipkeysvaluesiter_child_nodes __class__ SINGLETONS)rWr[keyvaluechilds&& r#rUrUs  d 3 3 chhDIIt{{3   k4 ##D)e j( k *s BB/% B/c<VPP\9#)z+Returns whether node is an expression node.)rcrexpr_class_namesrVs&r#is_exprrj  $4 44r"c<VPP\9#)z)Returns whether node is a statement node.)rcrstmt_class_namesrVs&r#is_stmtrnrkr"c4VPPR8H#)z&Returns whether node is a module node.rrcrrVs&r# is_modulerqs  H ,,r"c4VPPR8H#)zFReturns whether node is a JoinedStr node, used to represent f-strings. JoinedStrrprVs&r#rZrZs  K //r"c4VPPR8H#)zSReturns whether node is an `Expr` node, which is a statement that is an expression.ExprrprVs&r# is_expr_stmtrvs  F **r")Constc"\V\4#)z(Returns whether node is a Constant node.)r]CONSTANT_CLASSESrVs&r# is_constantrzs D* ++r"cL\V4;'dVP\J#)z)Returns whether node is an Ellipsis node.)rzrfEllipsisrVs&r# is_ellipsisr}s  T  5 5tzzX55r"c4VPPR8H#)z2Returns whether node is a starred expression node.StarredrprVs&r# is_starredrs  I --r"c VPPR9;'g]VPPR8H;'d<\\\\ \ PV4P44#)z?Returns whether node represents a slice, e.g. `1:2` in `x[1:2]`r)SliceExtSlice) rcranymapis_slicerr^reltsrVs&r#rrsb  nn!66 .. ! !W , = =#hSYY 5 : :;< r"cVPPR8H;'dg\V\P4'*;'d@VP VP u;J;'dVPu;J;'dRJ#u#)rN)rcrr]r^rloweruppersteprVs&r#is_empty_astroid_slicersn nn(88sww' '88 ** 7 7dii 7 74 7 8r"cV'gRp\V4p\4pRpVR\3.pV'dVP4wrxp V \JdkWt9gQhVP V4V!Wx4wrVP WxV 34\ V4p V!V4Fp VPWV \34K KV!Wx\\\,V 44pKV#)a Scans the tree under the node depth-first using an explicit stack. It avoids implicit recursion via the function call stack to avoid hitting 'maximum recursion depth exceeded' error. It calls ``previsit()`` and ``postvisit()`` as follows: * ``previsit(node, par_value)`` - should return ``(par_value, value)`` ``par_value`` is as returned from ``previsit()`` of the parent. * ``postvisit(node, par_value, value)`` - should return ``value`` ``par_value`` is as returned from ``previsit()`` of the parent, and ``value`` is as returned from ``previsit()`` of this node itself. The return ``value`` is ignored except the one for the root node, which is returned from the overall ``visit_tree()`` call. For the initial node, ``par_value`` is None. ``postvisit`` may be None. cR#r1r)rWpvaluerfs&&&r#visit_tree..sDr"N) rXset _PREVISITpopaddappendleninsertrr r/)rWprevisit postvisit iter_childrendoneretstackcurrent par_valuerfr post_valueinsns&&& r# visit_treers$ 0I$T*- $ # $ " #% % G     hhw#G7f llG 34 JcW%! Sfi01& g$x*F Gc *r"c#"\V4p\4pV.pV'd[VP4pWS9gQhVPV4Vx\ V4pV!WQ4FpVP Wg4K KbR#5i)a# Recursively yield all descendant nodes in the tree starting at ``node`` (including ``node`` itself), using depth-first pre-order traversal (yieling parents before their children). This is similar to ``ast.walk()``, but with a different order, and it works for both ``ast`` and ``astroid`` trees. Also, as ``iter_children()``, it skips singleton nodes generated by ``ast``. By default, ``JoinedStr`` (f-string) nodes and their contents are skipped because they previously couldn't be handled. Set ``include_joined_str`` to True to include them. N)rXrrrrr)rWr[rrrrrcs&& r#walkr)su%T*- $ &% iikG   HHW M e*C 7 7 ll38 s A?AA?c^p.p\V4F,wrEpVPWV4VPV4TpK. VPWR4RPV4#)a\ Replaces multiple slices of text with new values. This is a convenience method for making code modifications of ranges e.g. as identified by ``ASTTokens.get_text_range(node)``. Replacements is an iterable of ``(start, end, new_text)`` tuples. For example, ``replace("this is a test", [(0, 4, "X"), (8, 9, "THE")])`` produces ``"X is THE test"``. N)sortedrjoin)rP replacementsppartsrBendnew_texts&& r#replacerFsc! % &| 4u8 LL LL A!5,,tBx r"c0a]tRtRtoRtRtRtRtVtR#) NodeMethodsiZzW Helper to get `visit_{node_type}` methods given a node's class and cache the results. c/VnR#r1_cacher3s&r#__init__NodeMethods.__init__^s DKr"c VPPV4pV'gFRVPP4,p\ WVP 4pW0PV&V#)z Using the lowercase name of the class as node_type, returns `obj.visit_{node_type}`, or `obj.visit_default` if the type-specific method is not found. visit_)rgetrrgetattr visit_default)r4objclsmethodnames&&& r#rNodeMethods.getbsS [[__S !F   **, ,ds#"3"34fkk# Mr"rN) rrrrr7rrr!r8r9s@r#rrZs  r"rc#~".pVFpVP\P\P\P39d>V'd#VR,P VP 8XdVPV4K~\V4FpVxK .pVxK \V4FpVxK R#5i)a Fixes tokens yielded by `tokenize.generate_tokens` to handle more non-ASCII characters in identifiers. Workaround for https://github.com/python/cpython/issues/68382. Should only be used when tokenizing a string that is known to be valid syntax, because it assumes that error tokens are not actually errors. Combines groups of consecutive NAME, NUMBER, and/or ERRORTOKEN tokens into a single NAME token. N) r2rKNAME ERRORTOKENNUMBERrrBrcombine_tokens)original_tokensgrouptokcombined_tokens& r#patched_generate_tokensrps E ((x}}h&9&98??K KE"IMMSYY6 S,U3N 4 )/ 0s A B=A-B=c\;QJdRV4F 'gK RM RM !RV44'd*\VUu0uFqPkK up4^8wdV#\P!\P RP RV44V^,PVR,PV^,PR7.#uupi)c3Z"TF!qP\P8HxK# R#5ir1)r2rKr).0rs& r# !combine_tokens..s@%3xx8...%s)+TFrc38"TFqPxK R#5ir1)r,)rts& r#rrs/Axxs)r2r,rBrliner) rrrrK TokenInforrrBr)rrs& r#rrs 3@%@333@%@ @ @C]bHc]bVY]bHcDdhiDi l ]]ww///Ahnn "IMM 1X]]  IdsCc\V4!V4Uu.uF2p\V4'g\V4PR9gK0VNK4 ppV'd\ VR,4#V#uupi)zk If the given AST node contains multiple statements, return the last one. Otherwise, just return the node. ) excepthandler ExceptHandler match_case MatchCase TryExcept TryFinallyr)rXrnr2r last_stmt)rWrg child_stmtss& r#rrsm*$/5 5eu~~e--2 E5  [_ %% + s -A*A*)maxsizecaRo\P!S4p\P!V4Uu.uF'p\V\P4'gK%VNK) ppVUu.uFqP VP 3NK pp\\V44\V48Hp\;QJdV3RlV4F 'dK RM RM!V3RlV44pT;'dT#uupiuupi)a The positions attached to nodes inside f-string FormattedValues have some bugs that were fixed in Python 3.9.7 in https://github.com/python/cpython/pull/27729. This checks for those bugs more concretely without relying on the Python version. Specifically this checks: - Values with a format spec or conversion - Repeated (i.e. identical-looking) expressions - f-strings implicitly concatenated over multiple lines. - Multiline, triple-quoted f-strings. z( f"a {b}{b} c {d!r} e {f:g} h {i:{j}} k {l:{m:n}}" f"a {b}{b} c {d!r} e {f:g} h {i:{j}} k {l:{m:n}}" f"{x + y + z} {x} {y} {z} {z} {z!a} {z:z}" f''' {s} {t} {u} {v} ''' )c3l<"TF)p\P!SV4VP8HxK+ R#5ir1)r^get_source_segmentid)rrWsources& r#r)fstring_positions_work..s. 64(DGG3s14FT) r^parserr]Namer col_offsetrrall)treerW name_nodesname_positionspositions_are_uniquecorrect_source_segmentsrs @r#fstring_positions_workrs & 6 $!$$N:dCHH3M*N?IJzt[[$//2z.JS01S5HHC  CCC    9 9"99OJs"C-C-% C2c\PR8dR#\VRR7Fp\V\P 4'gK%VP Fp\VRR4\V\P4'gK2\4'g*\VP4Fp\VRR4K VP'gK\VPRR4K K R#)zs Add a special attribute `_broken_positions` to nodes inside f-strings if the lineno/col_offset cannot be trusted. NT)r[_broken_positions) ) sys version_inforr]r^rsrasetattrFormattedValuerrf format_spec)r joinedstrpartrgs& r#annotate_fstring_nodesrs    6i i / /   d'. D#,, - -%''DJJ'e E. 5(     $""$7 >!7r"cZV^8dQh/^\9d\\R3,;R&#).ry)__conditional_annotations__rr)formats"r# __annotate__rs# v54%c "4w r"r1)F>rwDelAttrDelName AssignAttr AssignName)Srr^ collectionsrMrr'rKabcrrrr functoolsrtypingrr r r r r rrrrrrastroid_compatrrAstNoderr- namedtupler/r>rCrIrLrXrT__dict__itemsr]r2 issubclass expr_contextboolopoperatorunaryopcmpoprdrUstmtrmrirjrnrqrZrvConstantry astroid.nodesrw ImportErrorrzr}rrrobjectrrrrrrrrrrr)rrrs00@r#rs  !!    $C +v% &'  )H.K " "7,^ _.&Q +AWW LL..0c0DAJq$4GaS--szz3<<VYV_V_`aa0c ,#&,,"4"4"6H"6$!!!T*/9!SXX/FA"6H#&<<#5#5#7H#741!!T*/9!SXX/FQ#7HOP 5 5 - 0+'*ll_4!uh , 6 .  H ( V:(,2 . 4::>?K c4HHPsII:-AI:5I:!J9JJ;JJ.J"J JJ