The Perl and Raku Conference 2025: Greenville, South Carolina - June 27-29 Learn more

NAME

Test::Named - Perl extension for named tests. Inspired on this:

http://www.modernperlbooks.com/mt/2013/05/running-named-perl-tests-from-prove.html

SYNOPSIS

#################
# WITH PLAN #
#################
# load your fav test harness
use Test::More tests => 3;
# load module to test
use_ok(Foo::Bar);
# run all tests unless named test specified
exit main( @ARGV );
# named tests are declared using test_ prefix
sub test_foo {
...
}
sub test_bar {
}
etc..
#################
# NO PLAN #
#################
# load your fav test harness - no plan
# load module to test
use_ok(Foo::Bar);
# use hooks to setup before and after testing
before_launch(sub { ok(1, 'Before Launch Executed') });
before_exit( sub { done_testing() });
# run all tests unless named test specified
exit main( @ARGV );
# named tests are declared using test_ prefix
sub test_foo {
...
}
sub test_bar {
}
etc..
#################
# RUN TESTS #
#################
prove -v -I lib/ t/*
prove -v -I lib/ t/TestFile.t
prove -v -I lib/ t/TestFile.t :: foo
prove -v -I lib/ t/TestFile.t :: bar

DESCRIPTION

This module is a very thin wrapper that allows easy named testing much like JUnit-based testing frameworks.

EXPORT

This module exports a subroutine named main() and two hooks before_lauch and before_exit that are setup using code references (see SYNOPSIS above)

SEE ALSO

https://github.com/aimass/Test-Named

AUTHOR

Alejandro Imass, https://github.com/aimass

COPYRIGHT AND LICENSE

Copyright (C) 2022 by Alejandro Imass

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.35.10 or, at your option, any later version of Perl 5 you may have available.