12 Aug 2020 13:09:41 UTC
- Distribution: Dist-Zilla-Plugin-Test-ReportPrereqs
- Module version: 0.028
- Source (raw)
- Browse (raw)
- How to Contribute
- Issues (3)
- Testers (1611 / 2 / 0)
- KwaliteeBus factor: 1
- 89.47% Coverage
- License: apache_2_0
- Perl: v5.6.0
- Download (19.08KB)
- MetaCPAN Explorer
- Subscribe to distribution
- Reverse dependencies
- CPAN Testers List
- Dependency graph
- This version
- Latest version++ed by:2 non-PAUSE usersDavid Golden /
- SEE ALSO
- COPYRIGHT AND LICENSE
Dist::Zilla::Plugin::Test::ReportPrereqs - Report on prerequisite versions during automated testing
# in dist.ini [Test::ReportPrereqs] include = Acme::FYI exclude = Acme::Dont::Care
This Dist::Zilla plugin adds a t/00-report-prereqs.t test file and an accompanying t/00-report-prereqs.dd data file. It reports the version of all modules listed in the distribution metadata prerequisites (including 'recommends', 'suggests', etc.). However, any 'develop' prereqs are not reported (unless they show up in another category).
If a MYMETA.json file exists and CPAN::Meta is installed on the testing machine, MYMETA.json will be examined for prerequisites in addition, as it would include any dynamic prerequisites not set in the distribution metadata.
Versions are reported based on the result of
parse_versionfrom ExtUtils::MakeMaker, which means prerequisite modules are not actually loaded (which avoids various edge cases with certain modules). Parse errors are reported as "undef". If a module is not installed, "missing" is reported instead of a version string.
Additionally, if CPAN::Meta is installed, unfulfilled required prerequisites are reported after the list of all versions based on either MYMETA (preferably) or META (fallback).
includeattribute can be specified (multiple times) to add modules to the report. This can be useful if there is a module in the dependency chain that is problematic but is not directly required by this project. These modules will be listed in an "Other Modules" section at the end of the report.
excludeattribute can be specified (multiple times) to remove modules from the report (if you had a reason to do so).
When set, installed versions of all 'requires' prerequisites are verified against those specified. Defaults to true, but requires CPAN::Meta to be installed.
Specifies the module to use to extract each installed prerequisite's version. Defaults to ExtUtils::MakeMaker, which is recommended for most situations. It can also be specified as Module::Metadata, which can be useful if ExtUtils::MakeMaker's mechanism is too naive, or if ExtUtils::MakeMaker is not already a prerequisite of the distribution.
Other Dist::Zilla::Plugins do similar things in slightly different ways that didn't suit my style and needs.
Dist::Zilla::Plugin::Test::PrereqsFromMeta -- requires prereqs to be satisfied
Dist::Zilla::Plugin::Test::ReportVersions -- bundles a copy of YAML::Tiny, reads prereqs only from META.yml, and attempts to load them with
Dist::Zilla::Plugin::ReportVersions::Tiny -- static list only, loads modules with
Please report any bugs or feature requests through the issue tracker at https://github.com/dagolden/Dist-Zilla-Plugin-Test-ReportPrereqs/issues. You will be notified automatically of any progress on your issue.
This is open source software. The code repository is available for public review and contribution under the terms of the license.
git clone https://github.com/dagolden/Dist-Zilla-Plugin-Test-ReportPrereqs.git
David Golden <firstname.lastname@example.org>
Brendan Byrd <Perl@ResonatorSoft.org>
Dave Rolsky <email@example.com>
Karen Etheridge <firstname.lastname@example.org>
Kent Fredric <email@example.com>
Randy Stauner <firstname.lastname@example.org>
Yanick Champoux <email@example.com>
This software is Copyright (c) 2012 by David Golden.
This is free software, licensed under:
The Apache License, Version 2.0, January 2004
Module Install Instructions
To install Dist::Zilla::Plugin::Test::ReportPrereqs, copy and paste the appropriate command in to your terminal.
perl -MCPAN -e shell install Dist::Zilla::Plugin::Test::ReportPrereqs
For more information on module installation, please visit the detailed CPAN module installation guide.
|s||Focus search bar|
|?||Bring up this help dialog|
|g p||Go to pull requests|
|g i||go to github issues (only if github is preferred repository)|
|g a||Go to author|
|g c||Go to changes|
|g i||Go to issues|
|g d||Go to dist|
|g r||Go to repository/SCM|
|g s||Go to source|
|g b||Go to file browse|