yIfo> UddlZddlmZddlmZddlmZmZmZm Z m Z m Z m Z ddl mZmZddlmZmZmZmZmZmZmZmZddlmZddlmZmZe eefZhd Zee d <d d hZ!ee d <hdZ"ee d<dZ#dZ$dZ%eGddZ&dedeefdZ'edde(de)de e&fdZ*dede+ddfdZ,de(de(fd Z-d!ed"ed#ee e+e+fddfd$Z.d!ed"ed#ee e+e+fde)fd%Z/ded&e&d"edeefd'Z0ded&e&deefd(Z1d)ede)fd*Z2d)ede)fd+Z3d,e ede)fd-Z4d.e(d"ede)fd/Z5dS)0N) dataclass) lru_cache) CollectionFinalIteratorListOptionalTupleUnion)ModePreview)CLOSING_BRACKETSSTANDALONE_COMMENT WHITESPACE container_of first_leaf_ofmake_simple_prefixpreceding_leafsyms)token)LeafNode> # fmt:off # fmt: off# yapf: disableFMT_OFFz # fmt: skipz # fmt:skipFMT_SKIP># fmt:on # fmt: on# yapf: enableFMT_ONz !:#'z# ;cPeZdZUdZeed<eed<eed<eed<eed<eed<dS) ProtoCommentaDescribes a piece of syntax that is a comment. It's not a :class:`blib2to3.pytree.Leaf` so that: * it can be cached (`Leaf` objects should not be reused more than once as they store their lineno, column, prefix, and parent information); * `newlines` and `consumed` fields are kept separate from the `value`. This simplifies handling of special marker comments like ``# fmt: off/on``. typevaluenewlinesconsumed form_feedleading_whitespaceN)__name__ __module__ __qualname____doc__int__annotations__strboolB/var/www/piapp/venv/lib/python3.11/site-packages/black/comments.pyr$r$ sW III JJJMMMMMMOOOr4r$leafreturnc#Kd}t|j|jtjkD]A}|j}t |j|j}t|j|j |VBt||dS)aClean the prefix of the `leaf` and generate comments from it, if any. Comments in lib2to3 are shoved into the whitespace prefix. This happens in `pgen2/driver.py:Driver.parse_tokens()`. This was a brilliant implementation move because it does away with modifying the grammar to include all the possible places in which comments can be placed. The sad consequence for us though is that comments don't "belong" anywhere. This is why this function generates simple parentless Leaf objects for comments. We simply don't know what the correct parent should be. No matter though, we can live without this. We really only need to differentiate between inline and standalone comments. The latter don't share the line with any code. Inline comments are emitted as regular token.COMMENT leaves. Standalone are emitted with a fake STANDALONE_COMMENT token identifier. r is_endmarker)prefixN) list_commentsr;r%r ENDMARKERr(rr'r)rr&normalize_trailing_prefix)r6total_consumedpcr;s r5generate_commentsrA4s&NDKdi5?6RSSS55#BK>>27BHV4444444dN33333r4i)maxsizer;r:c ,g}|rd|vr|Sd}d}d}d}ttjd|D]\}}|t|dzz }tjd|} | sJ| \} } | s |dz }d|vrd}| ds| d r|dz }||kr|s tj } nt} t| } | t| | |||| d}d}|S) zNReturn a list of :class:`ProtoComment` objects parsed from the given `prefix`.#rFz ? z^(\s*)(\S.*|)$ T\)r%r&r'r(r)r*) enumerateresplitlenmatchgroups startswithendswithrCOMMENTr make_commentappendr$)r;r:resultr(nlines ignored_linesr)index full_linerL whitespaceline comment_typecomments r5r<r<Osn"$F S&& H FMI%bhw&?&?@@!!yC NNQ&&*I66  <<>> D ! aKFy   s## }}T"" #"  M ! !, ! =LL-Lt$$ !!##-       Mr4r?c|j|d}d|vrE|d}d|vo|d}t|||_dSd|_dS)zNormalize the prefix that's left over after generating comments. Note: don't use backslashes for formatting or you'll lose your voting rights. NrG rF)r;countrOr)r6r? remaindernl_countr)s r5r>r>sn  NOO,I 9??4((I%B)*<*z+convert_one_fmt_off_pair..s("A"Aa3q66"A"A"A"A"A"Ar4c3PK|] }|dcxko |dkncV!dS)rrENr3)rtrYcomment_linenos r5rvz+convert_one_fmt_off_pair..sX..=ADG~8888a8888......r4z z(INTERNAL ERROR: fmt: on/off handling (1)z(INTERNAL ERROR: fmt: on/off handling (2))r;fmt_pass_converted_first_leafT)leavesr<r;r&r_contains_fmt_skip_commentr(r%rrrlistgenerate_ignored_nodesparentr'joinlinenorKanyrJr no_normalize_fmt_skip_whitespacer*rOremove insert_childrr)rjrkrlr6previous_consumedr[should_pass_fmtprev ignored_nodesfirstrr;standalone_comment_prefix hidden_valuefmt_off_prefix first_idxignoredrVrxs @r5rnrns NN$T[uEEEL L G%mw6:T t;;O# $+$4! !7<3E#E#E%d++!}//DIZ4O4O 27=$GG! I33  !7gt!L!LMMM  !!$E\F\F}''%g&6&8&89 )'->> ! ,2))---.8H1HH*77"A"A="A"A"AAAL![7+;;N}''!#u::>>#....EJ...++>&,\\'-%@%@%CN~--)7)=)=d)C)CB)G)^;)&}t3lB )'->> "?4GG..M !"" $$T** 1 ,CRC0 '+I( & &(($ %I%%'Q%%%((*T(((   & 42?2F2F    444YL \ 5r4r[c#Kt|j|rt||Ed{VdSt|}|3|jt jkrt|rdSt|rt|j D]\}}t|tr$t|r|jtvr|VdS|jt jkr;|t|j dz kr t|j |dzrdSt|rdS|Vn)|jt jkr |jdS|V|j}||jt jkdSdSdSdS)zStarting from the container of `leaf`, generate all leaves until `# fmt: on`. If comment is skip, returns leaf only. Stops at the end of the block. NrE)r|r&%_generate_ignored_nodes_from_fmt_skiprr%rr= is_fmt_onchildren_contains_fmt_onrHchildren isinstancerrINDENTrKDEDENT next_sibling)r6r[rk containerrVchilds r5r~r~ s"'-668wGGGGGGGGG*400I  INeo$E$E Y    F $I . . / ))*< = =   ueT**y/?/?z%555 $ FFJ%,..I$6 7 7! ;;;01CEAI1NOO< FF+E22FF ' *~--)2H2POOO!.IA  INeo$E$E$E$E  $E$E  r4c#K|j}|j}t|jd}|r|j|djkrdS|Qd|_|g}d|jvr4|j-|j}|d|d|jvr|j-|Ed{VdS||jtjkr|jtj krd|_g}|j}|I|jtjkr4|d||j}||jtjk4|j}|<|j5|jjtj kr|d|jt|Ed{VdSdSdSdS)zLGenerate all leaves that should be ignored by the `# fmt: skip` from `leaf`.Fr9rNr^r]) prev_siblingrr<r;r&insertr%rsuiterNEWLINEASYNCiter) r6r[rrcommentssiblingsrparent_sibling grandparents r5rr:s$L [FT[u===H w} (999  >,---,2K2W'4L OOA| , , ,,---,2K2Wv{dj88TY%-=W=W  "$ ,(^-@DJ-N-N  N 3 3 3+8N(^-@DJ-N-N m  #(4(-<<  K$< = = = &&&&&&&&&&&) 88=W=Wr4rc~d}t|jdD]#}|jtvrd}|jtvrd}$|S)zDetermine whether formatting is switched on within a container. Determined by whether the last `# fmt:` comment is `on` or `off`. Fr9T)r<r;r&r!r)rfmt_onr[s r5rrdsTF !1FFF =F " "FF ]g % %F Mr4c`|jD]%}t|}|t|rdS&dS)z2Determine if children have formatting switched on.NTF)rrr)rrr6s r5rrqs?#U##   $ 44 5r4 comment_listcJ|D]}|jdrdS dS)z Returns: True iff one of the comments in @comment_list is a pragma used by one of the more common static analysis tools for python (e.g. mypy, flake8, pylint). )z# type:z# noqaz # pylint:TF)r&rN)rr[s r5contains_pragma_commentr{s?  = # #$F G G 44  5r4 comment_linec |gd|tddDd|ttD}t d|DS)aQ Checks if the given comment contains FMT_SKIP alone or paired with other comments. Matching styles: # fmt:skip <-- single comment # noqa:XXX # fmt:skip # a nice line <-- multiple comments (Preview) # pylint:XXX; fmt:skip <-- list of comments (; separated, Preview) cFg|]}t|zSr3_COMMENT_PREFIXstriprtr[s r5 z._contains_fmt_skip_comment..s5    gmmoo -   r4rENcFg|]}t|zSr3rrs r5rz._contains_fmt_skip_comment..s5    gmmoo -   r4c3(K|] }|tvVdSrs)rrs r5rvz-_contains_fmt_skip_comment..s'JJww("JJJJJJr4)rJrr_COMMENT_LIST_SEPARATORr)rrksemantic_comment_blockss r5r|r|s    '--o>>qrrB       '--o>>DD'    JJ2IJJJ J JJr4)6rI dataclassesr functoolsrtypingrrrrr r r black.moder r black.nodesrrrrrrrrblib2to3.pgen2rblib2to3.pytreerrLNrr0rr!rhrrr$rAr1r2r<r/r>rQrprnr~rrrrr|r3r4r5rs !!!!!!LLLLLLLLLLLLLLLLLL$$$$$$$$                    ! &&&&&&&& 4:?????? ,/%///;;;;;;  &4B48D>44446 4,#,,l9K,,,,^ B      ##4@ @@#-eCHo#>@ @@@@W WW#-eCHo#>W WWWWt,/ ,/%,/-1,/ b\,/,/,/,/^'' ''%'' b\''''''''T      t $t*     KSKKKKKKKKr4