o v&iӏ@sdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl mZmZmZddlZddlmZmZddlmZddlmZddlmZdd lmZmZmZdd lmZm Z m!Z!dd l"m#Z#m$Z$m%Z%dd l&m'Z'dd l(m)Z)m*Z*ddl+m,Z,dXddZ-GdddZ.Gdddej/Z0Gddde0Z1Gddde0Z2e.j3e.j4e.j5gZ6e2de.j7e.j8e.j9e.j:e.j;ge6de-dde2d e.je.j?ge6d!e-d"de2d#e6d$e-d%de2d&e.j=ge6d'd(e2d)e6d*d+de2d,e.j@e.j7e.j8e.jAe.j9e.j:e.j;e.jBe.j?e.jCe.jDe.jEe.jFe.jGge6de-d-de2d.e.j@e.j8e.jAe.j9e.j:e.j;e.jHe.jIe.j?e.jCg e6dd/de2d0e.j8e.jAe.j9e.j:e.jJe.j;e.j?ge6dd1de2d2e.j@e.j8e.jAe.jKe.j9e.j:e.j;e.jBe.jLe.jMe.jDe.jEe.jFg e6dd3de2d4e.jdZejdd?d d3ed@dZejdAdd dBddCdDZejdAdd dBddEdDZ ejdAdd dBddFdDZ!ejddGddHdZ"ejdIdJdedKdZ#ejddLd dMe$edNd(Z%ejdOdPddQdZ&ejddRd edSdZ'ejddTd dUdVdWgedXdYZ(ejdZdd[dZ)ejd\dd]dZ*ejd^d_d`dadbZ+ejdcddddZ,ejded dfedgdZ-ejddhd didjdZ.ejddkddldZ/ejddmd dndodZ0ejddpddqdZ1drS)sOptszBA namespace class for individual options we'll build parsers from.z-az--append store_truezBAppend data to the data file. Otherwise it starts clean each time.)actionhelpz--branchz:Measure branch coverage in addition to statement coverage.z --concurrencystoreLIBSz Properly measure code using a concurrency library. Valid values are: {}, or a comma-list of them. z, )r#metavarr$z --contextLABELz2The context label to record for this coverage run.z --contextszREGEX1,REGEX2,...z Only display data from lines covered in the given contexts. Accepts Python regexes, which must be quoted. z --data-fileDATAFILEz~ Base name of the data files to operate on. Defaults to '.coverage'. [env: COVERAGE_FILE] INFILEz Read coverage data for report generation from this file. Defaults to '.coverage'. [env: COVERAGE_FILE] OUTFILEz Write the recorded coverage data to this file. Defaults to '.coverage'. [env: COVERAGE_FILE] z--debugOPTSz9Debug options, separated by commas. [env: COVERAGE_DEBUG]z-dz --directoryDIRzWrite the output files to DIR.z --fail-underMINfloatz?Exit with a status of 2 if the total coverage is less than MIN.)r#r(typer$z--formatFORMATz9Output format, either text (default), markdown, or total.z-hz--helpzGet help on this command.z-iz--ignore-errorsz)Ignore errors while reading source files.z --includez PAT1,PAT2,...z Include only files whose paths match one of these patterns. Accepts shell-style wildcards, which must be quoted. z--keepz9Keep original coverage files, otherwise they are deleted.z-Lz--pylibz} Measure coverage even inside the Python installed library, which isn't done by default. -mz--show-missingzEShow line numbers of statements in each module that weren't executed.--modulez is an importable Python module, not a script path, to be run as 'python -m' would run it. z--omitz Omit files whose paths match one of these patterns. Accepts shell-style wildcards, which must be quoted. z-ooutfilez=Write the XML report to this file. Defaults to 'coverage.xml')r#destr(r$z?Write the JSON report to this file. Defaults to 'coverage.json'z?Write the LCOV report to this file. Defaults to 'coverage.lcov'z--pretty-printz"Format the JSON for human readers.z-pz--parallel-modez Append a unique suffix to the data file name to collect separate data from multiple processes. z --precisionNz| Number of digits after the decimal point to display for reported coverage percentages. z-qz--quietz-Don't print messages about what is happening.z--rcfilez Specify configuration file. By default '.coveragerc', 'setup.cfg', 'tox.ini', and 'pyproject.toml' are tried. [env: COVERAGE_RCFILE] z --save-signalSIGNALUSR1USR2z Specify a signal that will trigger coverage to write its collected data. Supported values are: USR1, USR2. Not available on Windows. )r#r(choicesr$z--show-contextsz Show contexts for covered lines.z--skip-coveredzSkip files with 100% coverage.z--no-skip-covered store_false skip_coveredzDisable --skip-covered.)r#r6r$z --skip-emptyzSkip files with no code.z--sortCOLUMNz Sort the report by the named column: name, stmts, miss, branch, brpart, or cover. Default is name. z--sourcez SRC1,SRC2,...z=A list of directories or importable names of code to measure.z--timidz*Use the slower Python trace function core.z--titleTITLEz.A text string to use as the title on the HTML.z --versionz%Display version information and exit.N)2__name__ __module__ __qualname____doc__optparse make_optionappendbranchr formatrsortedrCONCURRENCY_CHOICES concurrencycontextcontextsdatafile datafle_inputdatafile_outputdebug directory fail_underr$ ignore_errorsincludekeeppylib show_missingmoduleomit output_xml output_json output_lcovjson_pretty_print parallel_modeint precisionquietrcfile save_signal show_contextsr=no_skip_covered skip_emptysortsourcetimidtitleversionrrrrr!)s2               r!csJeZdZdZdfdd ZGd d d eZdfd d ZdddZZ S)CoverageOptionParserz|Base OptionParser for coverage.py. Problems don't exit the program. Defaults are initialized for all options. argsrkwargsrNonecsd|d<tj|i||jd$iddddddddddddd dd dd dd dd dddddddddddddddddddddddddddddddddddd dd!dd"dd#d|dS)%NFadd_help_optionr#rFrGrKrLrM data_filerQrRrSrHr$rTrUrVrYrZr_rarWrbrcTrdrerXr=rgrhrirjrkrlr)super__init__ set_defaultsdisable_interspersed_args)selfrnro __class__rrrtzs       ! $zCoverageOptionParser.__init__c@seZdZdZdS)z&CoverageOptionParser.OptionParserErrorz;Used to stop the optparse error handler ending the process.N)r@rArBrCrrrrOptionParserErrorsrz list[str].tuple[bool, optparse.Values | None, list[str]]cs>z t|\}}Wn|jyddgfYSwd||fS)zUCall optparse.parse_args, but return a triple: (ok, options, args) FNT)rs parse_argsrz)rwrnoptionsrxrr parse_args_oks  z"CoverageOptionParser.parse_args_okmsgrrcCst||j)z7Override optparse.error so sys.exit doesn't get called.) show_helprz)rwrrrrerrorszCoverageOptionParser.error)rnrrorrrp)rnr{rr|)rrrr) r@rArBrCrt Exceptionrzrr __classcell__rrrxrrmrs ) rmcs"eZdZdZdfdd ZZS)GlobalOptionParserz)r)rwrrrr__eq__szCmdOptionParser.__eq__cst}|d|jS)z>Override of an undocumented function in optparse.OptionParser.r)rs get_prog_namer)rw program_namerxrrrs zCmdOptionParser.get_prog_namer)r#rr~rrrrr)rrrr)rr) r@rArBrCrtr__hash__rrrrrxrrs rannotatez[options] [modules]z Make annotated copies of the given files, marking statements that are executed with > and statements that are missed with !. rcombinez%[options] ... a| Combine data from multiple coverage files. The combined results are written to a single file representing the union of the data. The positional arguments are data files or directories containing data files. If no paths are provided, data files in the default data file's directory are combined. rQza Display information about the internals of coverage.py, for diagnosing problems. Topics are: 'data' to show a summary of the collected data; 'sys' to show installation information; 'config' to show the configuration; 'premain' to show what is calling coverage; 'pybehave' to show internal flags describing Python behavior; 'sqlite' to show SQLite compilation options. erasez)Erase previously collected coverage data.)rr$z [command]zDescribe how to use coverage.pyhtmlz Create an HTML report of the coverage of the files. Each file gets its own page, with the source decorated to show executed, excluded, and missed lines. jsonz+Generate a JSON report of coverage results.lcovz,Generate an LCOV report of coverage results.reportz&Report coverage statistics on modules.runz$[options] [program options]z/Run a Python program, measuring code execution.xmlz+Generate an XML report of coverage results.) rrrQrr$rrrrrrrrtopicparseroptparse.OptionParser | NonerpcCsB|s|s|sJtjd}|tjjdrtj|}tj|}tj r5d}||r5|dt | }t t j }t|d<||d<trId|d<nd |d<|rbt|tjd td |d tjd n3|rpt|tn%|dusvJtt|d }|rt|jdi|ntd|tdjdi|dS)z-Display an error message, or the named topic.rz __main__.pyz -script.pyNrrzwith C extensionextension_modifierzwithout C extension)filezUse 'z help' for help.r%zDon't know topic z"Full documentation is at {__url__}r)sysargvendswithospathsepdirnamebasenamerWINDOWSlendictcoverage__dict__rr printstderr format_helpstriptextwrapdedent HELP_TOPICSgetrH)rrr program_pathr auto_suffix help_paramshelp_msgrrrrs6       r)rc@sLeZdZdZdddZdd d ZdddZd ddZd!ddZd"ddZ dS)#CoverageScriptz*The command-line interface to coverage.py.rrpcCsd|_|dS)NF) global_optionrrrrrtszCoverageScript.__init__rr{r`cCs|s tddtS|dd|_|jrt}nt|d}|s,td|dtS|dd}||\}}}|s>tS|dusDJ| |||rMtSt |j }t |j }t |j }t |j} t |j} |jdurr|jd} nd} t|jpyt|j|j|j|j|j|||| | d |j|j d |_|jd kr||S|jd kr|jtS|jd kr| ||S|jdkr|j!r|j"|pd} |jj#| d t$|j%d|j&tSt't(||j)||| d} t*j+,dd|j"d}|jdkr|jj-d#|j.|j/|j0|j1|j2|j3d| }nq|jdkr!|jj4d#d|j5i| n^|jdkr>|jj6d#|j5|j.|j0|j1|j7|j8d| }nA|jdkrS|jj9d#|j:|j1d| }n,|jdkrj|jj;d#|j:|j<|j7d| }n|jdkr}|jj=d#d|j:i| }nt>|dur|j?dur|j@d|j?|j.dur|j@d|j.tAtB|jCd}tAtD|jCd}tE|||rd j3tF||||d!}tGd"|tHStS)$zThe bulk of the command line interface to coverage.py. `argv` is the argument list to process. Returns 0 if all is well, 1 if something went wrong. minimum_helprr-zUnknown command: rN,T)rr data_suffix cover_pylibrjrG config_filerirZrUrQrKcheck_preimportedrLmessagesrQrrr)strictrV)morfsrTrZrUrMr%r)rarXr=rgrh output_formatrrRr)rRrar=rgrerkr)r5rgr)r5 pretty_printrerr5zreport:fail_underzreport:precisionz;total of {total} is less than fail-under={fail_under:.{p}f})totalrSpzCoverage failure:r)IrOK startswithrrCOMMANDSrERRrdo_help unshell_listrirZrUrQrMrKrrrrr r_rWrjrGrcrLrbrr#do_debugrdo_runrFloadrrrVsaver unglob_argsrTrrinsertrrarXr=rgrhrHrrR html_reportrerk xml_reportr5 json_reportr lcov_reportAssertionErrorrS set_optionrr0 get_optionr`rrr FAIL_UNDER)rwrrokr~rnrirZrUrQrMrK data_paths report_argsrrSrarrrr command_lines                              zCoverageScript.command_liner~optparse.Valuesrnroptparse.OptionParserrcCs|jr|jr tdddSt|ddS|jdkr=|r6|D]}t|}|dur.t|dqt|dqdStdddS|jrGtdddSdS)z`Deal with help requests. Return True if it handled the request, False if not. r$r)rTNrlF)r$rrr#rrrl)rwr~rnra parser_mayberrrrs(         zCoverageScript.do_help_signum_frametypes.FrameType | NonecCstddd|jdS)z&Signal handler to save coverage reportzSaving coverage data...T)flushN)rrr)rwrrrrrdo_signal_saves zCoverageScript.do_signal_savecCs|s.|jr tdtStt|jd}|dur.t|}|r.|ddvr.d|_|dd}|s6tdtS|j rE|jd rEtd tS|j d krdd D]}t ||durctd d|dtSqLdt j d<t|t|jd}||j r~|j|jrtjrtdtSt td|j}t||j|jd}z z|Wn tyd}wW|j|r|jtS|j|r|jww)z!Implementation of 'coverage run'.zNo module specified for -mzrun:command_lineNr>r3r4TrzNothing to do.z run:parallelz,Can't append to data files in parallel mode.multiprocessing)rGrUrZrWrirjzROptions affecting multiprocessing must only be specified in a configuration file. z Remove --z from the command line.true COVERAGE_RUN) as_modulez*--save-signal is not supported on Windows.SIGF)rYrrrrrrshlexrrFrKgetattrrenvironrrpreparerrdrrsignalrstartrrstoprr)rwr~rnropt_namerunnersigcode_ranrrrrsl             zCoverageScript.do_runcCs:|stdtS|ddrtdtS|ddkr%ttd|jtS|ddkrKttd|jjj}t |t |D] }tdt |q>tS|dd kr]ttd |jj tS|dd krrttd tt d d tS|dd krttd t tS|ddkrttdttStd|dtS)z#Implementation of 'coverage debug'.zNWhat information would you like: config, data, sys, premain, pybehave, sqlite?rNz Only one topic at a time, pleaserrdataz-----configpremainT)fullpybehavesqlitezDon't know what you mean by )rrrrrsys_inforrrrr r debug_inforrr r)rwrnrrfilenamerrrr sD          zCoverageScript.do_debugNr)rr{rr`)r~rrnr{rrrr)rr`rrrrp)r~rrnr{rr`)rnr{rr`) r@rArBrCrtrrrrrrrrrrs   % & Brslist[str] | NonecCs"|sdStjr |d}|dS)z)Turn a command-line argument into a list.N'r)rrrr)r rrrr1s   rrnr{cCsHtjr"g}|D]}d|vsd|vr|t|q||q|}|S)z5Interpret shell wildcards for platforms that need it.?*)rrextendglobrF)rnglobbedargrrrr?s ra Coverage.py, version {__version__} {extension_modifier} Measure, collect, and report on code coverage in Python programs. usage: {program_name} [options] [args] Commands: annotate Annotate source files with execution information. combine Combine a number of data files. debug Display information about the internals of coverage.py erase Erase previously collected coverage data. help Get help on using coverage.py. html Create an HTML report. json Create a JSON report of coverage results. lcov Create an LCOV report of coverage results. report Report coverage stats on modules. run Run a Python program and measure code execution. xml Create an XML report of coverage results. Use "{program_name} help " for detailed help on any command. z Code coverage for Python, version {__version__} {extension_modifier}. Use '{program_name} help' for help. z7Coverage.py, version {__version__} {extension_modifier})r$rrlr int | Nonec Cs|dur tjdd}z t|}W|Sty/}ztj|jt}WYd}~|Sd}~wt y]}z#|jd}|j rL| ddt d|j }t |t}WYd}~|Sd}~wty}z|jrm|jd}n d}WYd}~|SWYd}~|Sd}~ww)z\The main entry point to coverage.py. This is installed as the script entry point. Nrr.z; see z/messages.html#error-)rrrrr tracebackprint_exceptionrnrrslugrstriprr SystemExit)rstatuserrrrrrmainls6    rCOVERAGE_PROFILE)SimpleLauncherc Csvt}zt|W|jddd\}}t|j|dddd|S|jddd\}}t|j|dddd|w)z$A wrapper around main that profiles.rd) re_filter max_recordsr%)querylimitrcol)r launch original_mainr$rshowcancel)rprofilerr_rrrrs  )rrrr)NNN)rrrrrrrrp)r rrr )rnr{rr{r)rr rr)hrC __future__rrrDros.pathrrrrrtypestypingrrrrrrcoverage.configrcoverage.controlr coverage.corer coverage.datar r r coverage.debugrrrcoverage.exceptionsrrrcoverage.execfilercoverage.resultsrrcoverage.versionrr r! OptionParserrmrrrQr$rc GLOBAL_ARGSrRrOrTrUrZrFrNrVrbrMrSrarer=rfrgrkr\r^r]rHrhrXrGrKrLrPrYrWr_rdrirjr[rrrrrrrrrrgetenv_profileox_profile.core.launchersr r(rrrrs       KH2      D / @  $