gitpan / devel-coverage Goto Github PK
View Code? Open in Web Editor NEWRead-only release history for Devel-Coverage
Home Page: http://metacpan.org/release/Devel-Coverage
Read-only release history for Devel-Coverage
Home Page: http://metacpan.org/release/Devel-Coverage
Devel::Coverage 0.2 (alpha 2) WHAT IS IT? Devel::Coverage is a coverage analysis tool for Perl code. It is inspired by several factors, most notable my personal high consideration for the PureCoverage tool (formerly of PureAtria, now from Rational Software) and my frustration at finding bugs in my code that were hidden in blocks that were never reached in test cases. That's what a coverage analysis tool does-- it shows you what parts of your code were and were not reached over the course of one or more runs. WHAT DOES IT DO? Devel::Coverage is activated by the -d flag, just as tools like Devel::DProf are. With Perl in debugging mode, Devel::Coverage is able to take note of subroutine entry, lines reached, and each source code file as it is compiled. Counts of this data are collected, and at the end a total instrumentation data structure is created, merged with existing data, and written to a save file. The data gathered includes: Directories that had files instrumented All files that were instrumented Total number of runs done so far For each of the files, there is: A list of the subroutines in this file, each with a count of hits A list of the 'breakable' (executable) lines, with hit counts Total number of lines Modification time The modification time allows Devel::Coverage to discard stale instrumentation data for a file. If a file is changed between instrumentation runs, then the data from previous runs cannot be reliably compared to the new data (particularly when the change adds or deletes functions or lines). There is a *very* simple data output tool called coverperl included in the distribution. Future work includes much enhancement to this tool to make it into a useful utility. For now, you can at least look at the (fairly) raw data with it. What this package does *not* do is profiling. Profiling and coverage analysis are two different things, and the Devel::DProf package handles the former task very well. Devel::Coverage will show you where your tests are not reaching; Devel::DProf will tell you which subroutines are eating the most time. INSTALLATION The package should be uncompressed using the GNU zip utility. Once done and you have cd'd down to the directory: gzcat Devel-Coverage-0.1.tar.gz | tar xf - cd Devel/Coverage you will need to create the Makefile and verify that your package is complete: perl Makefile.PL This will verify the package contents against the manifest and create the file Makefile. It will also do some simple configuration checking and create a file called "prefs.pm" in the Coverage directory. Now all that needs to be done is: make #make test # There are not any tests, yet make install # Assuming all tests were passed CAVEATS This is about as alpha as code can be without me fearing my reputation over its release. There are bound to be bugs, oh boy are there. And the only way to view the data is a super-simplistic format from coverperl. But I *am* working on better data analysis tools. I just wanted some early feedback on the core functionality here. See the ToDo file for more detail. EXAMPLES Most simple: perl -d:Coverage script_name arg1 arg2 ... Data written to script_name.cvp. View it by: coverperl script_name.cvp Another example; create a file .coverperl in your home directory with the single line "file coverage". Run several scripts, either multiple runs of the same script with different arguments, or different scripts entirely. All data goes to the file coverage.cvp, which can be view with coverperl as per above. There are more things that can be added to .coverperl, but it isn't documented yet. PROBLEMS/BUG REPORTS Please send any reports of problems or bugs to [email protected]. CREDITS AND LICENSES This package is copyright (c) 2000 by Randy Ray ([email protected]) and may be distributed under terms of the Artistic License used to cover Perl itself. See the file Artistic in the distribution of Perl 5.002 or later for details of copy and distribution terms. All rights reserved.
A declarative, efficient, and flexible JavaScript library for building user interfaces.
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. ๐๐๐
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google โค๏ธ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.