NAME
Test::Cookbook - Write your tests as cookbooks
SYNOPSIS
With your test formatted as a cookbook in t/005_cookbook.t
$> ./Build test
$> ./Build test --test_files t/005_cookbook.t
$> prove t/005_cookbook.t
$> runtests t/005_cookbook.t
$> pod_tested.pl -i t/005_cookbook.t -o cookbook.pod
DESCRIPTION
This module is wrapper around POD::Tested. POD::Tested let's you write POD containing tests. I use it mainly to write cookbooks with the ability to check the cookbook and generate part of it.
I started by writing tests, then I copied the tests into the cookbook. Then it hit me that both could be the same. That I could write my tests as cookbooks.
These are the advantages when writing your tests as cookbooks:
single file to manipulate, no copy/paste and the errors associated with it
your tests become much easier to read because they must be documented
you can manually generate cookbooks from your tests
you can generate cookbooks when your tests are run (not yet implemented)
design and document your modules in the tests
DOCUMENTATION
SUBROUTINES/METHODS
import
This is automatically called for you by Perl
FILTER
This is automatically called for you by Perl
BUGS AND LIMITATIONS
None so far.
AUTHOR
Khemir Nadim ibn Hamouda
CPAN ID: NKH
mailto:nadim@khemir.net
LICENSE AND COPYRIGHT
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
SUPPORT
You can find documentation for this module with the perldoc command.
perldoc Test::Cookbook
You can also look for information at:
AnnoCPAN: Annotated CPAN documentation
RT: CPAN's request tracker
Please report any bugs or feature requests to L <bug-test-cookbook@rt.cpan.org>.
We will be notified, and then you'll automatically be notified of progress on your bug as we make changes.
Search CPAN