a ›`Ó7ã@sâdZddlmZddlZddlZddlZddlZddlmZm Z m Z m Z m Z ddl Z ddl mZddl mZddl mZddl mZdd l mZdd lmZdd lmZmZdd lmZdd lmZe e¡ZGd d„de ƒZ!dS)z3Module containing the application logic for Flake8.é)Úprint_functionN)ÚDictÚListÚOptionalÚSetÚTuple)Úchecker)Údefaults)Ú exceptions)Ú style_guide)Úutils)Úoptions)Ú aggregatorÚconfig)Úmanagerc@s¬eZdZdZdejfdd„Zdd„Zdd„Zd d „Z d d „Z d d„Z dd„Z d(dd„Z dd„Zdd„Zd)dd„Zdd„Zdd„Zdd„Zd d!„Zd"d#„Zd$d%„Zd&d'„ZdS)*Ú Applicationz&Abstract our application into a class.Úflake8cCs¦t ¡|_d|_||_||_tjdd|_t  |j¡t j dt j |jgd|_t |j¡d|_d|_d|_d|_d|_d|_d|_d|_d|_d|_d|_i|_dS)zçInitialize our application. :param str program: The name of the program/application that we're executing. :param str version: The version of the program/application we're executing. NF)Úadd_helpr)ÚprogÚversionÚparentsr)ÚtimeÚ start_timeÚend_timeÚprogramrÚargparseÚArgumentParserÚprelim_arg_parserr Zregister_preliminary_optionsrZ OptionManagerrÚ __version__Úoption_managerZregister_default_optionsÚ check_pluginsÚformatting_pluginsÚ formatterÚguideÚfile_checker_managerÚargsÚ result_countÚtotal_result_countÚcatastrophic_failureÚrunning_against_diffÚ parsed_diff)Úselfrr©r,ú6lib/python3.9/site-packages/flake8/main/application.pyÚ__init__ s0  ý zApplication.__init__cCs.|j |¡\}}|jr&| d|jf¡||fS)aaGet preliminary options from the CLI, pre-plugin-loading. We need to know the values of a few standard options so that we can locate configuration files and configure logging. Since plugins aren't loaded yet, there may be some as-yet-unknown options; we ignore those for now, they'll be parsed later when we do real option parsing. :param list argv: Command-line arguments passed in directly. :returns: Populated namespace and list of remaining argument strings. :rtype: (argparse.Namespace, list) z --output-file)rÚparse_known_argsÚ output_fileÚextend)r+Úargvr%Úrestr,r,r-Úparse_preliminary_optionsasz%Application.parse_preliminary_optionscCs>|jjrt|jƒ|jjr&t|jƒ‚nt|jdkp6|jƒ‚dS)z¾Handle finalization and exiting the program. This should be the last thing called on the application instance. It will check certain options and exit appropriately. rN)r ÚcountÚprintr&Z exit_zeroÚ SystemExitr(©r+r,r,r-Úexitzs  ÿzApplication.exitcCsLt |¡}tj |j¡t |j¡|_ t  |j ¡|_ |j   ¡|j   ¡dS)a3Find and load the plugins for this application. Set the :attr:`check_plugins` and :attr:`formatting_plugins` attributes based on the discovered plugins found. :param config.ConfigFileFinder config_finder: The finder for finding and reading configuration files. N)rZget_local_pluginsÚsysÚpathr1ÚpathsÚplugin_managerZCheckersÚ extensionr ZReportFormattersÚreportr!Z load_plugins)r+Ú config_finderZ local_pluginsr,r,r-Ú find_plugins‹s ÿ zApplication.find_pluginscCs.|j |j¡|j |j¡|j |j¡dS)z;Register options provided by plugins to our option manager.N)r Zregister_optionsrZregister_plugin_versionsr!r8r,r,r-Úregister_plugin_options¢sz#Application.register_plugin_optionscCsxt |j||¡\|_|_|jj|_|jr@t ¡|_ |j s@|  ¡d|j_ |j   |j|j|j¡|j  |j|j|j¡dS)aParse configuration files and the CLI options. :param config.ConfigFileFinder config_finder: The finder for finding and reading configuration files. :param list argv: Command-line arguments passed in directly. FN)rZaggregate_optionsrr r%Údiffr)r Zparse_unified_diffr*r9Z_running_from_vcsr Zprovide_optionsr!)r+r@r2r,r,r-Úparse_configuration_and_cli©s" ý    ÿ ÿz'Application.parse_configuration_and_clicCs4|jd}|j |¡}|dur.t d|¡|}|jS)z,Retrieve the formatter class by plugin name.ÚdefaultNz6"%s" is an unknown formatter. Falling back to default.)r!ÚgetÚLOGZwarningZexecute)r+Zformatter_plugin_nameZdefault_formatterZformatter_pluginr,r,r-Ú formatter_forËs  þzApplication.formatter_forNcCs\|jj}d|jjkr dkr*nnd}nd|jjkr:d}|durL| |¡}||jƒ|_dS)z3Initialize a formatter based on the parsed options.éézquiet-filenamez quiet-nothingN)r ÚformatÚquietrHr")r+Úformatter_classZ format_pluginr,r,r-Úmake_formatterØs  zApplication.make_formattercCs*t |j|j¡|_|jr&|j |j¡dS)zInitialize our StyleGuide.N)r ZStyleGuideManagerr r"r#r)Zadd_diff_rangesr*r8r,r,r-Ú make_guideæs ÿzApplication.make_guidecCstj|j|j|jd|_dS)z#Initialize our FileChecker Manager.)r Z argumentsZchecker_pluginsN)rZManagerr#r%r r$r8r,r,r-Úmake_file_checker_managerðs ýz%Application.make_file_checker_managerc CsŽ|jrt|jƒ}|j |¡z|j ¡Wn@tjyj}z&tt |ƒƒtdƒd|_ WYd}~n d}~00t   d¡|j  ¡t ¡|_dS)aRun the actual checks with the FileChecker Manager. This method encapsulates the logic to make a :class:`~flake8.checker.Manger` instance run the checks it is managing. :param list files: List of filenames to process z5Run flake8 with greater verbosity to see more detailsTNzFinished running)r)Úsortedr*r$ÚstartÚrunr ZPluginExecutionFailedr6Ústrr(rGÚinfoÚstoprr)r+ÚfilesZ plugin_failedr,r,r-Ú run_checksùs      zApplication.run_checkscCsˆ|jjs dS|j|j}d|fg}|j}tjdD]D}|jj|}d|d}|||fƒ|d}||t ||ƒfƒq2|j   |¡dS)z9Aggregate, calculate, and report benchmarks for this run.Nzseconds elapsed)rWztotal z processedz processed per second) r Z benchmarkrrÚappendr ZSTATISTIC_NAMESr$Ú statisticsÚintr"Zshow_benchmarks)r+Z time_elapsedrZZ add_statisticZ statisticÚvalueZtotal_descriptionZper_second_descriptionr,r,r-Úreport_benchmarkss     zApplication.report_benchmarkscCs6t d¡|j ¡}|\|_|_t d|j|j¡dS)z¾Report all the errors found by flake8 3.0. This also updates the :attr:`result_count` attribute with the total number of errors, warnings, and other messages found. zReporting errorsz.Found a total of %d violations and reported %dN)rGrUr$r?r'r&)r+Úresultsr,r,r-Ú report_errors"s   ýzApplication.report_errorscCs |jjs dS|j |jj¡dS)z.Aggregate and report statistics from this run.N)r rZr"Zshow_statisticsr#Zstatsr8r,r,r-Úreport_statistics2szApplication.report_statisticscCsr| |¡\}}t |j|j¡tj|j|j|j|j d}|  |¡|  ¡|  ||¡|  ¡| ¡| ¡dS)z—Initialize the application to be run. This finds the plugins, registers their options, and parses the command-line arguments. )Z config_fileZignore_config_filesN)r4rZconfigure_loggingÚverboser0rZConfigFileFinderrZ append_configÚisolatedrArBrDrNrOrP)r+r2Z prelim_optsÚremaining_argsr@r,r,r-Ú initialize9s" ü þzApplication.initializecCs0|j ¡| ¡| ¡| ¡|j ¡dS)z*Report errors, statistics, and benchmarks.N)r"rRr_r`r]rVr8r,r,r-r?Ts  zApplication.reportcCs| |¡| ¡| ¡dS)N)rdrXr?)r+r2r,r,r-Ú_run\s zApplication._runc Cs¾z| |¡WnªtyT}z.tdƒt d¡t |¡d|_WYd}~nnd}~0tjy˜}z,tdƒt|ƒt |¡d|_WYd}~n*d}~0tj y¸d|_tdƒYn0dS)zûRun our application. This method will also handle KeyboardInterrupt exceptions for the entirety of the flake8 application. If it sees a KeyboardInterrupt it will forcibly clean up the :class:`~flake8.checker.Manager`. z ... stoppedz#Caught keyboard interrupt from userTNz6There was a critical error during execution of Flake8:z"... stopped while processing files) reÚKeyboardInterruptr6rGZcriticalÚ exceptionr(r ZExecutionErrorZ EarlyQuit)r+r2Úexcr,r,r-rSbs   zApplication.run)N)N)Ú__name__Ú __module__Ú __qualname__Ú__doc__rrr.r4r9rArBrDrHrNrOrPrXr]r_r`rdr?rerSr,r,r,r-rs&A"   r)"rlZ __future__rrÚloggingr:rÚtypingrrrrrrrr r r r Z flake8.mainr Zflake8.optionsrrrZflake8.pluginsr=ÚTypeZ BaseFormatterZ getLoggerrirGÚobjectrr,r,r,r-Ús$