NAME
archive_devel_cover.pl - script to archive Devel::Cover reports
VERSION
version 1.001
SYNOPSIS
~/perl/Some-Project$ archive_devel_cover.pl --project Some-Project --from cover_db/ --to /var/www/coverage_reports/some_project/DESCRIPTION
Do you want to see how your test coverage (as reported by the wonderful Devel::Cover) changes over time? If yes, then give archive_devel_cover.pl a try!
archive_devel_cover.pl will copy your most current coverage report into an archive and set up a small index page, showing the most relevant (IMO) metrics and a "trend" (did you cover more or less code since the last run?).
NOTE: Currently there is nearly no input checking implemented, so if you use archive_devel_cover.pl on directories that contain other stuff than what's expected, strange things might happen...
USAGE
~$ C<archive_devel_cover.pl> --from path/to/cover_db --to target/dirThis statement will copy the contents of path/to/cover_db (which should be the result of a Devel-Cover testrun) into a directory in target/dir named like the ISO8601 formatted date of the test run (eg. 2012-02-26T00:32:42). The values for statement coverage, subroutine coverage and total coverage are stored in a very basic database (read: CSV text file) for later comparison. A link to the current run is added to the file index.html, together with the total coverage metrics and a trend value.
--from dir
The directory containing the HTML report generated by Devel::Cover.
--to dir
The directory that contains the collection of all coverage reports for this project.
--project name [optional]
The name of the project you're archiving. Currently only used in the generated HTML report. Defaults to 'unnamed project'.
AUTHOR
Thomas Klausner <domm@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2012 by Thomas Klausner.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.