ó …¾^Yc@sWdZddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl m Z ddl m Z mZddlmZddlmZddlmZmZmZeeƒZdefd „ƒYZd efd „ƒYZd „Zd „Zd„ZedkrSddlZeejdƒndS(sCoverage data for coverage.py.iÿÿÿÿN(tenv(tiitemst string_class(t_TEST_NAME_FILE(t PathAliases(tCoverageExceptiont file_be_gonetisolate_modulet CoverageDatacBs=eZdZd d„Zd„Zd„Zd„Zd„Zd„Z d„Z d„Z e d „Z d „ZeZd „Zd „Zd Zed„ƒZed„ƒZed„ƒZd„Zd„Zd„Zd„Zdd„Zd„Zd„Zd„Zd d„Zd„Z d„Z!d„Z"d„Z#d„Z$RS(!sÜ Manages collected coverage data, including file storage. This class is the public supported API to the data coverage.py collects during program execution. It includes information about what code was executed. It does not include information from the analysis phase, to determine what lines could have been executed, or what lines were not executed. .. note:: The file format is not documented or guaranteed. It will change in the future, in possibly complicated ways. Do not read coverage.py data files directly. Use this API to avoid disruption. There are a number of kinds of data that can be collected: * **lines**: the line numbers of source lines that were executed. These are always available. * **arcs**: pairs of source and destination line numbers for transitions between source lines. These are only available if branch coverage was used. * **file tracer names**: the module names of the file tracer plugins that handled each file in the data. * **run information**: information about the program execution. This is written during "coverage run", and then accumulated during "coverage combine". Lines, arcs, and file tracer names are stored for each source file. File names in this API are case-sensitive, even on platforms with case-insensitive file systems. To read a coverage.py data file, use :meth:`read_file`, or :meth:`read_fileobj` if you have an already-opened file. You can then access the line, arc, or file tracer data with :meth:`lines`, :meth:`arcs`, or :meth:`file_tracer`. Run information is available with :meth:`run_infos`. The :meth:`has_arcs` method indicates whether arc data is available. You can get a list of the files in the data with :meth:`measured_files`. A summary of the line data is available from :meth:`line_counts`. As with most Python containers, you can determine if there is any data at all by using this object as a boolean value. Most data files will be created by coverage.py itself, but you can use methods here to create data files if you like. The :meth:`add_lines`, :meth:`add_arcs`, and :meth:`add_file_tracers` methods add data, in ways that are convenient for coverage.py. The :meth:`add_run_info` method adds key-value pairs to the run information. To add a file without any measured data, use :meth:`touch_file`. You write to a named file with :meth:`write_file`, or to an already opened file with :meth:`write_fileobj`. You can clear the data in memory with :meth:`erase`. Two data collections can be combined by using :meth:`update` on one :class:`CoverageData`, passing it the other. cCs1||_d|_d|_i|_g|_dS(shCreate a CoverageData. `debug` is a `DebugControl` object for writing debug messages. N(t_debugtNonet_linest_arcst _file_tracerst_runs(tselftdebug((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pyt__init__ss     c Cs djd|jjd|jdkr*dndjt|jƒƒd|jdkrWdndjt|jƒƒddjt|jƒƒdd jt|jƒƒƒS( NsA<{klass} lines={lines} arcs={arcs} tracers={tracers} runs={runs}>tklasstlinesR s{{{0}}}tarcsttracerstrunss[{0}]( tformatt __class__t__name__R R tlenR R R(R((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pyt__repr__“s   --cCs |jƒS(sšDoes this data have arcs? Arc data is only available if branch coverage was used during collection. Returns a boolean. (t _has_arcs(R((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pythas_arcs s cCs|jdk r\|jj|ƒ}|dk r{tjj|ƒ}ttd„|DƒƒƒSn|jdk r{|jj|ƒSdS(scGet the list of lines executed for a file. If the file was not measured, returns None. A file might be measured, and have no lines executed, in which case an empty list is returned. If the file was executed, returns a list of integers, the line numbers executed in the file. The list is in no particular order. css!|]}|dkr|VqdS(iN((t.0tl((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pys ¹sN( R R tgett itertoolstchaint from_iterabletlisttsetR (RtfilenameRt all_lines((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pyR«s  cCs0|jdk r,||jkr,|j|SndS(sÆGet the list of arcs executed for a file. If the file was not measured, returns None. A file might be measured, and have no arcs executed, in which case an empty list is returned. If the file was executed, returns a list of 2-tuples of integers. Each pair is a starting line number and an ending line number for a transition from one line to another. The list is in no particular order. Negative numbers have special meaning. If the starting line number is -N, it represents an entry to the code object that starts at line N. If the ending ling number is -N, it's an exit from the code object that starts at line N. N(R R (RR&((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pyR¾scCs5||jp|jpikr1|jj|dƒSdS(s Get the plugin name of the file tracer for a file. Returns the name of the plugin that handles this file. If the file was measured, but didn't use a plugin, then "" is returned. If the file was not measured, then None is returned. tN(R R R R R (RR&((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pyt file_tracerÔs cCs|jS(sëReturn the list of dicts of run information. For data collected during a single run, this will be a one-element list. If data has been combined, there will be one element for each original data file. (R(R((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pyt run_infosãscCst|jp|jpiƒS(s+A list of all files that had been measured.(R$R R (R((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pytmeasured_filesíscCs^i}|rd„}n tjj}x3|jƒD]%}t|j|ƒƒ|||ƒýs(tostpathtbasenameR+RR(Rtfullpathtsummt filename_fnR&((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pyt line_countsñs   #cCst|jp|jƒS(N(tboolR R (R((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pyt __nonzero__scCs¥|j|ƒ}d|_|_d|kr;|d|_nd|krmtd„t|dƒDƒƒ|_n|jdiƒ|_|jdgƒ|_|j ƒdS(szRead the coverage data from the given file object. Should only be used on an empty CoverageData object. RRcss:|]0\}}|g|D]}t|ƒ^qfVqdS(N(ttuple(RtfnameRtpair((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pys st file_tracersRN( t_read_raw_dataR R R tdictRR R Rt _validate(Rtfile_objtdata((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pyt read_fileobj s  cCs—|jr5|jjdƒr5|jjd|fƒny)|j|ƒ}|j|ƒWdQXWn2tk r’}td||jj|fƒ‚nXdS(s8Read the coverage data from `filename` into this object.tdataiosReading data from %rNs$Couldn't read data from '%s': %s: %s( R tshouldtwritet_open_for_readingR@t ExceptionRRR(RR&R,texc((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pyt read_filess?!coverage.py: This is a private format, don't read it directly!cCs t|dƒS(s+Open a file appropriately for reading data.tr(topen(tclsR&((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pyRD/scCsC|jt|jƒƒ}||jkr6tdƒ‚ntj|ƒS(s%Read the raw data from a file object.s*Doesn't seem to be a coverage.py data file(treadRt_GO_AWAYRtjsontload(RJR>tgo_away((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pyR;4scCs)|j|ƒ}|j|ƒSWdQXdS(s-Read the raw data from a file, for debugging.N(RDR;(RJR&R,((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pyt_read_raw_data_file<scCs|jrT|jjdƒrT|jjdt|ƒtd„|jƒDƒƒfƒn|jƒrotdƒ‚n|jdkrŠi|_nxet |ƒD]W\}}||jkrÛt |j|ƒ}|j |ƒ|}nt |ƒ|j|Pss$Can't add lines to existing arc dataN(R RBRCRtsumtvaluesRRR R RR%tupdateR$R=(Rt line_dataR&tlinenost new_linenos((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pyt add_linesFs -    cCs|jrT|jjdƒrT|jjdt|ƒtd„|jƒDƒƒfƒn|jƒrotdƒ‚n|jdkrŠi|_nxet |ƒD]W\}}||jkrÛt |j|ƒ}|j |ƒ|}nt |ƒ|j|jss$Can't add arcs to existing line dataN(R RBRCRRRRSt _has_linesRR R RR%RTR$R=(Rtarc_dataR&Rtnew_arcs((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pytadd_arcs`s -    cCsó|jr;|jjdƒr;|jjdt|ƒfƒn|jpP|jpPi}xt|ƒD]\}}||krŽtd|fƒ‚n|jj |ƒ}|dk rÔ||krÔtd|||fƒ‚n||j||j|dt file_data((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pyt write_fileobj¹s    cCs^|jr5|jjdƒr5|jjd|fƒnt|dƒ}|j|ƒWdQXdS(s&Write the coverage data to `filename`.RAsWriting data to %rtwN(R RBRCRIRk(RR&tfdata((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pyt write_fileÏscCs2d|_d|_i|_g|_|jƒdS(sErase the data in this object.N(R R R R RR=(R((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pyteraseÖs     c CsW|jƒr'|jƒr'tdƒ‚n|jƒrN|jƒrNtdƒ‚n|pZtƒ}xŽ|jƒD]€}|j|ƒ}|j|ƒ}|j|ƒ}|dkrÂ|rê||j|If we are in paranoid mode, validate that everything is right.N(RtTESTINGt_validate_invariants(R((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pyR=s cCsì|jƒo|jƒ s%tdƒ‚|jƒr¢xnt|jƒD]Z\}}t|tƒsotd|fƒ‚td„|DƒƒsAtd||fƒ‚qAWn|jƒrxnt|jƒD]Z\}}t|tƒsìtd|fƒ‚td„|Dƒƒs¾td||fƒ‚q¾Wnxjt|j ƒD]Y\}}t|tƒs]td|fƒ‚|rrt|tƒs/td ||fƒ‚q/WxY|j D]N}t|t ƒs±t‚x0|D](}t|tƒs¸td |fƒ‚q¸Wq–Wd S( sValidate internal invariants.s$Shouldn't have both _lines and _arcssKey in _lines shouldn't be %rcss|]}t|tƒVqdS(N(t isinstancetint(Rtx((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pys .ss_lines[%r] shouldn't be %rsKey in _arcs shouldn't be %rcss3|])\}}t|tƒo*t|tƒVqdS(N(RzR{(RR|ty((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pys 6ss_arcs[%r] shouldn't be %rs$Key in _file_tracers shouldn't be %rs _file_tracers[%r] shoudn't be %rsKey in _runs shouldn't be %rN( RYRtAssertionErrorRR RzRtallR R RR<(RR8RRtplugintvaltkey((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pyRy#s*  " " cCsm|jƒr1|jt|j|ƒp'gƒƒn"|jt|j|ƒpLgƒƒ|j|j|ƒƒdS(sÚContribute `filename`'s data to the `hasher`. `hasher` is a `coverage.misc.Hasher` instance to be updated with the file's data. It should only get the results data, not the run data. N(RRTtsortedRRR)(RR&thasher((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pyt add_to_hashIs %"cCs |jdk S(sDo we have data in self._lines?N(R R (R((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pyRY[scCs |jdk S(sDo we have data in self._arcs?N(R R (R((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pyR_sN(%Rt __module__t__doc__R RRRRRR)R*R+tFalseR4R6t__bool__R@RGRLt classmethodRDR;RPRXR\R`RbReRkRnRoRTR=RyR…RYR(((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pyRs@?                 @  &  tCoverageDataFilescBsSeZdZdddd„Zed„Zd„Zdd„Zdded„Z RS(s&Manage the use of coverage data files.cCs1||_||_tjj|p$dƒ|_dS(s÷Create a CoverageDataFiles to manage data files. `warn` is the warning function to use. `basename` is the name of the file to use for storing data. `debug` is a `DebugControl` object for writing debug messages. s .coverageN(twarnRR.R/tabspathR&(RR0RŒR((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pyRgs  cCsñ|jr8|jjdƒr8|jjd|jfƒnt|jƒ|rítjj|jƒ\}}|d}tjjtjj |ƒ|ƒ}xYt j |ƒD]E}|jrÜ|jjdƒrÜ|jjd|fƒnt|ƒq¡WndS(s Erase the data from the file storage. If `parallel` is true, then also deletes data files created from the basename by parallel-mode. RAsErasing data file %rs.*sErasing parallel data file %rN( RRBRCR&RR.R/tsplittjoinRtglob(Rtparalleltdata_dirtlocaltlocaldottpatternR&((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pyRows  !cCs,tjj|jƒr(|j|jƒndS(sRead the coverage data.N(R.R/texistsR&RG(RR?((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pyRKŠscCsÀ|j}|tkr˜d}trOttƒ}|jƒ}WdQXd|}ntjtjdƒƒj ddƒ}dt j ƒ|tj ƒ|f}n|r¯|d|7}n|j |ƒdS(s7Write the collected coverage data to a file. `suffix` is a suffix to append to the base file name. This can be used for multiple or parallel execution, so that many coverage data files can exist simultaneously. A dot will be used to join the base name and the suffix. R(Nt.iii?Bs %s%s.%s.%06d(R&tTrueRRIRKtrandomtRandomR.turandomtrandinttsockett gethostnametgetpidRn(RR?tsuffixR&textraR,t test_nametdice((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pyRCs   $%cCs³tjj|jƒ\}}|d}|p1|g}g}x›|D]“} tjj| ƒru|jtjj| ƒƒqAtjj| ƒrÁtjjtjj| ƒ|ƒ} |j t j | ƒƒqAt d| fƒ‚qAW|rô| rôt dƒ‚nx¸|D]°} t d|j ƒ} y| j| ƒWn2t k rX} |jr«|jt| ƒƒq«qûX|j| d|ƒ|j r¡|j jdƒr¡|j jd| fƒnt| ƒqûWdS( s¿Combine a number of data files together. Treat `self.filename` as a file prefix, and combine the data from all of the data files starting with that prefix plus a dot. If `aliases` is provided, it's a `PathAliases` object that is used to re-map paths to match the local machine's. If `data_paths` is provided, it is a list of directories or files to combine. Directories are searched for files that start with `self.filename` plus dot as a prefix, and those files are combined. If `data_paths` is not provided, then the directory portion of `self.filename` is used as the directory to search for data files. Every data file found and combined is then deleted from disk. If a file cannot be read, a warning will be issued, and the file will not be deleted. If `strict` is true, and no files are found to combine, an error is raised. s.*s,Couldn't combine from non-existent path '%s'sNo data to combineRRsRAsDeleting combined data file %rN(R.R/RŽR&tisfiletappendRtisdirRRqRRRRRGRŒtstrRTRBRCR(RR?Rst data_pathststrictR’R“R”tfiles_to_combinetpR•R,tnew_dataRF((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pytcombine_parallel_dataªs0  !   N( RR†R‡R RRˆRoRKRCR­(((s//tmp/pip-build-hU8Cw8/coverage/coverage/data.pyR‹ds    cCs~x:t|jdiƒƒD] \}}t|ƒ|d|s2          ÿÿM