NAME
Dist::Zilla::Plugin::ReportVersions::Tiny - reports dependency versions during testing
VERSION
version 1.04
SYNOPSIS
In your dist.ini, include [ReportVersions::Tiny] to load the plugin.
DESCRIPTION
This module integrates with Dist::Zilla to automatically add an additional test to your released software. Rather than testing features of the software, this reports the versions of all static module dependencies, and of Perl, at the time the tests are run.
The value of this is that when someone submits a test failure report you can see which versions of the modules were installed and, hopefully, be able to reproduce problems that are dependent on a specific set of module versions.
Differences from Dist::Zilla::Plugin::ReportVersions
This module has the same goal as Dist::Zilla::Plugin::ReportVersions, but takes a much lighter weight approach: the module that inspired my code bundles a copy of YAML::Tiny, reads META.yml, then reports from that.
This gives the most accurate picture, since any requirements added at install time will be detected, but is overkill for the vast majority of modules that use a simple, static list of dependencies.
This module, rather, generates the list of modules to test at the time the distribution is being built, and reports from that static list.
The biggest advantage of this is that I no longer have to bundle a large volume of code that isn't really needed, and have a simpler test suite with less places that things can go wrong.
ARGUMENTS
- exclude
-
Exclude an individual items from version reporting.
This is most commonly required if some module otherwise interferes with the normal operation of the tests, such as Module::Install, which does not behave as you might expect if normally
used.
AUTHORS
COPYRIGHT AND LICENSE
Copyright 2010 by Daniel Pittman <daniel@rimspace.net> All Rights Reserved.