publishing cpan modules with testml tests

It is easy to publish Perl5 module distributions for CPAN, using TestML for some or all of their tests.

If you use Dist::Zilla you just need to add this line to your dist.ini file:

[TestMLIncluder]

When you create your dist using dzil build everything needed to run the TestML tests on the installer's side will be included under the inc directory.

NOTE: If you don't use Dist::Zilla you'll have to figure things out on your own for now. Helper tools for other distribution styles will be made available soon.

TestML Dev Set Up

You will need to have the latest TestML installed from source, like this:

git clone [email protected]:testml-lang/testml
source testml/.rc

NOTE: You don't install TestML from CPAN. Well, you can install it but it won't help you here. This may change in the future.

Now you can write any of your t/xxx.t test files in pure TestML. These files will start with the shebang line:

#!/usr/bin/env testml

or:

#!/usr/bin/env testml-pl5

You can have all or just some of your test files using TestML. TestML will produce TAP output, so they will ending up running just like your normal test files.