20 Aug 2017 00:48:12 UTC
- Distribution: Dist-Zilla-Plugin-Test-CheckBreaks
- Module version: 0.019
- Source (raw)
- Browse (raw)
- How to Contribute
- Testers (499 / 0 / 0)
- KwaliteeBus factor: 1
- 94.74% Coverage
- License: perl_5
- Perl: v5.6.0
- Activity24 month
- Download (36.38KB)
- MetaCPAN Explorer
- Subscribe to distribution
- This version
- Latest version
- Reverse dependencies
- CPAN Testers List
- Dependency graph
- SEE ALSO
- COPYRIGHT AND LICENCE
Dist::Zilla::Plugin::Test::CheckBreaks - Generate a test that shows what modules you are breaking
In your dist.ini:
[Breaks] Foo = <= 1.1 ; Foo at 1.1 or lower will break when I am installed [Test::CheckBreaks] conflicts_module = Moose::Conflicts
This is a Dist::Zilla plugin that runs at the gather files stage, providing a test file that runs last in your test suite and checks for conflicting modules, as indicated by
x_breaksin your distribution metadata. (See the t/zzz-check-breaks.t test in this distribution for an example.)
x_breaksentries are expected to be version ranges, with one addition, for backwards compatibility with [Conflicts]: if a bare version number is specified, it is interpreted as
'<= $version'(to preserve the intent that versions at or below the version specified are those considered to be broken). It is possible that this interpretation will be removed in the future; almost certainly before
breaksbecomes a formal part of the meta specification.
The name of the conflicts module to load and upon which to invoke the
check_conflictsmethod. Defaults to the name of the main module with '
::Conflicts' appended, such as what is generated by the [Conflicts] plugin.
If your distribution uses Moose but does not itself generate a conflicts plugin, then
Moose::Conflictsis an excellent choice, as there are numerous interoperability conflicts catalogued in that module.
There is no error if the module does not exist. This test does not require [Conflicts] to be used in your distribution; this is only a feature added for backwards compatibility.
This option can be used more than once starting with version 0.017.
Suitable for distributions that do not wish to add a
test requiresprerequisite on CPAN::Meta::Requirements and CPAN::Meta::Check -- instead, the dependencies will be added as
test suggests, and the generated test will gracefully skip checks if these modules are not available.
Available since version 0.015.
I came upon this idea for a test after handling a bug report I've seen many times before when dealing with Moose code: "hey, when I updated Moose, my other thing that uses Moose stopped working!" For quite some time Moose has generated breakage information in the form of the moose-outdated executable and a check in Makefile.PL (which uses the generated module
Moose::Conflicts), but the output is usually buried in the user's install log or way up in the console buffer, and so doesn't get acted on nearly as often as it should. I realized it would be a simple matter to re-run the executable at the very end of tests by crafting a filename that always sorts (and runs) last, and further that we could generate this test. This coincided nicely with conversations on irc
x_breaksmetadata field and plans for its future. Therefore, this distribution, and its sister plugin [Breaks] were born!
The Annotated Lancaster Consensus at "Improving on 'conflicts'"
Bugs may be submitted through the RT bug tracker (or bug-Dist-Zilla-Plugin-Test-CheckBreaks@rt.cpan.org).
There is also a mailing list available for users of this distribution, at http://dzil.org/#mailing-list.
There is also an irc channel available for users of this distribution, at
I am also usually active on irc, as 'ether' at
Karen Etheridge <firstname.lastname@example.org>
Olivier Mengué <email@example.com>
This software is copyright (c) 2014 by Karen Etheridge.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
Module Install Instructions
To install Dist::Zilla::Plugin::Test::CheckBreaks, copy and paste the appropriate command in to your terminal.
perl -MCPAN -e shell install Dist::Zilla::Plugin::Test::CheckBreaks
For more information on module installation, please visit the detailed CPAN module installation guide.