NAME

archive_devel_cover.pl - script to archive Devel::Cover reports

VERSION

version 1.004

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/dir

This 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@plix.at>

COPYRIGHT AND LICENSE

This software is copyright (c) 2012 - 2022 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.