^Yc@sdZddlZddlZddlZddlZddlZddlZddlZddlZddl m Z ddl m Z ddl mZmZddlmZddlmZddlmZmZdd lmZmZdd lmZmZdd lmZmZmZdd lm Z m!Z!dd lm"Z"m#Z#ddl$m%Z%ddl&m'Z'm(Z(m)Z)ddl&m*Z*m+Z+ddl,m-Z-ddl.m/Z/ddl0m1Z1m2Z2ddl3m4Z4m5Z5ddl6m7Z7ddl8m9Z9yddl:m;Z;Wne<k r!e=Z;nXe+eZe=Z>Z?e j@ryddl>Z>Wne<k rdnXyddl?Z?Wne<k rnXndeAfdYZBdZCdZDdZEdZFdS(s#Core control stuff for coverage.py.iN(tenv(tAnnotateReporter(t string_classtiitems(t Collector(tread_coverage_config(t CoverageDatatCoverageDataFiles(t DebugControltwrite_formatted_info(t TreeMatchertFnmatchMatcher(t PathAliasestfind_python_filest prep_patterns(tcanonical_filenametset_relative_directory(t ModuleMatchertabs_file(t HtmlReporter(tCoverageExceptiont bool_or_nonet join_regex(t file_be_gonetisolate_module(t FileReporter(tPlugins(tPythonFileReportertsource_for_file(tAnalysistNumbers(tSummaryReporter(t XmlReporter(tpatch_multiprocessingtCoveragec BseZdZd*d*d*ed*d*ed*d*d*d*d*d ZdZdZedZ dZ dZ dZ dZ d Zd*d Zd Zd Zd ZdZdZdZdZdZddZddZdZdZddZdZd*edZdZdZ dZ!dZ"dZ#d Z$d!Z%d"Z&d#Z'd*d$Z(d*d*d*d*d*d*d*d%Z)d*d*d*d*d*d&Z*d*d*d*d*d*d*d*d*d'Z+d*d*d*d*d*d(Z,d)Z-RS(+sProgrammatic access to coverage.py. To use:: from coverage import Coverage cov = Coverage() cov.start() #.. call your code .. cov.stop() cov.html_report(directory='covhtml') c Csptd|d|d|d|d|dt|d|d| d | d | d | \|_|_d |_||_|_||_d |_ d |_ d |_ |_ d |_ |_t|_t|_g|_d |_|_|_d |_d |_d |_|_|_d |_d |_|_d |_|_d |_ d |_!t"|_#t"|_$t%j&slt'nd S( sW `data_file` is the base name of the data file to use, defaulting to ".coverage". `data_suffix` is appended (with a dot) to `data_file` to create the final file name. If `data_suffix` is simply True, then a suffix is created with the machine and process identity included. `cover_pylib` is a boolean determining whether Python code installed with the Python interpreter is measured. This includes the Python standard library and any packages installed with the interpreter. If `auto_data` is true, then any existing data file will be read when coverage measurement starts, and data will be saved automatically when measurement stops. If `timid` is true, then a slower and simpler trace function will be used. This is important for some environments where manipulation of tracing functions breaks the faster trace function. If `branch` is true, then branch coverage will be measured in addition to the usual statement coverage. `config_file` determines what configuration file to read: * If it is ".coveragerc", it is interpreted as if it were True, for backward compatibility. * If it is a string, it is the name of the file to read. If the file can't be read, it is an error. * If it is True, then a few standard files names are tried (".coveragerc", "setup.cfg", "tox.ini"). It is not an error for these files to not be found. * If it is False, then no configuration file is read. `source` is a list of file paths or package names. Only code located in the trees indicated by the file paths or package names will be measured. `include` and `omit` are lists of file name patterns. Files that match `include` will be measured, files that match `omit` will not. Each will also accept a single string argument. `debug` is a list of strings indicating what debugging information is desired. `concurrency` is a string indicating the concurrency library being used in the measured code. Without this, coverage.py will get incorrect results if these libraries are in use. Valid strings are "greenlet", "eventlet", "gevent", "multiprocessing", or "thread" (the default). This can also be a list of these strings. .. versionadded:: 4.0 The `concurrency` parameter. .. versionadded:: 4.2 The `concurrency` parameter can now be a list of strings. t config_filet data_filet cover_pylibttimidtbranchtparalleltsourcetomittincludetdebugt concurrencyN((RRR#tconfigtNonet _debug_filet _auto_loadt _auto_savet _data_suffixt source_matchtsource_pkgs_matcht pylib_matcht cover_matcht include_matcht omit_matchtTruet _warn_no_datat_warn_unimported_sourcet _warningsR*R+R)tsource_pkgs_unmatchedt source_pkgstdatat data_filest collectortpluginst pylib_pathst cover_pathst data_suffixt run_suffixt _exclude_reR,tFalset_initedt_startedRtMETACOVt _prevent_sub_process_measurement( tselfR$RFR%t auto_dataR&R'R#R)R*R+R,R-((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyt__init__Ls:B               c Cs]|jr dSt|_|jdkratjjd}|rRt|d|_qatj |_nt |j j |j|_ t j|j j|j |j |_i|_|jtg|_g|_xU|j jpgD]A}tjj|r|jjt|q|jj|qW|j|_t|j j|_t|j j|_|j jpjg}d|krtstdntd|j t|j _!nt"d|j#d|j$d |j j%d |j j&d |j'd ||_(|jj)rg|j(j* rg|j'd dj+d|jj)D|j(j,fx |jj)D]}t-|_.qQWn|j/s||j j!rt0|j/t1st|_/qn d|_/d|_2|j/|_3t4d|j |_5t6d|j j7d |j'd|j |_8t9|_:|j j;sxct<t=tt>t?t@tAtBfD]C}|dk r1tC|dr1|j:jD|jE|dtq1q1WtArtCtAd rtAjF}y|jGjH}WntIk r|jJjH}nX|j:jD|jE|qn|jEtKdtg|_LtMjNr{|jLjtjj+|jLddddlO}ddlP} x0|| gD]} |jLj|jE| qUWntQjR|j jSt<jT|jU|js|jrtV|j|_WtX|j|_Yn<|jLrtV|jL|_Zn|j:rtV|j:|_[n|jr1t\|j|_]n|jrOt\|j|_^n|j_dS(sSet all the initial state. This is called by the public methods to initialize state. This lets us construct a :class:`Coverage` object, then tweak its state before this function is called. NtCOVERAGE_DEBUG_FILEtatmultiprocessings/multiprocessing is not supported on this Pythontrcfilet should_tracet check_includeR&R'twarnR-s1Plugin file tracers (%s) aren't supported with %ss, css|]}|jVqdS(N(t_coverage_plugin_name(t.0tplugin((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pys sR,tbasenamet__file__t directoryittestsi(`RJR:R0R/tostenvirontgettopentsyststderrRR.R,Rt load_pluginsRCRHt_exclude_regex_staleRR)R?tpathtisdirtappendRR>RR*R+R-R!RR#R(Rt _should_tracet_check_include_omit_etcR&R't_warnRBt file_tracerstsupports_pluginstjoint tracer_nameRIt_coverage_enabledR3t isinstanceRRFRGRR@RR$RAtsetRDR%tatexittinspecttplatformt_pypy_irc_topictret _structseqt tracebackthasattrtaddt_canonical_patht structseq_newt func_codet co_filenametAttributeErrort__code__R\RERtTESTINGt contractstsixRt set_precisiont precisiontregistert_atexitR R4RR5R7R6R R8R9t_write_startup_debug( RNtdebug_file_nametsrcR-RZtmR~tstructseq_fileRRtmod((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyt_inits  $                $  %&   &       c Cst}|jj|jjdr\t|jjj}t|jd|t }n|jjdrt|jd|j x=|j D]2}d|j }|j }t|j||qWt }nWdQX|rt|jddndS(s*Write out debug info at startup if needed.R.Rcssys: Ntend(( RIR,twithout_callerstshouldtsortedR.t__dict__titemsR R:tsys_infoRCRX(RNt wrote_anyt config_infoRZtheadertinfo((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyRds   cCsDt||j}|jds'|r@tjj|d}n|S(sReturn the canonical path of the module or file `morf`. If the module is a package, then return its directory. If it is a module, then return its file, unless `directory` is True, in which case return its enclosing directory. s __init__.pyi(RtfilenametendswithR_Rgtsplit(RNtmorfR]t morf_path((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyR}xscCs|dkri}n|jdd}t|trF|dkrF|S|jdd}xQdD]I}t||r_t||}nq_t|tr_|dkr_|Sq_Wtj|}|dk r|S|SdS(sGet the name of the module for a set of globals and file name. For configurability's sake, we allow __main__ modules to be matched by their importable name. If loaded via runpy (aka -m), we can usually recover the "original" full dotted module name, otherwise, we resort to interpreting the file name to get the module's name. In the case that the module name can't be determined, None is returned. t__name__t__main__t __loader__tfullnametnameN(sfullnamesname(R/RaRrtstrR{tgetattrRut getmodulename(RNtmodule_globalsRt dunder_nametloadertattrnameRt inspectedname((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyt_name_for_modules    c Cs|}t|jj|}d}|jo<|jjd}|rt|}|r|jd rtjj |}|tjj |kr|}qqn|s||dS|jdr||dS|jdr||dSt j d|r ||d S|j d r*|d d }nt |}||_ d} x|jjD]} | jsgqRnyk| j|} | dk r| | _t|_| |_| jrt|_nt | j|_PnWqRtk r|jd | jtjt| _qRqRXqRWt|_||_|js|jsTtd| |j fn|j!|j|} | r||| qn|S(sDecide whether to trace execution in `filename`, with a reason. This function is called from the trace function. As each new file name is encountered, this function determines whether it is traced or not. Returns a FileDisposition object. cSst|_||_|S(s+Simple helper to make it easy to return NO.(RIttracetreason(tdispR((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pytnopes  R\t|j r|j j|rdS|j r|j j|rdS|j r|j j|rdSdS(sCheck a file name against the include, omit, etc, rules. Returns a string or None. String means, don't trace, and is the reason why. None means no reason found to not trace. s falls outside the --source treess!falls outside the --include treessis in the stdlibsis part of coverage.pysis inside an --omit patternN( RRR4R5tmatchR>tremoveR/R8R6R7R9(RNRRt modulename((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyRs$  cCsA|j||}|jjdr=|jjt|n|S(sDecide whether to trace execution in `filename`. Calls `_should_trace_internal`, and returns the FileDisposition. R(RR,Rtwritet_disposition_debug_msg(RNRRR((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyRjCscCsb|j||}|jjdr]|s:d|f}nd||f}|jj|n| S(sCheck a file name against the include/omit/etc, rules, verbosely. Returns a boolean: True if the file should be traced, False if not. Rs Including %rsNot including %r: %s(RR,RR(RNRRRtmsg((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyRkNscCs||jjkrdS|jj||r?d||f}n|jjdrjdtj|f}ntj j d|dS(s_Use `msg` as a warning. For warning suppression, use `slug` as the shorthand. Ns%s (%s)tpids[%d] %ssCoverage.py warning: %s ( R.tdisable_warningsR=RiR,RR_tgetpidRcRdR(RNRtslug((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyRl^scCs|jj|S(s[Get an option from the configuration. `option_name` is a colon-separated string indicating the section and option name. For example, the ``branch`` option in the ``[run]`` section of the config file would be indicated with `"run:branch"`. Returns the value of the option. .. versionadded:: 4.0 (R.t get_option(RNt option_name((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyRns cCs|jj||dS(sSet an option in the configuration. `option_name` is a colon-separated string indicating the section and option name. For example, the ``branch`` option in the ``[run]`` section of the config file would be indicated with ``"run:branch"``. `value` is the new value for the option. This should be a Python value where appropriate. For example, use True for booleans, not the string ``"True"``. As an example, calling:: cov.set_option("run:branch", True) has the same effect as this configuration file:: [run] branch = True .. versionadded:: 4.0 N(R.t set_option(RNRtvalue((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyR|scCs$|j|s |jdndS(sObsolete method.s(use_cache(False) is no longer supported.N(RRl(RNtusecache((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyt use_caches cCs.|j|jj|jj|jdS(s;Load previously-collected coverage data from the data file.N(RRBtresetRAtreadR@(RN((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pytloads  cCsR|j|jr"|j|_n|jr8|jn|jjt|_dS(saStart measuring code coverage. Coverage measurement only occurs in functions called after :meth:`start` is invoked. Statements in the same scope as :meth:`start` won't be measured. Once you invoke :meth:`start`, you must also call :meth:`stop` eventually, or your process might not shut down cleanly. N( RRGRFR1RRBtstartR:RK(RN((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyRs     cCs&|jr|jjnt|_dS(sStop measuring code coverage.N(RKRBtstopRI(RN((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyRs cCs^|jjdr.|jjdj|n|jrD|jn|jrZ|jndS(sClean up on process shutdown.tprocesss atexit: {0!r}N(R,RRtformatRKRR2tsave(RN((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyRs    cCsA|j|jj|jj|jjd|jjdS(sErase previously-collected coverage data. This removes the in-memory data collected in this session as well as discarding the data file. R(N(RRBRR@teraseRAR.R((RN((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyRs   texcludecCs/|jt|j|dg|jdS(sClear the exclude list.t_listN(RtsetattrR.Rf(RNtwhich((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyt clear_excludes cCs;|jt|j|d}|j||jdS(s|Exclude source lines from execution consideration. A number of lists of regular expressions are maintained. Each list selects lines that are treated differently during reporting. `which` determines which list is modified. The "exclude" list selects lines that are not considered executable at all. The "partial" list indicates lines with branches that are not taken. `regex` is a regular expression. The regex is added to the specified list. If any of the regexes in the list is found in a line, the line is marked for special treatment during reporting. RN(RRR.RiRf(RNtregexRt excl_list((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyRs  cCs|jjdS(s=Drop all the compiled exclusion regexes, a list was modified.N(RHtclear(RN((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyRfscCsF||jkr;t|j|d}t||j|t_warn_about_unmeasured_codeR@R;RlR?RctmodulesR{R_RgtexistsR\Rt_find_unexecuted_filesR}R)R.Rt add_run_info(RNtpkgtpkg_fileR((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyR=s  cCstjj|}|dkr9|jd|dddSt|doUt|d }t|doytjj|j }|rdS|s|jd|dddS|jd |dd dS( s}Warn about a package or module that we never traced. `pkg` is a string, the name of the package or module. sModule %s was never imported.Rsmodule-not-importedNt__path__R\sModule %s has no Python source.smodule-not-pythons4Module %s was previously imported, but not measured.smodule-not-measured( RcRRaR/RlR{R_RgRR\(RNRRt is_namespacethas_file((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyR]s $ ccs@x9|jD].}x%|j|D]}||jfVq Wq WdS(s&Get executable files from the plugins.N(RCtfind_executable_filesRX(RNtsrc_dirRZtx_file((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyt_find_plugin_files|scCsdt|D}|j|}x`tj||D]L\}}t|}|jrq|jj|rqq8n|jj||q8WdS(sFind unexecuted files in `src_dir`. Search for files in `src_dir` that are probably importable, and add them as unexecuted files in `self.data`. css|]}|dfVqdS(N(R/(RYtpy_file((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pys sN( R Rt itertoolstchainRR9RR@t touch_file(RNRtpy_filest plugin_filest file_patht plugin_name((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyRs cCs.|j|\}}}}}||||fS(s:Like `analysis2` but doesn't return excluded line numbers.(t analysis2(RNRtftst_Rtmf((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pytanalysisscCsP|j|j|}|jt|jt|jt|j|jfS(sGAnalyze a module. `morf` is a module or a file name. It will be analyzed to determine its coverage statistics. The return value is a 5-tuple: * The file name for the module. * A list of line numbers of executable statements. * A list of line numbers of excluded statements. * A list of line numbers of statements not run (missing from execution). * A readable formatted string of the missing line numbers. The analysis uses the source file itself and the current measured coverage data. (Rt_analyzeRRt statementstexcludedtmissingtmissing_formatted(RNRR((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyRs    cCs;|jt|ts+|j|}nt|j|S(sTAnalyze a single morf or code unit. Returns an `Analysis` object. (RRrRt_get_file_reporterRR@(RNtit((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyRs cCsd}d}t|trWt|}|jj|}|rW|jj|}qWn|r|j|}|dkrt d|j |fqn|dkrt ||}n|S(s-Get a FileReporter for a module or file name.tpythons1Plugin %r did not provide a file reporter for %r.N( R/RrRRR@RRCRat file_reporterRRXR(RNRRZRtabs_morfR ((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyRs    cCsp|s|jj}nt|ttfs9|g}ng}x*|D]"}|j|}|j|qFW|S(sGet a list of FileReporters for a list of modules or file names. For each module or file name in `morfs`, find a FileReporter. Return the list of FileReporters. If `morfs` is a single module or file name, this returns a list of one FileReporter. If `morfs` is empty or None, then the list of all files measured is used to find the FileReporters. (R@tmeasured_filesRrtlistttupleRRi(RNtmorfstfile_reportersRR((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyt_get_file_reporterss   c CsZ|j|jjd|d|d|d|d|t||j}|j|d|S(sWrite a summary report to `file`. Each module in `morfs` is listed, with counts of statements, executed statements, missing statements, and a list of lines missed. `include` is a list of file name patterns. Files that match will be included in the report. Files matching `omit` will not be included in the report. If `skip_covered` is True, don't report on files with 100% coverage. Returns a float, the total percentage covered. t ignore_errorsR*R+t show_missingt skip_coveredtoutfile(RR.t from_argsRtreport( RNR!R%R$tfileR*R+R&treporter((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyR)s    cCsR|j|jjd|d|d|t||j}|j|d|dS(szAnnotate a list of modules. Each module in `morfs` is annotated. The source is written to a new file, named with a ",cover" suffix, with each line prefixed with a marker to indicate the coverage of the line. Covered lines have ">", excluded lines have "-", and missing lines have "!". See :meth:`report` for other arguments. R$R*R+R]N(RR.R(RR)(RNR!R]R$R*R+R+((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pytannotates   c Cs`|j|jjd|d|d|d|d|d|d|t||j} | j|S(sGenerate an HTML report. The HTML is written to `directory`. The file "index.html" is the overview starting point, with links to more detailed pages for individual modules. `extra_css` is a path to a file of other CSS to apply on the page. It will be copied into the HTML directory. `title` is a text string (not HTML) to use as the title of the HTML report. See :meth:`report` for other arguments. Returns a float, the total percentage covered. R$R*R+thtml_dirt extra_csst html_titleR&(RR.R(RR)( RNR!R]R$R*R+R.ttitleR&R+((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyt html_report#s  c Csa|j|jjd|d|d|d|d }t}|jjr|jjdkretj}qtj j |jj}|rtj j | rtj |ni} t jrd| ds t command_linet targvs???R4R5R8R9R7R6s-none-(!RBRRCRmRXRqRit __version__R\RERDRBRpR.tattempted_config_filesRDRARRcRAtreplaceRvtpython_implementationRIR_tgetcwdRgRRR`RoRR( RNtcovmodt ft_pluginstfttft_nameRt matcher_namest matcher_nametmatchert matcher_info((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyRssJ            '  N(.Rt __module__t__doc__R/RIR:RPRRR}RRRRjRkRlRRRRRRRRRRRfRRRRRRRRRRRRRR#R)R,R1R@R(((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyR">sd     r  ( l *             %              1cCsL|}||_||_d|_t|_d|_d|_t|_|S(s6Construct and initialize a new FileDisposition object.RGN( RRR/RRIRRRR(tclsRR((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyRs        cCsS|jr9d|jf}|jrO|d|j7}qOnd|j|jf}|S(s?Make a nice debug message of what the FileDisposition is doing.s Tracing %rs: will be traced by %rsNot tracing %r: %s(RRRR(RR((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyRs   cCsptjjd}|sdSttdr/dStd|}|t_|jt |_ t |_ t |_ |S(sCall this at Python start-up to perhaps measure coverage. If the environment variable COVERAGE_PROCESS_START is defined, coverage measurement is started. The value of the variable is the config file to use. There are two ways to configure your Python installation to invoke this function when Python starts: #. Create or append to sitecustomize.py to add these lines:: import coverage coverage.process_startup() #. Create a .pth file in your Python installation containing:: import coverage; coverage.process_startup() Returns the :class:`Coverage` instance that was started, or None if it was not started by this call. tCOVERAGE_PROCESS_STARTRBR#N(R_R`RaR/R{tprocess_startupR"RBRRIR;R<R:R2(tcpstcov((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyRds      cCs.ttdd}|dk r*t|_ndS(s7Stop any subprocess auto-measurement from writing data.RBN(RRdR/RIR2(tauto_created_coverage((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pyRMs (GRaRtRuRR_RvRxRcRzRBRtcoverage.annotateRtcoverage.backwardRRtcoverage.collectorRtcoverage.configRt coverage.dataRRtcoverage.debugRR tcoverage.filesR R R R RRRRRt coverage.htmlRt coverage.miscRRRRRtcoverage.pluginRtcoverage.plugin_supportRtcoverage.pythonRRtcoverage.resultsRRtcoverage.summaryRtcoverage.xmlreportR tcoverage.multiprocR!t ImportErrorR/RyRwtPYPYtobjectR"RRRdRM(((s2/tmp/pip-build-hU8Cw8/coverage/coverage/control.pytsh               t 5