NAME

Dist::Zilla::Plugin::PurePerlTests - Run all your tests twice, once
with XS code and once with pure Perl

VERSION

version 0.05

SYNOPSIS

In your dist.ini:

  [PurePerlTests]
  env_var = MY_MODULE_PURE_PERL

DESCRIPTION

This plugin is for modules which ship with a dual XS/pure Perl
implementation.

The plugin makes a copy of all your tests when doing release testing
(via dzil test or dzil release). The copy will set an environment value
that you specify in a BEGIN block. You can use this to force your code
to not load the XS implementation.

CONFIGURATION

This plugin takes one configuration key, "env_var", which is required.

SKIPPING TESTS

If you don't want to run the a given test file in pure Perl mode, you
can put a comment like this in your test:

  # no pp test

This must be on a line by itself. This plugin will skip any tests which
contain this comment.

SUPPORT

Please report any bugs or feature requests to
bug-dist-zilla-plugin-pureperltests@rt.cpan.org, or through the web
interface at http://rt.cpan.org. I will be notified, and then you'll
automatically be notified of progress on your bug as I make changes.

DONATIONS

If you'd like to thank me for the work I've done on this module, please
consider making a "donation" to me via PayPal. I spend a lot of free
time creating free software, and would appreciate any support you'd
care to offer.

Please note that I am not suggesting that you must do this in order for
me to continue working on this particular software. I will continue to
do so, inasmuch as I have in the past, for as long as it interests me.

Similarly, a donation made in this way will probably not make me work
on this software much more, unless I get so many donations that I can
consider working on free software full time, which seems unlikely at
best.

To donate, log into PayPal and send money to autarch@urth.org or use
the button on this page: http://www.urth.org/~autarch/fs-donation.html

AUTHOR

Dave Rolsky <autarch@urth.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2010 - 2015 by Dave Rolsky.

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)