\Og`8SrSSKJr SSKrSSKrSSKrSSKrSSKrSSKrSSK J r SSK J r SSK J r SSK Jr SSK Jr SS KJr SS KJr S r\R,"\5r"S S \R25r"SS\R25r"SS\R25rSSjrSSjr"SS5r"SS5r "SS5r!g)z0Implementation of the StyleGuide used by Flake8.) annotationsN) Generator)Sequence)defaults) statistics)utils)base) Violation) StyleGuidec \rSrSrSrSrSrSrg)Selectedz>(($  #5>>((#  '>>$<<((   &>>OO$<<((   rcURUR5(a[R$URUR5(a[R $[ R $)aXDetermine if the code has been selected by the user. :param code: The code for the check that has been run. :returns: Selected.Implicitly if the selected list is empty, Selected.Explicitly if the selected list is not empty and a match was found, Ignored.Implicitly if the selected list is not empty but no match was found. ) startswithr6r rr;rrr?codes r was_selectedDecisionEngine.was_selectedfsP ??433 4 4&& & __T]] + +&& &%% %rcURUR5(a[R$URUR5(a[R $[ R $)aXDetermine if the code has been ignored by the user. :param code: The code for the check that has been run. :returns: Selected.Implicitly if the ignored list is empty, Ignored.Explicitly if the ignored list is not empty and a match was found, Selected.Implicitly if the ignored list is not empty but no match was found. )rDr9rrr>rr rEs r was_ignoredDecisionEngine.was_ignoredxsP ??422 3 3%% % __T\\ * *%% %&& &rcP^URT5nURT5n[RSTUU5 [ U[ 5(a%[ U[ 5(a[ R $[ U[5(a%[ U[5(a[ R$U[ RLa#U[RLa[ R $U[ RLa#U[RLa[ R$U[RLa#U[ RLa[ R$U[ RLaU[RLd&U[ RLaU[RLav[U4SjUR55n[U4SjUR55n[U5[U5:a[ R $[ R$[STSUSU35e)z-Decide if code should be ignored or selected.z#The user configured %r to be %r, %rc3X># UHnTRU5(dMUv M! g7fNrD.0srFs r /DecisionEngine.make_decision..sI]dooa6H!!]* *c3X># UHnTRU5(dMUv M! g7frNrOrPs rrSrTsH\T__Q5G!!\rUz unreachable  )rGrJLOGdebug isinstancer rrrrnextr;r>lenAssertionError)r?rFr;r>r4r7s ` r make_decisionDecisionEngine.make_decisions$$T*""4( 1      h ) )j(.K.K$$ $ ' * *z'7/K/K## # ++ +w111$$ $ H// /7---## # ++ +8;N;N0N## # ++ +7;M;M0M ++ +7;M;M0MIT]]IIFHT\\HHF6{S[((((''' <vQxj'!KL LrcURRU5nUc5URU5nX RU'[R SX5 U$)aReturn the decision for a specific code. This method caches the decisions for codes to avoid retracing the same logic over and over again. We only care about the select and ignore rules as specified by the user in their configuration files and command-line flags. This method does not look at whether the specific line is being ignored in the file itself. :param code: The code for the check that has been run. z"%s" will be "%s")r3getr^rXrY)r?rFdecisions r decision_forDecisionEngine.decision_forsL::>>$'  ))$/H'JJt  II)4 :r)r3r>r9r;r6N)r@argparse.NamespacereturnNone)rFstrrfzSelected | IgnoredrFrhrfr) rrrrrrArGrJr^rcrrrrr0r0Es"  4&$'&(MTrr0c\rSrSrSrS S SjjrS SjrS Sjr\RSSj5r S SSjjr S r g)StyleGuideManagerz.Manage multiple style guides for a single run.Nc\XlX l[R"5UlU=(d [ U5Ul/Ul[XURUS9Ul UR/URU5QUl[R"SS9"UR5Ulg)CInitialize our StyleGuide. .. todo:: Add parameter documentation. )deciderN)maxsize)r@ formatterr Statisticsstatsr0ro style_guidesr default_style_guidepopulate_style_guides_with functools lru_cache_style_guide_forstyle_guide_for)r?r@rqros rrAStyleGuideManager.__init__s "**, 9."9 .0#-  G$    $ $  , ,W 5  )224@  ! ! rc## [R"UR5nUH up4URR X4S9v M" g7f)zGenerate style guides from the per-file-ignores option. :param options: The original options parsed from the CLI and config file. :returns: A copy of the default style guide with overridden values. )filenameextend_ignore_withN)rparse_files_to_codes_mappingper_file_ignoresrucopy)r?r@per_filer} violationss rrv,StyleGuideManager.populate_style_guides_withsK55g6N6NO$, H**//!0 %-sAA cB^[U4SjUR5SS9$)z3Find the StyleGuide for the filename in particular.c3V># UHoRT5(dMUv M g7frN) applies_to)rQgr}s rrS5StyleGuideManager._style_guide_for..s D)1\\(-CQQ)s) )c>[UR=(d S5$)N)r\r})rs r4StyleGuideManager._style_guide_for..s#ajj.B/r)key)maxrtr?r}s `rry"StyleGuideManager._style_guide_fors! D)) D/  rc## URU5nURU5 Uv SSS5 g!,(df  g=f7fz9Record the fact that we're processing the file's results.N)rzprocessing_file)r?r}guides rr!StyleGuideManager.processing_files5 $$X.  " "8 ,K- , ,s#A3 A AAcJURU5nURXX4XV5$)nHandle an error reported by a check. :param code: The error code found, e.g., E123. :param filename: The file in which the error was found. :param line_number: The line number (where counting starts at 1) at which the error occurs. :param column_number: The column number (where counting starts at 1) at which the error occurs. :param text: The text of the error message. :param physical_line: The actual physical line causing the error. :returns: 1 if the error was reported. 0 if it was ignored. This is to allow for counting of the number of errors found that were not ignored. )rz handle_error)r?rFr} line_number column_numbertext physical_liners rrStyleGuideManager.handle_errors.:$$X.!! K  r)rorurqr@rsrzrtrN)r@rerqbase_formatter.BaseFormatterroDecisionEngine | Nonerfrg)r@rerf!Generator[StyleGuide, None, None])r}rhrfr r}rhrfrrFrhr}rhrintrrrrhr str | Nonerfr) rrrrrrArvry contextlibcontextmanagerrrrrrrrkrks8 *.  # 0 '    6) *   *%)            "      rrkc\rSrSrSrS S SjjrSSjrS SSjjr\RSSj5r SSjr SS jr SSS jjr S rg)r i+z#Manage a Flake8 user's style guide.NcXlX lX0lU=(d [U5UlX@lUR (a&[ R"UR 5Ulgg)rnN)r@rqrsr0ror}rnormalize_path)r?r@rqrsr}ros rrAStyleGuide.__init__.sK " 9."9  ==!00?DM rc"SURS3$)z5Make it easier to debug which StyleGuide we're using.z r})r?s r__repr__StyleGuide.__repr__Bst}}oR00rc&U=(d URn[R"UR5nUR=(d /UlURR U=(d /5 [ X0RURUS9$)z8Create a copy of this style guide with different values.r) r}rdeepcopyr@r8r(r rqrs)r?r}r~r@s rrStyleGuide.copyFsm ,t}}-- - ' 5 5 ;$$%7%=2> ^^TZZ(  rc## URRU5 Uv URRU5 g7fr)rq beginningfinishedrs rrStyleGuide.processing_fileTs0   *  )s<>crURcg[R"UUR/U<S3[S9$)zCheck if this StyleGuide applies to the file. :param filename: The name of the file with violations that we're potentially applying this StyleGuide to. :returns: True if this applies, False otherwise Tz! does %(whether)smatch "%(path)s")patterns log_messagelogger)r}rmatches_filenamerXrs rrStyleGuide.applies_to]s> == %% mm_("CD   rc8URRU5$)a\Determine if the error code should be reported or ignored. This method only cares about the select and ignore rules as specified by the user in their configuration files and command-line flags. This method does not look at whether the specific line is being ignored in the file itself. :param code: The code for the check that has been run. )rorcrEs rshould_report_errorStyleGuide.should_report_erroros||((..rcnURRnU(dSn[UUUUS-UU5nURUR5[ R Ln URU5SLn U (a>U (a7URRU5 URRU5 gg)rrF) r@ disable_noqar rrFrr is_inline_ignoredrqhandlersrecord) r?rFr}rrrrrerrorerror_is_selectedis_not_inline_ignoreds rrStyleGuide.handle_error}s:||00 M    A       $ $UZZ 0H4E4E E !& 7 7 E N !6 NN ! !% ( JJ  e $r)ror}rqr@rs)NN) r@rerqrrszstatistics.Statisticsr}rror)rfrh)r}rr~zSequence[str] | Nonerfr r)r}rhrfboolrirNr)rrrrrrArrrrrrrrrrrrr r +s- $)- @#@0@% @  @ ' @(1 $37    1     ** *** $ /*%)222 2  2  2"2 22rr )r'list[str] | Noner(rrftuple[str, ...]) r'rr,rr-z list[str]r(rrfr)"r __future__rargparserrenumrwloggingtypingrrflake8rrrflake8.formattingr base_formatterflake8.violationr __all__ getLoggerrrXEnumr rrr*r.r0rkr rrrrs6" 4&  !'tyy'&dii& tyy , , , , ,  , , ,  ,  ,BBJ^ ^ BDDr