ziqn UdZddlZddlmZmZmZmZmZmZm Z m Z m Z ej dkrddlm Z nddlm Z ddlmZddlmZddlmZmZdd lmZmZdd lmZdd lmZdd lmZmZm Z m!Z!ej"eej#Z$ee%d <e dZ&e ee fZ'e(Z)e(Z*ej+ej,ej-hZ.ee%d<e$j/e$j0e$j1e$j2e$j3e$j4e$j5e$j6e$j7e$j8h Z9ee%d<dZ:ee%d<dej;e:<ddhZej?ej@ejAejBhZCee%d<ejDejEejFejGejHejIejJejKejLejMejNejOejPejQhZRee%d<ejKejQhZSee%d<eSejLhzZTee%d<e$jUe$jVe$jWe$jXe$jYhZZee%d<e$j[e$j\e$j]e$j^e$j_e$j`e$jahZbee%d<e$jce$jde$jee$jfe$jge$jhe$jie$jje$jke$jle$jme$jne$jWe$joe$jphZqee%d<e$jre$jshZtee%d<hdZuee%d<e$jve$j_e$jwhZxee%d <ejyejzej{ej|ej}ej~iZee%d!<eeZee%d"<eeZee%d#<eezZee%d$<eeje:hzZee%d%<d&Zed'(Gd)d*ee&Zd+ed,ed-ed.efd/Zdud1e(d2ed3ed.efd4Zd5ee'd.eefd6Zd5ee'd7eee*d.efd8Zd5ee'd.ee*fd9Zd:e d;e'd.ee'fd<Zd=e'd>e'd.dfd?Zd+ed.e'fd@Zd5e'd.eefdAZd5e'd.efdBZd+ed.efdCZd5e'd.efdDZd5e'd.efdEZd5e'd.efdFZejyejzffdGedHedIeedJe e(e(fd.ef dKZd5e'd.efdLZdvd5e'dNed.efdOZd5e'd.efdPZd5e'd.efdQZd+edRee*d.efdSZd+ed.efdTZd5e d.efdUZd5e d.efdVZd5e d-ed.efdWZd5e'd.efdXZd5e'd.efdYZd+ed.efdZZd+ed.efd[Zd+ed.efd\Zd+ed.efd]Zd+ed.efd^Zd+ed.efd_Zd+ed.efd`Zd+ed.efdaZdbed.efdcZd'dddee dfe'dged.dfdhZd5e'd.ee'fdiZd+ed.dfdjZdked.e efdlZdked.e efdmZdked.e efdnZdked.e efdoZdked.e efdpZd+ed.efdqZd5e'd.eefdrZd5e'd.eefdsZd+ed.e'fdtZdS)wz> blib2to3 Node/Leaf transformation-related utility functions. N) FinalGenericIteratorListOptionalSetTupleTypeVarUnion) ) TypeGuard) mypyc_attr) CACHE_DIR)ModePreview)get_string_prefixhas_triple_quotes)pygram)token)NLLeafNode type_reprsymsT WHITESPACE STATEMENTSTANDALONE_COMMENTandorLOGIC_OPERATORS COMPARATORSMATH_OPERATORSSTARSVARARGS_SPECIALSVARARGS_PARENTSUNPACKING_PARENTSTEST_DESCENDANTS TYPED_NAMES>%=&=*=+=-=/=@=^=|=**=//=<<=>>== ASSIGNMENTSIMPLICIT_TUPLEBRACKETOPENING_BRACKETSCLOSING_BRACKETSBRACKETSALWAYS_NO_SPACE7T)allow_interpreted_subclassescJeZdZdZdedeefdZdedeefdZdS)VisitorzBBasic lib2to3 visitor that yields things of type `T` on `visit()`.nodereturnc#K|jdkrtj|j}n!tt |j}t |d|d}|r||Ed{VdS||Ed{VdS)azMain method to visit `node` and its children. It tries to find a `visit_*()` method for the given `node.type`, like `visit_simple_stmt` for Node objects or `visit_INDENT` for Leaf objects. If no dedicated `visit_*()` method is found, chooses `visit_default()` instead. Then yields objects of type `T` from the selected visitor. visit_N)typertok_namestrrgetattr visit_default)selfrEnamevisitfs V/var/www/tmov.alphamb/tmov_inventario/venv/lib/python3.11/site-packages/black/nodes.pyvisitz Visitor.visits 9s??>$),DDy++,,D 55  0vd|| # # # # # # # # #))$// / / / / / / / / /c#Kt|tr%|jD]}||Ed{VdSdS)zCDefault `visit_*()` implementation. Recurses to children of `node`.N) isinstancerchildrenrS)rOrEchilds rRrNzVisitor.visit_defaultsd dD ! ! - - -::e,,,,,,,,,, - - - -rTN) __name__ __module__ __qualname____doc__LNrrrSrNrTrRrDrDsfLL0"0!00000-"-!------rTrDleafcomplex_subscriptmoderFcd}d}d}|j}|j}|j}|tvr|S|tjkr|S| Jd||tjkr,|jtjtj tj hvr|S|j } | st|} | r| jtvr|S|tjkr2| jtjkr|S| jtjkr|s|S|S| jtjkrf| jr]| jjtjtjtjtjhvr|S| jjtjkr| jSnF| jtjkrAt/| tjkr$t/| jtj kr|S| jt2vr!t5| t6t8zr|Sn| jtjkr2| jr*| jjtjtj hvr|r|n|Snz| jr*| jjtjkr| jt<vr|S| jtjkr#|jr|jjtj kr|Sn| jtvr|S|jtjtjhvr| r| jtjkr|Sn|jtjkr| r| jtjkr|Sn|jtjkr[| s|S|tjkr| jtBvr|Snv| jtjkr| jS| jtjkr|SnA|jtBvr,| s(t|} | r| jtjkr|Sn|jtj"kra|tj#ks|tj$kr|S| s$|tj%ks|tj&kr|Sn| jtjkr|Sn|jtjkr^|tjkr|S| s*t|} | r| jtj#kr|Sn>| jtjht2zvr|Sn|jtj kr|S|jtj'krC| r|St|} | r*| jtjks| jtj%kr|Sn|jtj(kr-|tj#kr|S| r| jtj#kr|Snm|jtjtj hvrl| s/|j Jd|jjtj kr|S|StRj*|vr'|tj+ks| jtj+kr|S|s|Sn|jtj,kr| r|tj%kr|Sn|jtj-kr| r| jtj.kr|Sn|jtjtjhvr| st|} | r| jtvr|S| j} | J| jtjkr!| jtjtj hvr|S| jtjkr| jtjkr|Sn|tj/tj0tj1hvr|Sn|jtj2kr\|tj%kr| r| jtj%kr|Snp|tj/kr!|dkr|S| r| jtj%kr|Sn>|jtj kr|S|jtj3kr|tjkr|S|S) zReturn whitespace prefix if needed for the given `leaf`. `complex_subscript` signals whether the given leaf is part of a subscription which has non-trivial arguments, like arithmetic expressions or function calls.  z Nz/INTERNAL ERROR: hand-made leaf without parent: )withinzsubscripts are always parentedimport)4rJparentvaluer@rCOMMENTCOLONr subscript subscriptlistsliceop prev_siblingpreceding_leafr=COMMAEQUALarglistargument parameters varargslist typedargslistprefixSTAR parent_type star_exprr' is_varargr(r)factorr%AT decoratorr+trailerLPARRPARDOTLSQB dotted_nameclassdefrwalrus_subscript COLONEQUALatom dictsetmaker DOUBLESTARNAMENUMBERSTRING import_from except_clause) r_r`raNOSPACE DOUBLESPACEtpvprevprevp prevp_parents rR whitespacers BE"K A A AO EM ==TDTT===EKAF   +   D :q!!  &666I   zU[(( u{**3D* L : $ $| (<$LMO$ ) I\&$*<<<!<' J%* $ $E""dn44EL))T-???I Z+ + +9J'JKKK   Z5; & &| : 1dndl5S S S 19uur9 L  !T[00 n,,I Z58 # # #QX]dn5T5TI & & & v$/4<000 tyEK//I0 4# # #  DI,,I 4% % % I   y ++ ,Y%+ % %;  Y%+ % %I& ;   "1%%E EJ%+55 4<    ??a5:ooI EI~~ej "1Y%+ % %I& 4=   I "1%%E EJ%*44 5Y5;-*:: : :I; 4> ! ! 4# # #  Iq!!  eh..%* 2I2II3J 4=  ??I  DI++I DNDL1 1 1 8'')I'''x} 222 I  % - - ! ! !TY%2B%B%BL" I  49    ANNI 4$ $ $  DI!111I DK0 0 0 "1%%E EJ*:::   C.. u{**|/@DM/Q/Q 5:u|U\: : :I; 4# # #  >>  UY.. %*__H}}   UY.. 4<   4% % %  ??I LrT nl_count form_feed empty_linec,|r||dz zdz|zS||zS)z$Generate a normalized prefix string. r^)rrrs rRmake_simple_prefixrs/Ahl+t3j@@   rTrEc|rb|j}|rPt|tr|S t|dS#t $rYdSwxYw|j}|bdS)z3Return the first leaf that precedes `node`, if any.N)rnrVrlistleaves IndexErrorrg)rEress rRroros    #t$$   CJJLL))"--   tt {   4s&A AAtokensc|sdS|d|duS|sdS|j|dkrdSt|j|ddS)a;Return if the `node` and its previous siblings match types against the provided list of tokens; the provided `node`has its type matched against the last element in the list. `None` can be used as the first element to declare that the start of the list is anchored at the start of its parent's children.TrNF)rJprev_siblings_arern)rErs rRrrsc t bzt| u yF2Ju T.ss < <  ?1  $ 3 3  ;$/ ) )    *v/B/G8/S/S    rTcvt|tr|S|jrt|jdSdS)z(Returns the first leaf of the node tree.rN)rVrrW first_leaf_ofrs rRrrs=$  }T]1-...trTcl|jtjtjtjtjhvS)z?Whether node is an arithmetic or a binary arithmetic expression)rJr arith_expr shift_exprxor_exprand_exprrs rR is_arith_liker s* 9     rTc|jtjkrdSt|j}t |drdSt|jdtj tj tj grdSt|jtj tjtj grdSdS)NFbBfFT)rJrrrrhset intersectionrrgNEWLINEINDENTr simple_stmtrtrj)r_rws rR is_docstringrs yEL  u tz * *F 6{{''u dEM5<9IJtt TEU&VWWt 5rTc|jtjkoWt|jdko?|jdjt jko|jdjt jkS)z+Return True if `node` holds an empty tuple.rr)rJrrlenrWrrrrs rRis_empty_tupler,s` TY 0   ! # 0 M!  !UZ / 0 M!  !UZ / rTcx|jtjkr`t|}||jtjkrdSt |jdko|jdjtjkS|jtvo7t |jdko|jdjtjkS)zMReturn True if `node` holds a tuple with one element, with or without parens.NFrr) rJrrunwrap_singleton_parenthesis testlist_gexprrWrrpr;rEgexps rR is_one_tupler6s yDI+D11 <49(:::54=!!Q&O4=+;+@EK+OO ^# 1   ! # 1 M!  !U[ 0rTc|jtjkrdSt|}||jtjkrdSt d|jDS)zDReturn True if `node` holds a tuple that contains a walrus operator.FNc3@K|]}|jtjkVdSN)rJrnamedexpr_test).0rXs rR z-is_tuple_containing_walrus..Ns,LLUuzT00LLLLLLrT)rJrrrranyrWrs rRis_tuple_containing_walrusrFs[ yDIu ' - -D |tyD$666u LLdmLLL L LLrTopeningclosingrbracketsc|j|jf|krdS|jdz}t|D] \}}||urn tdd}|dz }||dD]a}||urnZ|j}||krL|jtjkr7|dz }|jr+|jjtjtj hvr|dz }nb|dkS)zIReturn True if content between `opening` and `closing` is a one-sequence.Frz#Opening paren not found in `leaves`rNr) rJ bracket_depth enumerate LookupErrorrrprgrrrrv) rrrrdepth_opening_indexr_commasrs rRis_one_sequence_betweenrQs  gl#x//u  !A %E )& 1 1AA 7?? E ?@@@ FaN~'   7?? E* E ! !di5;&>&> aKF{ t{/ "4  !  A:rTcRt|}|duo|jtjkS)z7Return True iff `node` is of the shape ( test := test )N)rrJrr)rEinners rRis_walrus_assignmentrvs) ( . .E   Bt/B!BBrTFlastcF|jtjko t|jdko?|jdjt jko|jdjt jkp|oWt|jdko?|jdjt jko|jdjt j kpY|oWt|jdko?|jdjt jko|jdjt j kS)z?Return True iff `node` is a trailer valid in a simple decoratorrrrr ) rJrrrrWrrrrr)rErs rRis_simple_decorator_trailerr|s 9 $    ! # 4 a %2 4 a %3   4DM""a' 4 a %3 4 a %3   4DM""a' 4 a %3 4 a %3'rTcr|jtjkrdS|jtjkr|jr|jdjtjkobt tt|jddo3t|jdkpt|jddSdS)a\Return True iff `node` could be a 'dotted name' decorator This function takes the node of the 'namedexpr_test' of the new decorator grammar and test if it would be valid under the old decorator grammar. The old grammar was: decorator: @ dotted_name [arguments] NEWLINE The new grammar is : decorator: @ namedexpr_test NEWLINE Trrrr)rF) rJrrrpowerrWallmaprrrs rRis_simple_decorator_expressionrs yEJt yDJ =  a %37qt9LMMNN &&*Q24=3D4PPP   5rTcV|jtjkrdSt|r |jdkrdS|jtjkrdSt |jdkrdS|j\}}}|jtj kr$|jtj krt|SdS)zAReturn True if `node` holds a `yield` or `yield from` expression.TyieldFr ) rJr yield_expr is_name_tokenrhrrrWrrris_yield)rElparexprrpars rRrrs yDO##tTtzW44t yDIu 4=Qu}D$ yEJ49 #:#:~~ 5rTrec|jtvs|jsdS|j}|jtjkr|jsdS|j}|j|vS)aFReturn True if `leaf` is a star or double star in a vararg or kwarg. If `within` includes VARARGS_PARENTS, this applies to function signatures. If `within` includes UNPACKING_PARENTS, it applies to right hand-side extended iterable unpacking (PEP 3132) and additional unpacking generalizations (PEP 448). F)rJr'rgrrz)r_rers rRr{r{sY y((( (u Avx 5 H 6V rTc<t|jod|jvS)zKReturn True if `leaf` is a multiline string that actually spans many lines.r)rrhr_s rRis_multiline_stringrs TZ ( ( ?TTZ-??rTc,|jtjkSr)rJrfuncdefrs rR is_funcdefrs 9 $$rTcV|jtjtjtjhvSr)rJrrr async_funcdefrs rRis_function_or_classrs 9t}d6HI IIrTc|j$tj|vrt|jsdS|jrdSt |jdks`|jdjtj ks@|jdjtj ks |jdjtj krdS|jdjrdSt|jdS)z2Return True if `node` is a suite with a stub body.NFrrr r)rgrdummy_implementationsrrwstriprrWrJrrrDEDENT is_stub_body)rEras rR is_stub_suiter s   )T 1 1$T[11 2u {u DMa =  EM 1 1 =  EL 0 0 =  EL 0 0u }Q$$&&u  a( ) ))rTcrt|tr|jtjkrdSt |jdkrdS|jd}|j oJ|jtj ko5t |jdkotd|jDS)zCReturn True if `node` is a simple statement containing an ellipsis.Frrr c3RK|]"}|ttjdkV#dS).N)rrr)rr_s rRrzis_stub_body..s3HHUY,,,HHHHHHrT) rVrrJrrrrWrwr rr)rErXs rRr r s dD ! !TY$2B%B%Bu 4=Qu M! E L     I J$) # I   1 $ I HHHHH H H rTcbt|ts|jtjkrdS|jd|jd}}t|toT|jt jko?|jdko4t|to|jt j ko |jdkS)zGiven a `LN`, determines whether it's an atom `node` with invisible parens. Useful in dedupe-ing and normalizing parens. Frrrc) rVrrJrrrWrrrhr)rEfirstrs rRis_atom_with_invisible_parensrs$di!7!7u-"DM"$54E5$  J%* $  K2   tT " "  I #   J"  rTc>t|pt|Sr) is_empty_lpar is_empty_rparrs rR is_empty_parr%s    5-"5"55rTcB|jtjko |jdkSNrc)rJrrrhrs rRrr) 9 " 7tzR'77rTcB|jtjko |jdkSr)rJrrrhrs rRrr-rrTc|j}|j}|j}t|tjko9|dkr|r|jt jkp|dko|o|jt jkS)z9Return True if the given leaf starts an import statement.rffrom) rgrJrhboolrrr import_namer)r_rrrs rR is_importr 1ss A A A  UZ (] ?q ?QVt/?%? BV @@af0@&@   rTc$t|jtjko+|jdko |jo|jjt jkpBt|jtjko |j o|j jt jkS)zDReturn True if the given leaf starts a with or async with statement.with) rrJrrrhrgr with_stmtASYNC next_siblingrs rRis_with_or_async_with_stmtr&?s  UZ / J&  / K / K  .      U[  5   5   "dn 4   rTct|jtjko*|jo#|jjt jt jhvS)zReturn True if the given leaf starts an async def/for/with statement. Note that `async def` can be either an `async_stmt` or `async_funcdef`, the latter is used when it has decorators. )rrJrr$rgr async_stmtrrs rRis_async_stmt_or_funcdefr)MsJ  U[  F K F K $2D E E  rTcr|j}|j}|tjthvo|dS)aBReturn True if the given leaf is a type comment. This function should only be used for general type comments (excluding ignore annotations, which should use `is_type_ignore_comment`). Note that general type comments are no longer used in modern version of Python, this function may be deprecated in the future.z# type:)rJrhrrir startswithr_rrs rRis_type_commentr-Zs6 A A  23 3 O Y8O8OOrTcf|j}|j}|tjthvot |S)zGReturn True if the given leaf is a type comment with ignore annotation.)rJrhrrir is_type_ignore_comment_stringr,s rRis_type_ignore_commentr0ds2 A A  23 3 X8UVW8X8XXrTrhc,|dS)zSReturn True if the given string match with type comment with ignore annotation.z# type: ignore)r+)rhs rRr/r/ks   , - --rT)visiblergrXr2c:ttj|rdnd}ttj|rdnd}|j}d|_|pd}t tj|||g}||_| ||dS)zWrap `child` in parentheses. This replaces `child` with an atom holding the parentheses and the old child. That requires moving the prefix. If `visible` is False, the leaves will be valueless (and thus invisible). (rc)rN) rrrrrwrrrrr)rgrXr2rrrwindexrs rRwrap_in_parenthesesr7qs  72CC 3 3D  72CC 3 3D \FEL LLNN aETYud 344II y)))))rTct|jdkrdS|j\}}}|jtjkr|jtjksdS|S)zqReturns `wrapped` if `node` is of the shape ( wrapped ). Parenthesis can be optional. Returns None otherwiser N)rrWrJrrr)rErwrappedrs rRrrsS 4=Qt-D'4 I # # UZ(?(?t NrTc~|jtjkr d|_dS|jtjkr d|_dSdS)zMake sure parentheses are visible. They could be invisible as part of some statements (see :func:`normalize_invisible_parens` and :func:`visit_import_from`). r4r5N)rJrrrhrrs rRensure_visibler;s@  yEJ ej   ! rTnlc,|jtjkSr)rJrrr<s rRrr 7ej  rTc,|jtjkSr)rJrrr>s rR is_lpar_tokenrAr?rTc,|jtjkSr)rJrrr>s rR is_rpar_tokenrCr?rTc,|jtjkSr)rJrrr>s rRis_string_tokenrE 7el ""rTc,|jtjkSr)rJrrr>s rRis_number_tokenrHrFrTc|j}|O|jr|jjtjkrdS|jr|jjt jkrdS|j}|OdS)z6Returns whether this leaf is part of type annotations.NTF)rgrnrJrRARROWrtname)r_rs rRis_part_of_annotationrLsg{H     X%:%?5<%O%O4 ? x3tzAA4?   5rTcvt|tr|S|jsdSt|jdS)z,Returns the first leaf of the ancestor node.Nr)rVrrW first_leafrs rRrNrNs=$, ],t$-*+++rTcvt|tr|S|jsdSt|jdS)z+Returns the last leaf of the ancestor node.Nr)rVrrW last_leafrs rRrPrPs=$, ],tr*+++rTc|}|jrN|jjrB||jjdur.|j}|jr |jjr||jjdu.|S)zGReturns the furthest ancestor that has this leaf node as the last leaf.r)rgrW)r_rEs rR furthest_ancestor_with_last_leafrRskD +$+.44;;OPR;S3S3S{ +$+.44;;OPR;S3S3S KrT)r)F)r\systypingrrrrrrr r r version_infortyping_extensionsmypy_extensionsr black.cacher black.moderr black.stringsrrblib2to3rblib2to3.pgen2rblib2to3.pytreerrrr initializepython_symbolsr__annotations__rr]intLeafIDNodeTyper rrrif_stmt while_stmtfor_stmttry_stmtrr#rr match_stmt case_blockrr rKr#LESSGREATEREQEQUALNOTEQUAL LESSEQUAL GREATEREQUALr$VBAR CIRCUMFLEXAMPER LEFTSHIFT RIGHTSHIFTPLUSMINUSrxSLASH DOUBLESLASHPERCENTr}TILDErr%r&r'rrrsrrvrur(rr listmakerrtestlist_star_expr subject_exprpatternr)testlambdefor_testand_testnot_test comparisonrzrrrrrtermrr*rK tname_starr+r:testlistexprlistr;rrrRSQBLBRACERBRACEr<rkeysr=valuesr>r?rpr@rJrDrrLrrrorryrrrrrrrrrrrrrrr{rrrr r rrrrr r&r)r-r0r/r7rr;rrArCrErHrLrNrPrRr^rTrRrs  WWWWWWWWWWWWWWWWWWWWWWw       ++++++&&&&&&!!!!!!$$$$$$$$>>>>>>>> 555555555555)#e### GCLL 4:  \5<? E???LOMMNLMOO  5    E%9!"&&& J M M N O   U J  K O  J K J K  M H K   E,-u---5;-/%///LML  INL5 ILLMMONIMMOOLIJ%"j$/2 U222 U"(?OOOO J  J  L%, #gllnn--%---#gnn..//%///"%55%555)U[:L,MMMMM  ...-----gaj--/.-DhThhThchhhhV!!!!3!RU!!!!"(4.$ =HRL =$x7I2J =t = = = = hrl x'9    DbXb\2R2B242222"t2x~tt, r d     MRMDMMMM"'UZ 8 "" " " J"CHo "  """"JCrCdCCCC b402$*D#h-D.@d@t@@@@ %T%d%%%%JtJJJJJ**D*T****6rd"t$6t66666888888888888 D T     T d     4 D    P$P4PPPPYY$YYYY...... EI****R*T*T****$ r hrl      $    !b!Yt_!!!!!b!Yt_!!!!!b!Yt_!!!!##y######y####      ,R,HTN,,,,,B,8D>,,,,4BrT