Thomas Klausner > App-ArchiveDevelCover > archive_devel_cover.pl

Download:
App-ArchiveDevelCover-1.002.tar.gz

Annotate this POD

CPAN RT

Open  1
View/Report Bugs
Source  

NAME ^

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

VERSION ^

version 1.002

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@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.

syntax highlighting: